Development & Ops

Note

This is mostly used as a reference for the core project team.

Working with Wilfred locally

Make sure you have pipenv installed and that you have cloned the repository to your computer (perhaps created a fork).

At the root of the project, enter the shell for the development environment.

pipenv shell

This will create the environment. Then you need to install the dependencies.

pipenv install
pipenv install --dev

Instead of using wilfred <command> to run Wilfred, you can use the built-in run script.

./run.py <command>

In this way, you can develop and see your changes instantly.

Publishing a release

Update the version in wilfred/version.py, snap/snapcraft.yml and docs/source/conf.py accordingly.

Set the version name and release status of this release in CHANGELOG.md to released on YYYY-MM-DD.

Commit the changes.

Tag the release on GitHub. Include all the changes from CHANGELOG.md in the release notes (you can use a previous release as reference).

Travis should automatically build and release the PyPI package, and snapcraft should also build and release the snap package automatically.

After the snap build has finished, go to the Snap listing and push the edge channel to stable or beta depending on the type of release.

Revert the changes in wilfred/version.py and snap/snapcraft.yml and commit the changes (should therefore not be included in the release).

Windows

You have to install pypiwin32 to develop on Windows.

pipenv shell
pip install pypiwin32

This is not ideal, but due to a bug in Pipenv we cannot put the pypiwin32 package as a platform specific dependency in the Pipfile.

Versioning convention

Wilfred releases should use the semantic versioning convention (i.e. MAJOR.MINOR.PATCH).