WIP: swagger yaml defination

Using openapi 3.0 specification to define the restAPI for beaker
backend.

skeleton api with some dummy methods to allow for testing the test
framework.

Once this is fleshed out we can start migrating the model code over and
then create the actual rest methods.

Author: p3ck

API/requirements.txt

@@ -0,0 +1,31 @@
+attrs==23.1.0
+blinker==1.6.3
+certifi==2023.7.22
+charset-normalizer==3.3.0
+click==8.1.7
+clickclick==20.10.2
+connexion==3.0.5
+Flask==2.2.2
+flask-marshmallow==0.14.0
+Flask-SQLAlchemy==3.0.3
+greenlet==3.0.0
+idna==3.4
+inflection==0.5.1
+itsdangerous==2.1.2
+Jinja2==3.1.2
+jsonschema==4.19.1
+jsonschema-specifications==2023.7.1
+MarkupSafe==2.1.3
+marshmallow==3.20.1
+marshmallow-sqlalchemy==0.29.0
+packaging==23.2
+PyYAML==6.0.1
+referencing==0.30.2
+requests==2.31.0
+rpds-py==0.10.3
+six==1.16.0
+SQLAlchemy==2.0.22
+swagger-ui-bundle==0.0.9
+typing_extensions==4.8.0
+urllib3==2.0.6
+Werkzeug==2.2.2

API/setup.cfg

@@ -0,0 +1,14 @@
+[metadata]
+name = bkr.api
+
+[options]
+package_dir=
+    =src
+packages = find:
+zip_safe = False
+python_requires = >= 3
+[options.packages.find]
+where = src
+exclude =
+    tests*
+    .gitignore

API/setup.py

@@ -0,0 +1,2 @@
+from setuptools import setup
+setup()

API/src/bkr/api/__init__.py

@@ -0,0 +1,23 @@
+from flask import abort
+
+ARCHES = {}
+
+def post(arch):
+    if arch and arch not in ARCHES:
+        ARCHES[arch] = {
+                "arch": arch,
+                }
+        return ARCHES[arch], 201
+    else:
+        abort(
+                406,
+                f"{arch} already exists",
+                )
+
+def search(offset=0, limit=None):
+    start = 0
+    end = len(ARCHES.values())
+    if offset and limit:
+        start = offset * limit
+        end = start + limit
+    return list(ARCHES.values())[start:end]

API/src/bkr/api/arches.py

@@ -0,0 +1,14 @@
+def post(distro):
+    pass
+
+def search(offset=0, limit=None):
+    pass
+
+def get(id):
+    pass
+
+def put(id):
+    pass
+
+def delete(id):
+    pass

API/src/bkr/api/distros/__init__.py

@@ -0,0 +1,14 @@
+def search():
+    pass
+
+def post():
+    pass
+
+def put():
+    pass
+
+def get():
+    pass
+
+def delete():
+    pass

API/src/bkr/api/distros/tags.py

@@ -0,0 +1,3 @@
+def search():
+    return {'msg': 'ok'}, 200
+

API/src/bkr/api/health.py

@@ -0,0 +1,14 @@
+def search():
+    pass
+
+def post():
+    pass
+
+def put():
+    pass
+
+def get():
+    pass
+
+def delete():
+    pass

API/src/bkr/api/jobs/__init__.py

@@ -0,0 +1,2 @@
+def put():
+    pass