Note: This is a public repo
Thunderstorm library is a package for keeping functionality which is useful across multiple Thunderstorm Services in one convenient location. If you have some functionality that you feel would be useful to other users of the library or wish to submit suggestions for improvement please feel free to submit a pull request.
This document provides instructions for installation and basic usage.
Install this library from a tarball on Github.
> pip install https://github.com/artsalliancemedia/thunderstorm-library/releases/download/vX.Y.Z/thunderstorm-library-X.Y.Z.tar.gz
> pip install thunderstorm-library
At present the library provides some basic functions although the library will expand to cover areas such as messaging in future releases.
First you will need to pick a service to develop against.
If, for example, you are working on the complex-service
, first clone this
repo as a subdirectory of that project.
Next, modify the installation of the thunderstorm library. The complex-service
has a line in its Dockerfile
installing the auth library from a tarball. Change
this line to the following two lines:
COPY thunderstorm-library /var/app/thunderstorm-library
RUN pip install -e file:/var/app/thunderstorm-library
At present the library needs to support python versions 3.4, 3.5 and 3.6. The docker-compose file in this repo has individual services for each python version. e.g. to run unit tests for python 3.6:
> docker-compose run --rm python36 make test
New releases can be easily created using github-release.
Increment the version number in thunderstorm/__init__.py
,
and ensure you have a valid github token and run the following command (replacing
your github token with {github token}
).
> GITHUB_TOKEN={github token} release