ImJoy Utils

Utility module for ImJoy in Python

Development

• Install and set up development environment.

  pip install -r requirements_dev.txt

  This will install all requirements. It will also install this package in development mode, so that code changes are applied immediately without reinstall necessary.

• Here's a list of development tools we use.

  • black
  • flake8
  • mypy
  • pydocstyle
  • pylint
  • pytest
  • tox

• It's recommended to use the corresponding code formatter and linters also in your code editor to get instant feedback. A popular editor that can do this is vscode.

• Run all tests, check formatting and linting.

  tox

• Run a single tox environment.

  tox -e lint

• Reinstall all tox environments.

  tox -r

• Run pytest and all tests.

  pytest

• Run pytest and calculate coverage for the package.

  pytest --cov-report term-missing --cov=imjoy_utils

• Continuous integration is by default supported via GitHub actions. GitHub actions is free for public repositories and comes with 2000 free Ubuntu build minutes per month for private repositories.