ezKit 1.6.1__tar.gz → 1.7.0__tar.gz

{ezKit-1.6.1/ezKit.egg-info → ezkit-1.7.0}/PKG-INFO

@@ -1,10 +1,8 @@
 Metadata-Version: 2.1
 Name: ezKit
-Version: 1.6.1
+Version: 1.7.0
 Summary: Easy Kit
 Author: septvean
 Author-email: septvean@gmail.com
 Requires-Python: >=3.10
 License-File: LICENSE
-Requires-Dist: loguru>=0.7.0
-Requires-Dist: tomlkit>=0.12.0

{ezKit-1.6.1 → ezkit-1.7.0}/README.md

@@ -151,6 +151,15 @@ pip install ezKit-1.1.3.tar.gz
 
 版本号说明: [PEP 440 – Version Identification and Dependency Specification](https://peps.python.org/pep-0440/)
 
+## 函数
+
+- 明确 参数 和 返回值 的类型
+- 必须有返回值
+- 添加一个 debug 参数, 用于调试
+    - 如果 debug 为 True, 则输出相关信息, 否则一律不输出任何信息
+- 必须有说明
+- 必须用 try ... except ... 包裹
+
 try ... except ... 一律输出 Exception:
 
 ```py

{ezKit-1.6.1 → ezkit-1.7.0}/ezKit/cipher.py

@@ -2,6 +2,7 @@
 https://docs.python.org/3.10/library/hashlib.html
 https://www.pycrypto.org/
 https://stackoverflow.com/a/21928790
+pip install pycryptodome
 '''
 import base64
 import hashlib

{ezKit-1.6.1 → ezkit-1.7.0}/ezKit/mongo.py

@@ -1,3 +1,4 @@
+"""MongoDB"""
 from loguru import logger
 from pymongo import MongoClient
 
@@ -5,21 +6,19 @@ from . import utils
 
 
 class Mongo():
+    """MongoDB"""
 
     client = MongoClient()
 
-    def __init__(self, mongo_url=None):
-        ''' Initiation '''
-        if mongo_url != None:
-            self.client = MongoClient(mongo_url)
-
     def close(self):
+        """client close"""
         try:
             self.client.close()
         except Exception as e:
             logger.exception(e)
 
     def connect_test(self, debug: bool = False):
+        """client connect test"""
         info = 'MongoDB连接测试'
         try:
             logger.info(f'{info}[执行]')
@@ -28,19 +27,22 @@ class Mongo():
             return True
         except Exception as e:
             logger.error(f'{info}[失败]')
-            logger.exception(e) if utils.v_true(debug, bool) else next
+            if utils.v_true(debug, bool):
+                logger.exception(e)
             return False
 
     def collection(self, database, name):
+        """client collection"""
         return self.client[database][name]
 
     def collection_insert(self, database, collection, data, drop=None):
+        """client collection insert"""
         db_collection = self.client[database][collection]
         info = '插入数据'
         try:
             logger.info(f'{info}[执行]')
             # 是否删除 collection
-            if drop == True:
+            if drop is True:
                 # 删除 collection
                 db_collection.drop()
             # 插入数据