lush-sqlalchemyx 0.1.0__tar.gz

lush_sqlalchemyx-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.3
+Name: lush-sqlalchemyx
+Version: 0.1.0
+Summary: see README.md
+Author: straydragon
+Requires-Dist: sqlalchemy[asyncio]>=2.0.43
+Requires-Dist: pydantic>=2.11.0,<3.0.0
+Requires-Dist: typing-extensions>=4.12.2
+Requires-Dist: lush-pydanticx>=0.1.0
+Requires-Dist: lush-stdx>=0.1.0
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# lush-sqlalchemyx
+
+SQLAlchemy(偏 asyncio) 的一组工具和封装. 这里的东西偏“工程向”: 解决常见的 session 管理、只读会话、以及一些重复写到吐的样板代码.
+
+## 例子
+
+一个最小的异步 MySQL 管理器:
+
+```python
+import asyncio
+
+from lush_sqlalchemyx.mgrs.mysql.manager import AsyncMySQLManager
+
+async def main() -> None:
+    mgr = AsyncMySQLManager("mysql+aiomysql://<user>:<password>@127.0.0.1:3306/<dbname>")
+    ok = await mgr.health_check()
+    print(ok)
+
+    await mgr.close()
+
+
+asyncio.run(main())
+```
+
+## 开发
+
+```bash
+uv sync -p 3.10 --frozen
+uv run -p 3.10 pytest
+```

lush_sqlalchemyx-0.1.0/README.md

@@ -0,0 +1,30 @@
+# lush-sqlalchemyx
+
+SQLAlchemy(偏 asyncio) 的一组工具和封装. 这里的东西偏“工程向”: 解决常见的 session 管理、只读会话、以及一些重复写到吐的样板代码.
+
+## 例子
+
+一个最小的异步 MySQL 管理器:
+
+```python
+import asyncio
+
+from lush_sqlalchemyx.mgrs.mysql.manager import AsyncMySQLManager
+
+async def main() -> None:
+    mgr = AsyncMySQLManager("mysql+aiomysql://<user>:<password>@127.0.0.1:3306/<dbname>")
+    ok = await mgr.health_check()
+    print(ok)
+
+    await mgr.close()
+
+
+asyncio.run(main())
+```
+
+## 开发
+
+```bash
+uv sync -p 3.10 --frozen
+uv run -p 3.10 pytest
+```

lush_sqlalchemyx-0.1.0/pyproject.toml

@@ -0,0 +1,254 @@
+[project]
+name = "lush-sqlalchemyx"
+version = "0.1.0"
+description = "see README.md"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "straydragon" }]
+dependencies = [
+    "sqlalchemy[asyncio]>=2.0.43",
+    "pydantic>=2.11.0,<3.0.0",
+    "typing-extensions>=4.12.2",
+    "lush-pydanticx>=0.1.0",
+    "lush-stdx>=0.1.0",
+]
+
+[build-system]
+requires = ["uv_build>=0.10.12,<0.11.0"]
+build-backend = "uv_build"
+
+[tool.uv]
+package = true
+
+[tool.uv.sources]
+lush-pydanticx = { path = "../lush-pydanticx" }
+lush-stdx = { path = "../lush-stdx" }
+
+[dependency-groups]
+dev = [
+    "jinja2sql>=0.8.0",
+    "pytest>=8.4.1",
+    "pytest-asyncio>=1.1.0",
+    "pytest-cov>=6.2.1",
+    "aiosqlite>=0.20.0",
+    "fastapi[standard]>=0.117.1",
+]
+
+[tool.pytest.ini_options]
+addopts = "--import-mode=importlib --cov=lush_sqlalchemyx --cov-report=term-missing"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+asyncio_default_test_loop_scope = "function"
+
+[tool.ruff]
+line-length = 140
+indent-width = 4
+target-version = "py310"
+
+[tool.ruff.lint]
+fixable = ["F401", "ALL"]
+unfixable = []
+
+dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
+
+select = ["ALL"]
+ignore = [
+    # === 代码质量与复杂性 ===
+    "C901",    # 函数复杂度过高,影响可读性
+    "PLR0912", # 函数分支过多,建议重构
+    "PLR0913", # 函数参数过多,难以维护
+    "PLR0915", # 函数语句过多,建议拆分
+    "PLR0911", # 函数返回语句过多,逻辑复杂
+    "PLR2004", # 使用魔术数值,建议使用常量
+    "SIM108",  # 更倾向于使用ifelse表达式,而不是if/else语句
+
+    # === 类型注解 ===
+    "ANN002", # 函数*args参数缺少类型注解
+    "ANN003", # 函数**kwargs参数缺少类型注解
+    "ANN401", # 使用Any类型,建议使用具体类型
+
+    # === 函数参数设计 ===
+    "FBT001", # 布尔类型位置参数,易混淆
+    "FBT002", # 布尔默认值位置参数,易误用
+    "N805",   # 与pydantic field_validator冲突(cls->self X), 先忽略, 后面再处理
+
+    # === 异常处理 ===
+    "BLE001", # 捕获所有异常,隐藏问题
+    "TRY003", # 异常消息应在类中定义
+    "TRY004", # 类型检查应抛出TypeError
+
+    # === 代码简化 ===
+    "SIM102", # 可折叠的if语句,简化代码
+
+    # === 格式规范 ===
+    "COM812", # 缺少尾随逗号,影响diff
+    "E501",   # 行长度过长,影响可读性
+
+    # === 日志记录 ===
+    "G004", # 日志使用f-string,影响性能
+
+    # === 类型检查优化 ===
+    "TC001", # 仅用于类型检查的导入,优化性能
+    "TC002", # 仅用于类型检查的导入,优化性能
+    "TC003", # 仅用于类型检查的导入,优化性能
+
+    # === 代码清理 ===
+    "ERA001", # 注释掉的代码,应删除
+
+    # === 私有成员访问 ===
+    "SLF001", # 访问私有成员,破坏封装
+
+    # === 日期时间处理 ===
+    "DTZ001", # datetime缺少时区信息
+    "DTZ005", # datetime.now()缺少时区
+
+    # === 调试代码 ===
+    "T201", # print语句调试代码,生产环境禁用
+
+    # === T O D O管理 ===
+    "TD002", # 缺少作者信息
+    "TD003", # 缺少问题链接
+
+    # === 其他 ===
+    "D",  # 文档字符串相关规则
+    "EM", # 错误消息相关规则
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    # === 测试代码质量 ===
+    "B011",    # assert False应改为raise AssertionError
+    "B008",    # 函数调用作为默认参数
+    "ARG001",  # 未使用的函数参数
+    "ARG002",  # 未使用的方法参数
+    "ARG005",  # lambda中未使用的参数
+    "F841",    # 未使用的变量
+    "B018",    # 无用的表达式
+    "N806",    # 函数中非小写变量名
+    "W293",    # 空行包含空格
+    "N802",    # 函数名不规范
+    "PERF401", # 性能相关
+    "PT",      # assert 相关
+
+    # === 测试安全相关 ===
+    "S101", # assert语句(测试中使用)
+    "S105", # 硬编码密码字符串
+    "S201", # Flask debug=True
+    "S301", # 可疑的pickle使用
+    "S311", # 非加密安全的随机数
+
+    # === 测试异常处理 ===
+    "BLE001", # 捕获所有异常
+    "B017",   # assertRaises捕获Exception
+    "PT011",  # pytest.raises缺少match参数
+    "PT017",  # except中的assert语句
+    "EM101",  # 异常中的原始字符串
+
+    # === 测试代码复杂度 ===
+    "C901",    # 函数复杂度过高
+    "PLR2004", # 魔术数值
+
+    # === 测试导入相关 ===
+    "PLC0415", # 函数内import语句
+    "ANN",     # 类型注解(测试中宽松)
+    "TC",      # 类型检查的导入
+
+    # === 测试参数设计 ===
+    "FBT001", # 布尔类型位置参数
+    "FBT002", # 布尔默认值位置参数
+    "FBT003", # 布尔位置参数调用
+
+    # === 测试异常处理 ===
+    "TRY003", # 异常消息定义
+
+    # === 测试代码简化 ===
+    "SIM117", # 多个连续的with语句
+
+    # === 测试格式规范 ===
+    "E501", # 行长度过长
+
+    # === 测试日志处理 ===
+    "G004", # 日志使用f-string
+
+    # === 测试调试代码 ===
+    "T201", # print语句
+
+    # === 测试文档相关 ===
+    "D", # 文档字符串
+
+    # === 测试私有访问 ===
+    "SLF001", # 私有成员访问
+
+    # === 测试Unicode ===
+    "RUF001", # 模糊的Unicode字符
+
+    # === 测试路径处理 ===
+    "PTH", # pathlib相关规则
+
+    # === 测试日期时间 ===
+    "DTZ001", # datetime缺少时区
+    "DTZ005", # datetime.now()缺少时区
+
+    # === 测试代码清理 ===
+    "ERA001", # 注释掉的代码
+
+    "RUF",
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-format = true
+docstring-code-line-length = "dynamic"
+
+# ============================================================================
+# basedpyright 配置 - 独立包配置
+# ============================================================================
+[tool.basedpyright]
+pythonVersion = "3.10"
+
+reportUnannotatedClassAttribute = "none"
+reportUnreachable = "none"
+reportUnnecessaryIsInstance = "none"
+reportAny = "none"
+reportExplicitAny = "none"
+reportConstantRedefinition = "none"
+reportUnnecessaryComparison = "none"
+
+[[tool.basedpyright.executionEnvironments]]
+root = "tests"
+reportUnusedCallResult = false
+reportUnknownArgumentType = false
+reportUnknownVariableType = false
+reportUnknownMemberType = false
+reportMissingParameterType = false
+reportUnknownParameterType = false
+reportArgumentType = false
+reportCallIssue = false
+reportReturnType = false
+reportUnusedVariable = false
+reportUnusedImport = false
+reportUnusedFunction = false
+reportUnusedParameter = false
+reportPrivateUsage = false
+reportIncompatibleVariableOverride = false
+reportIncompatibleMethodOverride = false
+reportImplicitAbstractClass = false
+reportAbstractUsage = false
+reportExplicitAny = "none"
+reportAny = "none"
+reportUnnecessaryTypeIgnoreComment = false
+reportMissingTypeArgument = false
+reportOptionalMemberAccess = false
+reportAttributeAccessIssue = "none"
+reportGeneralTypeIssues = false
+reportOperatorIssue = false
+reportIndexIssue = false
+reportInvalidTypeArguments = "none"
+
+
+[[tool.basedpyright.executionEnvironments]]
+root = "src"