Skip to content

CONTRIBUTION.rst

Latest commit

 

History

History
120 lines (77 loc) · 4.59 KB

CONTRIBUTION.rst

File metadata and controls

120 lines (77 loc) · 4.59 KB

Contribution Guideline

Welcome to the contribution guideline page!

Setting up the environment

Installing uv

This project uses uv as a package manager. To install uv, simply run:

$ curl -LsSf https://astral.sh/uv/install.sh | sh

Fork the project and clone the repo

$ git clone https://github.com/<your-username>/pylero.git

You can add upstream as a remote repo and origin as your fork repo

Installing dependencies

Create a virtual environment and install all dependencies:

$ uv venv
$ uv pip install -e .
$ uv pip install pre-commit ruff

Setting up configuration file

You will need to setup config values, for that you need to get some values from Polarion and provide it to the config file. For more detail, check out project's README.md

Installing pre-commit

pre-commit is a multi-language package manager for pre-commit hooks. It is used to check code before it makes it to commit. A list of hooks is specified in .pre-commit-config.yaml in the root directory of the project.

$ pre-commit install

Before you commit

In order to ensure you are able to pass the GitHub CI build, it is recommended that you run the following commands in the base of your pylero directory:

$ pre-commit run -a

Pre-commit will ensure that the changes you made are not in violation of PEP8 standards and automatically apply ruff fixes.

You can also run ruff directly to fix any issues:

$ ruff check --fix .
$ ruff format .

Install the project with uv

Pylero supports command line interface. Simply run pylero on your terminal, it will prompt to the command line interface. However, before you can do that you will have to install the project by running:

$ uv pip install -e .

in your project root directory. With that, you're ready to submit your first contribution.

How to contribute to Pylero

There are many ways to contribute to Pylero. You can start from reporting issues, raising discussion, submitting bug fixes, adding new features, or updating the documentation. You can also browse through list of issues and look for any issues with the label of good first issue or help wanted.

Create an issue

To report any bug, please open a new issue here. Remember to provide as much detail as you can including running environment, version of Pylero or snippet of the code.

Create a discussion topic

In addition, you can create a discussion topic. It can be general topics, new ideas, polls, Q&As or awareness raising.

Adding new feature/bug fix

Before adding new feature, it's recommended to create a discussion topic first. Then you can create a pull request for your new feature linked to the discussion topic. That way it is easier for the maintainer to track what the change is about.

New proposed features must be conform to coding style/standard (passing pre-commit checks) and must include at least unit tests. You should create a pull request from your fork against an upstream project. A pull request must be properly rebased from upstream main branch, include a precise commit messages, and a brief description.

If you're pushing a bug fix, please link it to the issue related.

Note: The project uses GitHub action to run the CI/CD, you should be able to check whether the CI passes or fails. Then, you can wait for code reviews from maintainers or fix any errors that do not pass in the pipeline.

Update documentation

The other way to contribute to the project is to look for any outdated documentation and submit an update version to reflect the current status. New added features should also include documentation and a brief how-to.