aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2019-04-15 10:00:20 +0200
committerElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2019-04-15 10:00:20 +0200
commit94baa0b3c43954204dd6c2049b36fb7523e6c844 (patch)
tree6c9250f27e35611df5dc9fcac5a8dbd7b8b30edf /docs
parent615c439ad45eee9eb709200e3727d1d6eacaecfe (diff)
Document developement procedures
Diffstat (limited to 'docs')
-rw-r--r--docs/hacking.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/docs/hacking.rst b/docs/hacking.rst
new file mode 100644
index 0000000..ab51c71
--- /dev/null
+++ b/docs/hacking.rst
@@ -0,0 +1,20 @@
+#########
+ Hacking
+#########
+
+The current developement platfor for ``pyapd`` is debian buster with the
+following dependencies::
+
+ apt install python3-tornado python3-ruamel.yaml
+
+on other platforms you will need to install the same packages in an
+appropriate version (see `the README <../README.rst>`_ for details).
+
+``pyapd`` can be run in place for development: just run
+``./pyactivitypubd`` to run a local instance that will listen on
+http://localhost:8888 using the configuration in ``pyapd_config.yaml``.
+
+All tests and QA tools can be run using the script ``./run_tests`` which
+requires the following further dependencies::
+
+ apt install mypy python3-nose2 python3-coverage flake8