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

staran/__init__.py

@@ -5,7 +5,7 @@
 Staran - 简化的Python工具库
 =========================
 
-基于Python标准库的轻量级实用工具集，提供日期处理等常用功能。
+基于Python标准库的轻量级实用工具集，提供日期处理、SQL生成等常用功能。
 
 主要特性：
 - 零依赖：仅基于Python标准库
@@ -13,10 +13,15 @@ Staran - 简化的Python工具库
 - 直观API：符合Python习惯的设计
 - 类型安全：完整的参数验证
 
+工具模块：
+---------
+1. Date工具 - 智能日期处理
+2. SQL工具 - 数据分析SQL生成
+
 快速开始：
 ---------
 
-基本用法::
+Date工具基本用法::
 
     from staran import Date
     
@@ -28,6 +33,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 +59,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 +107,7 @@ Staran - 简化的Python工具库
 
 核心功能：
 ---------
+Date工具：
 - Date: 智能日期类，支持格式记忆和多种输出
 - 日期运算：add_days(), add_months()
 - 格式化：多种预设格式方法
@@ -80,6 +115,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 +131,14 @@ Staran - 简化的Python工具库
 
 # 导入主要功能
 from .tools import Date
+from .sql import TableSchema, FeatureGenerator, SparkSQLGenerator
 
 # 主要导出
 __all__ = [
-    'Date'
+    'Date',
+    'TableSchema', 
+    'FeatureGenerator',
+    'SparkSQLGenerator'
 ]
 
 # 包信息

staran-0.2.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,8 @@
+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,,

staran-0.1.3.dist-info/METADATA

@@ -1,140 +0,0 @@
-Metadata-Version: 2.4
-Name: staran
-Version: 0.1.3
-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标准库的实用工具库，提供日期处理等常用功能，无需复杂依赖。
-
-## 🚀 快速开始
-
-### 安装
-```bash
-pip install staran
-```
-
-### 基本使用
-
-```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格式)
-```
-
-## 📖 主要功能
-
-### 1. 智能格式记忆
-Date类会根据输入格式自动设置默认输出格式：
-
-| 输入方式 | 默认输出 | 说明 |
-|---------|---------|------|
-| `Date('202504')` | `202504` | 年月紧凑格式 |
-| `Date('20250415')` | `20250415` | 完整紧凑格式 |
-| `Date(2025, 4)` | `2025-04` | 年月格式 |
-| `Date(2025, 4, 15)` | `2025-04-15` | 完整格式 |
-
-### 2. 多种输出格式
-```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
-```
-
-### 3. 日期运算
-```python
-date = Date('202504')
-
-# 运算后保持原格式
-next_month = date.add_months(1)     # 202505
-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习惯的设计
-- **类型安全** - 完整的参数验证和错误处理
-
-## 📁 项目结构
-
-```
-staran/
-├── __init__.py           # 主包入口，包含使用示例
-├── tools/
-│   ├── __init__.py      # 工具模块
-│   └── date.py          # Date类实现
-├── setup.py             # 安装配置  
-└── README.md            # 本文档
-```
-
-## 🧪 快速测试
-
-```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
-```
-
-## 📄 许可证
-
-MIT License
-
----
-
-**Staran** - 让Python工具使用更简单 🌟

staran-0.1.3.dist-info/RECORD

@@ -1,8 +0,0 @@
-staran/__init__.py,sha256=SzcxcJGSnmBbA9OWuwey1BXbz49zpsOOj3Qunodps9w,3657
-staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
-staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
-staran-0.1.3.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
-staran-0.1.3.dist-info/METADATA,sha256=sNvkxV_9PYfUdkR-F_JZMVoxpq-lXljNJLB2wsxg8B4,3497
-staran-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-staran-0.1.3.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
-staran-0.1.3.dist-info/RECORD,,