Contributing¶
Cardsource should work and is tested on Python 2.6+, 3.3+ and pypy. Pull requests are welcomed on GitHub, but major changes should probably be discussed before simply sending a huge patch.
Semantic versioning¶
Cardsource uses semantic versioning which means that it declares a public API and acts reasonably with respect to version numbers. However, since cardsource has a major version of zero (0.y.x) the public API should not be considered entirely stable. Backward incompatible changes are not introduced lightly and will be documented in depth in the changelog.
Unit testing¶
All patches that add features or fix bugs should come with unit tests. Unit tests are run automatically as part of continuous integration and can be run manually with:
% python setup.py test
If tox is installed, unit tests for all supported Python versions can be
run with the following command. See .tox.ini
for details.
% tox