staran 0.1.3__tar.gz → 0.2.1__tar.gz

{staran-0.1.3/staran.egg-info → staran-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staran
-Version: 0.1.3
+Version: 0.2.1
 Summary: staran - 高性能Python工具库
 Home-page: https://github.com/starlxa/staran
 Author: StarAn
@@ -26,9 +26,9 @@ Dynamic: summary
 
 # Staran - 简化的Python工具库
 
-## � 轻量级Python实用工具集
+## 📦 轻量级Python实用工具集
 
-Staran是一个基于Python标准库的实用工具库，提供日期处理等常用功能，无需复杂依赖。
+Staran是一个基于Python标准库的实用工具库，提供日期处理、SQL生成等常用功能，无需复杂依赖。
 
 ## 🚀 快速开始
 
@@ -37,7 +37,7 @@ Staran是一个基于Python标准库的实用工具库，提供日期处理等
 pip install staran
 ```
 
-### 基本使用
+### Date工具 - 智能日期处理
 
 ```python
 from staran import Date
@@ -51,9 +51,28 @@ 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. 智能格式记忆
+### 1. Date工具 - 智能格式记忆
 Date类会根据输入格式自动设置默认输出格式：
 
 | 输入方式 | 默认输出 | 说明 |
@@ -63,7 +82,28 @@ Date类会根据输入格式自动设置默认输出格式：
 | `Date(2025, 4)` | `2025-04` | 年月格式 |
 | `Date(2025, 4, 15)` | `2025-04-15` | 完整格式 |
 
-### 2. 多种输出格式
+### 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')
 
@@ -77,7 +117,7 @@ print(date.format_year_month())    # 2025-04
 print(date.format_compact())       # 20250401
 ```
 
-### 3. 日期运算
+### 4. 日期运算
 ```python
 date = Date('202504')
 
@@ -89,20 +129,13 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 diff = date.difference(Date('202502'))  # 天数差
 ```
 
-### 4. 基本信息
-```python
-date = Date(2024, 2, 29)
-print(date.is_leap_year())          # True
-print(date.weekday())               # 星期几
-print(date.days_in_month())         # 当月天数
-```
-
 ## 🎯 设计特色
 
 - **格式智能** - 自动记忆输入格式，保持输出一致性
 - **零依赖** - 仅基于Python标准库
 - **直观API** - 符合Python习惯的设计
 - **类型安全** - 完整的参数验证和错误处理
+- **代码生成** - 智能SQL特征工程代码生成
 
 ## 📁 项目结构
 
@@ -112,12 +145,19 @@ staran/
 ├── tools/
 │   ├── __init__.py      # 工具模块
 │   └── date.py          # Date类实现
+├── sql/
+│   ├── __init__.py      # SQL模块
+│   ├── schema.py        # 表结构定义
+│   ├── generator.py     # 特征生成器
+│   └── engines.py       # SQL引擎（Spark等）
 ├── setup.py             # 安装配置  
-└── README.md            # 本文档
+├── README.md            # 本文档
+└── SQL_GUIDE.md         # SQL工具详细指南
 ```
 
 ## 🧪 快速测试
 
+### Date工具测试
 ```python
 from staran import Date
 
@@ -131,6 +171,23 @@ 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-0.1.3 → staran-0.2.1}/README.md

@@ -1,8 +1,8 @@
 # Staran - 简化的Python工具库
 
-## � 轻量级Python实用工具集
+## 📦 轻量级Python实用工具集
 
-Staran是一个基于Python标准库的实用工具库，提供日期处理等常用功能，无需复杂依赖。
+Staran是一个基于Python标准库的实用工具库，提供日期处理、SQL生成等常用功能，无需复杂依赖。
 
 ## 🚀 快速开始
 
@@ -11,7 +11,7 @@ Staran是一个基于Python标准库的实用工具库，提供日期处理等
 pip install staran
 ```
 
-### 基本使用
+### Date工具 - 智能日期处理
 
 ```python
 from staran import Date
@@ -25,9 +25,28 @@ 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. 智能格式记忆
+### 1. Date工具 - 智能格式记忆
 Date类会根据输入格式自动设置默认输出格式：
 
 | 输入方式 | 默认输出 | 说明 |
@@ -37,7 +56,28 @@ Date类会根据输入格式自动设置默认输出格式：
 | `Date(2025, 4)` | `2025-04` | 年月格式 |
 | `Date(2025, 4, 15)` | `2025-04-15` | 完整格式 |
 
-### 2. 多种输出格式
+### 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')
 
@@ -51,7 +91,7 @@ print(date.format_year_month())    # 2025-04
 print(date.format_compact())       # 20250401
 ```
 
-### 3. 日期运算
+### 4. 日期运算
 ```python
 date = Date('202504')
 
@@ -63,20 +103,13 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 diff = date.difference(Date('202502'))  # 天数差
 ```
 
-### 4. 基本信息
-```python
-date = Date(2024, 2, 29)
-print(date.is_leap_year())          # True
-print(date.weekday())               # 星期几
-print(date.days_in_month())         # 当月天数
-```
-
 ## 🎯 设计特色
 
 - **格式智能** - 自动记忆输入格式，保持输出一致性
 - **零依赖** - 仅基于Python标准库
 - **直观API** - 符合Python习惯的设计
 - **类型安全** - 完整的参数验证和错误处理
+- **代码生成** - 智能SQL特征工程代码生成
 
 ## 📁 项目结构
 
@@ -86,12 +119,19 @@ staran/
 ├── tools/
 │   ├── __init__.py      # 工具模块
 │   └── date.py          # Date类实现
+├── sql/
+│   ├── __init__.py      # SQL模块
+│   ├── schema.py        # 表结构定义
+│   ├── generator.py     # 特征生成器
+│   └── engines.py       # SQL引擎（Spark等）
 ├── setup.py             # 安装配置  
-└── README.md            # 本文档
+├── README.md            # 本文档
+└── SQL_GUIDE.md         # SQL工具详细指南
 ```
 
 ## 🧪 快速测试
 
+### Date工具测试
 ```python
 from staran import Date
 
@@ -105,6 +145,23 @@ 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-0.1.3 → staran-0.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name='staran',
-    version='0.1.3',
+    version='0.2.1',
     description='staran - 高性能Python工具库',
     long_description=open('README.md', encoding='utf-8').read(),
     long_description_content_type='text/markdown',

{staran-0.1.3 → staran-0.2.1}/staran/__init__.py

@@ -5,7 +5,7 @@
 Staran - 简化的Python工具库
 =========================
 
-基于Python标准库的轻量级实用工具集，提供日期处理等常用功能。
+基于Python标准库的轻量级实用工具集，提供日期处理、SQL生成等常用功能。
 
 主要特性：
 - 零依赖：仅基于Python标准库
@@ -13,10 +13,16 @@ Staran - 简化的Python工具库
 - 直观API：符合Python习惯的设计
 - 类型安全：完整的参数验证
 
+工具模块：
+---------
+1. Date工具 - 智能日期处理
+2. SQL工具 - 数据分析SQL生成
+
+
 快速开始：
 ---------
 
-基本用法::
+Date工具基本用法::
 
     from staran import Date
     
@@ -28,6 +34,23 @@ Staran - 简化的Python工具库
     # 格式保持
     new_date = date1.add_months(2)  # 输出: 202506 (保持原格式)
 
+SQL工具基本用法::
+
+    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)
+
 多种输出格式::
 
     date = Date('202504')
@@ -37,6 +60,18 @@ Staran - 简化的Python工具库
     print(date.format_chinese())   # 2025年04月01日
     print(date.format_compact())   # 20250401
 
+SQL特征生成::
+
+    # 配置特征生成
+    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()
+
 日期运算::
 
     date = Date(2025, 4, 15)
@@ -73,6 +108,7 @@ Staran - 简化的Python工具库
 
 核心功能：
 ---------
+Date工具：
 - Date: 智能日期类，支持格式记忆和多种输出
 - 日期运算：add_days(), add_months()
 - 格式化：多种预设格式方法
@@ -80,6 +116,13 @@ Staran - 简化的Python工具库
 - 转换：to_timestamp(), to_date(), to_datetime()
 - 信息：is_leap_year(), weekday(), days_in_month()
 
+SQL工具：
+- TableSchema: 表结构定义，支持字段类型和特性配置
+- FeatureGenerator: 特征生成器，支持聚合、环比、同比特征
+- SparkSQLGenerator: Spark SQL代码生成
+- 支持每人每月唯一数据的特征工程
+- 可配置的聚合类型和时间窗口
+
 版本信息：
 ---------
 - 版本: 1.0.0
@@ -89,10 +132,14 @@ Staran - 简化的Python工具库
 
 # 导入主要功能
 from .tools import Date
+from .sql import TableSchema, FeatureGenerator, SparkSQLGenerator
 
 # 主要导出
 __all__ = [
-    'Date'
+    'Date',
+    'TableSchema', 
+    'FeatureGenerator',
+    'SparkSQLGenerator'
 ]
 
 # 包信息

{staran-0.1.3 → staran-0.2.1/staran.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staran
-Version: 0.1.3
+Version: 0.2.1
 Summary: staran - 高性能Python工具库
 Home-page: https://github.com/starlxa/staran
 Author: StarAn
@@ -26,9 +26,9 @@ Dynamic: summary
 
 # Staran - 简化的Python工具库
 
-## � 轻量级Python实用工具集
+## 📦 轻量级Python实用工具集
 
-Staran是一个基于Python标准库的实用工具库，提供日期处理等常用功能，无需复杂依赖。
+Staran是一个基于Python标准库的实用工具库，提供日期处理、SQL生成等常用功能，无需复杂依赖。
 
 ## 🚀 快速开始
 
@@ -37,7 +37,7 @@ Staran是一个基于Python标准库的实用工具库，提供日期处理等
 pip install staran
 ```
 
-### 基本使用
+### Date工具 - 智能日期处理
 
 ```python
 from staran import Date
@@ -51,9 +51,28 @@ 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. 智能格式记忆
+### 1. Date工具 - 智能格式记忆
 Date类会根据输入格式自动设置默认输出格式：
 
 | 输入方式 | 默认输出 | 说明 |
@@ -63,7 +82,28 @@ Date类会根据输入格式自动设置默认输出格式：
 | `Date(2025, 4)` | `2025-04` | 年月格式 |
 | `Date(2025, 4, 15)` | `2025-04-15` | 完整格式 |
 
-### 2. 多种输出格式
+### 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')
 
@@ -77,7 +117,7 @@ print(date.format_year_month())    # 2025-04
 print(date.format_compact())       # 20250401
 ```
 
-### 3. 日期运算
+### 4. 日期运算
 ```python
 date = Date('202504')
 
@@ -89,20 +129,13 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 diff = date.difference(Date('202502'))  # 天数差
 ```
 
-### 4. 基本信息
-```python
-date = Date(2024, 2, 29)
-print(date.is_leap_year())          # True
-print(date.weekday())               # 星期几
-print(date.days_in_month())         # 当月天数
-```
-
 ## 🎯 设计特色
 
 - **格式智能** - 自动记忆输入格式，保持输出一致性
 - **零依赖** - 仅基于Python标准库
 - **直观API** - 符合Python习惯的设计
 - **类型安全** - 完整的参数验证和错误处理
+- **代码生成** - 智能SQL特征工程代码生成
 
 ## 📁 项目结构
 
@@ -112,12 +145,19 @@ staran/
 ├── tools/
 │   ├── __init__.py      # 工具模块
 │   └── date.py          # Date类实现
+├── sql/
+│   ├── __init__.py      # SQL模块
+│   ├── schema.py        # 表结构定义
+│   ├── generator.py     # 特征生成器
+│   └── engines.py       # SQL引擎（Spark等）
 ├── setup.py             # 安装配置  
-└── README.md            # 本文档
+├── README.md            # 本文档
+└── SQL_GUIDE.md         # SQL工具详细指南
 ```
 
 ## 🧪 快速测试
 
+### Date工具测试
 ```python
 from staran import Date
 
@@ -131,6 +171,23 @@ 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