Initial structure

Author: george.k

.gitignore

@@ -0,0 +1,116 @@
+.venv/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/

Procfile

@@ -0,0 +1 @@
+web: gunicorn --worker-class eventlet -w 1 manpage-bot:app

README README.md

@@ -0,0 +1,11 @@
+#! /usr/bin/env python3.7
+import os
+
+from flask import Flask
+
+app = Flask(__name__)
+app.config["SECRET_KEY"] = os.environ.get("FLASK_SECRET_KEY", "development secret key")
+app.config["DEBUG"] = True
+app.debug = True
+
+from . import views

manpage-bot/__init__.py

@@ -0,0 +1,59 @@
+#! /usr/bin/env python3.7
+import re
+import json
+import functools
+
+from flask import request
+
+from . import app
+
+
+def get_js(**kwargs):
+    js = request.get_json(**kwargs)
+    if js is None:
+        raise TypeError("empty payload")
+    if not isinstance(js, dict):
+        js = json.loads(js)     # wtf tbh?
+    return js
+
+def json_endpoint(view_fn):
+    """ Dumps the return value of a view function to JSON.
+    """
+    @functools.wraps(view_fn)
+    def wrapper(*args, **kwargs):
+        rv = view_fn(*args, **kwargs)
+        if not isinstance(rv, tuple):
+            errno = 200
+        else:
+            assert len(rv) == 2, "Invalid request return format."
+            rv, errno = rv
+
+        if errno < 200 or errno > 299:
+            if isinstance(rv, str):
+                rv = { "error": rv }
+            elif "error" not in rv:
+                rv["error"] = "An error occurred."
+
+        if not isinstance(rv, str): rv = json.dumps(rv)
+        return rv, errno
+
+    return wrapper
+
+
+@app.route("/api/v1/manpage", methods=["GET"])
+@json_endpoint
+def get_manpage():
+    """ Responds to an `app_mention` event from Slack.
+
+        {
+            "type": "app_mention",
+            "user": "U061F7AUR",
+            "text": "<@U0LAN0Z89> is it everything a river should be?",
+            "ts": "1515449522.000016",
+            "channel": "C0LAN2Q65",
+            "event_ts": "1515449522000016"
+        }
+    """
+    js = get_js()
+    print(js)
+    return "{}"

manpage-bot/views.py

@@ -0,0 +1,12 @@
+Click==7.0
+dnspython==1.15.0
+eventlet==0.24.1
+Flask==1.0.2
+greenlet==0.4.15
+gunicorn==19.9.0
+itsdangerous==1.1.0
+Jinja2==2.10
+MarkupSafe==1.1.0
+monotonic==1.5
+six==1.11.0
+Werkzeug==0.14.1