Add README.md

Closes #13

README.md

@@ -0,0 +1,75 @@
+# Kontr Pushee
+
+Tool that uploads Kontr submissions to gitlab repo and creates MRs so it's easier to review.
+
+## Usage
+
+```
+pushee <command>
+
+Commands:
+        mrs                     Fetch files and create merge requests for them
+        update-assignees        Update assignees on MRs
+        comments                Fetch all comments on MRs
+        merge                   Merge all MRs
+        test                    Debugging function
+```
+
+## Dependencies
+
+-  [`ogr`](https://github.com/packit-service/ogr)
+-  `requests`
+
+## Configuration
+
+Uses config from `~/.pushee.json` and `GITLAB_TOKEN` from environment variables (used for accessing Gitlab's API).
+
+### Example config
+
+```json
+{
+    "project_namespace": "xfocko",
+    "project_name": "2020-pb071-reviews",
+    "reviewer": "xfocko",
+    "homework": "hw04",
+    "homeworks": {
+        "hw03": {
+            "deadline": "2020_0426_020000",
+            "submissions": [
+                "xlogin_YYYY_MMDD_HHMMSS"
+            ],
+            "correction": false,
+            "files": [
+                "cpu.h",
+                "cpu.c"
+            ]
+        },
+        "hw04": {
+            "deadline": "2020_0507_235959",
+            "mbox_path": "~/hw04.mbox",
+            "correction": false,
+            "files": [
+                "main.c"
+            ],
+            "prefix": "master-nanecisto/naostro"
+        }
+    }
+}
+```
+
+### Description
+
+-  `project_namespace` - specifies project namespace (username) where are files uploaded and MRs created
+-  `project_name` - project name
+-  `reviewer` - login of reviewer, allows filtering out mails for colleagues
+-  `homework` - specifies which homework is being processed
+-  homework format (element of `homeworks`):
+   -  `deadline` - deadline of homework formatted the same way as submissions from Kontr
+   -  submissions to review (*one* of):
+      -  `submissions` - list of submissions to be reviewed
+      -  `mbox_path` - path to exported mails in mbox format
+      mails are parsed, submissions after deadline are ignored, chooses submission with highest points achieved
+      also leaves spaces for correction if needed
+   -  `correction` - used for IB111, deadline specifies "timestamp" of submitting review to IS, from that date is calculated deadline of corrected homework
+   -  `files` - list of files that are reviewed
+   -  `prefix` - path from submission directory to the directory that *always* contains source files