fastapi-augment 0.1.1__tar.gz → 0.1.2__tar.gz

{fastapi_augment-0.1.1 → fastapi_augment-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-augment
-Version: 0.1.1
+Version: 0.1.2
 Summary: FastAPI 通用代码工具包，跨项目复用
 Author-email: zarkhan <hanguangzheng@qq.com>
 License-Expression: MIT

fastapi_augment-0.1.2/VERSION

@@ -0,0 +1 @@
+0.1.2

{fastapi_augment-0.1.1 → fastapi_augment-0.1.2}/pyproject.toml

@@ -77,9 +77,9 @@ include = ["fastapi_augment*"]
 [tool.setuptools.package-data]
 fastapi_augment = [
     "py.typed",
-    "db/sqlalchemy/migrations/*.py",
-    "db/sqlalchemy/migrations/*.mako",
-    "db/sqlalchemy/migrations/README",
+    "db/sqlalchemy/alembic/*.py",
+    "db/sqlalchemy/alembic/*.mako",
+    "db/sqlalchemy/alembic/README",
 ]
 
 [tool.setuptools.dynamic]

fastapi_augment-0.1.2/src/fastapi_augment/common/utils/__init__.py

@@ -0,0 +1,32 @@
+"""
+@Author         : hangu
+@CreateDate     : 2026/9/4
+@Description    :
+"""
+from .paths import get_root_dir
+from .strings import (
+    SupportsWriteStr,
+    SupportsReadBytes,
+    camel_to_snake,
+    snake_to_camel,
+    random_string,
+    json_dumps,
+    json_dump,
+    json_loads,
+    json_load
+)
+
+__all__ = [
+    # paths
+    'get_root_dir',
+    # strings
+    'SupportsWriteStr',
+    'SupportsReadBytes',
+    'camel_to_snake',
+    'snake_to_camel',
+    'random_string',
+    'json_dumps',
+    'json_dump',
+    'json_loads',
+    'json_load'
+]

fastapi_augment-0.1.2/src/fastapi_augment/common/utils/paths.py

@@ -0,0 +1,36 @@
+"""
+@Author         : hangu
+@CreateDate     : 2026/9/9
+@Description    :
+"""
+import sys
+from pathlib import Path
+
+
+# 获取项目根目录路径
+def get_root_dir(reference_path: str | Path, parent_index: int) -> Path:
+    """
+    动态获取项目根目录路径，兼容源码开发环境与 PyInstaller/Nuitka 打包二进制环境。
+
+    源码模式：以传入的参考路径为基准，向上回溯 parent_index 层目录得到项目根；
+    打包 frozen 模式：自动返回可执行文件(.exe/二进制)所在目录，忽略 reference_path、parent_index。
+
+    Args:
+        reference_path: 锚点参考路径，业务调用一般直接传入 __file__
+        parent_index: 源码环境向上回溯层级下标
+
+    Returns:
+        项目根目录绝对路径
+
+    Notes:
+        parent_index >= 0；根据当前文件物理位置调整下标
+    """
+    if parent_index < 0:
+        raise ValueError("parent_index 不能是负数")
+
+    if getattr(sys, "frozen", False):
+        path = Path(sys.executable).parent
+    else:
+        path = Path(reference_path).parents[parent_index]
+
+    return path.resolve()

fastapi_augment-0.1.2/src/fastapi_augment/db/sqlalchemy/alembic/README

@@ -0,0 +1 @@
+Generic single-database configuration.

fastapi_augment-0.1.2/src/fastapi_augment/db/sqlalchemy/alembic/script.py.mako

@@ -0,0 +1,28 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, Sequence[str], None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    """Upgrade schema."""
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    """Downgrade schema."""
+    ${downgrades if downgrades else "pass"}

{fastapi_augment-0.1.1 → fastapi_augment-0.1.2}/src/fastapi_augment.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastapi-augment
-Version: 0.1.1
+Version: 0.1.2
 Summary: FastAPI 通用代码工具包，跨项目复用
 Author-email: zarkhan <hanguangzheng@qq.com>
 License-Expression: MIT

{fastapi_augment-0.1.1 → fastapi_augment-0.1.2}/src/fastapi_augment.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ src/fastapi_augment/common/constants.py
 src/fastapi_augment/common/exception_handlers.py
 src/fastapi_augment/common/exceptions.py
 src/fastapi_augment/common/utils/__init__.py
+src/fastapi_augment/common/utils/paths.py
 src/fastapi_augment/common/utils/strings.py
 src/fastapi_augment/config/__init__.py
 src/fastapi_augment/config/settings.py
@@ -28,8 +29,10 @@ src/fastapi_augment/db/sqlalchemy/migrate.py
 src/fastapi_augment/db/sqlalchemy/model_base.py
 src/fastapi_augment/db/sqlalchemy/repository_base.py
 src/fastapi_augment/db/sqlalchemy/session.py
+src/fastapi_augment/db/sqlalchemy/alembic/README
 src/fastapi_augment/db/sqlalchemy/alembic/__init__.py
 src/fastapi_augment/db/sqlalchemy/alembic/env.py
+src/fastapi_augment/db/sqlalchemy/alembic/script.py.mako
 src/fastapi_augment/db/sqlalchemy/mixins/__init__.py
 src/fastapi_augment/db/sqlalchemy/mixins/audit.py
 src/fastapi_augment/db/sqlalchemy/mixins/soft_delete.py

fastapi_augment-0.1.1/VERSION

@@ -1 +0,0 @@
-0.1.1

fastapi_augment-0.1.1/src/fastapi_augment/common/utils/__init__.py

@@ -1,5 +0,0 @@
-"""
-@Author         : hangu
-@CreateDate     : 2026/9/4
-@Description    :
-"""