aboutsummaryrefslogtreecommitdiffstats
path: root/doc/source/installation.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/installation.rst')
-rw-r--r--doc/source/installation.rst49
1 files changed, 49 insertions, 0 deletions
diff --git a/doc/source/installation.rst b/doc/source/installation.rst
new file mode 100644
index 0000000..42b1e4e
--- /dev/null
+++ b/doc/source/installation.rst
@@ -0,0 +1,49 @@
+
+Installation
+============
+
+Installation
+------------
+
+Install *bsie* via pip::
+
+ pip install --extra-index-url https://pip.bsfs.io bsie
+
+This installs the `bsie` python package as well as the `bsie.app` command.
+It is recommended to install *bsie* in a virtual environment (via `virtualenv`).
+
+
+License
+-------
+
+This project is released under the terms of the 3-clause BSD License.
+By downloading or using the application you agree to the license's terms and conditions.
+
+.. literalinclude:: ../../LICENSE
+
+
+Source
+------
+
+Check out our git repository::
+
+ git clone https://git.bsfs.io/bsie.git
+
+You can further install *bsie* via the ususal `setuptools <https://setuptools.pypa.io/en/latest/index.html>`_ commands from your bsie source directory::
+
+ python setup.py develop
+
+For development, you also need to install some additional dependencies::
+
+ # extra packages for tests
+ pip install rdflib requests
+
+ # code style discipline
+ pip install mypy coverage pylint
+
+ # documentation
+ pip install sphinx sphinx-copybutton furo
+
+ # packaging
+ pip install build
+