py-ard REST Service

 - REST service with `redux` endpoint
 - Dockerize the service
 - Add Make targets to build/run service

Author: pbashyal-nmdp

.dockerignore

@@ -0,0 +1,23 @@
+.github
+.git
+.direnv
+.idea
+.eggs/
+build
+dist
+*.egg
+*.egg-info
+tests
+venv
+
+__pycache__
+*.pyo
+*.pyd
+*.output
+.coverage
+.coverage.*
+.cache
+htmlcov/
+.pytest_cache
+allure_report
+CHANGELOG.md

Dockerfile

@@ -0,0 +1,19 @@
+FROM python:3.10-slim-buster
+
+LABEL MAINTAINER="Pradeep Bashyal"
+
+WORKDIR /app
+
+COPY requirements.txt /app
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -r requirements.txt
+
+COPY requirements-deploy.txt /app
+RUN pip install --no-cache-dir -r requirements-deploy.txt
+
+COPY app.py /app/
+COPY api.py /app/
+COPY api-spec.yaml /app/
+COPY pyard /app/pyard
+
+CMD ["gunicorn", "--bind", "0.0.0.0:8080", "--worker-tmp-dir", "/dev/shm",  "--timeout", "30", "app:app"]

Makefile

@@ -95,18 +95,18 @@ dist: clean ## builds source and wheel package
 	ls -l dist
 
 docker-build: ## build a docker image for the service
-	docker build -t my-project-template-service:0.0.1 .
+	docker build -t pyard-service:latest .
 
 docker: docker-build ## build a docker image and run the service
-	docker run --name my-project-template -p 8080:8080 my-project-template-service:0.0.1
+	docker run --name pyard-service -p 8080:8080 pyard-service:latest
 
 install: clean ## install the package to the active Python's site-packages
 	pip install --upgrade pip
-	python setup.py install
 	pip install -r requirements.txt
 	pip install -r requirements-tests.txt
 	pip install -r requirements-dev.txt
 	pip install -r requirements-deploy.txt
+	python setup.py install
 	pre-commit install
 
 venv: ## creates a Python3 virtualenv environment in venv

README.md

@@ -119,6 +119,7 @@ ard.redux_gl('B14', 'lg')
 | `lgx`          | Reduce to 2 field ARD level                     |
 | `W`            | Reduce/Expand to 3 field WHO nomenclature level |
 | `exon`         | Reduce/Expand to exon level                     |
+| `U2`           | Reduce to 2 field unambiguous level             |
 
 # Command Line Tools
 
@@ -186,3 +187,19 @@ A*01:01/A*01:02/A*01:03/A*01:06/A*01:07/A*01:08/A*01:09/A*01:10/A*01:12/ ...
 ### Batch Reduce a CSV file
 
 `pyard-csv-reduce` can be used to batch process a CSV file with HLA typings. See [documentation](extras/README.md) for instructions on how to configure and run.
+
+## py-ard REST Service
+
+Run `py-ard` as a service so that it can be accessed as a REST service endpoint.
+
+Build the docker image:
+```shell
+make docker-build
+```
+
+Build the docker and run it with:
+```shell
+make docker
+```
+
+The endpoint should then be available at [localhost:8080](http://0.0.0.0:8080)

api-spec.yaml

@@ -0,0 +1,62 @@
+openapi: 3.0.3
+info:
+  title: ARD Reduction
+  description: Reduce to ARD Level
+  version: "0.8.0"
+servers:
+  - url: 'http://localhost:8080'
+tags:
+  - name: ARD Reduction
+    description: Reduce GL String to ARD
+paths:
+  /redux:
+    post:
+      tags:
+        - ARD Reduction
+      operationId: api.redux_controller
+      summary: Reduce to ARD
+      description: |
+        Given a GL String and a reduction method perform ARD Reduction
+      requestBody:
+        content:
+          application/json:
+            schema:
+              properties:
+                gl_string:
+                  description: GL String
+                  type: string
+                  example: "A*01:01+A*01:01^B*08:ASXJP+B*07:02^C*02:02+C*07:HTGM^DPB1*28:01:01G+DPB1*296:01"
+                reduction_method:
+                  description: Reduction Method
+                  type: string
+                  enum:
+                    - G
+                    - lg
+                    - lgx
+                    - W
+                    - exon
+                    - U2
+                  example: "lgx"
+      responses:
+        200:
+          description: Reduction Result
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ard:
+                    description: ARD reduced version of GL String
+                    type: string
+                    example: "A*01:01+A*01:01^B*07:02+B*08:01^C*02:02/C*02:10+C*07:01/C*07:150Q^DPB1*28:01+DPB1*28:01"
+        400:
+          description: Invalid GL String
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    description: Describes what went wrong
+                    type: string
+                    example: "Invalid HLA locus"

api.py

@@ -0,0 +1,26 @@
+from flask import request
+
+from pyard import ARD
+from pyard.exceptions import PyArdError
+
+# Globally accessible for all endpoints
+ard = ARD()
+
+
+def redux_controller():
+    if request.json:
+        # Check the request has required inputs
+        try:
+            gl_string = request.json["gl_string"]
+            reduction_method = request.json["reduction_method"]
+        except KeyError:
+            return {"message": "gl_string and reduction_method not provided"}, 400
+        # Perform redux
+        try:
+            redux_gl_string = ard.redux_gl(gl_string, reduction_method)
+            return {"ard": redux_gl_string}, 200
+        except PyArdError as e:
+            return {"message": e.message}, 400
+
+    # if no data is sent
+    return {"message": "No input data provided"}, 404

app.py

@@ -0,0 +1,17 @@
+#!/usr/bin/env python3
+import connexion
+
+from flask import redirect
+
+app = connexion.App(__name__)
+application = app.app
+api = app.add_api("api-spec.yaml")
+
+
+@app.route("/")
+def index():
+    return redirect(api.base_path + "/ui")
+
+
+if __name__ == "__main__":
+    app.run(port=8080, debug=True)

setup.cfg

@@ -11,6 +11,10 @@ replace = version="{new_version}"
 search = __version__ = "{current_version}"
 replace = __version__ = "{new_version}"
 
+[bumpversion:file:api-spec.yaml]
+search = version: "{current_version}"
+replace = version: "{new_version}"
+
 [bdist_wheel]
 universal = 1