ny-sync 0.1.0__tar.gz

ny_sync-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include README.md
+include requirements.txt
+include run_dashboard.bat

ny_sync-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: ny_sync
+Version: 0.1.0
+Summary: A Python SDK for AnySync: Distributed Token Bucket Rate Limiter
+Home-page: https://github.com/djmin/ny_sync
+Author: AnySync Team
+Author-email: readerror000@outlook.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: redis>=4.0.0
+Provides-Extra: dashboard
+Requires-Dist: streamlit>=1.0.0; extra == "dashboard"
+Requires-Dist: plotly>=5.0.0; extra == "dashboard"
+Requires-Dist: pandas>=1.0.0; extra == "dashboard"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+ # NySync
+
+> **Any Data, Any Source, Any Destination.**
+
+NySync 是一个 **AI-First** 的数据同步与任务编排平台：用声明式任务把“任何数据源”持续、可靠地同步到“任何目的地”，并让 Agent 能够安全地生成、校验与运维这些任务。
+
+## 当前进展（Milestone）
+
+- 已完成：分布式令牌桶限流（Python SDK，基于 Redis）
+  - 实现包含：LuaTokenBucket（默认）、NumericTokenBucket（GCRA）、StringTokenBucket（Slot-based）
+  - 支持 Dashboard 可视化与并发/批量场景验证
+- 主线目标：平台层的作业管理、调度编排、执行引擎与观测体系
+
+快速开始（Python SDK）：
+
+```python
+import redis
+from ny_sync import TokenBucket, RateUnit
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+bucket = TokenBucket(r)
+
+key = "demo"
+capacity = 10
+rate = 60 / RateUnit.MINUTE  # 每分钟 60 个
+
+allowed = bucket.allow(key, capacity, rate)
+```
+
+ ## 提供分布式令牌桶限流，基于 Redis 实现。内置三种实现：
+ 
+ - LuaTokenBucket（默认）：并发能力强，适合通用场景
+ - NumericTokenBucket（GCRA）：高吞吐批量场景
+ - StringTokenBucket（Slot-based）：一个 Token 一个 String Key，便于峰值与历史可视化
+ 
+ ## 安装
+ 
+ ```bash
+ pip install any-sync
+ ```
+ 
+ ## 快速开始
+ 
+ ```python
+ import redis
+ from ny_sync import TokenBucket, RateUnit, RateLimit, RateLimitExceeded
+ 
+ r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+ 
+ # 手动使用（TokenBucket 是 RedisTokenBucket 的简化别名）
+ bucket = TokenBucket(r)
+ key = "demo"
+ capacity = 10  # 桶容量10个
+ rate = 60 / RateUnit.MINUTE  # 每分钟补充 60 个
+ allowed = bucket.allow(key, capacity, rate)
+
+ 
+ # 装饰器使用（RateLimit 是 RateLimitDecorator 的简化别名）
+ @RateLimit(r, "api", capacity, rate)
+ def my_api():
+     return "ok"
+ ```
+ 
+ ## 可视化 Dashboard
+ 
+ 运行简单的 Streamlit Dashboard：
+ 
+ ```bash
+ # Windows
+ c:\project\anysync\python_sdk\run_dashboard.bat
+ ```
+ 
+ ## 主要导出
+ 
+ - TokenBucket / RedisTokenBucket / LuaTokenBucket / NumericTokenBucket / StringTokenBucket
+ - RateUnit（SECOND / MINUTE / HOUR / DAY / WEEK）
+ - RateLimit / RateLimitExceeded
+ 
+ ## 许可证
+ 
+ MIT

ny_sync-0.1.0/README.md

@@ -0,0 +1,81 @@
+ # NySync
+
+> **Any Data, Any Source, Any Destination.**
+
+NySync 是一个 **AI-First** 的数据同步与任务编排平台：用声明式任务把“任何数据源”持续、可靠地同步到“任何目的地”，并让 Agent 能够安全地生成、校验与运维这些任务。
+
+## 当前进展（Milestone）
+
+- 已完成：分布式令牌桶限流（Python SDK，基于 Redis）
+  - 实现包含：LuaTokenBucket（默认）、NumericTokenBucket（GCRA）、StringTokenBucket（Slot-based）
+  - 支持 Dashboard 可视化与并发/批量场景验证
+- 主线目标：平台层的作业管理、调度编排、执行引擎与观测体系
+
+快速开始（Python SDK）：
+
+```python
+import redis
+from ny_sync import TokenBucket, RateUnit
+
+r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+bucket = TokenBucket(r)
+
+key = "demo"
+capacity = 10
+rate = 60 / RateUnit.MINUTE  # 每分钟 60 个
+
+allowed = bucket.allow(key, capacity, rate)
+```
+
+ ## 提供分布式令牌桶限流，基于 Redis 实现。内置三种实现：
+ 
+ - LuaTokenBucket（默认）：并发能力强，适合通用场景
+ - NumericTokenBucket（GCRA）：高吞吐批量场景
+ - StringTokenBucket（Slot-based）：一个 Token 一个 String Key，便于峰值与历史可视化
+ 
+ ## 安装
+ 
+ ```bash
+ pip install any-sync
+ ```
+ 
+ ## 快速开始
+ 
+ ```python
+ import redis
+ from ny_sync import TokenBucket, RateUnit, RateLimit, RateLimitExceeded
+ 
+ r = redis.Redis(host="localhost", port=6379, db=0, decode_responses=True)
+ 
+ # 手动使用（TokenBucket 是 RedisTokenBucket 的简化别名）
+ bucket = TokenBucket(r)
+ key = "demo"
+ capacity = 10  # 桶容量10个
+ rate = 60 / RateUnit.MINUTE  # 每分钟补充 60 个
+ allowed = bucket.allow(key, capacity, rate)
+
+ 
+ # 装饰器使用（RateLimit 是 RateLimitDecorator 的简化别名）
+ @RateLimit(r, "api", capacity, rate)
+ def my_api():
+     return "ok"
+ ```
+ 
+ ## 可视化 Dashboard
+ 
+ 运行简单的 Streamlit Dashboard：
+ 
+ ```bash
+ # Windows
+ c:\project\anysync\python_sdk\run_dashboard.bat
+ ```
+ 
+ ## 主要导出
+ 
+ - TokenBucket / RedisTokenBucket / LuaTokenBucket / NumericTokenBucket / StringTokenBucket
+ - RateUnit（SECOND / MINUTE / HOUR / DAY / WEEK）
+ - RateLimit / RateLimitExceeded
+ 
+ ## 许可证
+ 
+ MIT

ny_sync-0.1.0/ny_sync/__init__.py

@@ -0,0 +1,37 @@
+from .rate_limiter import (
+    RedisTokenBucket,
+    LuaTokenBucket,
+    NumericTokenBucket,
+    StringTokenBucket,
+    RateUnit
+)
+
+from .decorators import (
+    RateLimitDecorator,
+    RateLimitExceededError
+)
+
+# Aliases for simplicity
+TokenBucket = RedisTokenBucket
+StringBucket = StringTokenBucket
+NumericBucket = NumericTokenBucket
+RateLimit = RateLimitDecorator
+RateLimitExceeded = RateLimitExceededError
+
+__all__ = [
+    # Core Classes
+    "RedisTokenBucket",
+    "LuaTokenBucket", 
+    "NumericTokenBucket",
+    "StringTokenBucket",
+    "RateUnit",
+    "RateLimitDecorator",
+    "RateLimitExceededError",
+    
+    # Simple Aliases
+    "TokenBucket",
+    "StringBucket",
+    "NumericBucket",
+    "RateLimit",
+    "RateLimitExceeded"
+]