panther 1.7.1__py3-none-any.whl → 1.7.3__py3-none-any.whl

panther/__init__.py

@@ -1,6 +1,6 @@
 from .main import Panther
 
-__version__ = '1.7.1'
+__version__ = '1.7.3'
 
 
 def version():

panther/app.py

@@ -41,44 +41,44 @@ class API:
         async def wrapper(*args, **kwargs):
             self.request: Request = kwargs.pop('request')  # NOQA: Non-self attribute could not be type hinted
 
-            # Handle Authentication
+            # 1. Authentication
             self.handle_authentications()
 
-            # Handle Throttling
+            # 2. Throttling
             self.handle_throttling()
 
-            # Handle Authentication
+            # 3. Permissions
             self.handle_permissions()
 
-            # Validate Input
+            # 4. Validate Input
             self.validate_input()
 
-            # Validate Path Variables
+            # 5. Validate Path Variables
             self.validate_path_variables(func, kwargs)
 
-            # Get Cached Response
+            # 6. Get Cached Response
             if self.cache and self.request.method == 'GET':
                 if cached := get_cached_response_data(request=self.request):
                     return Response(data=cached.data, status_code=cached.status_code)
 
-            # Put Request In kwargs
+            # 7. Put Request In kwargs
             if req_arg := [k for k, v in func.__annotations__.items() if v == Request]:
                 kwargs[req_arg[0]] = self.request
 
-            # Call Endpoint
+            # 8. Call Endpoint
             response = await func(**kwargs)
 
-            # Clean Output
+            # 9. Clean Output
             if not isinstance(response, Response):
                 response = Response(data=response)
             data = self.serialize_response_data(data=response._data)  # NOQA: Access to a protected member
             response.set_data(data)
 
-            # Set New Response To Cache
+            # 10. Set New Response To Cache
             if self.cache and self.request.method == 'GET':
                 set_cache_response(request=self.request, response=response, cache_exp_time=self.cache_exp_time)
 
-            # Warning CacheExpTime
+            # 11. Warning CacheExpTime
             if self.cache_exp_time and self.cache is False:
                 logger.warning('"cache_exp_time" won\'t work while "cache" is False')
 

panther/cli/monitor_command.py

@@ -1,44 +1,36 @@
 import os
 from collections import deque
 
-from rich import box
-from rich.align import Align
-from rich.console import Console, Group
+from rich.console import Group
 from rich.layout import Layout
-from rich.live import Live
+from rich.align import Align
 from rich.panel import Panel
 from rich.table import Table
 from watchfiles import watch
-
-from panther.cli.utils import cli_error
+from rich.live import Live
+from rich import box
 
 
 def monitor() -> None:
-    def _generate_table(rows):
+    monitoring_log_file = 'logs/monitoring.log'
+
+    def _generate_table(rows: deque):
         layout = Layout()
-        console = Console()
 
         rows = list(rows)
-        n_rows = os.get_terminal_size()[1]
-
-        while n_rows >= 0:
-            table = Table(box=box.MINIMAL_DOUBLE_HEAD)
-            table.add_column('Datetime', justify='center', style='magenta', no_wrap=True)
-            table.add_column('Method', justify='center', style='cyan')
-            table.add_column('Path', justify='center', style='cyan')
-            table.add_column('Client', justify='center', style='cyan')
-            table.add_column('Response Time', justify='center', style='blue')
-            table.add_column('Status Code', justify='center', style='blue')
+        _, lines = os.get_terminal_size()
 
-            for row in rows[-n_rows:]:
-                table.add_row(*row)
-            layout.update(table)
-            render_map = layout.render(console, console.options)
+        table = Table(box=box.MINIMAL_DOUBLE_HEAD)
+        table.add_column('Datetime', justify='center', style='magenta', no_wrap=True)
+        table.add_column('Method', justify='center', style='cyan')
+        table.add_column('Path', justify='center', style='cyan')
+        table.add_column('Client', justify='center', style='cyan')
+        table.add_column('Response Time', justify='center', style='blue')
+        table.add_column('Status Code', justify='center', style='blue')
 
-            if len(render_map[layout].render[-1]) > 2:
-                n_rows -= 1  # The table is overflowing
-            else:
-                break
+        for row in rows[-lines:]:  # It will give us "lines" last lines of "rows"
+            table.add_row(*row)
+        layout.update(table)
 
         return Panel(
             Align.center(Group(table)),
@@ -48,22 +40,19 @@ def monitor() -> None:
             border_style='bright_blue',
         )
 
-    try:
-        with open('logs/monitoring.log') as f:
-            f.readlines()
-            width, height = os.get_terminal_size()
-            messages = deque(maxlen=height - 8)  # Save space for header and footer
+    with open(monitoring_log_file) as f:
+        f.readlines()  # Set cursor at the end of file
 
-            with Live(_generate_table(messages), auto_refresh=False, vertical_overflow='visible', screen=True) as live:
-                # TODO: Is it only watch logs/monitoring.log or the whole directory ?
-                for _ in watch('logs/monitoring.log'):
+        _, init_lines_count = os.get_terminal_size()
+        messages = deque(maxlen=init_lines_count - 10)  # Save space for header and footer
+
+        with Live(_generate_table(messages), auto_refresh=False, vertical_overflow='visible', screen=True) as live:
+            try:
+                for _ in watch(monitoring_log_file):
                     data = f.readline().split('|')
+                    # 2023-03-24 01:42:52 | GET | /user/317/ | 127.0.0.1:48856 |  0.0366 ms | 200
                     messages.append(data)
                     live.update(_generate_table(messages))
                     live.refresh()
-
-    except FileNotFoundError:
-        cli_error("Monitor Log File Does Not Exists.\n\nHint: Make sure 'Monitor' is True in 'core/configs' "
-                  "or you are in a correct directory.")
-    except KeyboardInterrupt:
-        pass
+            except KeyboardInterrupt:
+                pass

panther/cli/template.py

@@ -10,15 +10,16 @@ from panther.configs import config
 from panther import version, status
 from panther.request import Request
 from panther.response import Response
+from app.throttling import InfoThrottling
 
 
 @API()
-async def hello_world():
+async def hello_world_api():
     return {'detail': 'Hello World'}
 
 
-@API(cache=True)
-async def info(request: Request):
+@API(cache=True, throttling=InfoThrottling)
+async def info_api(request: Request):
     data = {
         'version': version(),
         'datetime_now': datetime.now().isoformat(),
@@ -34,11 +35,18 @@ models_py = """from panther.db import Model
 serializers_py = """from pydantic import BaseModel as Serializer
 """
 
-app_urls_py = """from app.apis import hello_world, info
+throttling_py = """from datetime import timedelta
+from panther.throttling import Throttling
+
+
+InfoThrottling = Throttling(rate=5, duration=timedelta(minutes=1))
+"""
+
+app_urls_py = """from app.apis import hello_world_api, info_api
 
 urls = {
-    '': hello_world,
-    'info/': info,
+    '': hello_world_api,
+    'info/': info_api,
 }
 """
 
@@ -56,23 +64,29 @@ env = load_env(BASE_DIR / '.env')
 DB_NAME = env['DB_NAME']
 SECRET_KEY = env['SECRET_KEY']
 
-
+# # # More Info: Https://PantherPy.GitHub.io/middlewares/
 MIDDLEWARES = [
     ('panther.middlewares.db.Middleware', {'url': f'pantherdb://{BASE_DIR}/{DB_NAME}.pantherdb'}),
 ]
 
 USER_MODEL = 'panther.db.models.User'
 
+# # # More Info: Https://PantherPy.GitHub.io/authentications/
+AUTHENTICATION = 'panther.authentications.JWTAuthentication'
+
+# # # More Info: Https://PantherPy.GitHub.io/monitoring/
 MONITORING = True
 
+# # # More Info: Https://PantherPy.GitHub.io/log_queries/
 LOG_QUERIES = True
 
+# # # More Info: Https://PantherPy.GitHub.io/throttling/
+THROTTLING = Throttling(rate=60, duration=timedelta(minutes=1))
+
+# # # More Info: Https://PantherPy.GitHub.io/urls/
 URLs = 'core/urls.py'
 """ % datetime.now().date().isoformat()
 
-middlewares = """from panther.middlewares import BaseMiddleware
-"""
-
 env = """
 SECRET_KEY = '%s'
 
@@ -94,8 +108,9 @@ urls = {
 git_ignore = """__pycache__/
 .venv/
 .idea/
-.env
 logs/
+
+.env
 *.pantherdb
 """
 
@@ -107,11 +122,11 @@ Template = {
         'apis.py': apis_py,
         'models.py': models_py,
         'serializers.py': serializers_py,
+        'throttling.py': throttling_py,
         'urls.py': app_urls_py,
     },
     'core': {
         'configs.py': configs_py,
-        'middlewares.py': middlewares,
         'urls.py': urls_py,
     },
     'main.py': main_py,

panther/db/utils.py

@@ -26,7 +26,7 @@ def clean_object_id(_id: bson.ObjectId | str) -> bson.ObjectId:
     try:
         return bson.ObjectId(_id)
     except Exception:
-        raise bson.errors.InvalidId
+        raise bson.errors.InvalidId  # NOQA: Py Unresolved References
 
 
 def clean_object_id_in_dicts(*args):

panther/logger.py

@@ -2,8 +2,8 @@ import os
 import logging
 from pydantic import BaseModel
 
-from logging.config import dictConfig
 from panther.configs import config
+from logging.config import dictConfig
 
 
 LOGS_DIR = config['base_dir'] / 'logs'

panther/main.py

@@ -180,11 +180,10 @@ class Panther:
             if path.find('panther.middlewares.db.Middleware') != -1:
                 config['db_engine'] = data['url'].split(':')[0]
 
-            # noinspection PyPep8Naming
-            Middleware = import_class(path)
+            Middleware = import_class(path)  # NOQA: Py Pep8 Naming
             if not issubclass(Middleware, BaseMiddleware):
                 logger.critical(f'{Middleware} is not a sub class of BaseMiddleware.')
                 continue
-            # noinspection PyArgumentList
-            middlewares.append(Middleware(**data))
+
+            middlewares.append(Middleware(**data))  # NOQA: Py Argument List
         return middlewares

panther/middlewares/redis.py

@@ -20,17 +20,9 @@ class Middleware(BaseMiddleware):
             self.kwargs['host'] = '127.0.0.1'
 
     def validate_port(self):
-        if port := self.kwargs.get('port'):
-            if isinstance(port, str):
-                try:
-                    self.kwargs['port'] = int(port)
-                except ValueError:
-                    logger.critical('Redis "port" should be number')
-
-            elif not isinstance(port, int):
-                logger.critical('Redis "port" is not valid.')
-        else:
-            self.kwargs['port'] = 6379
+        port = self.kwargs.setdefault('port', 6379)
+        if not isinstance(port, int):
+            logger.critical('Redis "port" is not valid.')
 
     async def before(self, request: Request) -> Request:
         self.redis = RedisConnection(**self.kwargs)

{panther-1.7.1.dist-info → panther-1.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: panther
-Version: 1.7.1
+Version: 1.7.3
 Summary: Fast &  Friendly, Web Framework For Building Async APIs
 Home-page: https://github.com/alirn76/panther
 Author: Ali RajabNezhad
@@ -12,35 +12,41 @@ Classifier: Programming Language :: Python :: 3.11
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pantherdb (>=1.2.0)
-Requires-Dist: pydantic (>=1.10.5)
-Requires-Dist: watchfiles (>=0.18.1)
-Requires-Dist: uvicorn[standard]
 Requires-Dist: bpython (>=0.24)
 Requires-Dist: bson (>=0.5.10)
-Requires-Dist: redis (>=4.0.2)
-Requires-Dist: rich (>=13.3.1)
+Requires-Dist: httptools (>=0.5.0)
+Requires-Dist: pantherdb (>=1.2.2)
+Requires-Dist: pydantic (>=1.10.7)
+Requires-Dist: redis (>=4.5.3)
+Requires-Dist: rich (>=13.3.2)
+Requires-Dist: uvicorn (>=0.21.1)
+Requires-Dist: uvloop (>=0.17.0)
+Requires-Dist: watchfiles (>=0.18.1)
 Provides-Extra: full
 Requires-Dist: python-jose (>=3.3.0) ; extra == 'full'
 Requires-Dist: pymongo (>=4.3.3) ; extra == 'full'
 
-
 ## Panther 
 <b>Is A Fast &  Friendly, Web Framework For Building Async APIs With Python 3.11+</b> 
 
+<p align="center">
+<img src="https://github.com/AliRn76/panther/raw/master/docs/docs/images/logo.png" alt="logo" style="width: 200px">
+</p>
+
 >_Full Documentation_ -> [https://pantherpy.github.io](https://pantherpy.github.io)
 > 
 >_PyPI_ -> [https://pypi.org/project/panther/](https://pypi.org/project/panther/)
 
 ---
 
-### Features
+### Why Use Panther ?
 - Document-oriented Databases ODM ([PantherDB](https://pypi.org/project/pantherdb/), MongoDB)
 - Visual API Monitoring (In Terminal)
-- Cache APIs (In Memory, In Redis)
+- Caching for APIs (In Memory, In Redis)
 - Built-in Authentication Classes (Customizable)
 - Built-in Permission Classes (Customizable)
 - Handle Custom Middlewares
+- Handle Custom Throttling 
 ---
 
 ### Benchmark
@@ -160,13 +166,14 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
     **app/apis.py**:
     
     ```python
-    from datetime import datetime
+    from datetime import datetime, timedelta
 
     from panther.app import API
     from panther.configs import config
     from panther import version, status
     from panther.request import Request
     from panther.response import Response
+    from panther.throttling import Throttling
     
     
     @API()
@@ -174,7 +181,7 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
         return {'detail': 'Hello World'}
     
     
-    @API(cache=True)
+    @API(cache=True, throttling=Throttling(rate=5, duration=timedelta(minutes=1)))
     async def info(request: Request):
         data = {
             'version': version(),

{panther-1.7.1.dist-info → panther-1.7.3.dist-info}/RECORD

@@ -1,12 +1,12 @@
-panther/__init__.py,sha256=3AJjmWhBodf_pBho1kKI_7Pu4BOxGInDcBBKOsiXBX8,89
+panther/__init__.py,sha256=ZNlrk0ToNVSaok7NcXQHwGl68nxc1gOv0q8amPR0wKU,89
 panther/_utils.py,sha256=EC-5HJnVsUmfY9LCoauUGtRsShGJVbL0ssvYn8CRvSU,3668
-panther/app.py,sha256=vjaCkbV5SnkQPMu31ttGubyHA-NiqqVPXdebBtmOjC0,6252
+panther/app.py,sha256=gHyxMH1nQrj_JlBKfdfYAXUXB_Yc3Xka9AYd5s8rVCo,6263
 panther/authentications.py,sha256=ZOpgWzaQXy5sGgXrWY_DtfHQ55hYLYOBt-BHejIYbZM,3124
 panther/caching.py,sha256=ja7r2iNJxP6-XUuKBKAcnQQ2s72XYRPpAnbV-YMobxE,2382
 panther/configs.py,sha256=HZuLA4UvJGfBB8PUDuKjOkyKS0EAvZZBVcw5epEYKnQ,1076
 panther/exceptions.py,sha256=hXwV0NQSNZZxMtbzDHKIC2363AWMSyFPIHb-DqU2SLw,1150
-panther/logger.py,sha256=1skaZg4w55mTh4pSrCohkGp-7dg62lyEIoFAJKMP5L8,2499
-panther/main.py,sha256=LwOuvKJ0utK-Zfhs9k-m19AeQKIfsHy5FUZjJQy_v1s,7866
+panther/logger.py,sha256=FjOG9CNj-Sqo-pCEy-T3019R8oswA44r8W6g9WE0zok,2499
+panther/main.py,sha256=AmCFA3mH-70arhzirk3CLS4qB7i-ANK_5cHWvCMSA9o,7835
 panther/permissions.py,sha256=iKKUNbYH6GKCgS0Au1ildsDsW_gGOs_XlaYiZBtaR-s,383
 panther/request.py,sha256=BjpsE_u9uMjG1F1FFHa32LhdhxN7Jlv2rqJg3CiCgh0,4382
 panther/response.py,sha256=h57bWRGR8neKxKyfcoi1w3hKIVWjDCrC3zgMr4pf4bg,1592
@@ -17,14 +17,14 @@ panther/utils.py,sha256=8RyLF4zOf8OQkwf-n2n2RwYFr-mR_rg12tVli1pAhHI,947
 panther/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 panther/cli/create_command.py,sha256=F472b-4WH5vC7ZkvZ1qp3MHPr_j5BMM-Zdy2pAllFLI,2910
 panther/cli/main.py,sha256=spotgTcfXquc07Sx4tdFpxdLJG2vcYJRpTyZZ9Up0sM,739
-panther/cli/monitor_command.py,sha256=7A76Yya761mkmDB2Rqp_vIAPgtflBaDfn1kAYtmHqu0,2470
+panther/cli/monitor_command.py,sha256=ahInyna59bWW0LhIfI-CLoE8BKFFApLK9OtKR71vk4o,2076
 panther/cli/run_command.py,sha256=qpK2Bxe2_tyNppGmhhP1LRKDBVmTdlbZHlSNGAI33Jo,1509
-panther/cli/template.py,sha256=GA2DpYU2GvmzJqB0tGJ62Eo-CEVs76MVx-bliJMFdtE,2313
+panther/cli/template.py,sha256=S9Q89WIyWqoBvA6izyBYIsLtBWZjG9XznLTxoZQbe8k,2974
 panther/cli/utils.py,sha256=rpjSK0T0-0m_UxAnYGPl0-zJ0fVlxmIFRYqhLAddBcY,8539
 panther/db/__init__.py,sha256=0mo9HwD_JAjJ-kRudbZqWNgzSxJ2t0ewh7Pa-83FhPY,50
 panther/db/connection.py,sha256=jQkY-JJu4LMHUau8-G6AQzlODwzESkghcLALe6wsR4g,2207
 panther/db/models.py,sha256=1s2F2STMLvqZoZGw_oqy_hrWk-T-wM_yKQT1odfrci8,1020
-panther/db/utils.py,sha256=Z9qG6zncy6TrkQYuTxh7TkPIVBb0Rr2x7g-upp9-bMw,1255
+panther/db/utils.py,sha256=Axf7XvkHCr-Ky7c9CJPpQbqgf9kWgW_gVdTqbQlZc94,1289
 panther/db/queries/__init__.py,sha256=BMffHS9RbHE-AUAeT9C5uY3L-hpDh0WGRduDUQ9Kpuc,41
 panther/db/queries/mongodb_queries.py,sha256=uXd81Q2ukJskFDYlNfOiuCCkHuH7URyfZMkD6MUiVkk,3205
 panther/db/queries/pantherdb_queries.py,sha256=Ee3Kb5WIGQ-ZDeAYFHYx_Y34f-I0RgLT0XYFEof5FLM,2505
@@ -33,10 +33,10 @@ panther/middlewares/__init__.py,sha256=7RtHuS-MfybnJc6pcBSGhi9teXNhDsnJ3n7h_cXSk
 panther/middlewares/base.py,sha256=Php29ckITeGZm6GfauFG3i61bcsb4qoU8RpPLTqsfls,240
 panther/middlewares/db.py,sha256=C_PevTIaMykJl0NaaMYEfwE_oLdSLfKW2HR9UoPN1dU,508
 panther/middlewares/monitoring.py,sha256=oRFRGRNuoBOkGd46VYsXpRHRIklSuSglfuy574kHM4Y,863
-panther/middlewares/redis.py,sha256=bmKPDUH3Bs1ax-gYd7QX91KnvxROKAnuihvUlPqsNRI,1317
-panther-1.7.1.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
-panther-1.7.1.dist-info/METADATA,sha256=Ry2z4ZATzoAD3W2H0anrtPGxkBSHQSBfDrdQ8jCzuy0,5160
-panther-1.7.1.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-panther-1.7.1.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
-panther-1.7.1.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
-panther-1.7.1.dist-info/RECORD,,
+panther/middlewares/redis.py,sha256=m_a0QPqUP_OJyuDJtRxCQpn5m_DLdrDIVHHFcytQmAU,1046
+panther-1.7.3.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
+panther-1.7.3.dist-info/METADATA,sha256=4GHwPbXf3VMfZCuJFO_pmTGsp8MYI69hFL2oZQarkVo,5531
+panther-1.7.3.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+panther-1.7.3.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
+panther-1.7.3.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
+panther-1.7.3.dist-info/RECORD,,