staran 0.2.4__py3-none-any.whl → 0.3.0__py3-none-any.whl

staran/__init__.py

@@ -154,18 +154,18 @@ SQL工具：
 from .tools import Date
 from .features import (
     TableSchema, FeatureGenerator, FeatureManager, FeatureTableManager, 
-    FeatureConfig, DatabaseType
+    FeatureConfig, DatabaseType, FeatureType, Field, FieldType
 )
-from .engines import SparkEngine, HiveEngine, create_engine
+from .engines import SparkEngine, HiveEngine, TuringEngine, BaseEngine, create_engine, create_turing_engine
+
+# 示例模块
+from .examples import create_aum_example, run_aum_example
 
 # 图灵平台引擎 (可选导入，避免依赖问题)
 try:
-    from .engines import TuringEngine, create_turing_engine
     from .features import quick_create_and_download
     _TURING_AVAILABLE = True
 except ImportError:
-    TuringEngine = None
-    create_turing_engine = None
     quick_create_and_download = None
     _TURING_AVAILABLE = False
 
@@ -179,12 +179,21 @@ __all__ = [
     'TableSchema', 
     'FeatureGenerator',
     'FeatureConfig',
+    'FeatureType',
+    'Field',
+    'FieldType',
     'FeatureManager',
     'FeatureTableManager',
     'DatabaseType',
+    'BaseEngine',
     'SparkEngine',
     'HiveEngine',
+    'TuringEngine',
     'create_engine',
+    'create_turing_engine',
+    # 示例模块
+    'create_aum_example',
+    'run_aum_example',
     # 向后兼容
     'SQLManager',
     'SparkSQLGenerator'
@@ -193,15 +202,13 @@ __all__ = [
 # 如果图灵引擎可用，添加到导出列表
 if _TURING_AVAILABLE:
     __all__.extend([
-        'TuringEngine',
-        'create_turing_engine',
         'quick_create_and_download'
     ])
 
 # 包信息
-__version__ = '2.0.0'
+__version__ = '0.2.4'
 __author__ = 'Staran Team'
-__description__ = 'Smart feature engineering toolkit with modular engine architecture'
+__description__ = 'Smart feature engineering toolkit with modular engine architecture and examples'
 __license__ = 'MIT'
 
 # 便捷函数示例

{staran-0.2.4.dist-info → staran-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staran
-Version: 0.2.4
+Version: 0.3.0
 Summary: staran - 高性能Python工具库
 Home-page: https://github.com/starlxa/staran
 Author: StarAn
@@ -30,7 +30,7 @@ Dynamic: summary
 
 Staran是一个强大的特征工程和数据处理工具包，提供从数据到模型的完整解决方案。特别针对工银图灵平台优化，让特征工程和模型训练变得前所未有的简单。
 
-## ✨ v0.2.4 新特性
+## ✨ v0.3.0 新特性
 
 - �️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
 - 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
@@ -315,7 +315,7 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 
 ```
 staran/
-├── __init__.py                    # 主包入口，v0.2.4功能导出
+├── __init__.py                    # 主包入口，v0.3.0功能导出
 ├── engines/                       # 🆕 模块化引擎架构
 │   ├── __init__.py               # 引擎模块入口
 │   ├── base.py                   # BaseEngine抽象基类
@@ -327,11 +327,14 @@ staran/
 │   ├── manager.py                # FeatureManager (使用引擎架构)
 │   ├── schema.py                 # 表结构定义
 │   └── generator.py              # 特征生成器
+├── examples/                      # 🆕 完整示例模块
+│   ├── __init__.py               # 示例模块入口
+│   └── aum_longtail.py           # AUM代发长尾模型示例
 ├── tools/
 │   ├── __init__.py               # 工具模块
 │   └── date.py                   # Date类实现
 ├── setup.py                      # 安装配置  
-├── README.md                     # 本文档 v0.2.4
+├── README.md                     # 本文档 v0.3.0
 └── quick-upload.sh               # 快速部署脚本
 ```
 
@@ -355,27 +358,26 @@ sql = turing.generate_sql("SELECT user_id, amount FROM users", {"table": "test"}
 print(f"SQL生成测试: {'success' if sql else 'failed'}")
 ```
 
-### 特征工程测试
+### AUM示例测试  
 ```python
-from staran import TableSchema, FeatureManager
+from staran import create_aum_example
 
-# 定义表结构
-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)
+# 创建示例并查看摘要
+example = create_aum_example("dwegdata03000")
+example.print_summary()
 
-# 创建管理器（使用引擎架构）
-manager = FeatureManager(engine_type='spark', database='analytics_db')
+# 快速运行（测试模式，不执行实际SQL）
+print("🎯 AUM长尾模型示例已准备就绪")
+print("📊 包含4张业务表的完整特征工程流程")
+```
 
-# 生成特征并查看摘要
-summary = manager.get_feature_summary(schema)
-print(f"生成特征数: {summary['total']}")
+### 一键运行示例
+```python
+from staran import run_aum_example
 
-# 生成聚合特征SQL
-result = manager.generate_feature_by_type(schema, 'aggregation', 2025, 7)
-print("SQL长度:", len(result['sql']))
+# 最简单的使用方式
+results = run_aum_example("202507")  # 指定特征月份
+print(f"✅ 处理完成: {len(results)} 个表")
 ```
 
 ### Date工具测试
@@ -408,21 +410,38 @@ print(f"✅ 继承关系: 继承自{turing.__class__.__bases__[0].__name__}")
 print("🚀 环境就绪！开始特征工程之旅")
 ```
 
-### 2. 完整ML流程
+### 2. 运行AUM示例
 ```python
-# 使用新引擎架构进行特征工程
-from staran import FeatureManager
-
-# 创建基于Turing引擎的特征管理器
-manager = FeatureManager(engine_type='turing', database='production_analytics')
+# 最简单的方式 - 一行代码完成复杂特征工程
+from staran import run_aum_example
 
-# 执行SQL并下载结果
-result = manager.execute_and_download(
-    sql="SELECT user_id, features FROM ml_features WHERE dt='2025-07-28'",
-    output_path="file:///nfsHome/ml_pipeline/"
+results = run_aum_example(
+    feature_date="202507",           # 特征月份
+    database="dwegdata03000",        # 数据库名
+    output_path="file:///nfsHome/aum_features"  # 输出路径
 )
 
-print(f"✅ 成功！使用{manager.engine.__class__.__name__}完成数据处理")
+print(f"✅ 成功！处理了4张表，生成了完整的特征数据集")
+print("📂 数据已保存到 /nfsHome/aum_features/ 目录")
+```
+
+### 3. 自定义特征工程
+```python
+# 如需更多控制，使用详细API
+from staran import create_aum_example
+
+example = create_aum_example("dwegdata03000")
+
+# 查看会生成哪些特征
+example.print_summary()
+
+# 运行特征工程
+results = example.run("202507")
+
+# 查看结果
+for table_type, result in results.items():
+    if 'table_name' in result:
+        print(f"{table_type}: {result['table_name']}")
 ```
 
 ## 📊 性能优势
@@ -437,10 +456,58 @@ print(f"✅ 成功！使用{manager.engine.__class__.__name__}完成数据处理
 - **批量处理**: 并行下载和增量处理
 - **错误恢复**: 自动重试和断点续传
 
+## 🎯 完整示例
+
+### AUM代发长尾模型 - 简化API
+位置：`staran.examples` 模块
+
+基于真实金融业务场景的完整特征工程示例，展示了新的引擎架构优势：
+
+```python
+# 最简单的使用方式
+from staran import run_aum_example
+
+# 一键运行完整特征工程流程
+results = run_aum_example(
+    feature_date="202507",  # 可选，默认当前月
+    database="dwegdata03000",
+    output_path="file:///nfsHome/aum_longtail"
+)
+
+print(f"✅ 特征工程完成！处理了 {len(results)} 个表")
+```
+
+**更多控制的方式：**
+```python
+from staran import create_aum_example
+
+# 创建示例实例
+example = create_aum_example("dwegdata03000")
+
+# 查看特征摘要
+example.print_summary()
+
+# 运行特征工程
+results = example.run("202507")
+```
+
+**示例特点：**
+- 🏦 **真实业务场景** - 4张银行核心业务表的完整处理
+- 🔧 **智能特征配置** - A表(源表+聚合)，其他表(全特征：环比5个月+同比1年)
+- 📊 **多维度特征** - 客户行为、资产配置、交易统计、境外交易等
+- 🚀 **简化API** - 一行代码完成复杂特征工程
+- 📋 **完整文档** - 每个字段都有详细的业务含义说明
+
+**数据表说明：**
+- **A表** (`bi_hlwj_dfcw_f1_f4_wy`): 客户行为特征 → 仅生成原始拷贝+聚合特征
+- **B表** (`bi_hlwj_zi_chan_avg_wy`): 资产平均余额 → 生成全部特征(聚合+环比5个月+同比1年)
+- **C表** (`bi_hlwj_zi_chang_month_total_zb`): 月度资产配置 → 生成全部特征
+- **D表** (`bi_hlwj_realy_month_stat_wy`): 月度实际统计 → 生成全部特征
+
 ## 📄 许可证
 
 MIT License
 
 ---
 
-**Staran v0.2.4** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟
+**Staran v0.3.0** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟

staran-0.3.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+staran/__init__.py,sha256=ia3Hu8bJDy9_MMv1otR659qxvtxsEWQ-JceSLxdiY3g,6945
+staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
+staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
+staran-0.3.0.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
+staran-0.3.0.dist-info/METADATA,sha256=jaYgW3F7ZpDcoJSDG0VA9jhEEqAJ3wuSfhqRv9UFvKs,16573
+staran-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+staran-0.3.0.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
+staran-0.3.0.dist-info/RECORD,,

staran-0.2.4.dist-info/RECORD

@@ -1,8 +0,0 @@
-staran/__init__.py,sha256=wUE__5gRPVTm7Epdrc9cskI2VtgbmhCnGr63TE482dg,6768
-staran/tools/__init__.py,sha256=KtudrYnxKD9HZEL4H-mrWlKrmsI3rYjJrLeC9YDTpG4,1054
-staran/tools/date.py,sha256=-QyEMWVx6czMuOIwcV7kR3gBMRVOwb5qevo7GEFSJKE,10488
-staran-0.2.4.dist-info/licenses/LICENSE,sha256=2EmsBIyDCono4iVXNpv5_px9qt2b7hfPq1WuyGVMNP4,1361
-staran-0.2.4.dist-info/METADATA,sha256=4LPrB-WKoZ7AGGHon0uA1kZDDaHeX8zv1prSXuJYWwc,14510
-staran-0.2.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-staran-0.2.4.dist-info/top_level.txt,sha256=NOUZtXSh5oSIEjHrC0lQ9WmoKtD010Q00dghWyag-Zs,7
-staran-0.2.4.dist-info/RECORD,,