Metadata-Version: 2.4
Name: isage-tools
Version: 0.1.5
Summary: SAGE Development Tools - CLI, Web UI, and Development Utilities
Author-email: IntelliStream Team <intellistream@outlook.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/intellistream/SAGE
Project-URL: Documentation, https://intellistream.github.io/SAGE-Pub/
Project-URL: Repository, https://github.com/intellistream/SAGE.git
Project-URL: Bug Tracker, https://github.com/intellistream/SAGE/issues
Keywords: sage,tools,cli,development,web-ui,studio,devtools,frontend,intellistream
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: isage-common>=0.1.0
Requires-Dist: click>=8.0.0
Requires-Dist: jinja2>=2.11.1
Requires-Dist: markdown>=3.4.4
Requires-Dist: markupsafe>=2.0.1
Requires-Dist: packaging>=20.5
Requires-Dist: pytest>=7.0.0
Requires-Dist: pytest-cov>=4.0.0
Requires-Dist: pytest-asyncio>=0.21.0
Requires-Dist: pytest-mock>=3.10.0
Requires-Dist: pytest-timeout>=2.1.0
Requires-Dist: pytest-benchmark>=4.0.0
Requires-Dist: black>=23.0.0
Requires-Dist: isort>=5.10.0
Requires-Dist: mypy>=1.0.0
Requires-Dist: ruff>=0.1.0
Requires-Dist: flake8>=5.0.0
Requires-Dist: coverage>=7.0.0
Requires-Dist: bandit>=1.7.0
Requires-Dist: safety>=2.3.0
Requires-Dist: virtualenv>=20.31.2
Requires-Dist: filelock<4,>=3.12.2
Requires-Dist: urllib3<2.4.0,>=1.24.2
Provides-Extra: cli
Requires-Dist: typer>=0.15.0; extra == "cli"
Requires-Dist: rich>=13.0.0; extra == "cli"
Requires-Dist: click>=8.0.0; extra == "cli"
Requires-Dist: questionary>=1.10.0; extra == "cli"
Requires-Dist: prompt_toolkit>=3.0.50; extra == "cli"
Requires-Dist: tabulate>=0.9.0; extra == "cli"
Requires-Dist: colorama>=0.4.6; extra == "cli"
Requires-Dist: shellingham>=1.5.4; extra == "cli"
Provides-Extra: dev
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Requires-Dist: memory-profiler>=0.60.0; extra == "dev"
Requires-Dist: line-profiler>=4.0.0; extra == "dev"
Requires-Dist: httpx>=0.24.0; extra == "dev"
Requires-Dist: requests>=2.31.0; extra == "dev"
Requires-Dist: tomli>=2.0.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: wheel>=0.40.0; extra == "dev"
Provides-Extra: frontend
Requires-Dist: pydantic[email]>=2.0.0; extra == "frontend"
Requires-Dist: fastapi<0.116,>=0.115; extra == "frontend"
Requires-Dist: starlette<0.47,>=0.40; extra == "frontend"
Requires-Dist: uvicorn[standard]>=0.34.0; extra == "frontend"
Requires-Dist: h11>=0.8; extra == "frontend"
Requires-Dist: websockets>=11.0; extra == "frontend"
Requires-Dist: python-multipart>=0.0.6; extra == "frontend"
Requires-Dist: aiofiles>=23.0.0; extra == "frontend"
Requires-Dist: structlog>=23.0.0; extra == "frontend"
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == "frontend"
Requires-Dist: passlib[bcrypt]>=1.7.4; extra == "frontend"
Requires-Dist: pydantic-settings>=2.0.0; extra == "frontend"
Requires-Dist: configparser>=5.3.0; extra == "frontend"
Requires-Dist: pandas>=2.0.0; extra == "frontend"
Requires-Dist: numpy<2.3.0,>=2.0.0; extra == "frontend"
Requires-Dist: plotly>=5.15.0; extra == "frontend"
Requires-Dist: dash>=2.11.0; extra == "frontend"
Requires-Dist: streamlit>=1.25.0; extra == "frontend"
Requires-Dist: matplotlib>=3.7.0; extra == "frontend"
Requires-Dist: seaborn>=0.12.0; extra == "frontend"
Requires-Dist: cryptography<46,>=41.0.5; extra == "frontend"
Requires-Dist: bcrypt>=4.0.0; extra == "frontend"
Requires-Dist: authlib>=1.2.0; extra == "frontend"
Requires-Dist: prometheus-client>=0.17.0; extra == "frontend"
Requires-Dist: psutil>=5.9.0; extra == "frontend"
Provides-Extra: web
Requires-Dist: isage-tools[frontend]; extra == "web"
Provides-Extra: studio
Provides-Extra: ui
Requires-Dist: isage-tools[frontend]; extra == "ui"
Provides-Extra: basic
Requires-Dist: isage-tools[cli]; extra == "basic"
Requires-Dist: pygments>=2.0.0; extra == "basic"
Requires-Dist: pyasn1>=0.4.8; extra == "basic"
Requires-Dist: wheel>=0.37.0; extra == "basic"
Requires-Dist: setuptools>=45.0.0; extra == "basic"
Requires-Dist: packaging>=21.0; extra == "basic"
Requires-Dist: certifi>=2021.0.0; extra == "basic"
Provides-Extra: tools
Requires-Dist: isage-tools[cli,dev]; extra == "tools"
Provides-Extra: docs
Requires-Dist: sphinx>=7.0.0; extra == "docs"
Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
Requires-Dist: myst-parser>=2.0.0; extra == "docs"
Requires-Dist: mkdocs>=1.6.0; extra == "docs"
Requires-Dist: mkdocs-material>=9.6.0; extra == "docs"
Requires-Dist: pymdown-extensions>=10.2.0; extra == "docs"
Provides-Extra: full
Requires-Dist: isage-tools[cli,dev,docs,frontend]; extra == "full"

# SAGE Common - Utilities, CLI, Development Tools & Frontend

This package provides the core utilities, command-line interface, development tools, and web frontend for the SAGE (Stream Analytics in Go-like Environments) framework.

## Features

### 🛠️ Core Utilities (`sage.utils`)
- Configuration management with YAML/TOML support
- Flexible logging system with multiple backends
- Platform-specific directory management
- Type validation with Pydantic models
- Common data structures and helpers

### 💻 Command Line Interface (`sage.cli`)
- Rich CLI with auto-completion support
- Interactive questionnaires and prompts
- Beautiful table formatting and progress bars
- Cross-platform shell integration
- Core SAGE system management commands

### 🔧 Development Toolkit (`sage.dev`)
- Automated testing with pytest integration
- Code quality tools (black, isort, mypy, ruff)
- Package management and publishing
- Performance profiling and benchmarking
- Documentation generation tools

### 🌐 Web Frontend (`sage.frontend`)
- FastAPI-based web server and dashboard
- Real-time websocket communication
- Interactive data visualization
- Authentication and security features
- RESTful API endpoints

## Installation

```bash
# 基础安装 (仅 utils 核心功能)
pip install isage-common

# 基础 + CLI 工具
pip install isage-tools
# 或者
pip install isage-common[basic]

# CLI + 开发工具
pip install isage-common[tools]

# 开发环境完整安装
pip install isage-tools

# Frontend/Web 功能
pip install isage-tools
# 或者
pip install isage-common[web]

# 文档生成工具
pip install isage-common[docs]

# 完整安装 (所有功能)
pip install isage-common[full]
```

## Quick Start

### Using Utilities

```python
from sage.utils.config import load_config
from sage.utils.logging import get_logger

# Load configuration
config = load_config("my_config.yaml")

# Set up logging
logger = get_logger("my_app")
logger.info("Hello SAGE!")
```

### Using CLI

```bash
# Basic SAGE commands
sage --help
sage config show
sage status

# Core system management
sage-core start
sage-core status
sage-core stop
```

### Using Development Tools

```bash
# Run tests
sage-dev test

# Code analysis
sage-dev analyze

# Package management
sage-dev package build
sage-dev package publish

# Generate reports
sage-dev report coverage
sage-dev report performance
```

### Using Frontend

```bash
# Start SAGE web server
sage-frontend

# Start dashboard  
sage-dashboard

# Start Studio with custom config
sage studio start --config my_config.yaml
```

## Package Structure

```
src/sage/
├── utils/           # Core utilities
│   ├── config/      # Configuration management
│   ├── logging/     # Logging system
│   ├── types/       # Type definitions
│   └── helpers/     # Helper functions
├── cli/             # Command line interface
│   ├── commands/    # CLI command implementations
│   ├── prompts/     # Interactive prompts
│   └── formatters/  # Output formatting
├── dev/             # Development tools
│   ├── testing/     # Test automation
│   ├── quality/     # Code quality tools
│   ├── packaging/   # Package management
│   └── docs/        # Documentation tools
└── frontend/        # Web frontend and dashboard
    ├── studio/      # Angular Studio implementation
    ├── static/      # Static web assets
    └── templates/   # HTML templates
```

## Contributing

This package is part of the SAGE monorepo. Please see the main [SAGE repository](https://github.com/intellistream/SAGE) for contribution guidelines.

## License

MIT License - see the [LICENSE](../../LICENSE) file for details.
