panther 1.3.1__py3-none-any.whl → 1.4.0__py3-none-any.whl

panther/__init__.py

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

panther/authentications.py

@@ -49,10 +49,11 @@ class JWTAuthentication:
         if user_id := payload.get('user_id') is None:
             raise AuthenticationException
         user_model = config['user_model'] or cls.model
-        user = user_model.get_one(id=user_id)
-        if user is None:
-            raise AuthenticationException
-        return user
+
+        if user := user_model.get_one(id=user_id):
+            return user
+
+        raise AuthenticationException
 
     @staticmethod
     def encode_jwt(user_id: int) -> str:

panther/cli/template.py

@@ -65,6 +65,8 @@ USER_MODEL = 'panther.db.models.User'
 
 MONITORING = True
 
+LOG_QUERIES = True
+
 URLs = 'core/urls.py'
 """ % datetime.now().date().isoformat()
 

panther/configs.py

@@ -15,6 +15,7 @@ class JWTConfig:
 class Config(TypedDict):
     base_dir: Path
     monitoring: bool
+    log_queries: bool
     urls: dict
     middlewares: list
     reversed_middlewares: list
@@ -28,7 +29,8 @@ class Config(TypedDict):
 
 config: Config = {
     'base_dir': Path(),
-    'monitoring': True,
+    'monitoring': False,
+    'log_queries': False,
     'secret_key': None,
     'urls': {},
     'middlewares': [],

panther/db/queries/mongodb_queries.py

@@ -3,7 +3,7 @@ from typing import TypeVar
 import bson
 
 from panther.db.connection import db  # NOQA: F401
-from panther.db.utils import clean_object_id_in_dicts, merge_dicts, query_logger
+from panther.db.utils import clean_object_id_in_dicts, merge_dicts, log_query
 
 # TODO: Not sure about this bounding
 T = TypeVar('T', bound='BaseMongoDBQuery')
@@ -12,7 +12,6 @@ T = TypeVar('T', bound='BaseMongoDBQuery')
 class BaseMongoDBQuery:
 
     @classmethod
-    @query_logger
     def get_one(cls: type[T], _data: dict = None, /, **kwargs) -> T:
         clean_object_id_in_dicts(_data, kwargs)
         _query = merge_dicts(_data, kwargs)
@@ -20,14 +19,12 @@ class BaseMongoDBQuery:
         return cls(**obj) if obj else None
 
     @classmethod
-    @query_logger
     def count(cls, _data: dict = None, /, **kwargs) -> int:
         clean_object_id_in_dicts(_data, kwargs)
         _query = merge_dicts(_data, kwargs)
         return eval(f'db.session.{cls.__name__}.count_documents(_query)')
 
     @classmethod
-    @query_logger
     def list(cls, _data: dict = None, /, **kwargs):
         clean_object_id_in_dicts(_data, kwargs)
         _query = merge_dicts(_data, kwargs)
@@ -35,32 +32,27 @@ class BaseMongoDBQuery:
         return [cls(**obj) for obj in result]
 
     @classmethod
-    @query_logger
     def create(cls, _data: dict = None, **kwargs) -> bson.objectid.ObjectId:
         _query = merge_dicts(_data, kwargs)
         return eval(f'db.session.{cls.__name__}.insert_one(_query)').inserted_id
 
-    @query_logger
     def delete(self) -> bool:
         _filter = {'_id': self._id}
         result = eval(f'db.session.{self.__class__.__name__}.delete_one(_filter)')
         return bool(result.deleted_count)
 
     @classmethod
-    @query_logger
     def delete_one(cls, **kwargs) -> bool:
         clean_object_id_in_dicts(kwargs)
         result = eval(f'db.session.{cls.__name__}.delete_one(kwargs)')
         return bool(result.deleted_count)
 
     @classmethod
-    @query_logger
     def delete_many(cls, **kwargs) -> int:
         clean_object_id_in_dicts(kwargs)
         result = eval(f'db.session.{cls.__name__}.delete_many(kwargs)')
         return result.deleted_count
 
-    @query_logger
     def update(self, _data: dict = None, **kwargs) -> dict:
         for field, value in (_data or kwargs).items():
             if hasattr(self, field):
@@ -70,7 +62,6 @@ class BaseMongoDBQuery:
         return eval(f'db.session.{self.__class__.__name__}.update_one(_filter, _update)')
 
     @classmethod
-    @query_logger
     def update_one(cls, _filter, _data: dict = None, /, **kwargs) -> dict:
         clean_object_id_in_dicts(_filter)
 
@@ -81,19 +72,16 @@ class BaseMongoDBQuery:
         return eval(f'db.session.{cls.__name__}.update_one(_filter, _data | _update)')
 
     @classmethod
-    @query_logger
     def update_many(cls, _filter, **kwargs) -> dict:
         _update = {'$set': kwargs}
         return eval(f'db.session.{cls.__name__}.update_many(_filter, _update)')
 
     @classmethod
-    @query_logger
     def increment(cls, _filter, **kwargs):
         _update = {'$inc': kwargs}
         return eval(f'db.session.{cls.__name__}.update_many({_filter}, {_update})')
 
     @classmethod
-    @query_logger
     def get_or_create(cls, **kwargs) -> tuple[bool, any]:
         obj = cls.get_one(**kwargs)
         if obj:

panther/db/queries/pantherdb_queries.py

@@ -1,9 +1,8 @@
-import operator
-from functools import reduce
 from typing import Self
 from pydantic import ValidationError
 
 from panther.db.connection import db
+from panther.db.utils import merge_dicts
 from panther.exceptions import DBException
 
 
@@ -32,7 +31,7 @@ class BasePantherDBQuery:
     @classmethod
     def _merge(cls, *args) -> dict:
         # TODO: Convert "id" to "_id"
-        return reduce(operator.ior, filter(None, args), {})
+        return merge_dicts(*args)
 
     # # # # # Find # # # # #
     @classmethod

panther/db/queries/queries.py

@@ -1,8 +1,9 @@
 from typing import Self
 
+from panther.configs import config
+from panther.db.utils import log_query
 from panther.db.queries.mongodb_queries import BaseMongoDBQuery
 from panther.db.queries.pantherdb_queries import BasePantherDBQuery
-from panther.configs import config
 
 if config['db_engine'] == 'pantherdb':
     BaseQuery = BasePantherDBQuery
@@ -18,6 +19,7 @@ class Query(BaseQuery):
 
     # # # # # Find # # # # #
     @classmethod
+    @log_query
     def find_one(cls, _data: dict = None, /, **kwargs) -> Self | None:
         """
         example:
@@ -27,6 +29,7 @@ class Query(BaseQuery):
         return super().find_one(_data, **kwargs)
 
     @classmethod
+    @log_query
     def find(cls, _data: dict = None, /, **kwargs) -> list[Self]:
         """
         example:
@@ -37,6 +40,7 @@ class Query(BaseQuery):
 
     # # # # # Insert # # # # #
     @classmethod
+    @log_query
     def insert_one(cls, _data: dict = None, /, **kwargs) -> Self:
         """
         example:
@@ -46,10 +50,12 @@ class Query(BaseQuery):
         return super().insert_one(_data, **kwargs)
 
     @classmethod
+    @log_query
     def insert_many(cls, _data: dict = None, **kwargs):
         return super().insert_many(_data, **kwargs)
 
     # # # # # Delete # # # # #
+    @log_query
     def delete(self) -> None:
         """
         example:
@@ -60,6 +66,7 @@ class Query(BaseQuery):
         return super().delete()
 
     @classmethod
+    @log_query
     def delete_one(cls, **kwargs) -> bool:
         """
         example:
@@ -69,6 +76,7 @@ class Query(BaseQuery):
         return super().delete_one(**kwargs)
 
     @classmethod
+    @log_query
     def delete_many(cls, **kwargs) -> int:
         """
         example:
@@ -78,6 +86,7 @@ class Query(BaseQuery):
         return super().delete_many(**kwargs)
 
     # # # # # Update # # # # #
+    @log_query
     def update(self, **kwargs) -> None:
         """
         example:
@@ -88,6 +97,7 @@ class Query(BaseQuery):
         return super().update(**kwargs)
 
     @classmethod
+    @log_query
     def update_one(cls, _filter, _data: dict = None, /, **kwargs) -> bool:
         """
         example:
@@ -98,6 +108,7 @@ class Query(BaseQuery):
         return super().update_one(_filter, _data, **kwargs)
 
     @classmethod
+    @log_query
     def update_many(cls, _filter, **kwargs) -> int:
         """
         example:
@@ -108,6 +119,7 @@ class Query(BaseQuery):
 
     # # # # # Other # # # # #
     @classmethod
+    @log_query
     def first(cls, _data: dict = None, /, **kwargs) -> Self | None:
         """
         It works same as find_one()
@@ -118,6 +130,7 @@ class Query(BaseQuery):
         return super().first(_data, **kwargs)
 
     @classmethod
+    @log_query
     def last(cls, _data: dict = None, /, **kwargs) -> Self | None:
         """
         example:
@@ -127,6 +140,7 @@ class Query(BaseQuery):
         return super().last(_data, **kwargs)
 
     @classmethod
+    @log_query
     def count(cls, _data: dict = None, /, **kwargs) -> int:
         """
         example:

panther/db/utils.py

@@ -4,18 +4,18 @@ from functools import reduce
 from time import perf_counter
 
 from panther.configs import config
-from panther.logger import logger
+from panther.logger import query_logger
 
 
-def query_logger(func):
+def log_query(func):
     def log(*args, **kwargs):
-        if config['monitoring'] is False:
+        if config['log_queries'] is False:
             return func(*args, **kwargs)
         start = perf_counter()
         response = func(*args, **kwargs)
         end = perf_counter()
         class_name = args[0].__name__ if hasattr(args[0], '__name__') else args[0].__class__.__name__
-        logger.info(f'\033[1mQuery -->\033[0m  {class_name}.{func.__name__}() --> {(end - start) * 1_000:.2} ms')
+        query_logger.info(f'\033[1mQuery -->\033[0m  {class_name}.{func.__name__}() --> {(end - start) * 1_000:.2} ms')
         return response
     return log
 

panther/logger.py

@@ -1,14 +1,6 @@
 import os
 import logging
 from pydantic import BaseModel
-from panther.cli.utils import error
-
-try:
-    import uvicorn
-    del uvicorn
-except ImportError:
-    error('No module named "uvicorn"\n\nHint: Try to install with "pip install uvicorn[standard]"')
-    exit()
 
 from logging.config import dictConfig
 from panther.configs import config
@@ -26,6 +18,7 @@ class LogConfig(BaseModel):
     DEFAULT_LOG_FORMAT: str = '%(levelprefix)s | %(asctime)s | %(message)s'
     FILE_LOG_FORMAT: str = '%(asctime)s | %(message)s'
     LOG_LEVEL: str = 'DEBUG'
+    MAX_FILE_SIZE: int = 1024 * 1024 * 100  # 100 MB
 
     version = 1
     disable_existing_loggers = False
@@ -47,15 +40,21 @@ class LogConfig(BaseModel):
             'formatter': 'file_formatter',
             'filename': LOGS_DIR / 'monitoring.log',
             'class': 'logging.handlers.RotatingFileHandler',
-            'maxBytes': 1024 * 1024 * 100,  # 100 MB,
+            'maxBytes': MAX_FILE_SIZE,  # 100 MB,
+            'backupCount': 3,
+        },
+        'query_file': {
+            'formatter': 'file_formatter',
+            'filename': LOGS_DIR / 'query.log',
+            'class': 'logging.handlers.RotatingFileHandler',
+            'maxBytes': MAX_FILE_SIZE,  # 100 MB,
             'backupCount': 3,
         },
         'file': {
             'formatter': 'file_formatter',
-            # TODO: Don't know but base_dir.name will return '.' here :\
-            'filename': LOGS_DIR / f'{config["base_dir"].name}.log',
+            'filename': LOGS_DIR / f'main.log',
             'class': 'logging.handlers.RotatingFileHandler',
-            'maxBytes': 1024 * 1024 * 100,  # 100 MB,
+            'maxBytes': MAX_FILE_SIZE,  # 100 MB,
             'backupCount': 3,
         },
         'default': {
@@ -73,13 +72,14 @@ class LogConfig(BaseModel):
             'handlers': ['monitoring_file'],
             'level': LOG_LEVEL,
         },
+        'query': {
+            'handlers': ['default', 'query_file'],
+            'level': LOG_LEVEL,
+        },
     }
 
 
 dictConfig(LogConfig().dict())
 logger = logging.getLogger('panther')
-monitoring = logging.getLogger('monitoring')
-
-"""
-[debug, info, warning, error, critical]
-"""
+query_logger = logging.getLogger('query')
+monitoring_logger = logging.getLogger('monitoring')

panther/main.py

@@ -117,6 +117,7 @@ class Panther:
 
         # Put Variables In "config"
         config['monitoring'] = self.settings.get('MONITORING', config['monitoring'])
+        config['log_queries'] = self.settings.get('LOG_QUERIES', config['log_queries'])
         config['default_cache_exp'] = self.settings.get('DEFAULT_CACHE_EXP', config['default_cache_exp'])
         config['secret_key'] = self._get_secret_key()
 

panther/middlewares/monitoring.py

@@ -1,8 +1,8 @@
 from time import perf_counter
 
-from panther.logger import monitoring
-from panther.middlewares.base import BaseMiddleware
 from panther.request import Request
+from panther.logger import monitoring_logger
+from panther.middlewares.base import BaseMiddleware
 
 
 class Middleware(BaseMiddleware):
@@ -21,4 +21,4 @@ class Middleware(BaseMiddleware):
         but we should put in middlewares chain later ...
         """
         response_time = (perf_counter() - self.start_time) * 1_000
-        monitoring.info(f'{self.log} | {response_time: .3} ms | {status_code}')
+        monitoring_logger.info(f'{self.log} | {response_time: .3} ms | {status_code}')

{panther-1.3.1.dist-info → panther-1.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: panther
-Version: 1.3.1
+Version: 1.4.0
 Summary: Fast &  Friendly, Web Framework For Building Async APIs
 Home-page: https://github.com/alirn76/panther
 Author: Ali RajabNezhad
@@ -14,7 +14,7 @@ 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 (==0.20.0)
 Requires-Dist: bpython (>=0.24)
 Requires-Dist: bson (>=0.5.10)
 Requires-Dist: redis (>=4.0.2)
@@ -102,14 +102,10 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
     ```
 
 - #### Run Project
-  Panther needs Uvicorn as ASGI (Asynchronous Server Gateway Interface)
-  ```console
-  $ pip install uvicorn[standard]
-  ```
-  Then
-  ```console
-  $ panther run 
-  ```
+    Panther Uses [Uvicorn](https://github.com/encode/uvicorn) as ASGI (Asynchronous Server Gateway Interface)
+    ```console
+    $ panther run 
+    ```
 
 - #### Monitoring Requests
 
@@ -118,7 +114,7 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
     ```
 
 - #### Python Shell
- 
+    Panther Uses [bpython](https://bpython-interpreter.org) for shell
     ```console
     $ panther shell 
     ```
@@ -163,7 +159,7 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
     **app/apis.py**:
     
     ```python
-    from datetime import timedelta, datetime
+    from datetime import datetime
 
     from panther.app import API
     from panther.configs import config
@@ -177,15 +173,13 @@ with [https://github.com/nakabonne/ali](https://github.com/nakabonne/ali) and he
         return {'detail': 'Hello World'}
     
     
-    @API(cache=True, cache_exp_time=timedelta(minutes=2))
+    @API(cache=True)
     async def info(request: Request):
         data = {
             'version': version(),
             'datetime_now': datetime.now().isoformat(),
             'user_agent': request.headers.user_agent,
-            'middlewares': config['middlewares'],
             'db_engine': config['db_engine'],
-            'urls': config['urls'],
         }
         return Response(data=data, status_code=status.HTTP_202_ACCEPTED)
     ```

{panther-1.3.1.dist-info → panther-1.4.0.dist-info}/RECORD

@@ -1,12 +1,12 @@
-panther/__init__.py,sha256=HJY_lGJ4RIHIDpgZQAwMSnNG9SuUyeAKe9qT7MmjC4U,89
+panther/__init__.py,sha256=ViOJcmBWhbt9e0b1kOj-Y3RfqE4-sRmE9jJ0CwqE-FM,89
 panther/_utils.py,sha256=Ltev6PCrTWHTWSQcWNfHMWDof1_MXODTAcDaGwflgXo,3667
 panther/app.py,sha256=tojfQaU8x5pZa7m8XS4m9fR7D5sIe_-d96hD2ccBINo,5469
-panther/authentications.py,sha256=BvuvR8oPNs1TcAWxOAqLYcK3KFcQDKZZtbLAcYGwtPI,2368
+panther/authentications.py,sha256=FCRQL3xqN1Tla2vZsOY8-qXwPhnZBFsujJ-R7CeaW7w,2350
 panther/caching.py,sha256=qCqb-IaXD1T7VU0AzJVMoXawb366ZYob9kblDUT-7sM,2452
-panther/configs.py,sha256=UU2ePtjM0dT6C1p63l0EE9w0FPCDpUTOHbDPOkFHJRM,926
+panther/configs.py,sha256=bRGRy772Rxjb3RunEBBvfa9LCNCmgcc2TKkfbNTK0GM,975
 panther/exceptions.py,sha256=c1MeSo7_uwDuqoBcjKTFyXz17uXP5iZ3bM0Sp5Stvhw,769
-panther/logger.py,sha256=S-Q8fCPKGhQm1BAA1t1EF6GT9FVnYaFeqH-1Pka4IFs,2376
-panther/main.py,sha256=oQu4v_c8Iip1TrXmRtxHx7j4qYiYrNimMoAXMicOZ9g,7372
+panther/logger.py,sha256=1skaZg4w55mTh4pSrCohkGp-7dg62lyEIoFAJKMP5L8,2499
+panther/main.py,sha256=Aa43X3ZEonPrJ4Mj5ACEyGmJl-BbsHcPyKj3fDe2E4k,7460
 panther/request.py,sha256=Ix1podGHCU5NlUCT9Emc79GOITKEw623ldpTw3oZm68,4383
 panther/response.py,sha256=zzfe8vsPSnydN-_peJTizlnmnawxlNbJFU9zvXppYTk,1025
 panther/routings.py,sha256=sV3xWksKYb3_95BTDOtSqouroHkB98ExoNkgWT1t7jE,4422
@@ -17,24 +17,24 @@ panther/cli/create_command.py,sha256=cUPMzXJnwsa2J1eGetWYUnbEL5GEEe5x-_wG3fA3rLg
 panther/cli/main.py,sha256=TttHOr0jA2rkLxCCtpW3ES9x4dDpq5AS32dMN0VwoW0,891
 panther/cli/monitor_command.py,sha256=wR6Ti8-2-LuLhfPzdXH77g7xlNQAL5flpBoVwu9qdoE,2458
 panther/cli/run_command.py,sha256=SdguosH7Orlh-8x8eZK_EWrv8MPnXFKzqxruTHYdHqk,1501
-panther/cli/template.py,sha256=XssIjmb98tECumKC0wqE4b61_tpzFi9TXv6jzGtrlFg,2297
+panther/cli/template.py,sha256=KhehW5nzovQzbW75J1lpAAQcIsqucqU4IXQXpVWBj5M,2317
 panther/cli/utils.py,sha256=QKQ5_qLWtTjpLY0lZ6yt2vDlc2H0jF6HFe3F-8YNJDg,8225
 panther/db/__init__.py,sha256=lOgqqRkGMzMSS1WS8D7lTChTr9ikIB5ImRPmucOhCyc,54
 panther/db/connection.py,sha256=BoqTetHcWn2cmjo1ELDoFFGkGlvJw6qDuBorKSe8ru0,2097
 panther/db/models.py,sha256=vnhFtVONqhCkTkFMOSz_rTDmAAxNcegPoxk1p5SljLc,1028
-panther/db/utils.py,sha256=ed_wCy8tga6CLgGjUDe-GZvXZzVrLoUxPQukJvhrdo4,1209
+panther/db/utils.py,sha256=6ndrZ9reaVTqnbFhX8MjOYtcrcPSY7UywAbDquY4eEg,1219
 panther/db/queries/__init__.py,sha256=BMffHS9RbHE-AUAeT9C5uY3L-hpDh0WGRduDUQ9Kpuc,41
-panther/db/queries/mongodb_queries.py,sha256=CHum1VDxVHt9fqa97CCvOijxSEWycEDiibcuoq0mJow,3447
-panther/db/queries/pantherdb_queries.py,sha256=FjmRILq2hPAuK_NSaJ6UuCqLhUSIfH9sVoG7BsKk_hw,3864
-panther/db/queries/queries.py,sha256=dVjp-P5z6fgIj0jrKW2C2GHQE3Wlx_6IRvgpsg6zH6A,3900
+panther/db/queries/mongodb_queries.py,sha256=qFW1tsxnyh459rFOOD-jPTZwhDFh6q6qSttA_a4ryaw,3228
+panther/db/queries/pantherdb_queries.py,sha256=CEKxBcFZo4PmcleE87Jw1PrujtOB-emd20mqzHI1IKw,3834
+panther/db/queries/queries.py,sha256=yG5B_qg4cNL8nDkeJtJ0RRj4EH5dEMC-2jNIk4I1eS0,4134
 panther/middlewares/__init__.py,sha256=7RtHuS-MfybnJc6pcBSGhi9teXNhDsnJ3n7h_cXSkJk,66
 panther/middlewares/base.py,sha256=Php29ckITeGZm6GfauFG3i61bcsb4qoU8RpPLTqsfls,240
 panther/middlewares/db.py,sha256=C_PevTIaMykJl0NaaMYEfwE_oLdSLfKW2HR9UoPN1dU,508
-panther/middlewares/monitoring.py,sha256=WpB_DGPBLC0OSOHCFkFc5R3FlO6PTZ83C-px1Frm254,838
+panther/middlewares/monitoring.py,sha256=CbGNJ4Ja-m9Wq3Ytv7RFyd-Qj9Ft6cYqBZZncCAxccs,852
 panther/middlewares/redis.py,sha256=_XIvPAOrVl74UoiA6-Xz8hSfWoeuM2Y1e74xeyvW0I4,1126
-panther-1.3.1.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
-panther-1.3.1.dist-info/METADATA,sha256=5B12zrA7yBo3oDrw43gFRIGCQ7Z-HumBS0k5AaW09m4,5209
-panther-1.3.1.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-panther-1.3.1.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
-panther-1.3.1.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
-panther-1.3.1.dist-info/RECORD,,
+panther-1.4.0.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
+panther-1.4.0.dist-info/METADATA,sha256=AnzClL3p1FGVv2WWYBoSfJdMrIG3If4tq43T4zXx_Sk,5124
+panther-1.4.0.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
+panther-1.4.0.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
+panther-1.4.0.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
+panther-1.4.0.dist-info/RECORD,,