PyPI - panther - Versions diffs - 4.3.7__py3-none-any.whl → 5.0.0b1__py3-none-any.whl - Mend

panther 4.3.7py3-none-any.whl → 5.0.0b1py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

panther/__init__.py +1 -1
panther/_load_configs.py +78 -64
panther/_utils.py +1 -1
panther/app.py +126 -60
panther/authentications.py +26 -9
panther/base_request.py +27 -2
panther/base_websocket.py +26 -27
panther/cli/create_command.py +1 -0
panther/cli/main.py +19 -27
panther/cli/monitor_command.py +8 -4
panther/cli/template.py +11 -6
panther/cli/utils.py +3 -2
panther/configs.py +7 -9
panther/db/cursor.py +23 -7
panther/db/models.py +26 -19
panther/db/queries/base_queries.py +1 -1
panther/db/queries/mongodb_queries.py +172 -10
panther/db/queries/pantherdb_queries.py +5 -5
panther/db/queries/queries.py +1 -1
panther/events.py +10 -4
panther/exceptions.py +24 -2
panther/generics.py +2 -2
panther/main.py +80 -117
panther/middlewares/__init__.py +1 -1
panther/middlewares/base.py +15 -19
panther/middlewares/monitoring.py +42 -0
panther/openapi/__init__.py +1 -0
panther/openapi/templates/openapi.html +27 -0
panther/openapi/urls.py +5 -0
panther/openapi/utils.py +167 -0
panther/openapi/views.py +101 -0
panther/pagination.py +1 -1
panther/panel/middlewares.py +10 -0
panther/panel/templates/base.html +14 -0
panther/panel/templates/create.html +21 -0
panther/panel/templates/create.js +1270 -0
panther/panel/templates/detail.html +55 -0
panther/panel/templates/home.html +9 -0
panther/panel/templates/home.js +30 -0
panther/panel/templates/login.html +47 -0
panther/panel/templates/sidebar.html +13 -0
panther/panel/templates/table.html +73 -0
panther/panel/templates/table.js +339 -0
panther/panel/urls.py +10 -5
panther/panel/utils.py +98 -0
panther/panel/views.py +143 -0
panther/request.py +3 -0
panther/response.py +91 -53
panther/routings.py +7 -2
panther/serializer.py +1 -1
panther/utils.py +34 -26
panther/websocket.py +3 -0
{panther-4.3.7.dist-info → panther-5.0.0b1.dist-info}/METADATA +19 -17
panther-5.0.0b1.dist-info/RECORD +75 -0
{panther-4.3.7.dist-info → panther-5.0.0b1.dist-info}/WHEEL +1 -1
panther-4.3.7.dist-info/RECORD +0 -57
{panther-4.3.7.dist-info → panther-5.0.0b1.dist-info}/entry_points.txt +0 -0
{panther-4.3.7.dist-info → panther-5.0.0b1.dist-info}/licenses/LICENSE +0 -0
{panther-4.3.7.dist-info → panther-5.0.0b1.dist-info}/top_level.txt +0 -0

panther/middlewares/base.py CHANGED Viewed

@@ -1,30 +1,26 @@
+import typing
+from panther.base_websocket import Websocket
 from panther.request import Request
 from panther.response import Response
 from panther.websocket import GenericWebsocket
-class BaseMiddleware:
-    """Used in both http & ws requests"""
-    async def before(self, request: Request | GenericWebsocket):
-        raise NotImplementedError
-    async def after(self, response: Response | GenericWebsocket):
-        raise NotImplementedError
-class HTTPMiddleware(BaseMiddleware):
+class HTTPMiddleware:
     """Used only in http requests"""
-    async def before(self, request: Request):
-        return request
-    async def after(self, response: Response):
-        return response
+    def __init__(self, dispatch: typing.Callable):
+        self.dispatch = dispatch
+    async def __call__(self, request: Request) -> Response:
+        return await self.dispatch(request=request)
-class WebsocketMiddleware(BaseMiddleware):
+class WebsocketMiddleware:
     """Used only in ws requests"""
-    async def before(self, request: GenericWebsocket):
-        return request
-    async def after(self, response: GenericWebsocket):
-        return response
+    def __init__(self, dispatch: typing.Callable):
+        self.dispatch = dispatch
+    async def __call__(self, connection: Websocket) -> GenericWebsocket:
+        return await self.dispatch(connection=connection)

panther/middlewares/monitoring.py ADDED Viewed

@@ -0,0 +1,42 @@
+import logging
+from time import perf_counter
+from panther.base_websocket import Websocket
+from panther.middlewares import HTTPMiddleware, WebsocketMiddleware
+from panther.request import Request
+logger = logging.getLogger('monitoring')
+class MonitoringMiddleware(HTTPMiddleware):
+    """
+    Create Log Message Like Below:
+    date_time | method | path | ip:port | response_time(seconds) | status
+    """
+    async def __call__(self, request: Request):
+        start_time = perf_counter()
+        method = request.scope['method']
+        response = await self.dispatch(request=request)
+        response_time = perf_counter() - start_time  # Seconds
+        logger.info(f'{method} | {request.path} | {request.client} | {response_time} | {response.status_code}')
+        return response
+class WebsocketMonitoringMiddleware(WebsocketMiddleware):
+    """
+    Create Log Message Like Below:
+    date_time | WS | path | ip:port | connection_time(seconds) | status
+    """
+    ConnectedConnectionTime = ' - '
+    async def __call__(self, connection: Websocket):
+        start_time = perf_counter()
+        logger.info(f'WS | {connection.path} | {connection.client} |{self.ConnectedConnectionTime}| {connection.state}')
+        connection = await self.dispatch(connection=connection)
+        connection_time = perf_counter() - start_time  # Seconds
+        logger.info(f'WS | {connection.path} | {connection.client} | {connection_time} | {connection.state}')
+        return connection

panther/openapi/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ from panther.openapi.utils import OutputSchema

panther/openapi/templates/openapi.html ADDED Viewed

@@ -0,0 +1,27 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Swagger UI</title>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/4.16.0/swagger-ui.css" />
+</head>
+<body>
+    <div id="swagger-ui"></div>
+    <script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/4.16.0/swagger-ui-bundle.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/swagger-ui-dist/swagger-ui-standalone-preset.js"></script>
+    <script>
+    const openapiContent = {{ openapi_content | tojson }};
+    const ui = SwaggerUIBundle({
+        spec: openapiContent,
+        dom_id: '#swagger-ui',
+        presets: [
+            SwaggerUIBundle.presets.apis,
+            SwaggerUIStandalonePreset
+        ],
+        layout: "StandaloneLayout",
+    });
+    </script>
+</body>
+</html>

panther/openapi/urls.py ADDED Viewed

@@ -0,0 +1,5 @@
+from panther.openapi.views import OpenAPI
+urls = {
+    '': OpenAPI,
+}

panther/openapi/utils.py ADDED Viewed

@@ -0,0 +1,167 @@
+import ast
+import inspect
+import pydantic
+from panther import status
+from panther.serializer import ModelSerializer
+class EmptyResponseModel(pydantic.BaseModel):
+    pass
+class OutputSchema:
+    """
+    Its values only used in OpenAPI response schema
+    """
+    def __init__(
+            self,
+            model: type[ModelSerializer] | type[pydantic.BaseModel] = EmptyResponseModel,
+            status_code: int = status.HTTP_200_OK,
+    ):
+        self.model = model
+        self.status_code = status_code
+class ParseEndpoint:
+    """
+    ParseEndpoint parses the endpoint (function-base/ class-base) and finds where it returns
+        and extract the `data` and `status_code` values.
+    """
+    def __init__(self, endpoint, method):
+        self.tree = ast.parse(inspect.getsource(endpoint))
+        self.method = method
+        self.status_code = status.HTTP_200_OK
+        self.title = None
+        self.data = {}
+        self.parse()
+    def parse(self):
+        for branch in self.tree.body:
+            match branch:
+                case ast.ClassDef(name=name, body=body):
+                    # class ...(GenericAPI):
+                    #     def get(...
+                    self.title = name
+                    for part in body:
+                        match part:
+                            case ast.FunctionDef(name=name, body=function_body):
+                                # def get(...
+                                if name == self.method:
+                                    self.parse_function(body=function_body)
+                                    break
+                            case ast.AsyncFunctionDef(name=name, body=function_body):
+                                # async def get(...
+                                if name == self.method:
+                                    self.parse_function(body=function_body)
+                                    break
+                case ast.FunctionDef(name=name, body=body):
+                    # def api(...
+                    self.title = name
+                    self.parse_function(body=body)
+                case ast.AsyncFunctionDef(name=name, body=body):
+                    # async def api(...
+                    self.title = name
+                    self.parse_function(body=body)
+    def parse_function(self, body):
+        for part in body:
+            match part:
+                case ast.Return(value=ast.Dict(keys=keys, values=values)):
+                    # return {...}
+                    self.status_code = 200
+                    self.parse_dict_response(keys=keys, values=values)
+                case ast.Return(value=ast.Name(id=name)):
+                    # return my_data
+                    self.status_code = 200
+                    for value in self.searching_variable(body=body, name=name):
+                        match value:
+                            # my_data = {...}
+                            case ast.Dict(keys=keys, values=values):
+                                self.parse_dict_response(keys=keys, values=values)
+                case ast.Return(value=ast.Call(args=args, keywords=keywords, func=func)):
+                    if func.id == 'TemplateResponse':
+                        return
+                    # return Response(...
+                    self.parse_response(body=body, args=args, keywords=keywords)
+    def parse_dict_response(self, keys, values):
+        for k, v in zip(keys, values):
+            final_value = None
+            match v:
+                case ast.Constant(value=value):
+                    final_value = value
+            self.data[k.value] = final_value
+    def parse_response(self, body, args, keywords):
+        for keyword in keywords:
+            if keyword.arg == 'data':
+                self.parse_data(body=body, value=keyword.value)
+            if keyword.arg == 'status_code':
+                self.parse_status_code(body=body, value=keyword.value)
+        for i, arg in enumerate(args):
+            if i == 0:  # index 0 is `data`
+                self.parse_data(body=body, value=arg)
+            elif i == 1:  # index 1 is `status_code`
+                self.parse_status_code(body=body, value=arg)
+    def parse_status_code(self, body, value):
+        match value:
+            # return Response(?, status_code=my_status)
+            # return Response(?, my_status)
+            case ast.Name():
+                for inner_value in self.searching_variable(body=body, name=value.id):
+                    match inner_value:
+                        # my_status = status.HTTP_202_ACCEPTED
+                        case ast.Attribute(value=inner_inner_value, attr=attr):
+                            if inner_inner_value.id == 'status':
+                                self.status_code = getattr(status, attr)
+                        # my_status = 202
+                        case ast.Constant(value=inner_inner_value):
+                            self.status_code = inner_inner_value
+            # return Response(?, status_code=status.HTTP_202_ACCEPTED)
+            # return Response(?, status.HTTP_202_ACCEPTED)
+            case ast.Attribute(value=value, attr=attr):
+                if value.id == 'status':
+                    self.status_code = getattr(status, attr)
+            # return Response(?, status_code=202)
+            # return Response(?, 202)
+            case ast.Constant(value=value):
+                self.status_code = value
+    def parse_data(self, body, value):
+        match value:
+            # return Response(data=my_data, ?)
+            # return Response(my_data, ?)
+            case ast.Name():
+                for value in self.searching_variable(body=body, name=value.id):
+                    match value:
+                        # my_data = {...}
+                        case ast.Dict(keys=keys, values=values):
+                            self.parse_dict_response(keys=keys, values=values)
+            # return Response(data={...}, ?)
+            # return Response({...}, ?)
+            case ast.Dict(keys=keys, values=values):
+                self.parse_dict_response(keys=keys, values=values)
+    def searching_variable(self, body, name):
+        for part in body:
+            match part:
+                case ast.Assign(targets=targets, value=value):
+                    for target in targets:
+                        match target:
+                            case ast.Name(id=inner_name):
+                                if inner_name == name:
+                                    yield value

panther/openapi/views.py ADDED Viewed

@@ -0,0 +1,101 @@
+import types
+from panther.app import GenericAPI
+from panther.configs import config
+from panther.openapi.utils import ParseEndpoint
+from panther.response import TemplateResponse
+class OpenAPI(GenericAPI):
+    @classmethod
+    def get_content(cls, endpoint, method):
+        parsed = ParseEndpoint(endpoint=endpoint, method=method)
+        if endpoint.output_schema:
+            status_code = endpoint.output_schema.status_code
+            schema = endpoint.output_schema.model.schema()
+        else:
+            status_code = parsed.status_code
+            schema = {
+                'properties': {
+                    k: {'default': v} for k, v in parsed.data.items()
+                }
+            }
+        responses = {}
+        if schema:
+            responses = {
+                'responses': {
+                    status_code: {
+                        'content': {
+                            'application/json': {
+                                'schema': schema
+                            }
+                        }
+                    }
+                }
+            }
+        request_body = {}
+        if endpoint.input_model and method in ['post', 'put', 'patch']:
+            request_body = {
+                'requestBody': {
+                    'required': True,
+                    'content': {
+                        'application/json': {
+                            'schema': endpoint.input_model.schema() if endpoint.input_model else {}
+                        }
+                    }
+                }
+            }
+        content = {
+                      'title': parsed.title,
+                      'summary': endpoint.__doc__,
+                      'tags': ['.'.join(endpoint.__module__.rsplit('.')[:-1]) or endpoint.__module__],
+                  } | responses | request_body
+        return {method: content}
+    def get(self):
+        paths = {}
+        # TODO:
+        #   Try to process the endpoint with `ast` if output_schema is None
+        #   Create Component for output_schema.model and input_model
+        #
+        for url, endpoint in config.FLAT_URLS.items():
+            if url == '':
+                url = '/'
+            if not url.startswith('/'):
+                url = f'/{url}'
+            paths[url] = {}
+            if isinstance(endpoint, types.FunctionType):
+                methods = endpoint.methods
+                if methods is None or 'POST' in methods:
+                    paths[url] |= self.get_content(endpoint, 'post')
+                if methods is None or 'GET' in methods:
+                    paths[url] |= self.get_content(endpoint, 'get')
+                if methods is None or 'PUT' in methods:
+                    paths[url] |= self.get_content(endpoint, 'put')
+                if methods is None or 'PATCH' in methods:
+                    paths[url] |= self.get_content(endpoint, 'patch')
+                if methods is None or 'DELETE' in methods:
+                    paths[url] |= self.get_content(endpoint, 'delete')
+            else:
+                if endpoint.post is not GenericAPI.post:
+                    paths[url] |= self.get_content(endpoint, 'post')
+                if endpoint.get is not GenericAPI.get:
+                    paths[url] |= self.get_content(endpoint, 'get')
+                if endpoint.put is not GenericAPI.put:
+                    paths[url] |= self.get_content(endpoint, 'put')
+                if endpoint.patch is not GenericAPI.patch:
+                    paths[url] |= self.get_content(endpoint, 'patch')
+                if endpoint.delete is not GenericAPI.delete:
+                    paths[url] |= self.get_content(endpoint, 'delete')
+        openapi_content = {
+            'openapi': '3.0.0',
+            'paths': paths,
+            'components': {}
+        }
+        print(f'{openapi_content=}')
+        return TemplateResponse(name='openapi.html', context={'openapi_content': openapi_content})

panther/pagination.py CHANGED Viewed

@@ -11,7 +11,7 @@ class Pagination:
             'count': 10,
             'next': '?limit=10&skip=10',
             'previous': None,
-            results: [...]
+            'results': [...]
         }
     """
     DEFAULT_LIMIT = 20

panther/panel/middlewares.py ADDED Viewed

@@ -0,0 +1,10 @@
+from panther.middlewares import HTTPMiddleware
+from panther.request import Request
+from panther.response import RedirectResponse
+class RedirectToSlashMiddleware(HTTPMiddleware):
+    async def __call__(self, request: Request):
+        if not request.path.endswith('/'):
+            return RedirectResponse(request.path + '/')
+        return await self.dispatch(request=request)

panther/panel/templates/base.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>{{ title }}</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+</head>
+<body class="bg-gray-900 text-white p-8">
+{% block content %}
+{% endblock %}
+</body>
+</html>

panther/panel/templates/create.html ADDED Viewed

@@ -0,0 +1,21 @@
+{% extends "base.html" %}
+{% block content %}
+<div class="max-w-4xl mx-auto">
+  <h1 class="text-2xl font-semibold mb-6">Create New Record</h1>
+  <form id="createForm" class="space-y-4 bg-gray-800 p-6 rounded-lg">
+    <div id="dynamicInputs" class="space-y-4">
+      <!-- Dynamic inputs will be generated here -->
+    </div>
+    <button type="submit" class="w-full bg-blue-600 hover:bg-blue-500 text-white py-2 px-4 rounded-lg">
+      Submit
+    </button>
+  </form>
+</div>
+<script>
+const isUpdate = false;
+  const data = {};
+  {% include "create.js" %}
+</script>
+{% endblock %}

panther 4.3.7__py3-none-any.whl → 5.0.0b1__py3-none-any.whl

panther 4.3.7py3-none-any.whl → 5.0.0b1py3-none-any.whl