panther 4.2.2__py3-none-any.whl → 4.2.4__py3-none-any.whl

panther/__init__.py

@@ -1,6 +1,6 @@
 from panther.main import Panther  # noqa: F401
 
-__version__ = '4.2.2'
+__version__ = '4.2.4'
 
 
 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/queries.py

@@ -364,6 +364,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

panther/db/utils.py

@@ -29,7 +29,7 @@ def log_query(func):
 def check_connection(func):
     async def wrapper(*args, **kwargs):
         if config.QUERY_ENGINE is None:
-            msg = "You don't have active database connection, Check your middlewares"
+            msg = "You don't have active database connection, Check your DATABASE block in configs"
             raise NotImplementedError(msg)
         return await func(*args, **kwargs)
 

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.2.dist-info → panther-4.2.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: panther
-Version: 4.2.2
+Version: 4.2.4
 Summary: Fast &  Friendly, Web Framework For Building Async APIs
 Home-page: https://github.com/alirn76/panther
 Author: Ali RajabNezhad
@@ -13,20 +13,20 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: httptools ~=0.6
-Requires-Dist: pantherdb ==2.1.0
-Requires-Dist: pydantic ~=2.6
-Requires-Dist: rich ~=13.7
-Requires-Dist: uvicorn ~=0.27
+Requires-Dist: httptools ~=0.6.1
+Requires-Dist: pantherdb ~=2.1.0
+Requires-Dist: pydantic ~=2.7.4
+Requires-Dist: rich ~=13.7.1
+Requires-Dist: uvicorn ~=0.27.1
 Requires-Dist: pytz ~=2024.1
 Provides-Extra: full
 Requires-Dist: redis ==5.0.1 ; extra == 'full'
-Requires-Dist: motor ~=3.3 ; extra == 'full'
+Requires-Dist: motor ~=3.5.0 ; extra == 'full'
 Requires-Dist: bpython ~=0.24 ; extra == 'full'
 Requires-Dist: ruff ~=0.1.9 ; extra == 'full'
-Requires-Dist: python-jose ~=3.3 ; extra == 'full'
+Requires-Dist: python-jose ~=3.3.0 ; extra == 'full'
 Requires-Dist: websockets ~=12.0 ; extra == 'full'
-Requires-Dist: cryptography ~=42.0 ; extra == 'full'
+Requires-Dist: cryptography ~=42.0.8 ; extra == 'full'
 Requires-Dist: watchfiles ~=0.21.0 ; extra == 'full'
 
 
@@ -56,7 +56,7 @@ Requires-Dist: watchfiles ~=0.21.0 ; extra == 'full'
 - Support Custom **Middlewares**
 - Support Custom **Throttling**
 - Support **Function-Base** and **Class-Base** APIs
-- It's One Of The **Fastest Python Framework** 
+- It's One Of The **Fastest Python Framework** ([Benchmark](https://www.techempower.com/benchmarks/#section=test&runid=d3364379-1bf7-465f-bcb1-e9c65b4840f9&hw=ph&test=fortune&l=zik0zj-6bi))
 ---
 
 ### Supported by

{panther-4.2.2.dist-info → panther-4.2.4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-panther/__init__.py,sha256=Sv6vixQQrNOJFV4kgGUL-pMtNbXp7MrXCoCs7BYP6p0,110
+panther/__init__.py,sha256=jXiDH-UBeYxx2lgu4JXs2xheg9VZnc4TKPmqsisk1KQ,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=frSekBisjeHUHTiucgeiJNOGdrNcf3mjodupyeZjyKk,1575
+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/queries.py,sha256=dWTiOjdIbrD_TajiyIlCKuFNyn-dkVEWvUFsmH2grjg,12236
 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.2.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
-panther-4.2.2.dist-info/METADATA,sha256=WuUnOJAvGmczG9Mq0UJu0dKjaFLDqL6Vqvvh0cceGD0,6376
-panther-4.2.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-panther-4.2.2.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
-panther-4.2.2.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
-panther-4.2.2.dist-info/RECORD,,
+panther-4.2.4.dist-info/LICENSE,sha256=2aF1hL2aC0zRPjzUkSxJUzZbn2_uLoOkn7DHjzZni-I,1524
+panther-4.2.4.dist-info/METADATA,sha256=Nv8m1lQFmOM4DYsFWSARsnbR0EE5MwatWuGHP1JvDw4,6532
+panther-4.2.4.dist-info/WHEEL,sha256=Wyh-_nZ0DJYolHNn1_hMa4lM7uDedD_RGVwbmTjyItk,91
+panther-4.2.4.dist-info/entry_points.txt,sha256=6GPxYFGuzVfNB4YpHFJvYex6iWah5_tLnirAHwj2Qsg,51
+panther-4.2.4.dist-info/top_level.txt,sha256=VbBs02JGXTIoHMzsX-eLOk2MCbBZzQbLhWiYpI7xI2g,8
+panther-4.2.4.dist-info/RECORD,,

{panther-4.2.2.dist-info → panther-4.2.4.dist-info}/WHEEL

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