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

staran/__init__.py

@@ -18,6 +18,7 @@ Staran - 简化的Python工具库
 1. Date工具 - 智能日期处理
 2. SQL工具 - 数据分析SQL生成
 
+
 快速开始：
 ---------
 

staran-0.2.1.dist-info/METADATA

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: staran
+Version: 0.2.1
+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.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+staran/__init__.py,sha256=J-w06e5VGb5hGb7FLk4L869rFjhaNn6eGBJsT4V_f70,5046
+staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
+staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
+staran-0.2.1.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
+staran-0.2.1.dist-info/METADATA,sha256=FhdKvyXGUxK0Bw4PZu7xvM-LQvYC10Sf6CnDbesd1eI,5331
+staran-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+staran-0.2.1.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
+staran-0.2.1.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,,