sqlseed 0.1.0__tar.gz → 0.1.2__tar.gz

{sqlseed-0.1.0 → sqlseed-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlseed
-Version: 0.1.0
+Version: 0.1.2
 Summary: Declarative SQLite test data generation toolkit
 Project-URL: Homepage, https://github.com/sunbos/sqlseed
 Project-URL: Documentation, https://github.com/sunbos/sqlseed#readme
@@ -133,7 +133,7 @@ print(result)
 
 **🧮 表达式引擎 & 约束求解**
 
-支持派生列计算（`CutCard4byte = sCardNo[-8:]`），唯一性约束回溯求解，超时保护防止死循环。
+支持派生列计算（`last_eight = card_number[-8:]`），唯一性约束回溯求解，超时保护防止死循环。
 
 </td>
 <td>
@@ -189,10 +189,10 @@ pip install sqlseed[all]
 
 ```bash
 # AI 智能分析插件（LLM 驱动）
-pip install -e "./plugins/sqlseed-ai"
+pip install sqlseed-ai
 
 # MCP 服务器（让 AI 助手直接操作 sqlseed）
-pip install -e "./plugins/mcp-server-sqlseed"
+pip install mcp-server-sqlseed
 ```
 
 <details>
@@ -356,7 +356,7 @@ with sqlseed.connect("app.db", provider="mimesis", locale="zh_CN") as db:
     # →   orders: 50000 rows
 ```
 
-> **💡 提示**：如果两张表之间有同名列（如 `sUserNo`），即使没有声明外键约束，sqlseed 也会通过 **SharedPool 隐式关联机制**自动维持跨表一致性。
+> **💡 提示**：如果两张表之间有同名列（如 `account_id`），即使没有声明外键约束，sqlseed 也会通过 **SharedPool 隐式关联机制**自动维持跨表一致性。
 
 ---
 
@@ -447,27 +447,27 @@ sqlseed v2.0 引入了列依赖 DAG 和表达式引擎，支持从已有列计
 ```yaml
 # 银行卡信息表场景
 tables:
-  - name: card_info
+  - name: bank_cards
     count: 10000
     columns:
-      - name: sCardNo
+      - name: card_number
         generator: pattern
         params:
           regex: "62[0-9]{17}"     # 19 位银联卡号
         constraints:
           unique: true
 
-      - name: CutCard4byte
-        derive_from: sCardNo       # 依赖 sCardNo
+      - name: last_eight
+        derive_from: card_number       # 依赖 card_number
         expression: "value[-8:]"   # 取后 8 位
         constraints:
           unique: true
 
-      - name: CutCard3byte
-        derive_from: sCardNo
+      - name: last_six
+        derive_from: card_number
         expression: "value[-6:]"   # 取后 6 位
 
-      - name: sUserNo
+      - name: account_id
         generator: pattern
         params:
           regex: "U[0-9]{10}"
@@ -476,10 +476,10 @@ tables:
 ```
 
 **运作原理**：
-1. sqlseed 构建列依赖 DAG：`sCardNo → CutCard4byte, CutCard3byte`
+1. sqlseed 构建列依赖 DAG：`card_number → last_eight, last_six`
 2. 拓扑排序确定生成顺序
-3. 先生成 `sCardNo`，再通过表达式 `value[-8:]` 计算 `CutCard4byte`
-4. 如果 `CutCard4byte` 的唯一性约束失败，回溯重新生成 `sCardNo`
+3. 先生成 `card_number`，再通过表达式 `value[-8:]` 计算 `last_eight`
+4. 如果 `last_eight` 的唯一性约束失败，回溯重新生成 `card_number`
 
 #### 表达式引擎支持的函数
 
@@ -623,23 +623,23 @@ sqlseed replay snapshots/2026-04-15_033000_users.yaml
 
 ```bash
 # 安装 AI 插件
-pip install -e "./plugins/sqlseed-ai"
+pip install sqlseed-ai
 
 # 设置 API Key
 export SQLSEED_AI_API_KEY="your-api-key"
 export SQLSEED_AI_BASE_URL="https://your-llm-api-endpoint"
 
 # AI 分析并生成配置
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml
 
 # 带自纠正的 AI 建议（默认 3 轮修正）
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --verify
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --verify
 
 # 指定模型
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --model gpt-4o
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --model gpt-4o
 
 # 跳过缓存
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --no-cache
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --no-cache
 ```
 
 **AI 工作流程**：
@@ -663,7 +663,7 @@ sqlseed ai-suggest app.db --table card_info --output card_info.yaml --no-cache
 
 ```bash
 # 安装 MCP 服务器
-pip install -e "./plugins/mcp-server-sqlseed"
+pip install mcp-server-sqlseed
 
 # 启动
 python -m mcp_server_sqlseed
@@ -680,7 +680,7 @@ python -m mcp_server_sqlseed
 
 这意味着你可以在 AI 助手中说：
 
-> "分析 `app.db` 中 `card_info` 表的结构，生成 YAML 配置，然后填充 5000 行数据。"
+> "分析 `app.db` 中 `bank_cards` 表的结构，生成 YAML 配置，然后填充 5000 行数据。"
 
 AI 助手会依次调用 `inspect_schema` → `generate_yaml` → `execute_fill`，无需你手动编写任何代码。
 

{sqlseed-0.1.0 → sqlseed-0.1.2}/README.md

@@ -81,7 +81,7 @@ print(result)
 
 **🧮 表达式引擎 & 约束求解**
 
-支持派生列计算（`CutCard4byte = sCardNo[-8:]`），唯一性约束回溯求解，超时保护防止死循环。
+支持派生列计算（`last_eight = card_number[-8:]`），唯一性约束回溯求解，超时保护防止死循环。
 
 </td>
 <td>
@@ -137,10 +137,10 @@ pip install sqlseed[all]
 
 ```bash
 # AI 智能分析插件（LLM 驱动）
-pip install -e "./plugins/sqlseed-ai"
+pip install sqlseed-ai
 
 # MCP 服务器（让 AI 助手直接操作 sqlseed）
-pip install -e "./plugins/mcp-server-sqlseed"
+pip install mcp-server-sqlseed
 ```
 
 <details>
@@ -304,7 +304,7 @@ with sqlseed.connect("app.db", provider="mimesis", locale="zh_CN") as db:
     # →   orders: 50000 rows
 ```
 
-> **💡 提示**：如果两张表之间有同名列（如 `sUserNo`），即使没有声明外键约束，sqlseed 也会通过 **SharedPool 隐式关联机制**自动维持跨表一致性。
+> **💡 提示**：如果两张表之间有同名列（如 `account_id`），即使没有声明外键约束，sqlseed 也会通过 **SharedPool 隐式关联机制**自动维持跨表一致性。
 
 ---
 
@@ -395,27 +395,27 @@ sqlseed v2.0 引入了列依赖 DAG 和表达式引擎，支持从已有列计
 ```yaml
 # 银行卡信息表场景
 tables:
-  - name: card_info
+  - name: bank_cards
     count: 10000
     columns:
-      - name: sCardNo
+      - name: card_number
         generator: pattern
         params:
           regex: "62[0-9]{17}"     # 19 位银联卡号
         constraints:
           unique: true
 
-      - name: CutCard4byte
-        derive_from: sCardNo       # 依赖 sCardNo
+      - name: last_eight
+        derive_from: card_number       # 依赖 card_number
         expression: "value[-8:]"   # 取后 8 位
         constraints:
           unique: true
 
-      - name: CutCard3byte
-        derive_from: sCardNo
+      - name: last_six
+        derive_from: card_number
         expression: "value[-6:]"   # 取后 6 位
 
-      - name: sUserNo
+      - name: account_id
         generator: pattern
         params:
           regex: "U[0-9]{10}"
@@ -424,10 +424,10 @@ tables:
 ```
 
 **运作原理**：
-1. sqlseed 构建列依赖 DAG：`sCardNo → CutCard4byte, CutCard3byte`
+1. sqlseed 构建列依赖 DAG：`card_number → last_eight, last_six`
 2. 拓扑排序确定生成顺序
-3. 先生成 `sCardNo`，再通过表达式 `value[-8:]` 计算 `CutCard4byte`
-4. 如果 `CutCard4byte` 的唯一性约束失败，回溯重新生成 `sCardNo`
+3. 先生成 `card_number`，再通过表达式 `value[-8:]` 计算 `last_eight`
+4. 如果 `last_eight` 的唯一性约束失败，回溯重新生成 `card_number`
 
 #### 表达式引擎支持的函数
 
@@ -571,23 +571,23 @@ sqlseed replay snapshots/2026-04-15_033000_users.yaml
 
 ```bash
 # 安装 AI 插件
-pip install -e "./plugins/sqlseed-ai"
+pip install sqlseed-ai
 
 # 设置 API Key
 export SQLSEED_AI_API_KEY="your-api-key"
 export SQLSEED_AI_BASE_URL="https://your-llm-api-endpoint"
 
 # AI 分析并生成配置
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml
 
 # 带自纠正的 AI 建议（默认 3 轮修正）
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --verify
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --verify
 
 # 指定模型
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --model gpt-4o
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --model gpt-4o
 
 # 跳过缓存
-sqlseed ai-suggest app.db --table card_info --output card_info.yaml --no-cache
+sqlseed ai-suggest app.db --table bank_cards --output bank_cards.yaml --no-cache
 ```
 
 **AI 工作流程**：
@@ -611,7 +611,7 @@ sqlseed ai-suggest app.db --table card_info --output card_info.yaml --no-cache
 
 ```bash
 # 安装 MCP 服务器
-pip install -e "./plugins/mcp-server-sqlseed"
+pip install mcp-server-sqlseed
 
 # 启动
 python -m mcp_server_sqlseed
@@ -628,7 +628,7 @@ python -m mcp_server_sqlseed
 
 这意味着你可以在 AI 助手中说：
 
-> "分析 `app.db` 中 `card_info` 表的结构，生成 YAML 配置，然后填充 5000 行数据。"
+> "分析 `app.db` 中 `bank_cards` 表的结构，生成 YAML 配置，然后填充 5000 行数据。"
 
 AI 助手会依次调用 `inspect_schema` → `generate_yaml` → `execute_fill`，无需你手动编写任何代码。
 

{sqlseed-0.1.0 → sqlseed-0.1.2}/pyproject.toml

@@ -71,7 +71,7 @@ mimesis = "sqlseed.generators.mimesis_provider:MimesisProvider"
 
 [tool.hatch.version]
 source = "vcs"
-fallback-version = "0.1.0"
+fallback-version = "0.1.2"
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/sqlseed"]

{sqlseed-0.1.0 → sqlseed-0.1.2}/src/sqlseed/core/orchestrator.py

@@ -372,7 +372,7 @@ class DataOrchestrator:
 
         When a column name exists in the SharedPool (generated by a previously
         filled table), automatically use those values as a foreign_key strategy.
-        This handles cases like sUserNo appearing in multiple tables without
+        This handles cases like account_id appearing in multiple tables without
         an explicit FK constraint.
         """
         if not self._shared_pool._pools: