Skip to content

Latest commit

 

History

History
41 lines (28 loc) · 1.11 KB

devguide.md

File metadata and controls

41 lines (28 loc) · 1.11 KB

Developer's guide

Contributing to TextCL is easy. First, clone this repository and cd into the project's folder:

git clone https://github.com/alinapetukhova/textcl.git
cd textcl

Then create a virtual development environment to test and experiment with the package:

python3 -m venv env
source env/bin/activate
pip install -e .

The pytest, pytest-cov and pdoc3 packages are required for testing TextCL and generating its documentation:

pip install pytest pytest-cov pdoc3

Running the unit tests can be done with the following command from the project's root folder:

pytest

To check test coverage, execute the following command:

pytest --cov=textcl --cov-report=html

Project documentation can be generated with pdoc3. For example, running the following command in the project's root folder generates the HTML documentation and places it in the docs folder:

pdoc3 --html --output-dir docs textcl/