Development

Get Started!

Ready to contribute? Here’s how to set up lab_automation for local development.

  1. Clone the lab_automation repo from GitLab:

    $ git clone git@gitlab.com:https://gitlab.com/opensourcelab/openlab-site/lab-automation.git

  2. Ensure poetry is installed.

  3. Install dependencies and start your virtualenv:

    $ poetry install
$ poetry shell

  4. Create a branch for local development:

    $ git checkout -b feature/IssueNumber_name-of-your-bugfix-or-feature

# please do not use the '#' in branch names !

Now you can make your changes locally.

  1. When you’re done making changes, check that your changes pass the tests, including testing other Python versions, with tox:

    $ tox

  2. Commit your changes and push your branch to GitLab:

    $ git add .
$ git commit -m "Your detailed description of your changes."
$ git push origin feature/IssueNumber_name-of-your-bugfix-or-feature

  3. Submit a merge request through GitLab

Merge Request Guidelines

Before you submit a merge request, check that it meets these guidelines:

  1. The merge request should only include changes relating to one ticket.

  2. The merge request should include tests to cover any added changes and check that all existing and new tests pass.

  3. If the merge request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.rst.

  4. The team should be informed of any impactful changes.

Documentation

The Sphinx Documentation Sytem is used,

markdown is supported via the mystparser ( https://cerodell.github.io/sphinx-quickstart-guide/build/html/markdown.html )

To build the documentation, run

$ invoke docs

Tips

  1. To run a subset of tests:

    $ pytest tests.test_lab_automation

Deploying to PyPI

For every release:

  1. Update HISTORY.rst

  2. Update version number (can also be patch or major):

    bump2version minor

  3. Run the static analysis and tests:

    tox

  4. Commit the changes:

    git add HISTORY.rst
git commit -m "Changelog for upcoming release <#.#.#>"

  5. Push the commit:

    git push

  6. Add the release tag (version) on GitLab: https://gitlab.com/https://gitlab.com/opensourcelab/openlab-site/lab-automation/-/tags

The GitLab CI pipeline will then deploy to PyPI if tests pass.