41 lines
1 KiB
ReStructuredText
41 lines
1 KiB
ReStructuredText
Beancount plugin and tools for Conservancy's books
|
|
==================================================
|
|
|
|
Installation
|
|
------------
|
|
|
|
``cd`` to this directory with your checkout and then run::
|
|
|
|
python3 -m pip install --user --upgrade .
|
|
|
|
Of course, if you're familiar with Python development tools, you're welcome to install the module in a virtualenv, somewhere else, etc.
|
|
|
|
Running all tests
|
|
-----------------
|
|
|
|
The project comes with a Tox configuration that defines all the tests we expect to pass, across all the different environments we support. To run them all, run::
|
|
|
|
tox
|
|
|
|
The next sections describe how to run them standalone in your own development environment, for faster iteration or simpler isolation of problems.
|
|
|
|
Running unit tests
|
|
------------------
|
|
|
|
Run::
|
|
|
|
pytest
|
|
|
|
Type checking
|
|
-------------
|
|
|
|
Most of the code is typed, except for very dynamic loader methods. To run the type checker::
|
|
|
|
mypy conservancy_beancount
|
|
|
|
This is expected to pass just like the unit tests.
|
|
|
|
Legal
|
|
-----
|
|
|
|
Refer to ``LICENSE.txt`` for details.
|