panther 4.2.3__py3-none-any.whl → 4.2.5__py3-none-any.whl

panther/__init__.py

@@ -1,6 +1,6 @@
 from panther.main import Panther  # noqa: F401
 
-__version__ = '4.2.3'
+__version__ = '4.2.5'
 
 
 def version():

panther/cli/utils.py

@@ -142,7 +142,7 @@ def print_info(config: Config):
     if config.HAS_WS:
         try:
             import gunicorn
-            gunicorn_msg = f'{h} * You have WS so make sure to run gunicorn with --preload{h}\n'
+            gunicorn_msg = f'{h} * You have WS, so make sure to run gunicorn with --preload{h}\n'
         except ImportError:
             pass
 

panther/db/connections.py

@@ -75,7 +75,7 @@ class MongoDBConnection(BaseDatabaseConnection):
 
 class PantherDBConnection(BaseDatabaseConnection):
     def init(self, path: str | None = None, encryption: bool = False):
-        params = {'db_name': str(path), 'return_dict': True, 'return_cursor': True}
+        params = {'db_name': path, 'return_dict': True, 'return_cursor': True}
         if encryption:
             try:
                 import cryptography

panther/db/queries/mongodb_queries.py

@@ -114,6 +114,8 @@ class BaseMongoDBQuery(BaseQuery):
             else:
                 update_query['$set'] = update_query.get('$set', {})
                 update_query['$set'][field] = value
+                if isinstance(value, dict):
+                    value = type(getattr(self, field))(**value)
                 setattr(self, field, value)
 
         await db.session[self.__class__.__name__].update_one({'_id': self._id}, update_query)

panther/db/queries/pantherdb_queries.py

@@ -96,6 +96,8 @@ class BasePantherDBQuery(BaseQuery):
         self._validate_data(data=kwargs, is_updating=True)
 
         for field, value in document.items():
+            if isinstance(value, dict):
+                value = type(getattr(self, field))(**value)
             setattr(self, field, value)
         db.session.collection(self.__class__.__name__).update_one({'_id': self._id}, **document)
 

panther/db/queries/queries.py

@@ -2,6 +2,7 @@ import sys
 from typing import Sequence, Iterable
 
 from pantherdb import Cursor as PantherDBCursor
+from pydantic import BaseModel
 
 from panther.configs import QueryObservable
 from panther.db.cursor import Cursor
@@ -364,6 +365,26 @@ class Query(BaseQuery):
 
         raise NotFoundAPIError(detail=f'{cls.__name__} Does Not Exist')
 
+    @classmethod
+    async def exists(cls, _filter: dict | None = None, /, **kwargs) -> bool:
+        """
+        Check if document exists in collection or not
+
+        Example:
+        -------
+            >>> from app.models import User
+
+            >>> await User.exists(age=18, name='Ali')
+            or
+            >>> await User.exists({'age': 18, 'name': 'Ali'})
+            or
+            >>> await User.exists({'age': 18}, name='Ali')
+        """
+        if await cls.count(_filter, **kwargs) > 0:
+            return True
+        else:
+            return False
+
     async def save(self) -> None:
         """
         Save the document
@@ -382,7 +403,12 @@ class Query(BaseQuery):
             >>> user = User(name='Ali')
             >>> await user.save()
         """
-        document = {field: getattr(self, field) for field in self.model_fields_set if field != 'request'}
+        document = {
+            field: getattr(self, field).model_dump()
+            if issubclass(type(getattr(self, field)), BaseModel)
+            else getattr(self, field)
+            for field in self.model_fields_set if field != 'request'
+        }
 
         if self.id:
             await self.update(document)

panther/logging.py

@@ -64,10 +64,5 @@ LOGGING = {
             'handlers': ['default', 'query_file'],
             'level': 'DEBUG',
         },
-        'uvicorn.error': {
-            'handlers': ['default'],
-            'level': 'INFO',
-            'propagate': False,
-        },
     }
 }

panther/utils.py

@@ -50,6 +50,20 @@ def generate_secret_key() -> str:
 
 
 def round_datetime(dt: datetime, delta: timedelta):
+    """
+    Example:
+        >>> round_datetime(datetime(2024, 7, 15, 13, 22, 11, 562159), timedelta(days=2))
+        datetime.datetime(2024, 7, 16, 0, 0)
+
+        >>> round_datetime(datetime(2024, 7, 16, 13, 22, 11, 562159), timedelta(days=2))
+        datetime.datetime(2024, 7, 16, 0, 0)
+
+        >>> round_datetime(datetime(2024, 7, 17, 13, 22, 11, 562159), timedelta(days=2))
+        datetime.datetime(2024, 7, 18, 0, 0)
+
+        >>> round_datetime(datetime(2024, 7, 18, 13, 22, 11, 562159), timedelta(days=2))
+        datetime.datetime(2024, 7, 18, 0, 0)
+    """
     return datetime.min + round((dt - datetime.min) / delta) * delta
 
 

panther/websocket.py

@@ -27,6 +27,12 @@ class GenericWebsocket(Websocket):
         """
         return await super().send(data=data)
 
+    async def close(self, code: int = status.WS_1000_NORMAL_CLOSURE, reason: str = ''):
+        """
+        Called whenever server or client, wants to close the connection
+        """
+        return await super().close(code=code, reason=reason)
+
 
 async def send_message_to_websocket(connection_id: str, data: any):
     await config.WEBSOCKET_CONNECTIONS.publish(connection_id=connection_id, action='send', data=data)

{panther-4.2.3.dist-info → panther-4.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: panther
-Version: 4.2.3
+Version: 4.2.5
 Summary: Fast &  Friendly, Web Framework For Building Async APIs
 Home-page: https://github.com/alirn76/panther
 Author: Ali RajabNezhad

{panther-4.2.3.dist-info → panther-4.2.5.dist-info}/RECORD

@@ -1,4 +1,4 @@
-panther/__init__.py,sha256=Nnh-BbkFDE8VPq-rwqN77nqyR2APRJ19ZXjzrBrNX6c,110
+panther/__init__.py,sha256=zgKwp0ZZMtz_3Ih_Rd9y7QJinvbePp_Lp5OSfG9pUoM,110
 panther/_load_configs.py,sha256=AVkoixkUFkBQiTmrLrwCmg0eiPW2U_Uw2EGNEGQRfnI,9281
 panther/_utils.py,sha256=j0rwIxTf0rtcZAAD-1nGE-_bWpvinyKtnwt3uO0hMmY,4330
 panther/app.py,sha256=e2eb4sXIaBje5vpcm4pbvvEO_sj83pLfBHCIZJFFX38,8222
@@ -12,7 +12,7 @@ panther/events.py,sha256=bxDqrfiNNBlvD03vEk2LDK4xbMzTMFVcgAjx2ein7mI,1158
 panther/exceptions.py,sha256=7rHdJIES2__kqOStIqbHl3Uxask2lzKgLQlkZvvDwFA,1591
 panther/file_handler.py,sha256=I94tpbtTVniBnnUMkFr3Eis6kPDt8sLzS5u8TzFrR5I,1323
 panther/generics.py,sha256=D2ia7M4ML15kMZiuCIMpL7ZfQhMmKpqE4wCmuRE-q4Y,7233
-panther/logging.py,sha256=k__vzvSrPpr1IsA4OLrBt1JHuRUBXr7ekPlBW0-9rbM,2209
+panther/logging.py,sha256=SGgF9faQM1QmbmMPVc6m1DY-TbV329kTD8BuzGLx3I0,2073
 panther/main.py,sha256=UbIxwaojvY_vH9nYfBpkulRBqVEj4Lbl81Er4XW_KCY,9334
 panther/monitoring.py,sha256=y1F3c8FJlnmooM-m1nSyOTa9eWq0v1nHnmw9zz-4Kls,1314
 panther/pagination.py,sha256=ANJrEF0q1nVAfD33I4nZfUUxFcETzJb01gIhbZX3HEw,1639
@@ -24,34 +24,34 @@ panther/serializer.py,sha256=UX-cVS-11KnxijUhPXsBs_Pb-Sm3EVzUQFTf9bFQT0A,9096
 panther/status.py,sha256=Gc_PnYrHfInTsZpGbqiCfDB-py1C7Rh8KMdb6Lq9Exs,3346
 panther/test.py,sha256=RsQtP5IURLWR__BihOjruWoX3NscmGDqDqj1CfAb3bI,7037
 panther/throttling.py,sha256=mVa_mGv6w_Ad7LLtV4eG5QpDwwNsk4QjFFi0mIHQBnE,231
-panther/utils.py,sha256=Iq5q1suIgBBQGO5UctwR4HXs8E6zclXNh5lYc8k1Vjg,3409
-panther/websocket.py,sha256=5WLw--Oa-6kGYbeRvO79hjbd0ARFcTTF40-hO_bdjmQ,1206
+panther/utils.py,sha256=6ZkHWm4FniOv-Hufknq2tVclrfIbxyzCL-gDlx6uNaQ,3977
+panther/websocket.py,sha256=YRWgc_FUrv94-dnM2nm41EDgCsqZHxQ1N53Gma7c9s0,1452
 panther/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 panther/cli/create_command.py,sha256=mT5GFzsTYZbzqShNHlw_UIkMcWLw9btm2mTwcg7TlfI,10292
 panther/cli/main.py,sha256=pCqnOTazgMhTvFHTugutIsiFXueU5kx2VmGngwAl54Q,1679
 panther/cli/monitor_command.py,sha256=sbnxQOSy0Q6GB-ELrfyoY6S-ZwgbI7eZyKx7YkvrEas,3383
 panther/cli/run_command.py,sha256=yWcDoWC-c4ph4M5EDj0jvR9xSjh-apG5r6-NpDdArUo,2195
 panther/cli/template.py,sha256=hVkY1A3HZDVGEZzRkMtYte6FagKGTAxoFeG0wot7Zn4,5320
-panther/cli/utils.py,sha256=Jd4YQ9H6lapVktl7ZmiORt30WVmKI85xcwsY-fMRq3c,5289
+panther/cli/utils.py,sha256=g_Xkvh_GCFrc3Remgp02lVi3YkmCAvcNKuAY_QvBTLI,5290
 panther/db/__init__.py,sha256=w9lEL0vRqb18Qx_iUJipUR_fi5GQ5uVX0DWycx14x08,50
-panther/db/connections.py,sha256=rps48Ic2r3SV2HD3df1OU7C4Pv8j98PVXU1O_FqF9Ak,4210
+panther/db/connections.py,sha256=8QHQ_tmni4gfLHQCR7jmBFfvFgJCOrTQXdQiDRJRuv0,4205
 panther/db/cursor.py,sha256=jJ6bhz_Zljt3-AoeVdi563e2q3MSDJPP33WVbQk-goE,1287
 panther/db/models.py,sha256=GRbKXJiwnxQJ_SjuPfXPzA5miH_djZNTPPyqiRp5DI8,2561
 panther/db/utils.py,sha256=ZZa3TMkuRtssl5ZRItFLonyxvMFsTq4fmTD4BblhLDA,1589
 panther/db/queries/__init__.py,sha256=uF4gvBjLBJ-Yl3WLqoZEVNtHCVhFRKW3_Vi44pJxDNI,45
 panther/db/queries/base_queries.py,sha256=8HhdlsSW-lgz3-IrZYfOtHNC3TBWbCNErDR4XE718AY,3764
-panther/db/queries/mongodb_queries.py,sha256=4CQRdmgmKFIpnv6xijS0BMJO-Sf5beyuzmw8Z9jLtnA,5599
-panther/db/queries/pantherdb_queries.py,sha256=_dA4gXk1IA5jzIy6_6o1zgdZeeka6SPihvQeSkj7h68,4481
-panther/db/queries/queries.py,sha256=d6V4whHEYjtufoeqIC5lBNa_FGDW8_7AYeps48ilHDk,11665
+panther/db/queries/mongodb_queries.py,sha256=VLRrUc6kO6YinzEa3mnxzOPv2YyAEh7KjPS4WwzCcRM,5707
+panther/db/queries/pantherdb_queries.py,sha256=c9K3EHvOTZFN-1ZH8LUiK1BSXpEjPR8vaqPt5FuC05U,4581
+panther/db/queries/queries.py,sha256=kijRVOPlafGReWD2tHHbqVf6KyQ5_RDuInTuzwvdw1I,12417
 panther/middlewares/__init__.py,sha256=ydo0bSadGqa2v7Xy1oCTkF2uXrImedXjiyx2vPTwPhE,66
 panther/middlewares/base.py,sha256=tX0MBvDBkbsAB_DilRIYvcggSAqCzazRTb9MegZNdlA,843
 panther/panel/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 panther/panel/apis.py,sha256=COsbwKZyTgyHvHYbpDfusifAH9ojMS3z1KhZCt9M-Ms,2428
 panther/panel/urls.py,sha256=JiV-H4dWE-m_bfaTTVxzOxTvJmOWhyLOvcbM7xU3Bn4,240
 panther/panel/utils.py,sha256=0Rv79oR5IEqalqwpRKQHMn1p5duVY5mxMqDKiA5mWx4,437
-panther-4.2.3.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
-panther-4.2.3.dist-info/METADATA,sha256=eVG_pGFx9YD_x49hTbwe9XVg-7AzfCOrxPcc-LOIeXs,6532
-panther-4.2.3.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91
-panther-4.2.3.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
-panther-4.2.3.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
-panther-4.2.3.dist-info/RECORD,,
+panther-4.2.5.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
+panther-4.2.5.dist-info/METADATA,sha256=0wjcfmI8VOEtI41AySbErsINBzctgK2kF2-J7LFUqe4,6532
+panther-4.2.5.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
+panther-4.2.5.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
+panther-4.2.5.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
+panther-4.2.5.dist-info/RECORD,,

{panther-4.2.3.dist-info → panther-4.2.5.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (70.2.0)
+Generator: setuptools (71.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any