We welcome any contribution to our open source projects. If you want to participate in our work, make sure to read our software development principles before you start.

Issue Reporting

In case you encounter an issue feel free to let us know about it on GitHub.

Development Environment

You can manage the development environment of pyorbs with pyorbs itself. If you already have pyorbs installed you can simply execute orb -m pyorbs within the project folder, after which you can execute orb pyorbs and pip install -e . to install the orb command inside the pyorbs orb. This allows you to develop and test the orb command itself while the pyorbs orb is active.


Make sure to test pyorbs on all supported shells that are listed in the Features section of the documentation (for this you will need to install all of these shells on your system).

Creating Releases

You can make a new release as follows:

  1. Make sure the changelog is properly updated.

  2. Create a pull request and ask for review.

  3. Once the pull request has been approved, increase the version number using bump2version.

  4. Merge the pull request.

  5. Create a new distribution and upload it to

    $ make dist
    $ twine upload --repository-url dist/*
  6. Check if your distribution works properly:

    $ pip3 install --user --upgrade --index-url pyorbs
    $ orb -v
  7. Finally, upload the new distribution to PyPI:

    $ twine upload dist/*

Once the new version has been uploaded, Webrepublic’s Concourse cluster will take care of all further deployment steps, such as building and publishing the documentation or updating the various Docker base images.


This package is maintained by the Webrepublic Data & Technology department.