Contributing#

Thank you for your interest in contributing to conda auth! This is a short guide that will walk you through all the steps necessary to contribute code to the project.

Finding an issue to work on#

Finding an open issue to work on is the most important part when contributing. To see what’s currently available, head over to the GitHub issues queue.

If you have any questions about any open issues, please feel free to reach out to the maintainers via our Element chat room.

Tip

Please be sure that the issue is open before working on it. If you would like to work on it, ask in the comments or ping the conda-auth maintainers on Element.

Setting up your development environment#

Prerequisites#

Before setting up your development environment, make sure pixi is installed. If pixi is not already installed on your computer, please visit their installation guide. Also, make sure to create a fork of the repository in GitHub and clone the forked repository to your local computer.

Creating the development environment#

To set up your development environment, follow these steps:

Set up and activate the development environment with these commands:
```
pixi install
pixi run develop
```
Next, you will want to start a new shell with the following command:
```
pixi shell
```
To verify the installation, run the conda command with no arguments and make sure auth shows up under the list of available commands.

Once this has been done, you should be ready to start make changes to the conda-auth plugin and experimenting with it on your computer.

Running tests#

To run the test for conda-auth, run the following command:

pixi run --environment dev test

Or, to generate an HTML coverage report, run with the following command:

pixi run --environment dev testhtml

If you want to run tests for different supported Python versions, you can do so by specifying them via the --environment option:

# For Python 3.10
pixi run --environment dev-py310 test

# For Python 3.14
pixi run --environment dev-py314 test

Submitting a pull request#

Once you are ready to submit your code for review, submit a pull request via GitHub. Please be sure to link it to the open issue you are working on.