aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorBonfaceKilz2021-02-15 13:05:52 +0300
committerBonfaceKilz2021-02-15 13:06:15 +0300
commite03afe162589e07979c30aede3735bf4fc9b9f87 (patch)
treef0a2ced5066dddd68956583eeb43860062d08e0d /README.md
parent540ac7a3dba2c0430ffa0bcc5dc16c70774c97ac (diff)
downloadgenenetwork3-e03afe162589e07979c30aede3735bf4fc9b9f87.tar.gz
Update README with bootstrap instructions and how to run tests
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 48 insertions, 0 deletions
diff --git a/README.md b/README.md
index 04b8140..14b6a36 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,50 @@
# genenetwork3
GeneNetwork3 REST API for data science and machine learning
+
+## Installation
+
+##### Using python-pip
+
+1. Prepare your system. You need to make you have python > 3.8, and
+ the ability to install modules.
+2. Create and enter your virtualenv:
+
+```bash
+virtualenv --python python3 venv
+. venv/bin/activate
+```
+3. Install the required packages
+
+```bash
+pip install -r requirements.txt
+```
+
+#### Using guix
+
+Simply load up the environment (for development purposes):
+
+```bash
+guix environment --load=guix.scm
+```
+
+#### Running Tests
+
+(assuming you are in a guix container; otherwise use venv!)
+
+To run tests:
+
+```bash
+python -m unittest discover -v
+```
+
+Running pylint:
+
+```bash
+pylint *py tests gn3
+```
+
+Running mypy(type-checker):
+
+```bash
+mypy .
+```