aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.rst7
-rw-r--r--docs/hacking.rst20
2 files changed, 24 insertions, 3 deletions
diff --git a/README.rst b/README.rst
index 27af669..4901eeb 100644
--- a/README.rst
+++ b/README.rst
@@ -15,11 +15,12 @@ Dependencies
------------
PyAPD requires the following dependencies and targets their versions as
-available in Debian buster.
+available in Debian buster. Known minimum versions are listed
+explicitely.
-* `Python3 <https://www.python.org/>`
+* `Python3 <https://www.python.org/>` >= 3.7
* `Tornado <https://www.tornadoweb.org>`_
-* `ruamel.yaml <https://bitbucket.org/ruamel/yaml>`_
+* `ruamel.yaml <https://bitbucket.org/ruamel/yaml>`_ >= 0.15
License
=======
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