feat: Register endpoint

docs/spec.openapi.yaml

@@ -43,7 +43,7 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/statusResponse"
-  /register:
+  /account/register:
     post:
       tags:
         - Authentication
@@ -577,7 +577,7 @@ components:
     authorization:
       type: object
       properties:
-        jwt:
+        token:
           type: string
     fileDetails:
       type: object

src/controllers/_account_controllers.py

@@ -0,0 +1,31 @@
+from flask import request
+from src.config.soap_client import soap_client
+
+
+def register_handler():
+    try:
+        # Get JSON data from the request
+        data = request.json
+
+        if not data:
+            return {"msg": "No JSON data provided in the request"}, 400
+
+        username = data.get("username")
+        password = data.get("password")
+
+        if not username or not password:
+            return {"msg": "Required fields are missing in JSON data"}, 400
+
+        result = soap_client.service.account_register(
+            {"username": username, "password": password}
+        )
+
+        if result.auth is not None:
+            jwt = result.auth.token
+            return {"msg": "Register succeeded", "token": jwt}, 200
+
+        return {"msg": "Username already registered"}, 409
+
+    except Exception as e:
+        print("[Exception] register_handler ->", str(e))
+        return {"msg": "Internal error", "error": str(e)}, 500

src/views/__init__.py

@@ -1,9 +1,11 @@
 import flask
 from ._authentication_views import views as authentication_views
+from ._account_views import views as account_views
 
 
 # NOTE: Register all views / routes using the following blueprint
 views = flask.Blueprint("views", __name__)
 
 
 views.register_blueprint(authentication_views)
+views.register_blueprint(account_views)

src/views/_account_views.py

@@ -0,0 +1,9 @@
+import flask
+from src.controllers import _account_controllers
+
+views = flask.Blueprint("account", __name__)
+
+
+@views.route("/account/register", methods=["POST"])
+def account_register():
+    return _account_controllers.register_handler()

src/views/_account_views_test.py

@@ -0,0 +1,48 @@
+import json
+from main import app
+from src.lib.faker import fake_username, fake_password
+
+register_test_data = {"username": fake_username(), "password": fake_password()}
+
+
+def test_account_register_successful() -> None:
+    register_data = {
+        "username": register_test_data["username"],
+        "password": register_test_data["password"],
+    }
+    response = app.test_client().post("/account/register", json=register_data)
+    json_response = json.loads(response.data)
+
+    assert response.status_code == 200
+    assert json.loads(response.data)["msg"] == "Register succeeded"
+    assert json_response["token"] != ""
+
+
+def test_account_register_missing_fields() -> None:
+    # Empty json
+    data = {}
+    response = app.test_client().post("/account/register", json=data)
+
+    assert response.status_code == 400
+    assert json.loads(response.data)["msg"] == "No JSON data provided in the request"
+
+    # Missing password
+    data = {"username": register_test_data["username"]}
+    response = app.test_client().post("/account/register", json=data)
+
+    assert response.status_code == 400
+    assert (
+        json.loads(response.data)["msg"] == "Required fields are missing in JSON data"
+    )
+
+
+def test_account_register_Username_already_registered() -> None:
+    data = {
+        "username": register_test_data["username"],
+        "password": register_test_data["password"],
+    }
+    response = app.test_client().post("/account/register", json=data)
+    json_response = json.loads(response.data)
+
+    assert response.status_code == 409
+    assert json_response["msg"] == "Username already registered"