41 lines
1.2 KiB
ReStructuredText
41 lines
1.2 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::
|
|
|
|
./setup.py test
|
|
|
|
Type checking
|
|
-------------
|
|
|
|
Most of the code is typed, except for very dynamic loader methods. To run the type checker::
|
|
|
|
./setup.py typecheck
|
|
|
|
This is expected to pass just like the unit tests.
|
|
|
|
Legal
|
|
-----
|
|
|
|
Copyright © 2020 Brett Smith and others. Licensed under the GNU Affero General Public License, either version 3 of the License, or (at your option) any later version; with an additional permission. Refer to ``LICENSE.txt`` for details.
|