Add tasks service example

Author: rilian

.gitignore

@@ -0,0 +1,14 @@
+.DS_Store
+.tmp
+*.log
+*.zip
+*.rej
+.idea
+*.swp
+
+node_modules
+.serverless
+.env*
+.aws-credentials.*
+.cloudfrontSignerPrivateKey.*
+!*.example

README.md

@@ -0,0 +1,49 @@
+# Fastapi Graphql Postgres Example tasks service
+
+## Required software
+
+Follow `pyenv` setup instructions in https://github.com/pyenv/pyenv
+
+Install Python `3.9.7`
+
+Install `pipenv` for package management
+
+    python3.9 -m pip install --user pipenv --upgrade pip
+
+Finally install required packages for service
+
+    pipenv install -d
+
+
+## Run service locally
+
+You can use `Postgres.app` to run PostgreSQL locally. You can dump and import project database from test environment
+
+Launch Postgres db and ensure there is data in tables
+
+    pipenv run uvicorn main:app --reload
+
+Refer to api-doc.md regarding available endpoints
+
+    curl -X POST http://0.0.0.0:8000/...
+
+## Development
+
+Add new Python packages with
+
+    pipenv install xxx
+
+Add development-only package, for example for testing, with
+
+    pipenv install xxx --dev
+
+After experimenting (with new packages) run `pipenv clean` to remove unused packages
+
+### Lint code
+
+    - pipenv run mypy -config-file=mypy.ini .
+    - pipenv run flake8 --append-config=.flake8 .
+
+## Testing
+
+Use Graphql Playground or CURL

app/.env.example

@@ -0,0 +1,5 @@
+# necessary for deploy
+STAGE=example
+
+# necessary for service
+DB_STR='postgresql://xxx'

app/.flake8

@@ -0,0 +1,5 @@
+[flake8]
+max-line-length = 120
+exclude = migrations
+per-file-ignores =
+  __init__.py: F401,F403,X100

app/.gitignore

@@ -0,0 +1 @@
+*.pyc

app/.python-version

@@ -0,0 +1 @@
+3.9.7

app/Pipfile

@@ -0,0 +1,26 @@
+[[source]]
+url = "https://pypi.org/simple"
+verify_ssl = true
+name = "pypi"
+
+[packages]
+mangum = "*"
+python-dotenv = "*"
+pip = "*"
+fastapi = "==0.68.2"
+ariadne = "*"
+sqlalchemy = "*"
+psycopg2-binary = "*"
+stripe = "*"
+boto3 = "*"
+pydash = "*"
+
+[dev-packages]
+uvicorn = "*"
+pylint = "*"
+pep8 = "*"
+mypy = "*"
+flake8 = "*"
+
+[requires]
+python_version = "3.9"

app/Pipfile.lock

@@ -0,0 +1,44 @@
+# Fastapi Graphql Postgres Example tasks service documentation
+
+## auth_create_task
+
+    mutation {
+      auth_create_task(
+        params: {
+          description: "test"
+        }
+      ) {
+        ... Task fields
+      }
+    }
+
+    curl -v 'https://xxx/auth' \
+    -H 'content-type: application/json' \
+    -H 'authorization: Bearer xxx' \
+    --data-raw '{"operationName":null,"variables":{},"query":"mutation {\n auth_create_task(params: {data: {}}) {\n created_at\n description\n id\n updated_at\n }\n}\n"}'
+
+## create_task
+
+    mutation {
+      create_task(
+        params: {
+          description: "test"
+        }
+      ) {
+        ... Task fields
+      }
+    }
+
+    curl 'https://xxx/public' -X POST  --data-raw '{"operationName":null,"variables":{},"query":"mutation {\n  create_task(params: { description: \"test\" }) {\n description\n id\n }\n}\n"}'
+
+## get_task
+
+    query {
+      get_task(
+        id: 123
+      ) {
+        ... Task fields
+      }
+    }
+
+    curl 'https://xxx/public' -X POST  --data-raw '{"operationName":null,"variables":{},"query":"{\n  get_task(id: 123) {\n description\n id\n }\n}\n"}'