simtoolsz 0.2.14.2__tar.gz → 0.2.16__tar.gz

{simtoolsz-0.2.14.2 → simtoolsz-0.2.16}/.gitignore

@@ -9,3 +9,4 @@ wheels/
 
 # venv
 .venv
+.trae/

{simtoolsz-0.2.14.2 → simtoolsz-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: simtoolsz
-Version: 0.2.14.2
+Version: 0.2.16
 Summary: A simple and convenient toolkit containing useful functions, classes, and methods.
 Project-URL: Homepage, https://github.com/SidneyLYZhang/simtoolsz
 Project-URL: Repository, https://github.com/SidneyLYZhang/simtoolsz.git
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.11
 Requires-Dist: duckdb>=1.4.0
+Requires-Dist: numpy>=2.4.4
 Requires-Dist: pendulum>=3.1.0
 Requires-Dist: polars>=1.33.1
 Requires-Dist: pyarrow>=22.0.0

{simtoolsz-0.2.14.2 → simtoolsz-0.2.16}/examples/conversion_examples.py

@@ -3,97 +3,102 @@
 
 from simtoolsz.datetime import TimeConversion, DurationFormat
 
+
 def main():
     """展示时间格式转换的各种用法"""
-    
+
     print("=== 时间格式转换示例 ===\n")
-    
+
     # 示例1: 中文时间到秒
     print("1. 中文时间到秒")
     tc = TimeConversion("1天2小时30分钟45秒", "chinese")
     seconds = tc.convert("seconds")
     print(f"   1天2小时30分钟45秒 = {seconds}秒")
-    
+
     # 示例2: 秒到中文时间
     print("\n2. 秒到中文时间")
     tc = TimeConversion(90061, "seconds")
     chinese = tc.convert("chinese")
     print(f"   90061秒 = {chinese}")
-    
+
     # 示例3: 英文时间到分钟
     print("\n3. 英文时间到分钟")
     tc = TimeConversion("2.5 hours 30 minutes", "english")
     minutes = tc.convert("minutes")
     print(f"   2.5 hours 30 minutes = {minutes}分钟")
-    
+
     # 示例4: 冒号时间到秒
     print("\n4. 冒号时间到秒")
     tc = TimeConversion("01:30:45.5", "colon")
     seconds = tc.convert("seconds")
     print(f"   01:30:45.5 = {seconds}秒")
-    
+
     # 示例5: 毫秒到小时
     print("\n5. 毫秒到小时")
     tc = TimeConversion(3600000, "milliseconds")
     hours = tc.convert("hours")
     print(f"   3600000毫秒 = {hours}小时")
-    
+
     # 示例6: 多种格式间的相互转换
     print("\n6. 多种格式间的相互转换")
     original = "2小时30分钟"
-    
+
     # 中文 -> 各种格式
     tc = TimeConversion(original, "chinese")
-    
+
     print(f"   原始: {original}")
     print(f"   秒: {tc.convert('seconds')}")
     print(f"   分钟: {tc.convert('minutes')}")
     print(f"   小时: {tc.convert('hours')}")
     print(f"   英文: {tc.convert('english')}")
     print(f"   冒号: {tc.convert('colon')}")
-    
+
     # 示例7: 使用DurationFormat枚举
     print("\n7. 使用DurationFormat枚举")
     tc = TimeConversion(3600, DurationFormat.SECONDS)
-    
-    for fmt in [DurationFormat.MINUTES, DurationFormat.HOURS, 
-                DurationFormat.CHINESE, DurationFormat.ENGLISH]:
+
+    for fmt in [
+        DurationFormat.MINUTES,
+        DurationFormat.HOURS,
+        DurationFormat.CHINESE,
+        DurationFormat.ENGLISH,
+    ]:
         result = tc.convert(fmt)
         print(f"   3600秒 -> {fmt.value}: {result}")
-    
+
     # 示例8: 动态格式切换
     print("\n8. 动态格式切换")
     tc = TimeConversion(7200)  # 默认是seconds
     print(f"   默认格式: {tc.get_format()}")
     print(f"   7200秒 = {tc.convert('minutes')}分钟")
-    
+
     # 创建一个新的TimeConversion实例，输入是2小时
     tc2 = TimeConversion(2, "hours")
     result = tc2.convert("seconds")
     print(f"   2小时 = {result}秒")
-    
+
     # 示例9: ISO 8601 格式转换
     print("\n9. ISO 8601 格式转换")
-    
+
     # 秒到ISO 8601
     tc = TimeConversion(90061, "seconds")
     iso_format = tc.convert("iso8601")
     print(f"   90061秒 = {iso_format}")
-    
+
     # ISO 8601到秒
     tc = TimeConversion("P1DT1H1M1S", "iso8601")
     seconds = tc.convert("seconds")
     print(f"   P1DT1H1M1S = {seconds}秒")
-    
+
     # 复杂ISO 8601格式
     tc = TimeConversion("PT2H30M15.5S", "iso8601")
     print(f"   PT2H30M15.5S = {tc.convert('minutes')}分钟")
-    
+
     # 示例10: 所有格式间的相互转换
     print("\n10. 所有格式间的相互转换")
     original = 3661.5  # 1小时1分钟1.5秒
     tc = TimeConversion(original, "seconds")
-    
+
     print(f"   原始: {original}秒")
     print(f"   中文: {tc.convert('chinese')}")
     print(f"   英文: {tc.convert('english')}")
@@ -104,5 +109,6 @@ def main():
     print(f"   小时: {tc.convert('hours')}")
     print(f"   天: {tc.convert('hours') / 24}")
 
+
 if __name__ == "__main__":
-    main()
+    main()

{simtoolsz-0.2.14.2 → simtoolsz-0.2.16}/examples/special2db_example.py

@@ -8,11 +8,12 @@ import tempfile
 from pathlib import Path
 from simtoolsz.db import special2db
 
+
 def create_sample_data():
     """创建示例数据"""
-    
+
     tmpdir = Path(tempfile.mkdtemp())
-    
+
     # 创建TSV文件 - 用户数据
     tsv_content = """user_id\tname\tage\tcity\temail
 1\tAlice\t25\tNew York\talice@example.com
@@ -20,42 +21,43 @@ def create_sample_data():
 3\tCharlie\t35\tTokyo\tcharlie@example.com
 4\tDiana\t28\tParis\tdiana@example.com
 5\tEve\t32\tBerlin\teve@example.com"""
-    tsv_file = tmpdir / 'users.tsv'
-    tsv_file.write_text(tsv_content, encoding='utf-8')
-    
+    tsv_file = tmpdir / "users.tsv"
+    tsv_file.write_text(tsv_content, encoding="utf-8")
+
     print(f"示例数据已创建在: {tmpdir}")
     print(f"TSV文件: {tsv_file}")
-    
+
     return tmpdir, tsv_file
 
+
 def main():
     """主函数"""
     print("=== special2db 函数使用示例 ===\n")
-    
+
     tmpdir, tsv_file = create_sample_data()
-    
+
     # 示例1: 读取单个TSV文件
     print("--- 示例1: 读取单个TSV文件 ---")
     with tempfile.TemporaryDirectory() as test_dir:
         test_dir = Path(test_dir)
-        db_file = test_dir / 'users.db'
-        
+        db_file = test_dir / "users.db"
+
         con = special2db(tsv_file, db_file)
-        
+
         try:
             # 显示表信息
             tables = con.execute("SHOW TABLES").fetchall()
             print(f"创建的表: {[table[0] for table in tables]}")
-            
+
             # 显示数据
-            if 'users' in [t[0] for t in tables]:
+            if "users" in [t[0] for t in tables]:
                 count = con.execute("SELECT COUNT(*) FROM users").fetchone()[0]
                 print(f"记录数: {count}")
-                
+
                 # 显示表结构
                 columns = con.execute("DESCRIBE users").fetchall()
                 print(f"列信息: {[(col[0], col[1]) for col in columns]}")
-                
+
                 # 显示前3条数据
                 data = con.execute("SELECT * FROM users LIMIT 3").fetchall()
                 print(f"前3条数据:")
@@ -63,82 +65,83 @@ def main():
                     print(f"  {row}")
         finally:
             con.close()
-    
+
     # 示例2: 使用自定义表名
     print("\n--- 示例2: 使用自定义表名 ---")
     with tempfile.TemporaryDirectory() as test_dir:
         test_dir = Path(test_dir)
-        db_file = test_dir / 'custom_name.db'
-        
-        con = special2db(tsv_file, db_file, table='客户表')
-        
+        db_file = test_dir / "custom_name.db"
+
+        con = special2db(tsv_file, db_file, table="客户表")
+
         try:
             tables = con.execute("SHOW TABLES").fetchall()
             print(f"创建的表: {[table[0] for table in tables]}")
-            
-            if '客户表' in [t[0] for t in tables]:
+
+            if "客户表" in [t[0] for t in tables]:
                 count = con.execute("SELECT COUNT(*) FROM 客户表").fetchone()[0]
                 print(f"客户表记录数: {count}")
-                
+
                 # 查询特定数据
                 data = con.execute("SELECT * FROM 客户表 WHERE age > 30").fetchall()
                 print(f"年龄大于30的客户: {data}")
         finally:
             con.close()
-    
+
     # 示例3: 处理目录
     print("\n--- 示例3: 处理目录 ---")
     with tempfile.TemporaryDirectory() as test_dir:
         test_dir = Path(test_dir)
-        
+
         # 创建多个TSV文件
-        users_tsv = test_dir / 'users.tsv'
-        users_tsv.write_text(tsv_file.read_text(), encoding='utf-8')
-        
-        products_tsv = test_dir / 'products.tsv'
+        users_tsv = test_dir / "users.tsv"
+        users_tsv.write_text(tsv_file.read_text(), encoding="utf-8")
+
+        products_tsv = test_dir / "products.tsv"
         products_content = """product_id\tname\tprice\tcategory\tstock
 101\t笔记本电脑\t8999\t电子产品\t50
 102\t无线鼠标\t199\t配件\t200
 103\tUSB硬盘\t599\t存储\t80
 104\t显示器\t1599\t电子产品\t30
 105\t键盘\t299\t配件\t150"""
-        products_tsv.write_text(products_content, encoding='utf-8')
-        
-        db_file = test_dir / 'directory.db'
+        products_tsv.write_text(products_content, encoding="utf-8")
+
+        db_file = test_dir / "directory.db"
         con = special2db(test_dir, db_file)
-        
+
         try:
             tables = con.execute("SHOW TABLES").fetchall()
             print(f"创建的表: {[table[0] for table in tables]}")
-            
+
             # 查询每个表
-            for table_name in ['users', 'products']:
+            for table_name in ["users", "products"]:
                 if table_name in [t[0] for t in tables]:
-                    count = con.execute(f"SELECT COUNT(*) FROM {table_name}").fetchone()[0]
+                    count = con.execute(
+                        f"SELECT COUNT(*) FROM {table_name}"
+                    ).fetchone()[0]
                     print(f"{table_name}表记录数: {count}")
         finally:
             con.close()
-    
+
     # 示例4: 使用额外的DuckDB参数
     print("\n--- 示例4: 使用额外的DuckDB参数 ---")
     with tempfile.TemporaryDirectory() as test_dir:
         test_dir = Path(test_dir)
-        db_file = test_dir / 'with_params.db'
-        
+        db_file = test_dir / "with_params.db"
+
         # 为TSV文件指定编码和其他参数
-        con = special2db(tsv_file, db_file, 
-                        encoding='utf-8',
-                        header=True)
-        
+        con = special2db(tsv_file, db_file, encoding="utf-8", header=True)
+
         if con:
             try:
                 tables = con.execute("SHOW TABLES").fetchall()
                 print(f"创建的表: {[table[0] for table in tables]}")
             finally:
                 con.close()
-    
+
     print("\n=== 所有示例完成 ===")
     print("special2db 函数使用示例结束")
 
+
 if __name__ == "__main__":
-    main()
+    main()

{simtoolsz-0.2.14.2 → simtoolsz-0.2.16}/examples/today_examples.py

@@ -13,75 +13,75 @@ from simtoolsz.utils import today
 
 def main():
     print("=== today() 函数使用示例 ===\n")
-    
+
     # 1. 基本用法 - 获取当前日期（返回 DateTime 对象）
     print("1. 获取当前日期对象:")
     current_date = today()
     print(f"   today() = {current_date}")
     print(f"   类型: {type(current_date)}")
     print()
-    
+
     # 2. 获取标准 datetime 对象
     print("2. 获取标准 datetime 对象:")
     std_datetime = today(return_std=True)
     print(f"   today(return_std=True) = {std_datetime}")
     print(f"   类型: {type(std_datetime)}")
     print()
-    
+
     # 3. 获取当前日期时间
     print("3. 获取当前日期时间对象:")
     current_datetime = today(addtime=True)
     print(f"   today(addtime=True) = {current_datetime}")
     print(f"   类型: {type(current_datetime)}")
     print()
-    
+
     # 4. 格式化日期输出
     print("4. 格式化日期输出:")
-    formatted_date = today(fmt='YYYY-MM-DD')
+    formatted_date = today(fmt="YYYY-MM-DD")
     print(f"   today(fmt='YYYY-MM-DD') = '{formatted_date}'")
     print(f"   类型: {type(formatted_date)}")
     print()
-    
+
     # 5. 格式化日期时间输出
     print("5. 格式化日期时间输出:")
-    formatted_datetime = today(addtime=True, fmt='YYYY-MM-DD HH:mm:ss')
+    formatted_datetime = today(addtime=True, fmt="YYYY-MM-DD HH:mm:ss")
     print(f"   today(addtime=True, fmt='YYYY-MM-DD HH:mm:ss') = '{formatted_datetime}'")
     print()
-    
+
     # 6. 不同时区的日期
     print("6. 不同时区的日期:")
-    local_date = today(fmt='YYYY-MM-DD HH:mm:ss')
-    utc_date = today(tz='UTC', fmt='YYYY-MM-DD HH:mm:ss')
-    shanghai_date = today(tz='Asia/Shanghai', fmt='YYYY-MM-DD HH:mm:ss')
-    
+    local_date = today(fmt="YYYY-MM-DD HH:mm:ss")
+    utc_date = today(tz="UTC", fmt="YYYY-MM-DD HH:mm:ss")
+    shanghai_date = today(tz="Asia/Shanghai", fmt="YYYY-MM-DD HH:mm:ss")
+
     print(f"   本地时区: {local_date}")
     print(f"   UTC时区:  {utc_date}")
     print(f"   上海时区: {shanghai_date}")
     print()
-    
+
     # 7. 中文格式
     print("7. 中文格式:")
-    chinese_date = today(fmt='YYYY年MM月DD日')
-    chinese_datetime = today(addtime=True, fmt='YYYY年MM月DD日 HH时mm分ss秒')
+    chinese_date = today(fmt="YYYY年MM月DD日")
+    chinese_datetime = today(addtime=True, fmt="YYYY年MM月DD日 HH时mm分ss秒")
     print(f"   中文日期: {chinese_date}")
     print(f"   中文日期时间: {chinese_datetime}")
     print()
-    
+
     # 8. 其他常用格式
     print("8. 其他常用格式:")
     formats = [
-        'DD/MM/YYYY',
-        'MM-DD-YYYY',
-        'YYYY/MM/DD HH:mm',
-        'dddd, MMMM D, YYYY',  # 星期几，月份 日，年
-        'MMM D, YYYY',         # 简写月份
+        "DD/MM/YYYY",
+        "MM-DD-YYYY",
+        "YYYY/MM/DD HH:mm",
+        "dddd, MMMM D, YYYY",  # 星期几，月份 日，年
+        "MMM D, YYYY",  # 简写月份
     ]
-    
+
     for fmt in formats:
         result = today(addtime=True, fmt=fmt)
         print(f"   {fmt:20} = {result}")
     print()
-    
+
     # 9. 与 pendulum 对象的交互
     print("9. 与 pendulum 对象的交互:")
     dt_obj = today()  # 获取 DateTime 对象
@@ -92,7 +92,7 @@ def main():
     print(f"   星期: {dt_obj.day_of_week}")
     print(f"   是否闰年: {dt_obj.is_leap_year()}")
     print()
-    
+
     # 10. 标准 datetime 对象的使用
     print("10. 标准 datetime 对象的使用:")
     std_dt = today(addtime=True, return_std=True)
@@ -100,27 +100,27 @@ def main():
     print(f"   时间戳: {std_dt.timestamp()}")
     print(f"   ISO格式: {std_dt.isoformat()}")
     print()
-    
+
     # 11. 时区转换
     print("11. 时区转换示例:")
-    utc_time = today(tz='UTC', addtime=True)
+    utc_time = today(tz="UTC", addtime=True)
     print(f"   UTC时间: {utc_time}")
     # 转换到纽约时区
-    ny_time = utc_time.in_timezone('America/New_York')
+    ny_time = utc_time.in_timezone("America/New_York")
     print(f"   纽约时间: {ny_time}")
     print()
-    
+
     # 12. 组合用法示例
     print("12. 组合用法示例:")
     # 获取UTC时间的标准datetime对象
-    utc_std = today(tz='UTC', addtime=True, return_std=True)
+    utc_std = today(tz="UTC", addtime=True, return_std=True)
     print(f"   UTC标准datetime: {utc_std}")
-    
+
     # 获取格式化的中文日期时间
-    chinese_fmt = today(addtime=True, tz='Asia/Shanghai', fmt='YYYY年MM月DD日 HH:mm:ss')
+    chinese_fmt = today(addtime=True, tz="Asia/Shanghai", fmt="YYYY年MM月DD日 HH:mm:ss")
     print(f"   北京时间中文格式: {chinese_fmt}")
     print()
 
 
 if __name__ == "__main__":
-    main()
+    main()