mongo-2-sql 0.1.4__tar.gz → 0.1.6__tar.gz

{mongo_2_sql-0.1.4 → mongo_2_sql-0.1.6}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Bao Bingbo
+Copyright (c) 2026 baobingbo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ 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.
+SOFTWARE.

{mongo_2_sql-0.1.4 → mongo_2_sql-0.1.6}/PKG-INFO

@@ -1,9 +1,13 @@
 Metadata-Version: 2.4
 Name: mongo-2-sql
-Version: 0.1.4
+Version: 0.1.6
 Summary: A library to convert MongoDB aggregation pipelines to SQL parser
 Author-email: Bao Bingbo <baob2@outlook.com>
 License: MIT License
+Project-URL: Homepage, https://github.com/baobingbo/mongo-2-sql
+Project-URL: Documentation, https://github.com/baobingbo/mongo-2-sql#readme
+Project-URL: Repository, https://github.com/baobingbo/mongo-2-sql.git
+Project-URL: Issues, https://github.com/baobingbo/mongo-2-sql/issues
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -24,42 +28,62 @@ Dynamic: license-file
 
 Mongo to SQL 是一个将 MongoDB 聚合管道转换为 SQL 查询语句的工具。
 
-## 版本更新 v0.1.4
+## 项目仓库
 
-### 新增功能
-
-#### 1. CTE（公用表表达式）统一处理
-- **$addFields、$project、$group 阶段现在使用 CTE 方式处理**
-- 将复杂的聚合管道拆分为多个SQL片段，使用 WITH 子句拼接
-- 自动管理 CTE 命名和依赖关系
-- 适用于多次投影、多层分组等复杂场景
-
-#### 2. 表达式解析器统一架构
-- **ExpressionResolver**: 统一的表达式解析器入口，避免 stage 之间相互 import
-- **BaseExpressionParser**: 基础表达式解析器基类，减少代码重复
-- 提供通用操作符集合、字段引用解析、值转换等基础功能
+- **GitHub**: [baobingbo/mongo-2-sql](https://github.com/baobingbo/mongo-2-sql)
 
-#### 3. SQL 格式化输出
-- 使用 sqlparse 库自动格式化 SQL
-- SELECT、FROM、WHERE、GROUP BY 等关键字独占一行
-- 字段列表缩进对齐，提高可读性
-- WHERE 子句添加注释提示可扩展性
+## 版本更新 v0.1.6
 
-#### 4. Project 阶段增强
-- 支持字段重命名语法: `{"new_name": "$old_name"}`
-- 聚合后字段引用自动处理（无需添加表前缀）
-- 支持包含模式和排除模式
-
-#### 5. Stage 解耦架构
-- 各 stage 表达式解析器通过统一的 ExpressionResolver 进行交互
-- 避免模块之间的循环依赖
-- 更易于扩展和维护
-
-### 问题修复
+### 新增功能
 
-- **修复 `_id` 字段双引号问题**: 不再使用 `"_id"`，改为 `_id`
-- **修复聚合后字段引用**: 聚合后的字段不再错误添加表前缀
-- **修复模块导入路径**: 统一使用相对导入，避免 "attempted relative import beyond top-level package" 错误
+#### 1. $addFields 阶段表达式与字面量语义
+- `$addFields` 使用独立的 `AddFieldsExpressionParser`，不再复用 `$project` 的解析逻辑，避免跨阶段耦合
+- `$addFields` 支持三类值：
+  - **字面量值**: 如 `{"score": 1}`, `{ "flag": true }`, `{ "text": "hello" }`，会直接转换为 `1 AS score`、`TRUE AS flag`、`'hello' AS text`
+  - **字段引用**: 如 `{ "cat": "$category" }`，会转换为 `t.category AS cat`
+  - **表达式**: 如 `{ "total": { "$add": [1, "$price"] } }` 或 `{ "isBig": { "$gt": ["$amount", 100] } }`
+- **仅 `$project` 阶段中**，`{"field": 1}` / `{"field": 0}` 仍然表示"包含/排除字段"；其他阶段（包括 `$addFields`）中，`1` 始终被视为字面量数值 1
+
+#### 2. $addFields 阶段多种解析方式增强
+在 `stages/add_fields/expr.py` 中新增了以下操作符的解析支持：
+
+**算术操作符**：
+- `$add` - 加法运算（对应 SQL: `+`）
+- `$subtract` - 减法运算（对应 SQL: `-`）
+- `$multiply` - 乘法运算（对应 SQL: `*`）
+- `$divide` - 除法运算（对应 SQL: `/`）
+- `$mod` - 取模运算（对应 SQL: `%`）
+
+**字符串操作符**：
+- `$concat` - 字符串连接（对应 SQL: `CONCAT()`）
+- `$toLower` - 转小写（对应 SQL: `LOWER()`）
+- `$toUpper` - 转大写（对应 SQL: `UPPER()`）
+- `$substr` - 子字符串截取（对应 SQL: `SUBSTR()`）
+
+**日期操作符**：
+- `$dateToString` - 日期格式化（对应 SQL: `STRFTIME()`）
+- `$year` - 提取年份
+- `$month` - 提取月份
+- `$dayOfMonth` - 提取日期
+- `$hour` - 提取小时
+- `$minute` - 提取分钟
+- `$second` - 提取秒
+
+**条件操作符**：
+- `$cond` - 条件判断（对应 SQL: `CASE WHEN`）
+- `$ifNull` - 空值处理（对应 SQL: `COALESCE()`）
+
+**比较操作符**：
+- `$eq` - 等于（对应 SQL: `=`）
+- `$ne` - 不等于（对应 SQL: `!=`）
+- `$gt` - 大于（对应 SQL: `>`）
+- `$gte` - 大于等于（对应 SQL: `>=`）
+- `$lt` - 小于（对应 SQL: `<`）
+- `$lte` - 小于等于（对应 SQL: `<=`）
+
+**数组操作符**：
+- `$size` - 数组长度（对应 SQL: `JSON_ARRAY_LENGTH()`）
+- `$arrayElemAt` - 数组元素访问（对应 SQL: `JSON_EXTRACT()`）
 
 ## 功能特性
 
@@ -583,6 +607,27 @@ MIT License - 详见 [LICENSE](LICENSE) 文件
 
 ## 变更日志
 
+### v0.1.6 (2026-03-15)
+
+**新增功能:**
+- $addFields 阶段独立解析器（AddFieldsExpressionParser），与 project 解耦
+- $addFields 支持字面量值、字段引用、表达式三类语义
+- 统一数值 1 为字面量（仅 $project 阶段保留包含/排除语义）
+- $addFields 阶段新增多种操作符解析支持：
+  - 算术操作符：$add, $subtract, $multiply, $divide, $mod
+  - 字符串操作符：$concat, $toLower, $toUpper, $substr
+  - 日期操作符：$dateToString, $year, $month, $dayOfMonth, $hour, $minute, $second
+  - 条件操作符：$cond, $ifNull
+  - 比较操作符：$eq, $ne, $gt, $gte, $lt, $lte
+  - 数组操作符：$size, $arrayElemAt
+
+### v0.1.5 (2025-02-23)
+
+**新增功能:**
+- addFields阶段独立解析器（AddFieldsExpressionParser），与 project 解耦
+- 支持字面量值、字段引用、表达式三类语义
+- 统一数值 1 为字面量（仅 $project 阶段保留包含/排除语义）
+
 ### v0.1.4 (2025-02-13)
 
 **新增功能:**