Development

$ make run-debug-server

Docker

Simple example:

$ docker run -ti --name=jskom --net=host osks/jskom

More complete:

$ docker run -d --name=jskom --net=host --restart=always \
    -v /path/to/my-httpkom-config.cfg:/httpkom.cfg \
    -v /path/to/my-jskom-config.cfg:/jskom.cfg \
    osks/jskom:dev

Building a dev docker image

docker build -f Dockerfile.dev -t osks/jskom:dev --no-cache .
docker login  # username and access token for password
docker push osks/jskom:dev

Preparing a release

On master:

1. Update and check CHANGELOG.md.

2. Increment version number and remove +dev suffix IN BOTH setup.py AND jskom/version.py!

3. Test manually by using jskom.

4. Commit, push.

5. Tag (annotated) with v<version> (example: v0.1) and push the tag:

   git tag -a v0.1 -m "Version 0.1"
   git push origin v0.1

6. Build PyPI dist: make dist

7. Push to Test PyPI: twine upload --repository testpypi dist/* and check https://test.pypi.org/project/jskom/ .

8. Push to PyPI: twine upload dist/* and check https://pypi.org/project/jskom/ .

9. Add +dev suffix to version number, commit and push.

10. Github release: Go to https://github.com/osks/jskom/releases and draft a new release. Select tag and set title to “Version <version>”, and then publish the release.

11. Docker image:

    docker build -f Dockerfile -t osks/jskom:v<version> --no-cache .
    docker login  # username and access token for password
    docker push osks/jskom:v<version>

Tools

Install and update release tools with:

pip install --upgrade setuptools wheel pip twine

Twine is used for pushing the built dist to PyPI. The examples in the release process depends on a .pypirc file with config for the pypi and testpypi repositories.

Example of .pypirc:

[pypi]
username = __token__
password = pypi-...

[testpypi]
repository = https://test.pypi.org/legacy/
username = __token__
password = pypi-...