ci_exec.parsers¶
argparse
derivatives tailored to specific build systems.
If you would like to contribute a generic parser for a build system, the pull request shall add the following:
Add file
ci_exec/parsers/{build_system}_parser.py
with the implementation.Add file
tests/parsers/{build_system}_parser.py
with the tests.Add a top-level import to
ci_exec/parsers/__init__.py
(keep alphabetical).Update the top-level imports for
parsers
inci_exec/__init__.py
.Add
docs/source/api/parsers/{build_system}.rst
and update thetoctree
directive indocs/source/api/parsers.rst
(keep alphabetical).
When contributing a custom parser, please do your best to make it as generic as possible to support as wide an audience as is reasonably possible. If “arbitrary” decisions need to be made, please document them clearly and allow them to be overriden.
Lastly, by contributing a build system parser, you agree to being CC’d via a GitHub
@
mention for any issues that may arise with the parser. In other words, please
help me maintain the new parser being added 🙂