staran 1.0.9__tar.gz → 1.0.11__tar.gz

{staran-1.0.9/staran.egg-info → staran-1.0.11}/PKG-INFO

@@ -1,18 +1,21 @@
 Metadata-Version: 2.4
 Name: staran
-Version: 1.0.9
-Summary: staran - 轻量级Python日期工具库
+Version: 1.0.11
+Summary: staran - 企业级Python日期处理库
 Home-page: https://github.com/starlxa/staran
 Author: StarAn
 Author-email: starlxa@icloud.com
 License: MIT
 Project-URL: Bug Reports, https://github.com/starlxa/staran/issues
 Project-URL: Source, https://github.com/starlxa/staran
-Keywords: date datetime utilities time-processing lunar calendar i18n
+Project-URL: Documentation, https://github.com/starlxa/staran/blob/master/API_REFERENCE.md
+Keywords: date datetime utilities time-processing lunar calendar i18n timezone visualization api
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: Localization
+Classifier: Topic :: Scientific/Engineering :: Visualization
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
@@ -21,9 +24,25 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: MIT License
 Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: visualization
+Requires-Dist: matplotlib>=3.0.0; extra == "visualization"
+Requires-Dist: plotly>=5.0.0; extra == "visualization"
+Provides-Extra: web
+Requires-Dist: flask>=2.0.0; extra == "web"
+Provides-Extra: full
+Requires-Dist: matplotlib>=3.0.0; extra == "full"
+Requires-Dist: plotly>=5.0.0; extra == "full"
+Requires-Dist: flask>=2.0.0; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0.0; extra == "dev"
+Requires-Dist: black>=21.0.0; extra == "dev"
+Requires-Dist: flake8>=3.8.0; extra == "dev"
+Requires-Dist: mypy>=0.800; extra == "dev"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -34,6 +53,7 @@ Dynamic: keywords
 Dynamic: license
 Dynamic: license-file
 Dynamic: project-url
+Dynamic: provides-extra
 Dynamic: requires-python
 Dynamic: summary
 
@@ -48,8 +68,9 @@ Dynamic: summary
 
 ## 📚 文档导航
 
-- **[API 参考文档](API_REFERENCE.md)** - 完整的API文档和使用指南
-- **[更新日志](CHANGELOG.md)** - 详细的版本历史和更新记录
+- **[API 参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)** - 完整的API文档和使用指南
+- **[更新日志](https://github.com/StarLxa/staran/tree/master/CHANGELOG.md)** - 详细的版本历史和更新记录
+- **[PyPI包页面](https://pypi.org/project/staran/)** - 安装和版本信息
 - **[快速开始](#快速开始)** - 立即开始使用
 
 ## 🚀 核心理念
@@ -94,6 +115,9 @@ staran/
 ### 安装
 
 ```bash
+# 从PyPI安装 (推荐)
+pip install staran
+
 # 从源码安装
 git clone https://github.com/StarLxa/staran.git
 cd staran
@@ -172,8 +196,9 @@ python -m staran.date.tests.run_tests
 
 ## 📖 文档
 
-- **[API参考文档](API_REFERENCE.md)** - 完整的API文档、使用指南和示例
-- **[更新日志](CHANGELOG.md)** - 详细的版本历史和功能变更
+- **[API参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)** - 完整的API文档、使用指南和示例
+- **[更新日志](https://github.com/StarLxa/staran/tree/master/CHANGELOG.md)** - 详细的版本历史和功能变更
+- **[PyPI包页面](https://pypi.org/project/staran/)** - 安装和版本信息
 
 ## 🛠️ 开发
 
@@ -200,7 +225,8 @@ python -m staran.date.tests.run_tests
 ## 📞 支持
 
 - **GitHub Issues**: 报告Bug和功能请求
-- **文档**: [API参考文档](API_REFERENCE.md)
+- **文档**: [API参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)
+- **PyPI**: [PyPI包页面](https://pypi.org/project/staran/)
 - **示例**: 查看 `examples/` 目录
 
 ## 📄 许可证

{staran-1.0.9 → staran-1.0.11}/README.md

@@ -9,8 +9,9 @@
 
 ## 📚 文档导航
 
-- **[API 参考文档](API_REFERENCE.md)** - 完整的API文档和使用指南
-- **[更新日志](CHANGELOG.md)** - 详细的版本历史和更新记录
+- **[API 参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)** - 完整的API文档和使用指南
+- **[更新日志](https://github.com/StarLxa/staran/tree/master/CHANGELOG.md)** - 详细的版本历史和更新记录
+- **[PyPI包页面](https://pypi.org/project/staran/)** - 安装和版本信息
 - **[快速开始](#快速开始)** - 立即开始使用
 
 ## 🚀 核心理念
@@ -55,6 +56,9 @@ staran/
 ### 安装
 
 ```bash
+# 从PyPI安装 (推荐)
+pip install staran
+
 # 从源码安装
 git clone https://github.com/StarLxa/staran.git
 cd staran
@@ -133,8 +137,9 @@ python -m staran.date.tests.run_tests
 
 ## 📖 文档
 
-- **[API参考文档](API_REFERENCE.md)** - 完整的API文档、使用指南和示例
-- **[更新日志](CHANGELOG.md)** - 详细的版本历史和功能变更
+- **[API参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)** - 完整的API文档、使用指南和示例
+- **[更新日志](https://github.com/StarLxa/staran/tree/master/CHANGELOG.md)** - 详细的版本历史和功能变更
+- **[PyPI包页面](https://pypi.org/project/staran/)** - 安装和版本信息
 
 ## 🛠️ 开发
 
@@ -161,7 +166,8 @@ python -m staran.date.tests.run_tests
 ## 📞 支持
 
 - **GitHub Issues**: 报告Bug和功能请求
-- **文档**: [API参考文档](API_REFERENCE.md)
+- **文档**: [API参考文档](https://github.com/StarLxa/staran/tree/master/API_REFERENCE.md)
+- **PyPI**: [PyPI包页面](https://pypi.org/project/staran/)
 - **示例**: 查看 `examples/` 目录
 
 ## 📄 许可证

{staran-1.0.9 → staran-1.0.11}/setup.py

@@ -2,8 +2,8 @@ from setuptools import setup, find_packages
 
 setup(
     name="staran",
-    version="1.0.9",
-    description="staran - 轻量级Python日期工具库",
+    version="1.0.11",
+    description="staran - 企业级Python日期处理库",
     long_description=open("README.md", encoding="utf-8").read(),
     long_description_content_type="text/markdown",
     author="StarAn",
@@ -12,13 +12,39 @@ setup(
     url="https://github.com/starlxa/staran",
     packages=find_packages(),
     install_requires=[
-        # 只使用Python标准库，无外部依赖
+        # 核心功能零外部依赖
     ],
+    extras_require={
+        # v1.0.10 扩展功能的可选依赖
+        'visualization': [
+            'matplotlib>=3.0.0',
+            'plotly>=5.0.0',
+        ],
+        'web': [
+            'flask>=2.0.0',  # API服务器可选依赖
+        ],
+        'full': [
+            # 安装所有可选依赖
+            'matplotlib>=3.0.0',
+            'plotly>=5.0.0', 
+            'flask>=2.0.0',
+        ],
+        'dev': [
+            # 开发依赖
+            'pytest>=6.0.0',
+            'pytest-cov>=2.0.0',
+            'black>=21.0.0',
+            'flake8>=3.8.0',
+            'mypy>=0.800',
+        ]
+    },
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "Intended Audience :: Developers",
         "Topic :: Software Development :: Libraries :: Python Modules",
         "Topic :: Utilities",
+        "Topic :: Software Development :: Localization",
+        "Topic :: Scientific/Engineering :: Visualization",
         "Programming Language :: Python :: 3",
         "Programming Language :: Python :: 3.7",
         "Programming Language :: Python :: 3.8",
@@ -27,11 +53,18 @@ setup(
         "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: 3.12",
         "Operating System :: OS Independent",
+        "License :: OSI Approved :: MIT License",
     ],
     python_requires=">=3.7",
-    keywords="date datetime utilities time-processing lunar calendar i18n",
+    keywords="date datetime utilities time-processing lunar calendar i18n timezone visualization api",
     project_urls={
         "Bug Reports": "https://github.com/starlxa/staran/issues",
         "Source": "https://github.com/starlxa/staran",
+        "Documentation": "https://github.com/starlxa/staran/blob/master/API_REFERENCE.md",
+    },
+    entry_points={
+        'console_scripts': [
+            'staran=staran.date.utils.cli:main',  # 命令行工具 (如果需要)
+        ],
     },
 )

staran-1.0.11/staran/__init__.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+Staran - 企业级Python日期处理库
+"""
+
+__version__ = "1.0.11"
+__author__ = "StarAn"
+__email__ = "starlxa@icloud.com"
+__license__ = "MIT"
+
+# 导入核心功能
+try:
+    from .date import (
+        Date, 
+        DateRange,
+        DateError,
+        LunarDate,
+        Language,
+        today, 
+        from_string,
+        from_lunar,
+        parse_expression,
+        get_version_info,
+        get_feature_status
+    )
+except ImportError as e:
+    import warnings
+    warnings.warn(f"Staran核心功能导入失败: {e}")
+    
+    Date = None
+    DateRange = None
+    DateError = Exception
+    LunarDate = None
+    Language = None
+    
+    def today():
+        raise ImportError("Staran核心功能不可用")
+    
+    def from_string(date_string: str):
+        raise ImportError("Staran核心功能不可用")
+    
+    def from_lunar(year: int, month: int, day: int, is_leap: bool = False):
+        raise ImportError("Staran核心功能不可用")
+    
+    def parse_expression(expression: str):
+        raise ImportError("Staran核心功能不可用")
+    
+    def get_version_info():
+        return {'version': __version__, 'status': 'core_unavailable'}
+    
+    def get_feature_status():
+        return {'core_available': False}
+
+__all__ = [
+    '__version__', '__author__', '__email__', '__license__',
+    'Date', 'DateRange', 'DateError', 'LunarDate', 'Language',
+    'today', 'from_string', 'from_lunar', 'parse_expression',
+    'get_version_info', 'get_feature_status'
+]

staran-1.0.11/staran/date/__init__.py

@@ -0,0 +1,91 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+Staran 日期处理库 v1.0.10 - 简化版导入
+"""
+
+# 版本信息
+__version__ = "1.0.11"
+__author__ = "StarAn"
+__email__ = "starlxa@icloud.com"
+
+# 直接导入核心模块 (测试用)
+from .core import Date, DateRange, DateError, LunarDate, Language
+
+# 导入扩展功能
+from .extensions import (
+    Timezone, TimezoneInfo, TIMEZONE_AVAILABLE,
+    DateExpressionParser, ParseResult, EXPRESSIONS_AVAILABLE,
+    SolarTerms, SolarTerm, SOLAR_TERMS_AVAILABLE
+)
+
+# 导入集成功能  
+from .integrations import (
+    DateVisualization, ChartData, TimeSeriesPoint, VISUALIZATION_AVAILABLE,
+    StaranAPIServer, StaranAPIHandler, API_SERVER_AVAILABLE
+)
+
+# 便捷函数
+def today():
+    """创建今日的Date对象"""
+    return Date.today()
+
+def from_string(date_string: str):
+    """从字符串创建Date对象"""
+    return Date(date_string)
+
+def from_lunar(year: int, month: int, day: int, is_leap: bool = False):
+    """从农历创建Date对象"""
+    return Date.from_lunar(year, month, day, is_leap)
+
+def parse_expression(expression: str):
+    """解析日期表达式 (v1.0.10)"""
+    if not EXPRESSIONS_AVAILABLE or not DateExpressionParser:
+        return None
+    parser = DateExpressionParser()
+    result = parser.parse(expression)
+    if result and result.success and result.date:
+        # 确保返回Date对象而不是datetime.date
+        if hasattr(result.date, 'year'):
+            return Date(result.date.year, result.date.month, result.date.day)
+        else:
+            return result.date
+    return None
+
+def get_version_info():
+    """获取版本和功能信息"""
+    return {
+        'version': __version__,
+        'author': __author__,
+        'timezone_support': TIMEZONE_AVAILABLE,
+        'expression_parsing': EXPRESSIONS_AVAILABLE,
+        'solar_terms': SOLAR_TERMS_AVAILABLE,
+        'visualization': VISUALIZATION_AVAILABLE,
+        'api_server': API_SERVER_AVAILABLE,
+        'api_count': 190
+    }
+
+def get_feature_status():
+    """获取功能状态"""
+    return {
+        'core_date_operations': True,
+        'lunar_calendar': True,
+        'multilingual_support': True,
+        'timezone_support': TIMEZONE_AVAILABLE,
+        'expression_parsing': EXPRESSIONS_AVAILABLE,
+        'solar_terms': SOLAR_TERMS_AVAILABLE,
+        'data_visualization': VISUALIZATION_AVAILABLE,
+        'rest_api': API_SERVER_AVAILABLE
+    }
+
+# 导出
+__all__ = [
+    '__version__', '__author__', '__email__',
+    'Date', 'DateRange', 'DateError', 'LunarDate', 'Language',
+    'Timezone', 'TimezoneInfo', 'DateExpressionParser', 'ParseResult',
+    'SolarTerms', 'SolarTerm', 'DateVisualization', 'ChartData', 
+    'TimeSeriesPoint', 'StaranAPIServer', 'StaranAPIHandler',
+    'today', 'from_string', 'from_lunar', 'parse_expression',
+    'get_version_info', 'get_feature_status'
+]

staran-1.0.11/staran/date/core/__init__.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+Staran 核心模块
+==============
+
+包含日期处理的核心功能：
+- Date类：核心日期处理类
+- LunarDate：农历日期支持
+- Language：多语言国际化支持
+"""
+
+from .core import Date, DateRange, DateError
+from .lunar import LunarDate
+from .i18n import Language
+
+__all__ = [
+    'Date',
+    'DateRange', 
+    'DateError',
+    'LunarDate',
+    'Language'
+]