staran 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

staran/__init__.py

@@ -18,6 +18,7 @@ Staran - 简化的Python工具库
 1. Date工具 - 智能日期处理
 2. SQL工具 - 数据分析SQL生成
 
+
 快速开始：
 ---------
 
@@ -35,7 +36,10 @@ Date工具基本用法::
 
 SQL工具基本用法::
 
-    from staran import TableSchema, FeatureGenerator
+    from staran import TableSchema, FeatureGenerator, SQLManager, DatabaseType
+    
+    # 创建SQL管理器
+    sql_manager = SQLManager('my_database', DatabaseType.SPARK)
     
     # 定义表结构
     schema = TableSchema('user_behavior')
@@ -45,10 +49,27 @@ SQL工具基本用法::
     schema.add_field('status', 'string')
     schema.set_monthly_unique(True)
     
-    # 生成特征SQL
-    generator = FeatureGenerator(schema)
-    sql = generator.generate_spark_sql()
-    print(sql)
+    # 创建特征生成器
+    generator = FeatureGenerator(schema, sql_manager)
+    
+    # 按类型生成特征表
+    table_name = generator.create_feature_table('aggregation', 2025, 7, 1)
+    print(f"生成特征表: {table_name}")
+
+特征类型控制::
+
+    from staran.sql import FeatureConfig, FeatureType
+    
+    # 配置只生成基础特征
+    config = FeatureConfig()
+    config.enable_feature(FeatureType.MOM)  # 启用环比特征
+    config.set_mom_periods([1])  # 只生成1个月环比
+    
+    generator = FeatureGenerator(schema, sql_manager, config)
+    
+    # 分别生成不同类型的特征表
+    agg_table = generator.create_feature_table('aggregation', 2025, 7, 1)
+    mom_table = generator.create_feature_table('mom', 2025, 7, 2)
 
 多种输出格式::
 
@@ -131,14 +152,16 @@ SQL工具：
 
 # 导入主要功能
 from .tools import Date
-from .sql import TableSchema, FeatureGenerator, SparkSQLGenerator
+from .sql import TableSchema, FeatureGenerator, SparkSQLGenerator, SQLManager, DatabaseType
 
 # 主要导出
 __all__ = [
     'Date',
     'TableSchema', 
     'FeatureGenerator',
-    'SparkSQLGenerator'
+    'SparkSQLGenerator',
+    'SQLManager',
+    'DatabaseType'
 ]
 
 # 包信息

staran-0.2.2.dist-info/METADATA

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: staran
+Version: 0.2.2
+Summary: staran - 高性能Python工具库
+Home-page: https://github.com/starlxa/staran
+Author: StarAn
+Author-email: starlxa@icloud.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: datetime
+Requires-Dist: calendar
+Requires-Dist: re
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Staran - 简化的Python工具库
+
+## 📦 轻量级Python实用工具集
+
+Staran是一个基于Python标准库的实用工具库，提供日期处理、SQL生成等常用功能，无需复杂依赖。
+
+## 🚀 快速开始
+
+### 安装
+```bash
+pip install staran
+```
+
+### Date工具 - 智能日期处理
+
+```python
+from staran import Date
+
+# 创建日期 - 智能格式记忆
+date1 = Date('202504')      # 输出: 202504 (记住年月格式)
+date2 = Date('20250415')    # 输出: 20250415 (记住完整格式)
+date3 = Date(2025, 4, 15)   # 输出: 2025-04-15
+
+# 日期运算保持格式
+new_date = date1.add_months(2)  # 输出: 202506 (保持YYYYMM格式)
+```
+
+### SQL工具 - 数据分析SQL生成
+
+```python
+from staran import TableSchema, FeatureGenerator
+
+# 定义表结构
+schema = TableSchema('user_behavior')
+schema.add_primary_key('user_id', 'string')
+schema.add_date_field('date', 'date')
+schema.add_field('amount', 'decimal', aggregatable=True)
+schema.add_field('status', 'string')
+schema.set_monthly_unique(True)
+
+# 生成特征SQL
+generator = FeatureGenerator(schema)
+sql = generator.generate_spark_sql()
+print(sql)
+```
+
+## 📖 主要功能
+
+### 1. Date工具 - 智能格式记忆
+Date类会根据输入格式自动设置默认输出格式：
+
+| 输入方式 | 默认输出 | 说明 |
+|---------|---------|------|
+| `Date('202504')` | `202504` | 年月紧凑格式 |
+| `Date('20250415')` | `20250415` | 完整紧凑格式 |
+| `Date(2025, 4)` | `2025-04` | 年月格式 |
+| `Date(2025, 4, 15)` | `2025-04-15` | 完整格式 |
+
+### 2. SQL工具 - 特征工程SQL生成
+基于表结构自动生成数据分析SQL，支持：
+
+- **原始字段拷贝**：非聚合字段的智能拷贝
+- **聚合统计**：sum/avg/min/max/count/variance/stddev
+- **环比特征**：月度差分对比（MoM）
+- **同比特征**：年度差分对比（YoY）
+- **Spark SQL**：生成优化的Spark SQL代码
+
+```python
+# 特征生成配置
+from staran.sql import FeatureConfig
+
+config = FeatureConfig()
+config.set_aggregation_types(['sum', 'avg', 'max'])
+config.set_mom_months([1, 3])  # 1月、3月环比
+
+generator = FeatureGenerator(schema, config)
+generator.print_feature_summary()  # 查看特征统计
+```
+
+### 3. 多种输出格式（Date工具）
+```python
+date = Date('202504')
+
+# 默认格式（保持输入风格）
+print(date)                         # 202504
+
+# 常用格式
+print(date.format_full())          # 2025-04-01
+print(date.format_chinese())       # 2025年04月01日
+print(date.format_year_month())    # 2025-04
+print(date.format_compact())       # 20250401
+```
+
+### 4. 日期运算
+```python
+date = Date('202504')
+
+# 运算后保持原格式
+next_month = date.add_months(1)     # 202505
+tomorrow = date.add_days(1)         # 202504 (智能处理)
+
+# 日期差计算
+diff = date.difference(Date('202502'))  # 天数差
+```
+
+## 🎯 设计特色
+
+- **格式智能** - 自动记忆输入格式，保持输出一致性
+- **零依赖** - 仅基于Python标准库
+- **直观API** - 符合Python习惯的设计
+- **类型安全** - 完整的参数验证和错误处理
+- **代码生成** - 智能SQL特征工程代码生成
+
+## 📁 项目结构
+
+```
+staran/
+├── __init__.py           # 主包入口，包含使用示例
+├── tools/
+│   ├── __init__.py      # 工具模块
+│   └── date.py          # Date类实现
+├── sql/
+│   ├── __init__.py      # SQL模块
+│   ├── schema.py        # 表结构定义
+│   ├── generator.py     # 特征生成器
+│   └── engines.py       # SQL引擎（Spark等）
+├── setup.py             # 安装配置  
+├── README.md            # 本文档
+└── SQL_GUIDE.md         # SQL工具详细指南
+```
+
+## 🧪 快速测试
+
+### Date工具测试
+```python
+from staran import Date
+
+# 测试格式记忆
+date = Date('202504')
+print(f"原始: {date}")                    # 202504
+print(f"加2月: {date.add_months(2)}")     # 202506
+
+# 测试多格式输出
+print(f"中文: {date.format_chinese()}")   # 2025年04月01日
+print(f"完整: {date.format_full()}")      # 2025-04-01
+```
+
+### SQL工具测试
+```python
+from staran import TableSchema, FeatureGenerator
+
+# 定义简单表结构
+schema = TableSchema('user_stats')
+schema.add_primary_key('user_id', 'string')
+schema.add_date_field('date', 'date')
+schema.add_field('amount', 'decimal', aggregatable=True)
+schema.set_monthly_unique(True)
+
+# 生成并查看特征
+generator = FeatureGenerator(schema)
+print(f"生成特征数: {generator.get_feature_summary()['total']}")
+print(generator.generate_spark_sql())
+```
+
+## 📄 许可证
+
+MIT License
+
+---
+
+**Staran** - 让Python工具使用更简单 🌟

staran-0.2.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+staran/__init__.py,sha256=IzD8a-yQDXYzTNOgNTv5wD6HXmITPuYg5INjg3wfoCc,5871
+staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
+staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
+staran-0.2.2.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
+staran-0.2.2.dist-info/METADATA,sha256=5J9S_3ZIuPW3qDuOgdzpS50Mv2b_9Vqj04h5vsbwcwY,5331
+staran-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+staran-0.2.2.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
+staran-0.2.2.dist-info/RECORD,,

staran-0.2.0.dist-info/METADATA

@@ -1,24 +0,0 @@
-Metadata-Version: 2.4
-Name: staran
-Version: 0.2.0
-Summary: staran - 高性能Python工具库
-Home-page: https://github.com/starlxa/staran
-Author: StarAn
-Author-email: starlxa@icloud.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: datetime
-Requires-Dist: calendar
-Requires-Dist: re
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary

staran-0.2.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-staran/__init__.py,sha256=FdJTZ11EB1R2z70W8FsCSgudpbPE68rMEud19pp8VsU,5045
-staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
-staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
-staran-0.2.0.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
-staran-0.2.0.dist-info/METADATA,sha256=ReWJRHI_LYkUc4YWsBTsX2cqCA3XKyJgtm65jAPLjOI,634
-staran-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-staran-0.2.0.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
-staran-0.2.0.dist-info/RECORD,,