Thank you for helping twtxt to get a better piece of software.
If you have any questions regarding the usage of twtxt please visit us in the #twtxt IRC channel on freenode.net or post your question on StackOverflow.
Before you submit an Issue or proposing a Feature check the existing Issues in order to avoid duplicates.
Please make sure you provide enough information to work on your submitted Issue or proposed Feature:
- Which version of twtxt are you using?
- Which version of Python are you using?
- On which platform are you running twtxt?
We are very happy to receive Pull Requests! Please consider:
- Style Guide. Follow the rules of PEP8, but you may ignore too-long-lines and similar warnings.
- Tests. If our change affects Python code inside the source code directory, please make sure your code is covered by an automated test case.
- Documentation. If your change updates any interfaces, adds new features or change behavior please make sure the documentation is updated accordingly.
You need to make sure tox and pytest are installed in you testing environment:
pyhon3 -m pip install tox pytestTo test the twtxt source code against all supported Python versions you should use make test:
cd ~/work/twtxt
make testHowever, if you want to test your code manually in a certain environment use virtualenv:
cd ~/work/twtxt
virtualenv env -p python3.4
source env/bin/activate
python -m pip install --editable .
make pytest
The documentation can be generated using the docs rule in make:
make docsThe build directory of the documentation is located in docs/_build/html. To open this documentation just open the index.html with your preferred browser:
open docs/_build/html/index.html