square_administration 4.0.0__py3-none-any.whl

square_administration/configuration.py

@@ -0,0 +1,120 @@
+import os
+import sys
+
+from square_authentication_helper import SquareAuthenticationHelper
+from square_commons import ConfigReader
+from square_database_helper import SquareDatabaseHelper
+from square_logger.main import SquareLogger
+
+try:
+    config_file_path = os.path.join(
+        os.path.dirname(os.path.abspath(__file__)), "data", "config.ini"
+    )
+    config_sample_file_path = os.path.join(
+        os.path.dirname(os.path.abspath(__file__)), "data", "config.sample.ini"
+    )
+    ldict_configuration = ConfigReader(
+        config_file_path, config_sample_file_path
+    ).read_configuration()
+    # get all vars and typecast
+    # ===========================================
+    # general
+    config_str_module_name = ldict_configuration["GENERAL"]["MODULE_NAME"]
+    config_str_app_name = ldict_configuration["GENERAL"]["APP_NAME"]
+    # ===========================================
+
+    # ===========================================
+    # environment
+    config_str_host_ip = ldict_configuration["ENVIRONMENT"]["HOST_IP"]
+    config_int_host_port = int(ldict_configuration["ENVIRONMENT"]["HOST_PORT"])
+    config_list_allow_origins = eval(
+        ldict_configuration["ENVIRONMENT"]["ALLOW_ORIGINS"]
+    )
+    config_str_log_file_name = ldict_configuration["ENVIRONMENT"]["LOG_FILE_NAME"]
+    config_str_admin_password_hash = ldict_configuration["ENVIRONMENT"][
+        "ADMIN_PASSWORD_HASH"
+    ]
+
+    config_str_ssl_crt_file_path = ldict_configuration["ENVIRONMENT"][
+        "SSL_CRT_FILE_PATH"
+    ]
+    config_str_ssl_key_file_path = ldict_configuration["ENVIRONMENT"][
+        "SSL_KEY_FILE_PATH"
+    ]
+    config_str_cookie_domain = ldict_configuration["ENVIRONMENT"]["COOKIE_DOMAIN"]
+    config_str_db_ip = ldict_configuration["ENVIRONMENT"]["DB_IP"]
+    config_int_db_port = int(ldict_configuration["ENVIRONMENT"]["DB_PORT"])
+    config_str_db_username = ldict_configuration["ENVIRONMENT"]["DB_USERNAME"]
+    config_str_db_password = ldict_configuration["ENVIRONMENT"]["DB_PASSWORD"]
+    # ===========================================
+
+    # ===========================================
+    # square_logger
+    config_int_log_level = int(ldict_configuration["SQUARE_LOGGER"]["LOG_LEVEL"])
+    config_str_log_path = ldict_configuration["SQUARE_LOGGER"]["LOG_PATH"]
+    config_int_log_backup_count = int(
+        ldict_configuration["SQUARE_LOGGER"]["LOG_BACKUP_COUNT"]
+    )
+    config_formatter_choice = ldict_configuration["SQUARE_LOGGER"]["FORMATTER_CHOICE"]
+    if config_formatter_choice not in ("human_readable", "json"):
+        raise ValueError(f"Invalid formatter choice: {config_formatter_choice}")
+    config_bool_enable_redaction = eval(
+        ldict_configuration["SQUARE_LOGGER"]["ENABLE_REDACTION"]
+    )
+    # ===========================================
+
+    # ===========================================
+    # square_database_helper
+
+    config_str_square_database_protocol = ldict_configuration["SQUARE_DATABASE_HELPER"][
+        "SQUARE_DATABASE_PROTOCOL"
+    ]
+    config_str_square_database_ip = ldict_configuration["SQUARE_DATABASE_HELPER"][
+        "SQUARE_DATABASE_IP"
+    ]
+    config_int_square_database_port = int(
+        ldict_configuration["SQUARE_DATABASE_HELPER"]["SQUARE_DATABASE_PORT"]
+    )
+    # ===========================================
+    # ===========================================
+    # square_authentication_helper
+
+    config_str_square_authentication_protocol = ldict_configuration[
+        "SQUARE_AUTHENTICATION_HELPER"
+    ]["SQUARE_AUTHENTICATION_PROTOCOL"]
+    config_str_square_authentication_ip = ldict_configuration[
+        "SQUARE_AUTHENTICATION_HELPER"
+    ]["SQUARE_AUTHENTICATION_IP"]
+    config_int_square_authentication_port = int(
+        ldict_configuration["SQUARE_AUTHENTICATION_HELPER"][
+            "SQUARE_AUTHENTICATION_PORT"
+        ]
+    )
+    # ===========================================
+    # Initialize logger
+    global_object_square_logger = SquareLogger(
+        log_file_name=config_str_log_file_name,
+        log_level=config_int_log_level,
+        log_path=config_str_log_path,
+        log_backup_count=config_int_log_backup_count,
+        formatter_choice=config_formatter_choice,
+        enable_redaction=config_bool_enable_redaction,
+    )
+
+    global_object_square_database_helper = SquareDatabaseHelper(
+        param_str_square_database_ip=config_str_square_database_ip,
+        param_int_square_database_port=config_int_square_database_port,
+        param_str_square_database_protocol=config_str_square_database_protocol,
+    )
+    global_object_square_authentication_helper = SquareAuthenticationHelper(
+        param_str_square_authentication_protocol=config_str_square_authentication_protocol,
+        param_str_square_authentication_ip=config_str_square_authentication_ip,
+        param_int_square_authentication_port=config_int_square_authentication_port,
+    )
+
+except Exception as e:
+    print(
+        "\033[91mMissing or incorrect config.ini file.\n"
+        "Error details: " + str(e) + "\033[0m"
+    )
+    sys.exit()

square_administration/data/config.sample.ini

@@ -0,0 +1,56 @@
+[GENERAL]
+MODULE_NAME = square_administration
+APP_NAME = square_admin
+
+[ENVIRONMENT]
+HOST_IP = 0.0.0.0
+HOST_PORT = 10111
+ALLOW_ORIGINS = ["http://localhost:10111"]
+
+LOG_FILE_NAME = square_administration
+
+ADMIN_PASSWORD_HASH = $2b$12$tDw4ZR0guiF5s5oVve5PcuELhlWO.lUH.OChPoeWVn95ac7QJlndq
+
+# absolute path (mandatory only for http)
+SSL_CRT_FILE_PATH = ssl.crt
+SSL_KEY_FILE_PATH = ssl.key
+
+COOKIE_DOMAIN = localhost
+
+DB_IP = localhost
+DB_PORT = 10001
+DB_USERNAME = postgres
+DB_PASSWORD = dummy
+
+[SQUARE_LOGGER]
+
+# | Log Level | Value |
+# | --------- | ----- |
+# | CRITICAL  | 50    |
+# | ERROR     | 40    |
+# | WARNING   | 30    |
+# | INFO      | 20    |
+# | DEBUG     | 10    |
+# | NOTSET    | 0     |
+
+LOG_LEVEL = 20
+# absolute or relative path
+LOG_PATH = logs
+# number of backup log files to keep during rotation
+# if backupCount is zero, rollover never occurs.
+LOG_BACKUP_COUNT = 3
+# json or human_readable
+FORMATTER_CHOICE = json
+ENABLE_REDACTION = True
+
+[SQUARE_DATABASE_HELPER]
+
+SQUARE_DATABASE_PROTOCOL = http
+SQUARE_DATABASE_IP = localhost
+SQUARE_DATABASE_PORT = 10010
+
+[SQUARE_AUTHENTICATION_HELPER]
+
+SQUARE_AUTHENTICATION_PROTOCOL = http
+SQUARE_AUTHENTICATION_IP = localhost
+SQUARE_AUTHENTICATION_PORT = 10011

square_administration/data/config.testing.sample.ini

@@ -0,0 +1,57 @@
+[GENERAL]
+MODULE_NAME = square_administration
+APP_NAME = square_admin
+
+[ENVIRONMENT]
+HOST_IP = 0.0.0.0
+HOST_PORT = 10111
+ALLOW_ORIGINS = ["http://localhost:10111"]
+
+LOG_FILE_NAME = square_administration
+
+ADMIN_PASSWORD_HASH = $2b$12$tDw4ZR0guiF5s5oVve5PcuELhlWO.lUH.OChPoeWVn95ac7QJlndq
+
+# absolute path (mandatory only for http)
+SSL_CRT_FILE_PATH = ssl.crt
+SSL_KEY_FILE_PATH = ssl.key
+
+COOKIE_DOMAIN = localhost
+
+DB_IP = raspi.thepmsquare.com
+DB_PORT = 15432
+DB_USERNAME = postgres
+DB_PASSWORD = testing_password
+
+
+[SQUARE_LOGGER]
+
+# | Log Level | Value |
+# | --------- | ----- |
+# | CRITICAL  | 50    |
+# | ERROR     | 40    |
+# | WARNING   | 30    |
+# | INFO      | 20    |
+# | DEBUG     | 10    |
+# | NOTSET    | 0     |
+
+LOG_LEVEL = 20
+# absolute or relative path
+LOG_PATH = logs
+# number of backup log files to keep during rotation
+# if backupCount is zero, rollover never occurs.
+LOG_BACKUP_COUNT = 3
+# json or human_readable
+FORMATTER_CHOICE = json
+ENABLE_REDACTION = True
+
+[SQUARE_DATABASE_HELPER]
+
+SQUARE_DATABASE_PROTOCOL = http
+SQUARE_DATABASE_IP = raspi.thepmsquare.com
+SQUARE_DATABASE_PORT = 20010
+
+[SQUARE_AUTHENTICATION_HELPER]
+
+SQUARE_AUTHENTICATION_PROTOCOL = http
+SQUARE_AUTHENTICATION_IP = raspi.thepmsquare.com
+SQUARE_AUTHENTICATION_PORT = 20011

square_administration/main.py

@@ -0,0 +1,58 @@
+from fastapi import FastAPI, status
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import JSONResponse
+from square_commons import get_api_output_in_standard_format
+from uvicorn import run
+
+from square_administration.configuration import (
+    config_int_host_port,
+    config_str_host_ip,
+    global_object_square_logger,
+    config_str_module_name,
+    config_str_ssl_key_file_path,
+    config_str_ssl_crt_file_path,
+    config_list_allow_origins,
+)
+from square_administration.routes import core, authentication
+from square_administration.utils.common import is_https
+
+app = FastAPI()
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_credentials=True,
+    allow_origins=config_list_allow_origins,
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+app.include_router(core.router)
+app.include_router(authentication.router)
+
+
+@app.get("/")
+@global_object_square_logger.auto_logger()
+async def root():
+    output_content = get_api_output_in_standard_format(log=config_str_module_name)
+    return JSONResponse(status_code=status.HTTP_200_OK, content=output_content)
+
+
+if __name__ == "__main__":
+    try:
+        if is_https():
+            run(
+                app,
+                host=config_str_host_ip,
+                port=config_int_host_port,
+                ssl_certfile=config_str_ssl_crt_file_path,
+                ssl_keyfile=config_str_ssl_key_file_path,
+            )
+        else:
+            run(
+                app,
+                host=config_str_host_ip,
+                port=config_int_host_port,
+            )
+
+    except Exception as exc:
+        global_object_square_logger.logger.critical(exc, exc_info=True)

square_administration/messages.py

@@ -0,0 +1,16 @@
+messages = {
+    "REGISTRATION_SUCCESSFUL": "registration was successful. welcome aboard!",
+    "LOGIN_SUCCESSFUL": "you have logged in successfully.",
+    "LOGOUT_SUCCESSFUL": "you have logged out successfully.",
+    "INCORRECT_USERNAME": "the username you entered does not exist.",
+    "INCORRECT_PASSWORD": "the password you entered is incorrect. please try again.",
+    "GENERIC_CREATION_SUCCESSFUL": "records created successfully.",
+    "GENERIC_READ_SUCCESSFUL": "data retrieved successfully.",
+    "GENERIC_UPDATE_SUCCESSFUL": "your information has been updated successfully.",
+    "GENERIC_DELETE_SUCCESSFUL": "your records have been deleted successfully.",
+    "GENERIC_400": "the request is invalid or cannot be processed.",
+    "GENERIC_500": "an internal server error occurred. please try again later.",
+    "INCORRECT_ACCESS_TOKEN": "the access token provided is invalid or expired.",
+    "INCORRECT_REFRESH_TOKEN": "the refresh token provided is invalid or expired.",
+    "REFRESH_TOKEN_NOT_FOUND": "refresh token not found. please login again.",
+}

square_administration/pydantic_models/authentication.py

@@ -0,0 +1,36 @@
+from pydantic import BaseModel
+
+
+class RegisterUsernameV0(BaseModel):
+    username: str
+    password: str
+    admin_password: str
+
+
+class LoginUsernameV0(BaseModel):
+    username: str
+    password: str
+
+
+class RemoveAppForSelfV0(BaseModel):
+    password: str
+
+
+class ResetPasswordAndLoginUsingBackupCodeV0(BaseModel):
+    backup_code: str
+    username: str
+    new_password: str
+    logout_other_sessions: bool = False
+
+
+class ResetPasswordAndLoginUsingResetEmailCodeV0(BaseModel):
+    reset_email_code: str
+    username: str
+    new_password: str
+    logout_other_sessions: bool = False
+
+
+class UpdatePasswordV0(BaseModel):
+    old_password: str
+    new_password: str
+    logout_other_sessions: bool = False

square_administration/pydantic_models/core.py

@@ -0,0 +1,12 @@
+from typing import Optional, List
+
+from pydantic import BaseModel, Field
+from square_database_structure.square.greeting.tables import Greeting
+
+
+class GetAllGreetingsV0(BaseModel):
+    order_by: List[str] = Field(
+        default_factory=lambda: [f"-{Greeting.greeting_datetime.name}"]
+    )
+    limit: Optional[int] = None
+    offset: int = 0

square_administration/routes/authentication.py

@@ -0,0 +1,212 @@
+from typing import Annotated
+
+from fastapi import APIRouter, status, HTTPException, Header, Request
+from fastapi.responses import JSONResponse
+from square_commons import get_api_output_in_standard_format
+
+from square_administration.configuration import (
+    global_object_square_logger,
+)
+from square_administration.messages import messages
+from square_administration.pydantic_models.authentication import (
+    RegisterUsernameV0,
+    LoginUsernameV0,
+    RemoveAppForSelfV0,
+    ResetPasswordAndLoginUsingBackupCodeV0,
+    ResetPasswordAndLoginUsingResetEmailCodeV0,
+    UpdatePasswordV0,
+)
+from square_administration.utils.routes.authentication import (
+    util_register_username_v0,
+    util_login_username_v0,
+    util_remove_app_for_self_v0,
+    util_logout_v0,
+    util_generate_access_token_v0,
+    util_reset_password_and_login_using_backup_code_v0,
+    util_reset_password_and_login_using_reset_email_code_v0,
+    util_update_password_v0,
+)
+
+router = APIRouter(
+    tags=["authentication"],
+)
+
+
+@router.post("/register_username/v0")
+@global_object_square_logger.auto_logger()
+async def register_username_v0(
+    body: RegisterUsernameV0,
+):
+    try:
+        return util_register_username_v0(
+            body=body,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.post("/login_username/v0")
+@global_object_square_logger.auto_logger()
+async def login_username_v0(
+    body: LoginUsernameV0,
+):
+    try:
+        return util_login_username_v0(
+            body=body,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.patch("/remove_app_for_self/v0")
+@global_object_square_logger.auto_logger()
+async def remove_app_for_self_v0(
+    access_token: Annotated[str, Header()],
+    body: RemoveAppForSelfV0,
+):
+    try:
+        return util_remove_app_for_self_v0(
+            body=body,
+            access_token=access_token,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.delete("/logout/v0")
+@global_object_square_logger.auto_logger()
+async def logout_v0(request: Request):
+    try:
+        return util_logout_v0(
+            request=request,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.get("/generate_access_token/v0")
+@global_object_square_logger.auto_logger()
+async def generate_access_token_v0(
+    request: Request,
+):
+    try:
+        return util_generate_access_token_v0(
+            request=request,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.post("/reset_password_and_login_using_backup_code/v0")
+@global_object_square_logger.auto_logger()
+async def reset_password_and_login_using_backup_code_v0(
+    body: ResetPasswordAndLoginUsingBackupCodeV0,
+):
+    try:
+        return util_reset_password_and_login_using_backup_code_v0(
+            body=body,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.post("/reset_password_and_login_using_reset_email_code/v0")
+@global_object_square_logger.auto_logger()
+async def reset_password_and_login_using_reset_email_code_v0(
+    body: ResetPasswordAndLoginUsingResetEmailCodeV0,
+):
+    try:
+        return util_reset_password_and_login_using_reset_email_code_v0(
+            body=body,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )
+
+
+@router.patch("/update_password/v0")
+@global_object_square_logger.auto_logger()
+async def update_password_v0(
+    request: Request,
+    body: UpdatePasswordV0,
+    access_token: Annotated[str, Header()],
+):
+    try:
+        return util_update_password_v0(
+            request=request,
+            body=body,
+            access_token=access_token,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )

square_administration/routes/core.py

@@ -0,0 +1,39 @@
+from typing import Annotated
+
+from fastapi import APIRouter, Header, status, HTTPException
+from fastapi.responses import JSONResponse
+from square_commons import get_api_output_in_standard_format
+
+from square_administration.configuration import (
+    global_object_square_logger,
+)
+from square_administration.messages import messages
+from square_administration.pydantic_models.core import GetAllGreetingsV0
+from square_administration.utils.routes.core import util_get_all_greetings_v0
+
+router = APIRouter(
+    tags=["core"],
+)
+
+
+@router.post("/get_all_greetings/v0")
+@global_object_square_logger.auto_logger()
+async def get_all_greetings_v0(
+    access_token: Annotated[str, Header()], body: GetAllGreetingsV0
+):
+    try:
+        return util_get_all_greetings_v0(
+            access_token=access_token,
+            body=body,
+        )
+    except HTTPException as he:
+        global_object_square_logger.logger.error(he, exc_info=True)
+        return JSONResponse(status_code=he.status_code, content=he.detail)
+    except Exception as e:
+        global_object_square_logger.logger.error(e, exc_info=True)
+        output_content = get_api_output_in_standard_format(
+            message=messages["GENERIC_500"], log=str(e)
+        )
+        return JSONResponse(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR, content=output_content
+        )

square_administration/utils/common.py

@@ -0,0 +1,36 @@
+import os
+
+from square_database_helper import FiltersV0
+from square_database_helper.pydantic_models import FilterConditionsV0
+from square_database_structure.square import global_string_database_name
+from square_database_structure.square.public import global_string_schema_name
+from square_database_structure.square.public.tables import App
+
+from square_administration.configuration import (
+    config_str_ssl_key_file_path,
+    config_str_ssl_crt_file_path,
+    global_object_square_logger,
+    global_object_square_database_helper,
+    config_str_app_name,
+)
+
+
+@global_object_square_logger.auto_logger()
+def is_https() -> bool:
+    return os.path.exists(config_str_ssl_key_file_path) and os.path.exists(
+        config_str_ssl_crt_file_path
+    )
+
+
+# get app id
+global_int_app_id = global_object_square_database_helper.get_rows_v0(
+    database_name=global_string_database_name,
+    schema_name=global_string_schema_name,
+    table_name=App.__tablename__,
+    filters=FiltersV0(
+        root={
+            App.app_name.name: FilterConditionsV0(eq=config_str_app_name),
+        }
+    ),
+    columns=[App.app_id.name],
+)["data"]["main"][0][App.app_id.name]