redis-py-kit 0.1.0__tar.gz

redis_py_kit-0.1.0/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "WebSearch",
+      "Bash(gh api:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(uv sync:*)",
+      "Bash(uv run:*)",
+      "Bash(echo \"EXIT: $?\")",
+      "Bash(uv build:*)",
+      "Bash(uv publish:*)",
+      "Bash(rm:*)"
+    ]
+  }
+}

redis_py_kit-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+*.pyc

redis_py_kit-0.1.0/.idea/.gitignore

@@ -0,0 +1,8 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

redis_py_kit-0.1.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,15 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="PyArgumentListInspection" enabled="false" level="WARNING" enabled_by_default="false" />
+    <inspection_tool class="PyPep8Inspection" enabled="true" level="INFORMATION" enabled_by_default="true">
+      <option name="ignoredErrors">
+        <list>
+          <option value="E261" />
+          <option value="E305" />
+        </list>
+      </option>
+    </inspection_tool>
+  </profile>
+</component>

redis_py_kit-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

redis_py_kit-0.1.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="uv (redis-kit)" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="uv (redis-kit)" project-jdk-type="Python SDK" />
+</project>

redis_py_kit-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/redis-kit.iml" filepath="$PROJECT_DIR$/.idea/redis-kit.iml" />
+    </modules>
+  </component>
+</project>

redis_py_kit-0.1.0/.idea/redis-kit.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="uv (redis-kit)" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

redis_py_kit-0.1.0/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

redis_py_kit-0.1.0/.idea/workspace.xml

@@ -0,0 +1,110 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="81639434-f817-470f-b142-34a6722ea336" name="更改" comment="CLAUDE.md">
+      <change beforePath="$PROJECT_DIR$/.claude/settings.local.json" beforeDir="false" afterPath="$PROJECT_DIR$/.claude/settings.local.json" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
+    </list>
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="Git.Settings">
+    <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
+  </component>
+  <component name="GitHubPullRequestSearchHistory">{
+  &quot;lastFilter&quot;: {
+    &quot;state&quot;: &quot;OPEN&quot;,
+    &quot;assignee&quot;: &quot;Xinzz995&quot;
+  }
+}</component>
+  <component name="GithubPullRequestsUISettings">{
+  &quot;selectedUrlAndAccountId&quot;: {
+    &quot;url&quot;: &quot;https://github.com/Xinzz995/redis-kit.git&quot;,
+    &quot;accountId&quot;: &quot;f4cd84d6-287e-48c1-87f5-6633a431a863&quot;
+  }
+}</component>
+  <component name="ProjectColorInfo">{
+  &quot;associatedIndex&quot;: 3
+}</component>
+  <component name="ProjectId" id="3BvhcXlhhhysSQzokYYCIyPNP34" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.git.unshallow": "true",
+    "git-widget-placeholder": "main",
+    "last_opened_file_path": "E:/_coding/github/Xinzz995/redis-kit",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="RecentsManager">
+    <key name="CopyFile.RECENT_KEYS">
+      <recent name="E:\_coding\github\Xinzz995\redis-kit" />
+      <recent name="E:\_coding\github\Xinzz995\redis-kit\old" />
+    </key>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-6a121458b545-JavaScript-PY-251.25410.159" />
+        <option value="bundled-python-sdk-e0ed3721d81e-36ea0e71a18c-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.25410.159" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="默认任务">
+      <changelist id="81639434-f817-470f-b142-34a6722ea336" name="更改" comment="" />
+      <created>1775375531680</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1775375531680</updated>
+      <workItem from="1775375532737" duration="17756000" />
+      <workItem from="1775456942507" duration="24947000" />
+      <workItem from="1775622266896" duration="6666000" />
+      <workItem from="1775720601229" duration="12473000" />
+    </task>
+    <task id="LOCAL-00001" summary="CLAUDE.md">
+      <option name="closed" value="true" />
+      <created>1775741864037</created>
+      <option name="number" value="00001" />
+      <option name="presentableId" value="LOCAL-00001" />
+      <option name="project" value="LOCAL" />
+      <updated>1775741864037</updated>
+    </task>
+    <option name="localTasksCounter" value="2" />
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="Vcs.Log.Tabs.Properties">
+    <option name="TAB_STATES">
+      <map>
+        <entry key="MAIN">
+          <value>
+            <State />
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+  <component name="VcsManagerConfiguration">
+    <MESSAGE value="CLAUDE.md" />
+    <option name="LAST_COMMIT_MESSAGE" value="CLAUDE.md" />
+  </component>
+</project>

redis_py_kit-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

redis_py_kit-0.1.0/CLAUDE.md

@@ -0,0 +1,220 @@
+# CLAUDE.md
+
+你的目标不是"给出一个看起来合理的答案"，而是基于当前代码库和真实上下文，安全、准确地完成任务。
+
+---
+
+## 项目简介
+
+- 项目名称： redis-kit
+- 项目类型： 工具库
+- Python 版本： 3.11+
+- 包管理： uv
+- 主要技术栈： redis-py >= 7.4.0
+- 目标：redis-kit 是一个企业级 Python Redis 工具库，提供缓存、分布式锁、消息队列、布隆过滤器、计数器/ID 生成器和 Session 管理，支持同步/异步双模 API。
+
+---
+
+## 三方协同
+
+### 职责归属
+
+| 职责 | 归属 | 说明 |  
+|------|------|------|  
+| 工作流执行 | **Superpowers** | brainstorm → plan → implement → review → debug → subagent 的全流程方法论 |  
+| 状态持久化 | **planning-with-files** | `docs/planning-with-files/` 下 task_plan.md / findings.md / progress.md 的生命周期管理 |  
+| 项目约束与经验 | **本文件** | 硬约束、编码规范、质量验收标准、`docs/lessons.md` 经验循环 |
+
+### 协同规则
+
+1. **Superpowers 负责"怎么做"，本文件负责"什么不能做"和"必须满足什么"**  
+2. planning-with-files 只负责将 Superpowers 产出的计划和发现落盘到三文件，不另起规划流程  
+3. 如果 Superpowers brainstorm 已产出设计文档，task_plan.md 引用即可，不复制内容  
+4. **冲突时本文件的约束优先级最高**，插件方法论必须在这些约束内执行  
+
+### 已由插件覆盖的能力（本文件不再定义其方法论） 
+
+- 规划流程（brainstorm / plan）→ Superpowers  
+- TDD 循环（Red → Green → Refactor）→ Superpowers  
+- Code Review 方法论（逐文件 diff、自我挑战）→ Superpowers  
+- Debug 方法论（收集症状 → 形成假设 → 验证 → 定位根因）→ Superpowers  
+- Subagent 委派策略 → Superpowers  
+- 任务计划与进度追踪 → planning-with-files  
+- 跨 session 状态恢复 → planning-with-files  
+
+
+##  Session 启动协议
+
+每次新 session 按以下顺序执行，缺一不可：  
+
+```text  
+1. 读取本文件 (CLAUDE.md)             → 加载项目约束  
+2. 读取 docs/lessons.md              → 加载历史经验和踩坑记录  
+3. 读取 planning-with-files 三文件    → 恢复任务上下文  
+   ├── progress.md  → 上次做到哪了  
+   ├── task_plan.md → 哪些步骤未完成  
+   └── findings.md  → 有无待处理的发现  
+4. 综合判断：  
+   ├─ 有未完成任务 → 向用户汇报断点，等待确认后再继续  
+   └─ 无未完成任务 → 等待新指令  
+```
+汇报格式示例：
+
+"上次在做 [任务名]，完成到 Step [N]/[总数]。findings.md 中记录了 [Y] 需要注意。是否继续？"
+
+**绝对不要跳过恢复流程直接开始工作。**
+
+---
+
+## 硬约束（红线）
+
+以下为不可违反的绝对规则。所有工作流阶段、所有插件的执行都必须在这些约束内进行。
+
+| # | 约束 | 说明 |
+| --- | --- | --- |
+| 1 | 先读后改 | 修改任何文件前，必须先读取该文件及其调用链上下游；上下文不足时提问，不猜测 |
+| 2 | 先证据后结论 | 所有结论必须基于代码、日志、测试结果或运行输出；不基于假设、推测或二手结论 |
+| 3 | 先验证后宣称 | 未经实际验证的结果，不得标记为"已完成"或"可正常工作"；无法验证时必须标注"未验证"及原因 |
+| 4 | 最小改动 | 只做解决当前问题所必需的改动；不改无关代码，不预埋未来需求，不顺手重构 |
+| 5 | 不捏造 | 禁止编造代码、文件路径、日志、报错、测试结果、运行输出或需求 |
+| 6 | 不擅自扩大范围 | 不增加未要求的功能，不引入未批准的依赖，不修改不相关的公开接口 |
+| 7 | 不裸 except | 禁止裸 except，必须显式捕获具体异常类型 |
+| 8 | 坦诚沟通 | 不知道就说不知道，没做完就说没做完，不要为了看起来体面而模糊事实 |
+
+---
+
+## 工程原则
+
+- 硬约束之外的指导方向，在实际场景中权衡运用：
+
+- 遵循现有风格：项目已有的结构、命名、分层、依赖选择、测试模式，优先保持一致而非引入"更好"的模式
+
+- 简单优先，必要时优雅：默认选最简单的正确方案；仅当简单方案存在明显的可维护性问题时，才考虑更精巧的实现。判断标准：如果优雅方案的复杂度显著高于简单方案且收益不明确，选简单的
+- 只解释"为什么"：注释说明意图和决策理由，不描述代码字面行为；逻辑自解释时不写注释
+- 主动修复：发现 bug、测试失败、CI 报错时直接定位修复，不等待手把手指导；修复中产生的发现写入 findings.md
+- 影响面先行：任何可能影响接口、缓存结构、异步行为、配置兼容性的改动，先说明影响面再动手
+- 不删除未确认的代码：不删除注释、测试、配置或兼容逻辑，除非确认已无用并明确说明原因
+
+---
+
+## 编码规范
+
+### 类型与文档
+- 使用类型注解；公共函数/方法必须标注入参与返回值类型
+
+- 新增公共 API、核心函数、复杂数据结构时，补充 docstring
+- 优先小函数、单一职责；避免超长函数
+
+### 安全与精度
+
+- 字符串、时间、时区、金额、精度相关逻辑必须显式处理，禁止依赖隐式行为
+
+- 异常处理必须具体到异常类型（见硬约束 #7）
+
+### 命名规范
+
+| 类别 | 规则 | 示例 |
+| --- | --- | --- |
+| Python 文件 | 下划线分隔，全小写 | bloom_filter.py、async_cache_service.py |
+| 文件夹 | kebab-case，全小写，最多 4 层深度 | redis-kit/、docs/planning-with-files/ |
+| 类型后缀（可选） | 按职责添加 | .service、.utils、.config、.types、.test |
+| 单文件场景 | 直接放父目录，不单独建文件夹 | — |
+
+### 依赖管理
+
+非必要不引入新依赖
+如需引入，先向用户说明三点：引入收益 / 维护代价 / 替代方案
+等用户确认后再引入
+
+---
+
+## 测试要求
+
+- 任何非纯文档修改，都必须考虑测试影响
+
+- 修改业务逻辑时：先找已有测试 → 能复用就复用 → 无覆盖时补最小必要测试
+- 修 bug 时：先补能复现问题的测试，再修复（与 Superpowers TDD Red 阶段一致）
+- 无法本地运行测试时，必须明确说明原因并给出替代验证方法
+- 每次 implement 步骤完成后运行完整测试套件，确认无回归
+
+---
+
+## 质量验收标准
+
+superpowers review 阶段完成后，额外执行以下项目级检查。任何一项为"否"，不得标记任务完成：
+
+| # | 检查项 |
+| --- | --- |
+| 1 | 资深工程师会批准这个实现吗？ |
+| 2 | 所有测试通过？日志无异常输出？ |
+| 3 | 与主分支的 diff 只包含必要改动？无多余变更？ |
+| 4 | planning-with-files 三文件（task_plan.md / findings.md / progress.md）已更新到最新状态？ |
+| 5 | 本次任务产生的经验教训已写入 docs/lessons.md？（如无则跳过） |
+
+---
+
+## 自我改进循环
+
+此职责为本文件独有，两个插件均不覆盖。
+
+### 触发条件
+- 用户做出任何纠正
+
+- 发现自己犯了本可避免的错误
+- 任务收尾时 findings.md 中有长期价值的条目
+
+### 执行动作
+
+立即写入 docs/lessons.md：
+
+```markdown
+## [YYYY-MM-DD] 场景简述  
+- **错误做法**：xxx  
+- **正确做法**：xxx  
+- **防止规则**：xxx  
+```
+
+
+
+### findings.md 与 lessons.md 的边界
+
+| 内容类型 | 写入位置 | 生命周期 |
+| --- | --- | --- |
+| 任务执行中发现的技术事实（bug 根因、环境差异、配置问题等） | docs/planning-with-files/findings.md | 任务级，完成后归档 |
+| 被用户纠正的行为模式、跨任务可复用的经验教训 | docs/lessons.md | 永久，跨任务跨 session 生效 |
+| findings 中具有长期价值的条目 | 任务收尾时迁移到 docs/lessons.md | 迁移后在 findings 中标注"已迁移" |
+
+### 持续迭代
+- 每次新 session 必须读取 docs/lessons.md（见 Session 启动协议第 2 步）
+
+- 持续积累，直到同类错误不再重复出现
+
+---
+
+## 常用命令
+
+```bash
+# 依赖管理  
+uv sync                                       # 安装/同步依赖  
+
+# 运行  
+uv run python main.py                         # 运行入口  
+
+# 测试  
+uv run pytest                                 # 全量测试  
+uv run pytest -x -k "test_name"               # 单个测试（失败即停）  
+uv run pytest tests/path/to/test_file.py -q   # 指定文件测试  
+uv run pytest -k "keyword"                    # 按关键字过滤测试  
+
+# 代码质量  
+ruff check .                                  # Lint 检查  
+ruff format .                                 # 代码格式化  
+mypy app tests                                # 类型检查  
+```
+
+如项目存在 Makefile / justfile / tox.ini / noxfile.py，优先使用项目定义的入口命令。
+
+---
+
+## 交流语言
+默认使用中文交流。

redis_py_kit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Xinzz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.