dmsc 0.1.5__cp312-cp312-macosx_10_12_x86_64.whl

dmsc/__init__.py

@@ -0,0 +1,390 @@
+#!/usr/bin/env python3
+
+# Copyright © 2025-2026 Wenze Wei. All Rights Reserved.
+#
+# This file is part of DMSC.
+# The DMSC project belongs to the Dunimd Team.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# You may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+DMSC (Dunimd Middleware Service) - A high-performance Rust middleware framework with modular architecture.
+
+This Python library provides bindings to the DMSC Rust core, enabling Python applications to leverage
+a comprehensive set of middleware services including caching, messaging, service mesh, authentication,
+device management, observability, protocol handling, and database integration. The framework follows
+a plugin-based architecture where each module provides specialized functionality that can be composed
+into unified middleware solutions.
+
+Key Components:
+- Core Framework: Application lifecycle management, configuration, logging, and filesystem abstraction
+- Python Module Support: Native integration for Python-based service modules
+- Infrastructure Services: Caching, queuing, and database connectivity
+- Traffic Management: Gateway routing, rate limiting, and circuit breaker patterns
+- Service Mesh: Service discovery, load balancing, and traffic routing
+- Security: Authentication, authorization, and session management
+- Device Management: IoT device control and resource allocation
+- Observability: Metrics collection, tracing, and health monitoring
+- Protocol Support: Multi-protocol connection handling and frame processing
+- Data Validation: Schema validation, sanitization, and error reporting
+
+Example Usage:
+    from dmsc import DMSCAppBuilder, DMSCCacheModule, DMSCGateway
+    
+    app = (DMSCAppBuilder()
+        .with_config("config.yaml")
+        .with_logging(DMSCLogConfig())
+        .build())
+    cache = DMSCCacheModule()
+    gateway = DMSCGateway()
+"""
+
+__version__ = "0.1.5"
+__author__ = "Dunimd Team"
+__license__ = "Apache-2.0"
+
+# Import the Rust extension module containing all DMSC bindings
+# The dmsc extension is generated by PyO3 and provides zero-overhead access to Rust implementations
+from .dmsc import (
+    # =============================================================================
+    # Core classes - Fundamental framework components for application lifecycle,
+    # configuration management, logging, hooks, and service context management
+    # =============================================================================
+    DMSCAppRuntime, DMSCConfig, DMSCConfigManager, DMSCError,
+    DMSCFileSystem, DMSCHookBus, DMSCHookEvent, DMSCHookKind, DMSCLogConfig,
+    DMSCLogLevel, DMSCLogger, DMSCModulePhase, DMSCServiceContext,
+    
+    # =============================================================================
+    # Lock utilities - Safe lock utilities for concurrent programming
+    # Note: DMSCLockResult is a type alias, not a pyclass
+    # =============================================================================
+    DMSCLockError,
+    
+    # =============================================================================
+    # Python module support - Enables Python-based service modules to integrate
+    # with the DMSC framework, supporting both synchronous and asynchronous service patterns
+    # =============================================================================
+    DMSCPythonModule, DMSCPythonModuleAdapter, DMSCPythonServiceModule, DMSCPythonAsyncServiceModule,
+    
+    # =============================================================================
+    # Health check types - Health monitoring for services and modules
+    # =============================================================================
+    DMSCHealthStatus, DMSCHealthCheckResult, DMSCHealthCheckConfig, DMSCHealthReport,
+    
+    # =============================================================================
+    # Lifecycle management - Module lifecycle observation
+    # =============================================================================
+    DMSCLifecycleObserver,
+    
+    # =============================================================================
+    # Cache classes - In-memory caching with configurable backends, eviction policies,
+    # statistics tracking, and event notification capabilities
+    # =============================================================================
+    DMSCCacheModule, DMSCCacheManager, DMSCCacheConfig, DMSCCacheBackendType,
+    DMSCCachePolicy, DMSCCacheStats, DMSCCachedValue, DMSCCacheEvent,
+    
+    # =============================================================================
+    # Queue classes - Message queuing with multiple backend support, retry policies,
+    # dead letter handling, and queue statistics monitoring
+    # =============================================================================
+    DMSCQueueModule, DMSCQueueConfig, DMSCQueueManager, DMSCQueueMessage, 
+    DMSCQueueStats, DMSCQueueBackendType, DMSCRetryPolicy, DMSCDeadLetterConfig,
+    
+    # =============================================================================
+    # Gateway classes - Traffic management including HTTP routing, rate limiting,
+    # circuit breaker patterns, and sliding window algorithms for distributed systems
+    # =============================================================================
+    DMSCGateway, DMSCGatewayConfig, DMSCRouter, DMSCRoute,
+    DMSCRateLimiter, DMSCRateLimitConfig, RateLimitStats,
+    DMSCSlidingWindowRateLimiter, DMSCCircuitBreaker, DMSCCircuitBreakerConfig,
+    DMSCCircuitBreakerState, CircuitBreakerMetrics,
+    DMSCBackendServer, LoadBalancerServerStats,
+    
+    # =============================================================================
+    # Service mesh classes - Service discovery, traffic routing, load balancing,
+    # weighted destinations, and traffic splitting for microservices architecture
+    # =============================================================================
+    DMSCServiceMesh, DMSCServiceMeshConfig, DMSCServiceDiscovery,
+    DMSCServiceInstance, DMSCServiceStatus, DMSCServiceMeshStats,
+    DMSCTrafficRoute, DMSCMatchCriteria, DMSCRouteAction, DMSCWeightedDestination,
+    DMSCTrafficManager, DMSCHealthChecker,
+    
+    # =============================================================================
+    # Auth classes - Authentication and authorization including JWT management,
+    # session handling, OAuth integration, role-based and permission-based access control
+    # =============================================================================
+    DMSCAuthModule, DMSCAuthConfig, DMSCJWTManager, DMSCJWTClaims, DMSCJWTValidationOptions,
+    DMSCSessionManager, DMSCSession, DMSCPermissionManager, DMSCPermission, DMSCRole,
+    DMSCOAuthManager, DMSCOAuthToken, DMSCOAuthUserInfo, DMSCOAuthProvider,
+    DMSCJWTRevocationList, DMSCRevokedTokenInfo,
+    
+    # =============================================================================
+    # Device classes - IoT device management including device control, health monitoring,
+    # resource allocation, connection pooling, and network device discovery
+    # =============================================================================
+    DMSCDeviceControlModule, DMSCDevice, DMSCDeviceType, DMSCDeviceStatus,
+    DMSCDeviceCapabilities, DMSCDeviceHealthMetrics, DMSCDeviceController,
+    DMSCDeviceConfig, DMSCDeviceControlConfig, DMSCDeviceSchedulingConfig, NetworkDeviceInfo,
+    DMSCDiscoveryResult, DMSCResourceRequest,
+    DMSCResourceAllocation, DMSCRequestSlaClass, DMSCResourceWeights,
+    DMSCAffinityRules,
+    DMSCResourcePool, DMSCResourcePoolConfig, DMSCResourcePoolStatistics, DMSCResourcePoolManager,
+    DMSCConnectionPoolStatistics,
+    DMSCResourceScheduler, DMSCDeviceScheduler, DMSCSchedulingPolicy,
+    DMSCAllocationRecord, DMSCAllocationRequest, DMSCAllocationStatistics,
+    DMSCDeviceTypeStatistics, DMSCSchedulingRecommendation, DMSCSchedulingRecommendationType,
+    
+    # =============================================================================
+    # Observability classes - Metrics, tracing, and health monitoring for system
+    # observability and performance analysis
+    # =============================================================================
+    DMSCObservabilityModule, DMSCObservabilityConfig,
+    DMSCMetricsRegistry, DMSCTracer,
+    DMSCMetricType, DMSCMetricConfig, DMSCMetricSample, DMSCMetric,
+    DMSCObservabilityData,
+    
+    # =============================================================================
+    # Validation classes - Data validation, schema validation, sanitization,
+    # and validation result reporting with configurable severity levels
+    # =============================================================================
+    DMSCValidationError, DMSCValidationResult, DMSCValidationSeverity,
+    DMSCValidatorBuilder, DMSCValidationRunner, DMSCSanitizer,
+    DMSCSanitizationConfig, DMSCSchemaValidator, DMSCValidationModule,
+    
+    # =============================================================================
+    # Protocol classes - Multi-protocol support including connection management,
+    # frame processing, security levels, and protocol statistics monitoring
+    # =============================================================================
+    DMSCProtocolManager, DMSCProtocolType, DMSCProtocolConfig,
+    DMSCProtocolStatus, DMSCProtocolStats, DMSCConnectionState,
+    DMSCConnectionStats, DMSCProtocolHealth,
+    DMSCFrame, DMSCFrameHeader, DMSCFrameType,
+    DMSCConnectionInfo, DMSCMessageFlags, DMSCSecurityLevel,
+    DMSCFrameParser, DMSCFrameBuilder,
+    
+    # =============================================================================
+    # Database classes - Database configuration, connection pooling, row-level
+    # access, and result set management across different database backends
+    # =============================================================================
+    DMSCDatabaseConfig, DMSCDatabasePool, DMSCDBRow, DMSCDBResult, DatabaseType,
+    ColumnDefinition, IndexDefinition, ForeignKeyDefinition,
+    TableDefinition, LogicalOperator, Criteria, JoinClause,
+    ComparisonOperator, SortOrder, Pagination, QueryBuilder, JoinType,
+)
+
+# =============================================================================
+# Submodules - Functional submodules organized by domain area, providing
+# specialized functionality for specific middleware concerns
+# =============================================================================
+from .dmsc import (
+    device, cache, fs, hooks, observability,
+    queue, gateway, service_mesh, auth, protocol, database
+)
+
+# =============================================================================
+# __all__ export list - Public API surface defining all symbols intended for
+# external use. These symbols are imported when 'from dmsc import *' is used.
+# Organized by functional category for clarity and maintainability.
+# =============================================================================
+__all__ = [
+    # Core classes - Application framework, configuration, logging, and hooks
+    'DMSCAppRuntime', 'DMSCConfig', 'DMSCConfigManager', 'DMSCError',
+    'DMSCFileSystem', 'DMSCHookBus', 'DMSCHookEvent', 'DMSCHookKind', 'DMSCLogConfig',
+    'DMSCLogLevel', 'DMSCLogger', 'DMSCModulePhase', 'DMSCServiceContext',
+    
+    # Lock utilities - Safe lock utilities for concurrent programming
+    'DMSCLockError',
+    
+    # Python module support - Python service module integration
+    'DMSCPythonModule', 'DMSCPythonModuleAdapter', 'DMSCPythonServiceModule', 'DMSCPythonAsyncServiceModule',
+    
+    # Health check types - Health monitoring for services and modules
+    'DMSCHealthStatus', 'DMSCHealthCheckResult', 'DMSCHealthCheckConfig', 'DMSCHealthReport',
+    
+    # Lifecycle management - Module lifecycle observation
+    'DMSCLifecycleObserver',
+    
+    # Cache classes - Caching infrastructure and management
+    'DMSCCacheModule', 'DMSCCacheManager', 'DMSCCacheConfig', 'DMSCCacheBackendType',
+    'DMSCCachePolicy', 'DMSCCacheStats', 'DMSCCachedValue', 'DMSCCacheEvent',
+    
+    # Queue classes - Message queuing infrastructure
+    'DMSCQueueModule', 'DMSCQueueConfig', 'DMSCQueueManager', 'DMSCQueueMessage', 
+    'DMSCQueueStats', 'DMSCQueueBackendType', 'DMSCRetryPolicy', 'DMSCDeadLetterConfig',
+    
+    # Gateway classes - Traffic management and resilience patterns
+    'DMSCGateway', 'DMSCGatewayConfig', 'DMSCRouter', 'DMSCRoute',
+    'DMSCRateLimiter', 'DMSCRateLimitConfig', 'RateLimitStats',
+    'DMSCSlidingWindowRateLimiter', 'DMSCCircuitBreaker', 'DMSCCircuitBreakerConfig',
+    'DMSCCircuitBreakerState', 'CircuitBreakerMetrics',
+    'DMSCBackendServer', 'LoadBalancerServerStats',
+    
+    # Service mesh classes - Service discovery and traffic routing
+    'DMSCServiceMesh', 'DMSCServiceMeshConfig', 'DMSCServiceDiscovery',
+    'DMSCServiceInstance', 'DMSCServiceStatus', 'DMSCServiceMeshStats',
+    'DMSCTrafficRoute', 'DMSCMatchCriteria', 'DMSCRouteAction', 'DMSCWeightedDestination',
+    'DMSCTrafficManager', 'DMSCHealthChecker',
+    
+    # Auth classes - Authentication, authorization, and session management
+    'DMSCAuthModule', 'DMSCAuthConfig', 'DMSCJWTManager', 'DMSCJWTClaims', 'DMSCJWTValidationOptions',
+    'DMSCSessionManager', 'DMSCSession', 'DMSCPermissionManager', 'DMSCPermission', 'DMSCRole',
+    'DMSCOAuthManager', 'DMSCOAuthToken', 'DMSCOAuthUserInfo', 'DMSCOAuthProvider',
+    'DMSCJWTRevocationList', 'DMSCRevokedTokenInfo',
+    
+    # Device classes - IoT device control and resource management
+    'DMSCDeviceControlModule', 'DMSCDevice', 'DMSCDeviceType', 'DMSCDeviceStatus',
+    'DMSCDeviceCapabilities', 'DMSCDeviceHealthMetrics', 'DMSCDeviceController',
+    'DMSCDeviceConfig', 'DMSCDeviceControlConfig', 'DMSCDeviceSchedulingConfig', 'NetworkDeviceInfo',
+    'DMSCDiscoveryResult', 'DMSCResourceRequest',
+    'DMSCResourceAllocation', 'DMSCRequestSlaClass', 'DMSCResourceWeights',
+    'DMSCAffinityRules',
+    'DMSCResourcePool', 'DMSCResourcePoolConfig', 'DMSCResourcePoolStatistics', 'DMSCResourcePoolManager',
+    'DMSCConnectionPoolStatistics',
+    'DMSCResourceScheduler', 'DMSCDeviceScheduler', 'DMSCSchedulingPolicy',
+    'DMSCAllocationRecord', 'DMSCAllocationRequest', 'DMSCAllocationStatistics',
+    'DMSCDeviceTypeStatistics', 'DMSCSchedulingRecommendation', 'DMSCSchedulingRecommendationType',
+    
+    # Observability classes - Metrics, tracing, and health monitoring
+    'DMSCObservabilityModule', 'DMSCObservabilityConfig',
+    'DMSCMetricsRegistry', 'DMSCTracer',
+    'DMSCMetricType', 'DMSCMetricConfig', 'DMSCMetricSample', 'DMSCMetric',
+    'DMSCObservabilityData',
+    
+    # Validation classes - Data validation and sanitization
+    'DMSCValidationError', 'DMSCValidationResult', 'DMSCValidationSeverity',
+    'DMSCValidatorBuilder', 'DMSCValidationRunner', 'DMSCSanitizer',
+    'DMSCSanitizationConfig', 'DMSCSchemaValidator', 'DMSCValidationModule',
+    
+    # Protocol classes - Protocol management and connection handling
+    'DMSCProtocolManager', 'DMSCProtocolType', 'DMSCProtocolConfig',
+    'DMSCProtocolStatus', 'DMSCProtocolStats', 'DMSCConnectionState',
+    'DMSCConnectionStats', 'DMSCProtocolHealth',
+    'DMSCFrame', 'DMSCFrameHeader', 'DMSCFrameType',
+    'DMSCConnectionInfo', 'DMSCMessageFlags', 'DMSCSecurityLevel',
+    'DMSCFrameParser', 'DMSCFrameBuilder',
+    
+    # Database classes - Database configuration and connection pooling
+    'DMSCDatabaseConfig', 'DMSCDatabasePool', 'DMSCDBRow', 'DMSCDBResult', 'DatabaseType',
+    'ColumnDefinition', 'IndexDefinition', 'ForeignKeyDefinition',
+    'TableDefinition', 'LogicalOperator', 'Criteria', 'JoinClause',
+    'ComparisonOperator', 'SortOrder', 'Pagination', 'QueryBuilder', 'JoinType',
+    
+    # Submodules - Functional submodule references
+    'device', 'cache', 'fs', 'hooks', 'observability',
+    'queue', 'gateway', 'service_mesh', 'auth', 'protocol', 'database'
+]
+
+
+class DMSCAppBuilder:
+    """
+    Fluent API builder for DMSC applications.
+    
+    This class provides a Python-friendly chainable interface for building
+    DMSC applications. All configuration methods return `self` to enable
+    fluent-style method chaining.
+    
+    Example:
+        app = (DMSCAppBuilder()
+            .with_config("config.yaml")
+            .with_logging(DMSCLogConfig())
+            .build())
+    """
+    
+    def __init__(self):
+        from .dmsc import DMSCAppBuilder as RustBuilder
+        self._builder = RustBuilder()
+    
+    def with_config(self, config_path: str) -> 'DMSCAppBuilder':
+        """Add a configuration file path."""
+        self._builder.py_with_config(config_path)
+        return self
+    
+    def with_logging(self, log_config) -> 'DMSCAppBuilder':
+        """Add logging configuration."""
+        self._builder.py_with_logging(log_config)
+        return self
+    
+    def with_observability(self, observability_config) -> 'DMSCAppBuilder':
+        """Add observability configuration."""
+        self._builder.py_with_observability(observability_config)
+        return self
+    
+    def with_module(self, module) -> 'DMSCAppBuilder':
+        """Add a synchronous Python service module."""
+        self._builder.py_with_module(module)
+        return self
+    
+    def with_python_module(self, module) -> 'DMSCAppBuilder':
+        """Add a Python module adapter."""
+        self._builder.py_with_python_module(module)
+        return self
+    
+    def with_async_module(self, module) -> 'DMSCAppBuilder':
+        """Add an asynchronous Python service module."""
+        self._builder.py_with_async_module(module)
+        return self
+    
+    def with_dms_module(self, module) -> 'DMSCAppBuilder':
+        """Add a DMSC module adapter."""
+        self._builder.py_with_dms_module(module)
+        return self
+    
+    def with_modules(self, modules: list) -> 'DMSCAppBuilder':
+        """Add multiple synchronous Python service modules."""
+        self._builder.py_with_modules(modules)
+        return self
+    
+    def with_async_modules(self, modules: list) -> 'DMSCAppBuilder':
+        """Add multiple asynchronous Python service modules."""
+        self._builder.py_with_async_modules(modules)
+        return self
+    
+    def with_dms_modules(self, modules: list) -> 'DMSCAppBuilder':
+        """Add multiple DMSC module adapters."""
+        self._builder.py_with_dms_modules(modules)
+        return self
+    
+    def build(self):
+        """Build and return the DMSC application runtime."""
+        return DMSCAppRuntime(self._builder.py_build())
+    
+    def run(self, callback=None):
+        """Run the application with an optional callback."""
+        runtime = self.build()
+        runtime.run(callback)
+
+
+class DMSCAppRuntime:
+    """
+    DMSC Application Runtime.
+    
+    This class provides the runtime for executing a DMSC application.
+    It wraps the Rust implementation and provides a Python-friendly interface.
+    """
+    
+    def __init__(self, runtime):
+        self._runtime = runtime
+    
+    def run(self, callback=None):
+        """Run the application with an optional callback."""
+        if callback:
+            self._runtime.py_run(callback)
+        else:
+            self._runtime.py_run(lambda ctx: None)
+    
+    def get_context(self):
+        """Get the service context."""
+        return self._runtime.get_context()
+
+
+__all__.extend(['DMSCAppBuilder', 'DMSCAppRuntime'])

dmsc-0.1.5.dist-info/METADATA

@@ -0,0 +1,360 @@
+Metadata-Version: 2.4
+Name: dmsc
+Version: 0.1.5
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+License-File: LICENSE
+Summary: Dunimd Middleware Service - A high-performance Rust middleware framework with modular architecture
+Keywords: middleware,rust,async,gateway,service-mesh
+Author: Dunimd Team
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+
+<div align="center">
+
+# DMSC (Dunimd Middleware Service)
+
+English | [简体中文](README.zh.md)
+
+[Help Documentation](doc/en/index.md) | [Changelog](CHANGELOG.md)
+
+<a href="https://space.bilibili.com/3493284091529457" target="_blank">
+    <img alt="BiliBili" src="https://img.shields.io/badge/BiliBili-Dunimd-00A1D6?style=flat-square&logo=bilibili"/>
+</a>
+<a href="https://gitee.com/dunimd" target="_blank">
+    <img alt="Gitee" src="https://img.shields.io/badge/Gitee-Dunimd-C71D23?style=flat-square&logo=gitee"/>
+</a>
+<a href="https://github.com/mf2023/DMSC" target="_blank">
+    <img alt="GitHub" src="https://img.shields.io/badge/GitHub-DMSC-181717?style=flat-square&logo=github"/>
+</a>
+<a href="https://crates.io/crates/dmsc" target="_blank">
+    <img alt="Crates.io" src="https://img.shields.io/badge/Crates-DMSC-000000?style=flat-square&logo=rust"/>
+</a>
+<a href="https://pypi.org/project/dmsc/" target="_blank">
+    <img alt="PyPI" src="https://img.shields.io/badge/PyPI-DMSC-3775A9?style=flat-square&logo=pypi"/>
+</a>
+
+**DMSC (Dunimd Middleware Service)** — A high-performance Rust middleware framework that unifies backend infrastructure. Built for enterprise-scale with modular architecture, built-in observability, and distributed systems support.
+
+</div>
+
+<h2 align="center">🏗️ Core Architecture</h2>
+
+### 📐 Modular Design
+DMSC adopts a highly modular architecture with 16 core modules plus 3 optional modules, enabling on-demand composition and seamless extension:
+
+<div align="center">
+
+| Module | Description |
+|:--------|:-------------|
+| **auth** | Authentication & authorization (JWT, OAuth, permissions) |
+| **cache** | Multi-backend cache abstraction (Memory, Redis, Hybrid) |
+| **config** | Multi-source configuration management with hot reload |
+| **core** | Runtime, error handling, and service context |
+| **database** | Database abstraction with PostgreSQL, MySQL, SQLite support |
+| **device** | Device control, discovery, and intelligent scheduling |
+| **fs** | Secure file system operations and management |
+| **gateway** | API gateway with load balancing, rate limiting, and circuit breaking |
+| **grpc** | gRPC server and client support with Python bindings (requires `grpc` feature) |
+| **hooks** | Lifecycle event hooks (Startup, Shutdown, etc.) |
+| **log** | Structured logging with tracing context integration |
+| **module_rpc** | Inter-module RPC communication for distributed method calls |
+| **observability** | Metrics, tracing, and Grafana integration |
+| **database.orm** | Type-safe ORM with repository pattern, query builder, and Python bindings |
+| **protocol** | Protocol abstraction layer for multi-protocol support (requires `pyo3` feature) |
+| **queue** | Distributed queue abstraction (Kafka, RabbitMQ, Redis, Memory) |
+| **service_mesh** | Service discovery, health checking, and traffic management |
+| **validation** | Input validation and data sanitization utilities |
+| **ws** | WebSocket server support with Python bindings (requires `websocket` feature) |
+
+</div>
+
+> **Note**: Some modules require specific feature flags:
+> - `grpc`: gRPC support (`--features grpc`)
+> - `websocket`: WebSocket support (`--features websocket`)
+> - `protocol`: Protocol abstraction layer (`--features protocol` or `full`)
+
+### 🚀 Key Features
+
+#### 🔍 Distributed Tracing
+- W3C Trace Context standard implementation
+- Full-chain TraceID/SpanID propagation
+- Baggage data transmission for business context
+- Multi-language compatibility (Java, Go, Python)
+- Automatic span creation via `#[tracing::instrument]` attribute
+
+#### 📊 Enterprise Observability
+- Native Prometheus metrics export
+- Counter, Gauge, Histogram, Summary metric types
+- Out-of-the-box Grafana dashboard integration
+- Real-time performance statistics with quantile calculation
+- Full-stack metrics (CPU, memory, I/O, network)
+
+#### 🤖 Intelligent Device Management
+- Auto-discovery and registration
+- Efficient resource pool management
+- Policy-based scheduling with priority support
+- Dynamic load balancing
+- Complete device lifecycle management
+
+#### 📝 Structured Logging
+- JSON and text format support
+- Configurable sampling rates
+- Intelligent log rotation
+- Automatic tracing context inclusion
+- DEBUG/INFO/WARN/ERROR log levels
+
+#### ⚙️ Flexible Configuration
+- Multi-source loading (files, environment variables, runtime)
+- Hot configuration updates
+- Modular architecture for on-demand composition
+- Plugin-based extension mechanism
+
+#### 📁 Secure File System
+- Unified project root directory management
+- Atomic file operations
+- Categorized directory structure
+- JSON data persistence
+- Secure path handling
+
+<h2 align="center">🛠️ Installation & Environment</h2>
+
+### Prerequisites
+- **Rust**: 1.65+ (2021 Edition)
+- **Cargo**: 1.65+
+- **Platforms**: Linux, macOS, Windows
+
+### Quick Setup
+
+Add DMSC to your project's `Cargo.toml`:
+
+```toml
+[dependencies]
+dmsc = { git = "https://github.com/mf2023/DMSC" }
+```
+
+Or use cargo add:
+
+```bash
+cargo add DMSC --git https://github.com/mf2023/DMSC
+```
+
+<h2 align="center">⚡ Quick Start</h2>
+
+### Core API Usage
+
+```rust
+use dmsc::prelude::*;
+
+#[tokio::main]
+async fn main() -> DMSCResult<()> {
+    // Build service runtime
+    let app = DMSCAppBuilder::new()
+        .with_config("config.yaml")?
+        .with_logging(DMSCLogConfig::default())?
+        .with_observability(DMSCObservabilityConfig::default())?
+        .build()?;
+    
+    // Run business logic
+    app.run(|ctx: &DMSCServiceContext| async move {
+        ctx.logger().info("service", "DMSC service started")?;
+        // Your business code here
+        Ok(())
+    }).await
+}
+```
+
+### Observability Example
+
+```rust
+use dmsc::prelude::*;
+use dmsc::observability::{DMSCTracer, DMSCSpanKind, DMSCSpanStatus};
+
+#[tracing::instrument(name = "user_service", skip(ctx))]
+async fn get_user(ctx: &DMSCServiceContext, user_id: u64) -> DMSCResult<User> {
+    let user = fetch_user_from_db(user_id).await?;
+    Ok(user)
+}
+```
+
+Or using DMSCTracer directly:
+
+```rust
+use dmsc::prelude::*;
+use dmsc::observability::DMSCTracer;
+
+async fn get_user(ctx: &DMSCServiceContext, user_id: u64) -> DMSCResult<User> {
+    let tracer = DMSCTracer::new(1.0);
+    let _span = tracer.span("get_user")
+        .with_attribute("user_id", user_id.to_string())
+        .start();
+    let user = fetch_user_from_db(user_id).await?;
+    Ok(user)
+}
+```
+
+<h2 align="center">🔧 Configuration</h2>
+
+### Configuration Example
+
+```yaml
+# config.yaml
+service:
+  name: "my-service"
+  version: "1.0.0"
+
+logging:
+  level: "info"
+  file_format: "json"
+  file_enabled: true
+  console_enabled: true
+
+observability:
+  metrics_enabled: true
+  tracing_enabled: true
+  prometheus_port: 9090
+
+resource:
+  providers: ["cpu", "gpu", "memory"]
+  scheduling_policy: "priority_based"
+```
+
+### Configuration Sources
+
+DMSC supports multiple configuration sources in order of priority (lowest to highest):
+1. Configuration files (YAML, TOML, JSON)
+2. Custom configuration via code
+3. Environment variables (prefixed with `DMSC_`)
+
+<h2 align="center">🧪 Development & Testing</h2>
+
+### Running Tests
+
+```bash
+# Run all tests
+cargo test
+
+# Run specific test module
+cargo test cache
+
+# Run with verbose output
+cargo test -- --nocapture
+```
+
+<h2 align="center">❓ Frequently Asked Questions</h2>
+
+**Q: How to add a new module?**
+A: Implement the `DMSCModule` trait and register it via `DMSCAppBuilder::with_module`.
+
+**Q: How to configure logging level?**
+A: Set `logging.level` in the configuration file, supporting DEBUG/INFO/WARN/ERROR levels.
+
+**Q: How to enable metrics export?**
+A: Set `observability.metrics_enabled: true` and configure `prometheus_port` in the configuration file.
+
+**Q: How to extend configuration sources?**
+A: Implement a custom configuration loader and register it with `DMSCConfigManager`.
+
+**Q: How to handle asynchronous tasks?**
+A: Use `DMSCAppBuilder::with_async_module` to add async modules, the framework handles async lifecycle automatically.
+
+<h2 align="center">🌏 Community & Citation</h2>
+
+- Welcome to submit Issues and PRs!
+- Gitee: https://github.com/mf2023/DMSC.git
+
+
+<div align="center">
+
+## 📄 License & Open Source Agreements
+
+### 🏛️ Project License
+
+<p align="center">
+  <a href="LICENSE">
+    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache License 2.0">
+  </a>
+</p>
+
+This project uses **Apache License 2.0** open source agreement, see [LICENSE](LICENSE) file.
+
+### 📋 Dependency Package Open Source Agreements
+
+Open source packages and their agreement information used by this project:
+
+### Dependencies License
+
+<div align="center">
+
+| 📦 Package | 📜 License |
+|:-----------|:-----------|
+| serde | Apache 2.0 |
+| serde_json | MIT |
+| serde_yaml | MIT |
+| tokio | MIT |
+| prometheus | Apache 2.0 |
+| redis | MIT |
+| hyper | MIT |
+| lapin | Apache 2.0 |
+| futures | MIT |
+| yaml-rust | MIT |
+| toml | MIT |
+| etcd-client | MIT |
+| sysinfo | MIT |
+| async-trait | MIT |
+| dashmap | MIT |
+| chrono | MIT |
+| uuid | Apache 2.0 |
+| rand | MIT |
+| notify | MIT |
+| jsonwebtoken | MIT |
+| reqwest | MIT |
+| urlencoding | MIT |
+| parking_lot | MIT |
+| log | MIT |
+| pyo3 | Apache 2.0 |
+| tempfile | MIT |
+| tracing | MIT |
+| thiserror | MIT |
+| hex | MIT |
+| base64 | MIT |
+| regex | MIT |
+| url | Apache 2.0 |
+| aes-gcm | Apache 2.0 |
+| ring | Apache 2.0 |
+| lazy_static | MIT |
+| libloading | MIT |
+| zeroize | MIT/Apache-2.0 |
+| secrecy | MIT |
+| data-encoding | MIT |
+| crc32fast | MIT |
+| generic-array | MIT |
+| bincode | MIT |
+| typenum | MIT |
+| html-escape | MIT |
+| rustls | Apache 2.0/MIT |
+| rustls-pemfile | Apache 2.0/MIT |
+| webpki | ISC |
+| rustls-native-certs | Apache 2.0/MIT |
+| bytes | Apache 2.0 |
+| tonic | MIT |
+| prost | Apache 2.0 |
+| tokio-stream | MIT |
+| tower | MIT |
+| async-stream | MIT |
+| tokio-tungstenite | MIT |
+| tungstenite | MPL-2.0 |
+| num-bigint | MIT/Apache-2.0 |
+| oqs | MIT/Apache-2.0 |
+
+</div>
+
+</div>

dmsc-0.1.5.dist-info/RECORD

@@ -0,0 +1,6 @@
+dmsc/__init__.py,sha256=lezcKJ2TU5AfHe0FyiTdmbRyOPgQQTEvcDwNZeNuqhk,20210
+dmsc/dmsc.cpython-312-darwin.so,sha256=_GheCQ5NjArKAq2nNrvYddsV0uDWNBUfz7VSZdYTnSY,16641776
+dmsc-0.1.5.dist-info/METADATA,sha256=WAO0ReFnivRwknpEPCml7j2jO9D4Ts0s6cYzi-HiaYI,10821
+dmsc-0.1.5.dist-info/WHEEL,sha256=5PbULt6DKUkIiubOjwQPyn-vzBuHJr28QRlczaBjcdg,107
+dmsc-0.1.5.dist-info/licenses/LICENSE,sha256=QwcOLU5TJoTeUhuIXzhdCEEDDvorGiC6-3YTOl4TecE,11356
+dmsc-0.1.5.dist-info/RECORD,,

dmsc-0.1.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.11.5)
+Root-Is-Purelib: false
+Tag: cp312-cp312-macosx_10_12_x86_64

dmsc-0.1.5.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.