aboutsummaryrefslogtreecommitdiff
path: root/docs/hacking.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/hacking.rst')
-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