staran 0.5.0__tar.gz → 0.6.1__tar.gz

staran-0.6.1/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+recursive-include staran *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]

{staran-0.5.0 → staran-0.6.1}/PKG-INFO

@@ -1,48 +1,70 @@
 Metadata-Version: 2.4
 Name: staran
-Version: 0.5.0
+Version: 0.6.1
 Summary: staran - 高性能Python工具库
 Home-page: https://github.com/starlxa/staran
 Author: StarAn
-Author-email: starlxa@icloud.com
+Author-email: StarAn <starlxa@icloud.com>
+License: MIT
+Project-URL: Homepage, https://github.com/starlxa/staran
+Project-URL: Bug Reports, https://github.com/starlxa/staran/issues
+Project-URL: Source, https://github.com/starlxa/staran
+Keywords: machine-learning,feature-engineering,data-processing,sql-generation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
 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
 
-# Star## ✨ v0.4.2 新特性
+# Star## Staran ✨ v0.6.1 新特性
 
-- 📋 **独立Schema模块** - 专门的表结构定义和管理模块
+- � **完善的包管理** - 优化setup.py配置，移除不必要的标准库依赖
+- �📋 **独立Schema模块** - 专门的表结构定义和管理模块
 - 📄 **文档自动生成** - 支持Markdown/PDF/HTML格式的技术文档生成
 - 🏢 **业务域支持** - AUM等业务领域的标准表结构定义
-- 🔗 **无缝集成** - Schema与特征工程examples模块完美集成
+- 🔗 **无缝集成** - Schema与特征工程模块完美集成
 - 🛠️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
 - 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
 - 🎯 **继承复用架构** - TuringEngine继承SparkEngine，复用SQL生成逻辑
 - 📦 **清晰代码分离** - SQL生成与平台特定执行逻辑完全分离
 - 🚀 **易于扩展** - 新增数据库支持只需实现BaseEngine接口
 - 📁 **独立引擎存储** - engines/文件夹专门存放所有数据库引擎
-- 🔄 **向后兼容** - 保持对原有API的完全兼容工程工具包
+- 🔄 **向后兼容** - 保持对原有API的完全兼容
+
+## 🎯 专为机器学习设计的Python工具包
+
+Staran是一个强大的特征工程和数据处理工具包，提供从数据到模型的完整解决方案。特别针对工银图灵平台优化，让特征工程和模型训练变得前所未有的简单。
+
+## ✨ v0.6.1 新特性
+
+- 🔧 **完善的包管理** - 优化setup.py配置，移除不必要的标准库依赖
+- 🛠️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
+- 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
+- 🎯 **继承复用架构** - TuringEngine继承SparkEngine，复用SQL生成逻辑
+- 📦 **清晰代码分离** - SQL生成与平台特定执行逻辑完全分离
+- 🚀 **易于扩展** - 新增数据库支持只需实现BaseEngine接口
+- 📁 **独立引擎存储** - engines/文件夹专门存放所有数据库引擎
+- 🔄 **向后兼容** - 保持对原有API的完全兼容
 
 ## � 专为机器学习设计的Python工具包
 
 Staran是一个强大的特征工程和数据处理工具包，提供从数据到模型的完整解决方案。特别针对工银图灵平台优化，让特征工程和模型训练变得前所未有的简单。
 
-## ✨ v0.4.2 新特性
+## ✨ v0.6.0 新特性
 
 - �️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
 - 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
@@ -361,7 +383,7 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 
 ```
 staran/
-├── __init__.py                    # 主包入口，v0.4.2功能导出
+├── __init__.py                    # 主包入口，v0.6.0功能导出
 ├── schemas/                       # 🆕 表结构定义与文档生成模块
 │   ├── __init__.py               # Schema模块入口
 │   ├── document_generator.py     # 文档生成器 (MD/PDF/HTML)
@@ -385,7 +407,7 @@ staran/
 │   ├── __init__.py               # 工具模块
 │   └── date.py                   # Date类实现
 ├── setup.py                      # 安装配置  
-├── README.md                     # 本文档 v0.4.2
+├── README.md                     # 本文档 v0.6.0
 └── quick-upload.sh               # 快速部署脚本
 ```
 
@@ -561,4 +583,4 @@ MIT License
 
 ---
 
-**Staran v0.4.2** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟
+**Staran v0.6.0** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟

staran-0.5.0/staran.egg-info/PKG-INFO → staran-0.6.1/README.md

@@ -1,48 +1,38 @@
-Metadata-Version: 2.4
-Name: staran
-Version: 0.5.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
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license-file
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
-
-# Star## ✨ v0.4.2 新特性
-
-- 📋 **独立Schema模块** - 专门的表结构定义和管理模块
+# Star## Staran ✨ v0.6.1 新特性
+
+- � **完善的包管理** - 优化setup.py配置，移除不必要的标准库依赖
+- �📋 **独立Schema模块** - 专门的表结构定义和管理模块
 - 📄 **文档自动生成** - 支持Markdown/PDF/HTML格式的技术文档生成
 - 🏢 **业务域支持** - AUM等业务领域的标准表结构定义
-- 🔗 **无缝集成** - Schema与特征工程examples模块完美集成
+- 🔗 **无缝集成** - Schema与特征工程模块完美集成
+- 🛠️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
+- 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
+- 🎯 **继承复用架构** - TuringEngine继承SparkEngine，复用SQL生成逻辑
+- 📦 **清晰代码分离** - SQL生成与平台特定执行逻辑完全分离
+- 🚀 **易于扩展** - 新增数据库支持只需实现BaseEngine接口
+- 📁 **独立引擎存储** - engines/文件夹专门存放所有数据库引擎
+- 🔄 **向后兼容** - 保持对原有API的完全兼容
+
+## 🎯 专为机器学习设计的Python工具包
+
+Staran是一个强大的特征工程和数据处理工具包，提供从数据到模型的完整解决方案。特别针对工银图灵平台优化，让特征工程和模型训练变得前所未有的简单。
+
+## ✨ v0.6.1 新特性
+
+- 🔧 **完善的包管理** - 优化setup.py配置，移除不必要的标准库依赖
 - 🛠️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
 - 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
 - 🎯 **继承复用架构** - TuringEngine继承SparkEngine，复用SQL生成逻辑
 - 📦 **清晰代码分离** - SQL生成与平台特定执行逻辑完全分离
 - 🚀 **易于扩展** - 新增数据库支持只需实现BaseEngine接口
 - 📁 **独立引擎存储** - engines/文件夹专门存放所有数据库引擎
-- 🔄 **向后兼容** - 保持对原有API的完全兼容工程工具包
+- 🔄 **向后兼容** - 保持对原有API的完全兼容
 
 ## � 专为机器学习设计的Python工具包
 
 Staran是一个强大的特征工程和数据处理工具包，提供从数据到模型的完整解决方案。特别针对工银图灵平台优化，让特征工程和模型训练变得前所未有的简单。
 
-## ✨ v0.4.2 新特性
+## ✨ v0.6.0 新特性
 
 - �️ **模块化引擎架构** - 独立的引擎模块，支持Spark、Hive、图灵平台
 - 🔧 **统一接口设计** - 所有引擎提供一致的SQL生成、执行和下载接口
@@ -361,7 +351,7 @@ tomorrow = date.add_days(1)         # 202504 (智能处理)
 
 ```
 staran/
-├── __init__.py                    # 主包入口，v0.4.2功能导出
+├── __init__.py                    # 主包入口，v0.6.0功能导出
 ├── schemas/                       # 🆕 表结构定义与文档生成模块
 │   ├── __init__.py               # Schema模块入口
 │   ├── document_generator.py     # 文档生成器 (MD/PDF/HTML)
@@ -385,7 +375,7 @@ staran/
 │   ├── __init__.py               # 工具模块
 │   └── date.py                   # Date类实现
 ├── setup.py                      # 安装配置  
-├── README.md                     # 本文档 v0.4.2
+├── README.md                     # 本文档 v0.6.0
 └── quick-upload.sh               # 快速部署脚本
 ```
 
@@ -561,4 +551,4 @@ MIT License
 
 ---
 
-**Staran v0.4.2** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟
+**Staran v0.6.0** - 模块化引擎架构，让机器学习特征工程变得前所未有的简单 🌟

staran-0.6.1/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "staran"
+version = "0.6.1"
+description = "staran - 高性能Python工具库"
+readme = "README.md"
+authors = [{name = "StarAn", email = "starlxa@icloud.com"}]
+license = {text = "MIT"}
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+keywords = ["machine-learning", "feature-engineering", "data-processing", "sql-generation"]
+dependencies = []
+requires-python = ">=3.7"
+
+[project.urls]
+Homepage = "https://github.com/starlxa/staran"
+"Bug Reports" = "https://github.com/starlxa/staran/issues"
+Source = "https://github.com/starlxa/staran"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["staran*"]
+exclude = ["tests*"]

staran-0.6.1/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="staran",
+    version="0.6.1",
+    description="staran - 高性能Python工具库",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="StarAn",
+    author_email="starlxa@icloud.com",
+    license="MIT",
+    url="https://github.com/starlxa/staran",
+    packages=find_packages(),
+    install_requires=[
+        # 添加实际需要的外部依赖
+        # datetime, calendar, re 都是标准库，无需列出
+    ],
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.7",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.7",
+    keywords="machine-learning feature-engineering data-processing sql-generation",
+    project_urls={
+        "Bug Reports": "https://github.com/starlxa/staran/issues",
+        "Source": "https://github.com/starlxa/staran",
+    },
+)

staran-0.6.1/staran/banks/__init__.py

@@ -0,0 +1,30 @@
+"""
+staran.banks - 银行配置模块
+
+该模块包含不同银行的特定配置，包括：
+- 数据库连接配置
+- 表结构定义
+- 业务规则设置
+- 模型配置
+
+支持的银行：
+- xinjiang_icbc: 新疆工行配置
+
+版本: 0.6.0
+"""
+
+from .xinjiang_icbc import (
+    XinjiangICBCConfig,
+    get_xinjiang_icbc_tables,
+    get_xinjiang_icbc_models,
+    xinjiang_icbc_config
+)
+
+__all__ = [
+    'XinjiangICBCConfig',
+    'xinjiang_icbc_config',
+    'get_xinjiang_icbc_tables', 
+    'get_xinjiang_icbc_models'
+]
+
+__version__ = "0.6.0"

staran-0.6.1/staran/banks/xinjiang_icbc/__init__.py

@@ -0,0 +1,90 @@
+"""
+新疆工行银行配置模块
+
+专门针对新疆工行代发长尾客户的配置：
+- 数据库表结构定义（代发长尾客户专用）
+- 业务规则配置
+- 模型配置（提升模型和防流失模型）
+
+数据库: xinjiang_icbc_daifa_longtail
+业务范围: 代发长尾客户
+"""
+
+from dataclasses import dataclass
+from typing import Dict, List, Optional
+from datetime import datetime
+
+
+@dataclass 
+class XinjiangICBCConfig:
+    """新疆工行配置类"""
+    
+    # 数据库配置
+    database_name: str = "xinjiang_icbc_daifa_longtail"
+    schema_name: str = "daifa_longtail"
+    
+    # 业务配置
+    business_domain: str = "代发长尾客户"
+    customer_segment: str = "代发长尾"
+    
+    # 模型配置
+    available_models: List[str] = None
+    
+    # 业务规则
+    longtail_asset_min: float = 10000  # 长尾客户最小资产
+    longtail_asset_max: float = 100000  # 长尾客户最大资产
+    upgrade_target: float = 3000  # 提升目标金额
+    churn_threshold: float = 1500  # 流失阈值金额
+    
+    def __post_init__(self):
+        if self.available_models is None:
+            self.available_models = [
+                "daifa_longtail_upgrade_3k",    # 代发长尾提升3k模型
+                "daifa_longtail_churn_1_5k"     # 代发长尾防流失1.5k模型
+            ]
+
+
+def get_xinjiang_icbc_tables() -> Dict[str, str]:
+    """获取新疆工行代发长尾客户表配置"""
+    return {
+        # 代发长尾客户行为表
+        "daifa_longtail_behavior": "xinjiang_icbc_daifa_hlwj_dfcw_f1_f4_wy",
+        
+        # 代发长尾客户资产平均表  
+        "daifa_longtail_asset_avg": "xinjiang_icbc_daifa_hlwj_zi_chan_avg_wy",
+        
+        # 代发长尾客户资产配置表
+        "daifa_longtail_asset_config": "xinjiang_icbc_daifa_hlwj_zi_chan_config_wy",
+        
+        # 代发长尾客户月度统计表
+        "daifa_longtail_monthly_stat": "xinjiang_icbc_daifa_hlwj_monthly_stat_wy"
+    }
+
+
+def get_xinjiang_icbc_models() -> Dict[str, Dict]:
+    """获取新疆工行代发长尾客户模型配置"""
+    return {
+        "daifa_longtail_upgrade_3k": {
+            "name": "代发长尾客户提升3k预测模型",
+            "description": "预测下个月代发长尾客户资产提升3000元的概率",
+            "target": "upgrade_3k_next_month",
+            "model_type": "binary_classification",
+            "business_objective": "识别有潜力提升资产的代发长尾客户",
+            "target_threshold": 3000,
+            "prediction_window": "1_month"
+        },
+        
+        "daifa_longtail_churn_1_5k": {
+            "name": "代发长尾客户防流失1.5k预测模型", 
+            "description": "预测下个月代发长尾客户流失1500元资产的风险",
+            "target": "churn_1_5k_next_month",
+            "model_type": "binary_classification", 
+            "business_objective": "识别有流失风险的代发长尾客户",
+            "target_threshold": 1500,
+            "prediction_window": "1_month"
+        }
+    }
+
+
+# 创建默认配置实例
+xinjiang_icbc_config = XinjiangICBCConfig()

staran-0.6.1/staran/models/__init__.py

@@ -0,0 +1,72 @@
+"""
+staran.models v0.6.0 - 新疆工行代发长尾客户模型管理
+
+专门针对新疆工行代发长尾客户的两个核心模型：
+1. 代发长尾客户提升3k预测模型 (daifa_longtail_upgrade_3k)
+2. 代发长尾客户防流失1.5k预测模型 (daifa_longtail_churn_1_5k)
+
+主要功能：
+- 模型配置管理
+- SQL驱动的目标变量定义
+- 模型注册和版本控制
+- 新疆工行特定配置
+"""
+
+from .config import ModelConfig, create_model_config
+from .target import TargetDefinition, create_target_definition
+from .registry import ModelRegistry, register_model, save_model_registry
+from .daifa_models import (
+    create_daifa_longtail_upgrade_model,
+    create_daifa_longtail_churn_model,
+    get_available_daifa_models,
+    create_both_daifa_models
+)
+
+# 便捷函数
+def create_xinjiang_icbc_models(output_dir: str = "./xinjiang_models") -> dict:
+    """为新疆工行创建两个代发长尾客户模型"""
+    return create_both_daifa_models(output_dir)
+
+def list_available_models() -> list:
+    """列出所有可用的代发长尾客户模型"""
+    return get_available_daifa_models()
+
+def get_model_summary() -> dict:
+    """获取模型概述信息"""
+    return {
+        "version": "0.6.0",
+        "bank": "新疆工行",
+        "business_domain": "代发长尾客户",
+        "models": [
+            {
+                "name": "daifa_longtail_upgrade_3k",
+                "description": "预测下个月代发长尾客户资产提升3k的概率",
+                "target_amount": 3000,
+                "model_type": "binary_classification"
+            },
+            {
+                "name": "daifa_longtail_churn_1_5k", 
+                "description": "预测下个月代发长尾客户流失1.5k资产的风险",
+                "target_amount": 1500,
+                "model_type": "binary_classification"
+            }
+        ]
+    }
+
+__all__ = [
+    # 核心组件
+    'ModelConfig', 'TargetDefinition', 'ModelRegistry',
+    
+    # 创建函数
+    'create_model_config', 'create_target_definition', 'register_model',
+    
+    # 代发长尾模型
+    'create_daifa_longtail_upgrade_model', 'create_daifa_longtail_churn_model',
+    'create_both_daifa_models', 'get_available_daifa_models',
+    
+    # 便捷函数
+    'create_xinjiang_icbc_models', 'list_available_models', 'get_model_summary',
+    'save_model_registry'
+]
+
+__version__ = "0.6.0"