Zuul
Zuul is a project gating system.
The latest documentation for the current version of Zuul is published at: https://zuul-ci.org/docs/zuul/
If you are looking for the Edge routing service named Zuul that is related to Netflix, it can be found here: https://github.com/Netflix/zuul
If you are looking for the Javascript testing tool named Zuul, its archive can be found here: https://github.com/defunctzombie/zuul
Getting Help
There are two Zuul-related mailing lists:
- zuul-announce
A low-traffic announcement-only list to which every Zuul operator or power-user should subscribe.
- zuul-discuss
General discussion about Zuul, including questions about how to use it, and future development.
You will also find Zuul developers on Matrix <https://matrix.to/#/#zuul:opendev.org>.
Contributing
To browse the latest code, see: https://opendev.org/zuul/zuul To clone the latest code, use git clone https://opendev.org/zuul/zuul
Bugs are handled at: https://storyboard.openstack.org/#!/project/zuul/zuul
Suspected security vulnerabilities are most appreciated if first reported privately following any of the supported mechanisms described at https://zuul-ci.org/docs/zuul/latest/vulnerabilities.html
Code reviews are handled by gerrit at https://review.opendev.org
After creating a Gerrit account, use git review to submit patches. Example:
# Do your commits $ git review # Enter your username if prompted
Join us on Matrix to discuss development or usage.
AI-Generated Content
In general, please do not submit AI generated content to the Zuul project, but some exceptions apply.
The OpenInfra foundation has created a policy for AI Generated content at https://openinfra.org/legal/ai-policy which provides useful background to the Zuul project’s policy, but the Zuul project policy differs somewhat.
As a free software project, we are concerned with the copyright ownership of the project’s source code. Because most commercially available LLMs are not able to indicate whether their output may include training data incompatible with Zuul’s licences, accepting substantial contributions generated by them increases the risk to the project. And because LLM-generated output is not considered copyrightable in the United States and other regions, that further increases the risk to the project.
In many cases, the code and documentation output from LLMs is not of sufficient quality for easy incorporation into Zuul. A community of contributors and reviewers with deep understanding of the project is healthier in the long run. Contributions generated by LLMs without that understanding creates more work for the maintainers.
Nevertheless, if you use an LLM to create a very small patch (one that would likely not be subject to copyright protection even if generated by a human), that’s fine, but you must annotate it with the Assisted-By or Generated-By labels.
In short:
Please do not submit substantial AI-generated content (code or docs)
Very small/limited use may be okay if it’s not copyrightable
Make sure you fully understand the code or docs you are changing
If you don’t, engage with humans in the Zuul community
Any AI-Generated content must have Assisted-By or Generated-By labels
License
Zuul is free software. Most of Zuul is licensed under the Apache License, version 2.0. Some parts of Zuul are licensed under the General Public License, version 3.0. Please see the license headers at the tops of individual source files.
Python Version Support
Zuul requires Python 3. It does not support Python 2.
Since Zuul uses Ansible to drive CI jobs, Zuul can run tests anywhere Ansible can, including Python 2 environments.
3 maintainers
Release files for zuul 14.3.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| zuul-14.3.0.tar.gz | 10.9 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| zuul-14.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 17.9 MB
Release files / zuul-14.3.0.tar.gz
| Download URL | zuul-14.3.0.tar.gz |
|---|---|
| Size | 10.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ec0f4d7a5699dac543e4f63c3728d34d13e1bb30be126aa787b3a8e69cf8ef0
|
|
BLAKE2b-256 checksum How to use checksums |
8dbb8ec6d708d48bbe05f74e6072fd5797de4e6c9cde13853f006e79cbd0164c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / zuul-14.3.0-py3-none-any.whl
| Download URL | zuul-14.3.0-py3-none-any.whl |
|---|---|
| Size | 7.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54b8cfcf397ce7324a87b3c0cfea5a8fcd0f430082ba6be25f9e62326d9949e2
|
|
BLAKE2b-256 checksum How to use checksums |
38879dded2847d4ea1506c1f62808440ad9f97992f7da3511e7ca3f6914c3fdc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
