Welcome to pkgdev’s documentation!¶
pkgdev
is collection of tools for Gentoo development, from generating
commit messages, to pushing commits to the repository, to filing stable
requests bugs, to testing packages in a special environment.
Contents:
- pkgdev
- pkgdev bugs - Automatic bugs filer
- pkgdev commit - create git commit
- pkgdev manifest - update package manifests
- pkgdev mask - mask packages
- pkgdev push - run QA checks on commits and push them
- pkgdev showkw - show package keywords
- pkgdev tatt - package testing tool
- Config file support
- Release Notes
Indices and tables¶
Contributing to pkgdev¶
Thank you for considering contributing to pkgdev
! We appreciate your time and
effort in helping us improve our project. This document outlines the guidelines
and steps for contributing to our project.
Code of Conduct¶
We expect all contributors to follow Gentoo’s Code of Conduct. Please make sure to read and understand it before contributing.
How Can I Contribute?¶
There are several ways you can contribute to pkgdev
:
Reporting bugs
Suggesting enhancements
Writing code patches
Improving documentation
Providing feedback
Reporting Bugs¶
If you encounter any bugs or issues while using pkgdev
, please report them
by following these steps:
Check if the bug has already been reported by searching our issue tracker.
If the bug hasn’t been reported, open a new issue and provide a clear and detailed description of the problem.
Include any relevant information, such as error messages, screenshots, or steps to reproduce the issue.
Assign appropriate labels to the issue (e.g., bug, tool/tatt) and provide any additional context that might be helpful.
Suggesting Enhancements¶
If you have ideas for new features or improvements to pkgdev
, we would love
to hear them! To suggest an enhancement, please follow these steps:
Check if the enhancement has already been suggested by searching our issue tracker.
If the enhancement hasn’t been suggested, open a new issue and provide a clear and detailed description of your idea.
Explain why you think the enhancement would be valuable and how it aligns with the project’s goals.
Assign appropriate labels to the issue (e.g., enhancement, tool/bugs) and provide any additional context that might be helpful.
Pull Requests¶
We welcome pull requests from contributors. To submit a pull request, please follow these steps:
Fork the repository and create a new branch for your changes.
Make your changes and ensure that the code passes all tests.
Write clear and concise commit messages that describe your changes.
Sign-off your commits, for example using the command
git commit -s
. Must confirm to GLEP-76.Submit a pull request, explaining the purpose and benefits of your changes.
Be responsive to any feedback or questions during the review process.
Styleguides¶
When contributing to pkgdev
, please adhere to the following styleguides:
Code formatting is done using black. You can run
make format
for it to auto format your filesWhile not a hard requirement in all cases, we do want to have a healthy coverage of branches and flows. Attempt to write unit tests.
Vulnerabilities reports¶
In case you have found a vulnerability in pkgdev
’s code, feel free to open
an issue with as detailed explanation as possible. We believe in reporting as
fast as possible to our user base, so a vulnerability report should start as
public, even if no fix is ready, in which case we would also report it in extra
channels (i.e. IRC channel and gentoo-dev mailing list).