aswfdocker 0.3.4

ASWF Docker Utilities

ASWF Python Utilities

The aswfdocker command line tool is available to help with package and image builds.

Installation

For users:

git clone https://github.com/AcademySoftwareFoundation/aswf-docker
cd aswf-docker
python3 setup.py install

For developers:

First install pipenv for Python 3: pip3 install pipenv. Then:

git clone https://github.com/AcademySoftwareFoundation/aswf-docker
cd aswf-docker
pipenv shell
pipenv install --dev

You should now be in a python virtualenv shell where the aswfdocker command is available.

Finally

You should check the command is working:

aswfdocker --help

Usage

List packages and images

List all known packages:

aswfdocker packages

List all known images:

aswfdocker images

Development

Process

Once in the pipenv shell you should first install the pre-commit hooks by running pre-commit install The pre-commit hooks will run the following commands, which can be run individually as well:

• run black on the code to ensure formatting is OK: black python
• run the tests to ensure everything is OK: pytest python/aswfdocker
• run mypy to ensure static types are OK: mypy python/aswfdocker
• run prospector on the code to ensure linting is OK: prospector -F python/aswfdocker

To run them all manually use pre-commit run --all-files.

Adding new pip dependencies

• Run pipenv install xyz
• Run pipenv-setup sync to update setup.py with added dependency (pipenv-setup is a "dev" dependency already declared in PipFile)