Development Information

You can install all tools needed for developing the package by using the dev extra:

python-scsi $ pip install -e .[dev]

This will include test and verification tools, as well as all the necessary packages to build a new release.

pre-commit

This repository uses pre-commit to maintain a consistent codebase. The tool is installed as part of the dev extra.

To activate the pre-commit hooks, you should use:

python-scsi $ pre-commit install

which will set up the hooks for the current repository.

The tests directory contain unit tests for python-scsi.

To run the tests:

python-scsi $ pip install -e .[dev]
python-scsi $ pytest --mypy

or use the make file:

$ cd tests
$ make

Travis CI is set up to run integration tests for the repository. The configuration is in the .travis.yml file.

Travis will execute the whole testsuite (unittests and typechecking) on the master branch as well as on each Pull Request.

Setuptools is used to create the released packages:

python-scsi $ git clean -fxd
python-scsi $ python3 setup.py sdist

The repository follows a (mostly) standard layout for Python repositories:

.gitignore is part of the repository configuration and is set to ignore generated files from Python testing and usage.
.pre-commit-config.yaml contains the configuration for pre-commit and its hooks.
.travis.yml configures the continuous integration used to validate pull requests.
mypy.ini contains configuration for mypy.
setup.py and setup.cfg contain configuration for setuptools.
pyproject.toml contains PEP 518 configuration for various tools.
pyscsi contains the source code of the module that is actually installed by pip.
tools and examples contain Python entrypoints showing usage of the library.
tests contains the unittest to validate the correctness of the library.