sqlobjects 1.0.11__tar.gz → 1.0.13__tar.gz

{sqlobjects-1.0.11 → sqlobjects-1.0.13}/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.0.13 (2025-11-18)
+
+## 1.0.12 (2025-11-18)
+
+### Refactor
+
+- move rules installer to independent scripts
+
 ## 1.0.11 (2025-11-18)
 
 ### Feat

{sqlobjects-1.0.11/sqlobjects.egg-info → sqlobjects-1.0.13}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: sqlobjects
-Version: 1.0.11
+Version: 1.0.13
 Summary: Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/XtraVisionsAI/sqlobjects
 Project-URL: Repository, https://github.com/XtraVisionsAI/sqlobjects.git
 Project-URL: Documentation, https://github.com/XtraVisionsAI/sqlobjects#readme
@@ -13,7 +13,6 @@ Project-URL: Changelog, https://github.com/XtraVisionsAI/sqlobjects/blob/main/CH
 Keywords: python,orm,async,django-style,database,query
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
@@ -25,11 +24,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sqlalchemy[asyncio]>=2.0.43
-Provides-Extra: amazonq
-Provides-Extra: kiro
-Provides-Extra: claude
-Provides-Extra: cursor
+Requires-Dist: sqlalchemy[asyncio]>=2.0.44
 Dynamic: license-file
 
 # SQLObjects
@@ -233,7 +228,14 @@ Best practices and usage patterns optimized for AI coding assistants:
 - [Validation & Signals Guide](docs/rules/06-validation-signals-guide.md) - Data validation and lifecycle hooks
 - [Performance Guide](docs/rules/07-performance-guide.md) - Optimization techniques and best practices
 
-**Installation**: Rules are automatically installed with `pip install sqlobjects[amazonq]` (or `[cursor]`, `[claude]`, `[kiro]`)
+**Installation**: 
+```bash
+# Install package
+pip install sqlobjects
+
+# Install rules for your AI assistant
+sqlobjects-install-rules amazonq  # or cursor, claude, kiro
+```
 
 ### Feature Documentation
 

{sqlobjects-1.0.11 → sqlobjects-1.0.13}/README.md

@@ -199,7 +199,14 @@ Best practices and usage patterns optimized for AI coding assistants:
 - [Validation & Signals Guide](docs/rules/06-validation-signals-guide.md) - Data validation and lifecycle hooks
 - [Performance Guide](docs/rules/07-performance-guide.md) - Optimization techniques and best practices
 
-**Installation**: Rules are automatically installed with `pip install sqlobjects[amazonq]` (or `[cursor]`, `[claude]`, `[kiro]`)
+**Installation**: 
+```bash
+# Install package
+pip install sqlobjects
+
+# Install rules for your AI assistant
+sqlobjects-install-rules amazonq  # or cursor, claude, kiro
+```
 
 ### Feature Documentation
 

{sqlobjects-1.0.11 → sqlobjects-1.0.13}/docs/rules/README.md

@@ -42,13 +42,17 @@ These rules complement the full documentation:
 
 ## Installation
 
-These rules are automatically installed when you use:
+Install the package, then install rules for your AI assistant:
 
 ```bash
-pip install sqlobjects[amazonq]  # For Amazon Q
-pip install sqlobjects[cursor]   # For Cursor
-pip install sqlobjects[claude]   # For Claude
-pip install sqlobjects[kiro]     # For Kiro
+# Install SQLObjects
+pip install sqlobjects
+
+# Install rules for your AI assistant
+sqlobjects-install-rules amazonq  # For Amazon Q
+sqlobjects-install-rules cursor   # For Cursor
+sqlobjects-install-rules claude   # For Claude
+sqlobjects-install-rules kiro     # For Kiro
 ```
 
 ## Version

{sqlobjects-1.0.11 → sqlobjects-1.0.13}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "sqlobjects"
-version = "1.0.11"
+version = "1.0.13"
 description = "Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading"
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
 authors = [
     { name = "XtraVisions", email = "gitadmin@xtravisions.com" },
     { name = "Chen Hao", email = "chenhao@xtravisions.com" }
@@ -23,7 +23,6 @@ keywords = [
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
@@ -35,14 +34,11 @@ classifiers = [
 ]
 requires-python = ">=3.12"
 dependencies = [
-    "sqlalchemy[asyncio]>=2.0.43",
+    "sqlalchemy[asyncio]>=2.0.44",
 ]
 
-[project.optional-dependencies]
-amazonq = []
-kiro = []
-claude = []
-cursor = []
+[project.scripts]
+sqlobjects-install-rules = "sqlobjects._install_rules:main"
 
 [project.urls]
 Homepage = "https://github.com/XtraVisionsAI/sqlobjects"
@@ -80,6 +76,9 @@ include = ["sqlobjects*"]
 [tool.setuptools.package-data]
 sqlobjects = ["py.typed"]
 
+[tool.setuptools.data-files]
+"share/sqlobjects/rules" = ["docs/rules/*.md"]
+
 [[tool.uv.index]]
 name = "tsinghua"
 url = "https://pypi.tuna.tsinghua.edu.cn/simple/"

sqlobjects-1.0.13/sqlobjects/_install_rules.py

@@ -0,0 +1,121 @@
+"""Install AI assistant rules to configuration directories."""
+
+import shutil
+import sys
+from pathlib import Path
+
+
+def find_project_root() -> Path:
+    """Find project root by looking for common markers."""
+    current = Path.cwd()
+    markers = [".git", "pyproject.toml", "setup.py", "package.json"]
+
+    # Search up to 5 levels
+    for _ in range(5):
+        if any((current / marker).exists() for marker in markers):
+            return current
+        if current.parent == current:  # Reached filesystem root
+            break
+        current = current.parent
+
+    # Fallback to current directory
+    return Path.cwd()
+
+
+def install_rules(target_name: str, target_dir: Path | None = None) -> bool:
+    """Install rules to AI assistant configuration directory.
+
+    Args:
+        target_name: Target AI assistant (amazonq, kiro, claude, cursor)
+        target_dir: Optional custom target directory (default: auto-detect project root)
+
+    Returns:
+        True if successful, False otherwise
+    """
+    # Try multiple locations for rules directory
+    possible_locations = [
+        # Location 1: Standard installation - share/sqlobjects/rules
+        Path(sys.prefix) / "share" / "sqlobjects" / "rules",
+        # Location 2: Development mode - project root
+        Path(__file__).parent.parent / "docs" / "rules",
+    ]
+
+    rules_dir = None
+    for location in possible_locations:
+        if location.exists() and list(location.glob("*.md")):
+            rules_dir = location
+            break
+
+    if not rules_dir:
+        print("Error: Rules directory not found in any of:", file=sys.stderr)
+        for loc in possible_locations:
+            print(f"  - {loc}", file=sys.stderr)
+        return False
+
+    # Determine base directory
+    base_dir = target_dir if target_dir else find_project_root()
+
+    # Target directory mapping (project-level)
+    target_dirs = {
+        "amazonq": base_dir / ".amazonq" / "rules" / "sqlobjects",
+        "kiro": base_dir / ".kiro" / "rules" / "sqlobjects",
+        "claude": base_dir / ".claude" / "rules" / "sqlobjects",
+        "cursor": base_dir / ".cursor" / "rules" / "sqlobjects",
+    }
+
+    target_dir = target_dirs.get(target_name)
+    if not target_dir:
+        print(f"Error: Unknown target '{target_name}'", file=sys.stderr)
+        print(f"Valid targets: {', '.join(target_dirs.keys())}", file=sys.stderr)
+        return False
+
+    if not rules_dir.exists():
+        print(f"Error: Rules directory not found at {rules_dir}", file=sys.stderr)
+        return False
+
+    # Create target directory and copy files
+    try:
+        target_dir.mkdir(parents=True, exist_ok=True)
+
+        copied_count = 0
+        for file in rules_dir.glob("*.md"):
+            shutil.copy2(file, target_dir / file.name)
+            copied_count += 1
+
+        if copied_count > 0:
+            actual_target = target_dirs[target_name]
+            print(f"✓ Installed {copied_count} rule files to {actual_target}")
+            return True
+        else:
+            print("Warning: No rule files found to install", file=sys.stderr)
+            return False
+    except Exception as e:
+        print(f"Error: Failed to install rules: {e}", file=sys.stderr)
+        return False
+
+
+def main():
+    """CLI entry point."""
+    if len(sys.argv) < 2:
+        print("Usage: sqlobjects-install-rules <target>")
+        print()
+        print("Install SQLObjects AI assistant rules to configuration directory.")
+        print()
+        print("Targets:")
+        print("  amazonq  - Install to .amazonq/rules/sqlobjects/")
+        print("  cursor   - Install to .cursor/rules/sqlobjects/")
+        print("  claude   - Install to .claude/rules/sqlobjects/")
+        print("  kiro     - Install to .kiro/rules/sqlobjects/")
+        print()
+        print("Examples:")
+        print("  sqlobjects-install-rules amazonq")
+        print("  sqlobjects-install-rules cursor")
+        sys.exit(1)
+
+    target = sys.argv[1].lower()
+    success = install_rules(target)
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()

{sqlobjects-1.0.11 → sqlobjects-1.0.13/sqlobjects.egg-info}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: sqlobjects
-Version: 1.0.11
+Version: 1.0.13
 Summary: Django-style async ORM library based on SQLAlchemy with chainable queries, Q objects, and relationship loading
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://github.com/XtraVisionsAI/sqlobjects
 Project-URL: Repository, https://github.com/XtraVisionsAI/sqlobjects.git
 Project-URL: Documentation, https://github.com/XtraVisionsAI/sqlobjects#readme
@@ -13,7 +13,6 @@ Project-URL: Changelog, https://github.com/XtraVisionsAI/sqlobjects/blob/main/CH
 Keywords: python,orm,async,django-style,database,query
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
@@ -25,11 +24,7 @@ Classifier: Typing :: Typed
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sqlalchemy[asyncio]>=2.0.43
-Provides-Extra: amazonq
-Provides-Extra: kiro
-Provides-Extra: claude
-Provides-Extra: cursor
+Requires-Dist: sqlalchemy[asyncio]>=2.0.44
 Dynamic: license-file
 
 # SQLObjects
@@ -233,7 +228,14 @@ Best practices and usage patterns optimized for AI coding assistants:
 - [Validation & Signals Guide](docs/rules/06-validation-signals-guide.md) - Data validation and lifecycle hooks
 - [Performance Guide](docs/rules/07-performance-guide.md) - Optimization techniques and best practices
 
-**Installation**: Rules are automatically installed with `pip install sqlobjects[amazonq]` (or `[cursor]`, `[claude]`, `[kiro]`)
+**Installation**: 
+```bash
+# Install package
+pip install sqlobjects
+
+# Install rules for your AI assistant
+sqlobjects-install-rules amazonq  # or cursor, claude, kiro
+```
 
 ### Feature Documentation
 

{sqlobjects-1.0.11 → sqlobjects-1.0.13}/sqlobjects.egg-info/SOURCES.txt

@@ -1,9 +1,7 @@
 CHANGELOG.md
 LICENSE
-MANIFEST.in
 README.md
 pyproject.toml
-setup.py
 docs/rules/01-database-session-guide.md
 docs/rules/02-model-definition-guide.md
 docs/rules/03-query-operations-guide.md
@@ -13,6 +11,7 @@ docs/rules/06-validation-signals-guide.md
 docs/rules/07-performance-guide.md
 docs/rules/README.md
 sqlobjects/__init__.py
+sqlobjects/_install_rules.py
 sqlobjects/cascade.py
 sqlobjects/exceptions.py
 sqlobjects/metadata.py
@@ -25,6 +24,7 @@ sqlobjects/validators.py
 sqlobjects.egg-info/PKG-INFO
 sqlobjects.egg-info/SOURCES.txt
 sqlobjects.egg-info/dependency_links.txt
+sqlobjects.egg-info/entry_points.txt
 sqlobjects.egg-info/requires.txt
 sqlobjects.egg-info/top_level.txt
 sqlobjects/database/__init__.py

sqlobjects-1.0.13/sqlobjects.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sqlobjects-install-rules = sqlobjects._install_rules:main

sqlobjects-1.0.13/sqlobjects.egg-info/requires.txt

@@ -0,0 +1 @@
+sqlalchemy[asyncio]>=2.0.44

sqlobjects-1.0.11/MANIFEST.in

@@ -1,4 +0,0 @@
-include README.md
-include LICENSE
-include CHANGELOG.md
-recursive-include docs/rules *.md

sqlobjects-1.0.11/setup.py

@@ -1,105 +0,0 @@
-import os
-import re
-import shutil
-import sys
-from pathlib import Path
-
-from setuptools import Distribution, setup
-from setuptools.command.develop import develop
-from setuptools.command.install import install
-
-
-class PostInstallCommand(install):
-    """Post-installation for installation mode."""
-
-    user_options = install.user_options + [
-        ("extras=", None, "Extras to install (comma-separated)"),
-    ]
-
-    def __init__(self, dist: Distribution):
-        super().__init__(dist)
-        self.extras: str | None = None
-
-    def initialize_options(self):
-        install.initialize_options(self)
-        self.extras = None
-
-    def run(self):
-        install.run(self)
-        self._post_install()
-
-    def _post_install(self):
-        """执行安装后的 rules 复制"""
-        extras_to_install = set()
-
-        # 方法1: 从环境变量获取
-        env_extras = os.environ.get("SQLOBJECTS_INSTALL_EXTRAS", "")
-        if env_extras:
-            extras_to_install.update(e.strip() for e in env_extras.split(","))
-
-        # 方法2: 从命令行参数检测
-        for arg in sys.argv:
-            # 匹配 sqlobjects[amazonq] 或 .[amazonq] 格式
-            match = re.search(r"\[([^\]]+)\]", arg)
-            if match:
-                extras_str = match.group(1)
-                extras_to_install.update(e.strip() for e in extras_str.split(","))
-
-        # 方法3: 从 self.extras 获取（如果通过 --extras 传递）
-        if self.extras:
-            extras_to_install.update(e.strip() for e in self.extras.split(","))
-
-        # 执行安装
-        valid_extras = {"amazonq", "kiro", "claude", "cursor"}
-        for extra in extras_to_install & valid_extras:
-            try:
-                self._install_rules(extra)
-            except Exception as e:
-                print(f"Warning: Failed to install rules for {extra}: {e}", file=sys.stderr)
-
-    def _install_rules(self, target_name: str) -> None:
-        """复制 rules 到 AI 助手配置目录"""
-        # 获取 rules 目录
-        package_dir = Path(__file__).parent
-        rules_dir = package_dir / "docs" / "rules"
-
-        # 目标目录映射
-        target_dirs = {
-            "amazonq": Path.home() / ".amazonq" / "rules" / "sqlobjects",
-            "kiro": Path.home() / ".kiro" / "rules" / "sqlobjects",
-            "claude": Path.home() / ".claude" / "rules" / "sqlobjects",
-            "cursor": Path.home() / ".cursor" / "rules" / "sqlobjects",
-        }
-
-        target_dir = target_dirs.get(target_name)
-        if not target_dir or not rules_dir.exists():
-            return
-
-        # 创建目标目录并复制文件
-        target_dir.mkdir(parents=True, exist_ok=True)
-        copied_count = 0
-        for file in rules_dir.glob("*.md"):
-            try:
-                shutil.copy2(file, target_dir / file.name)
-                copied_count += 1
-            except Exception:
-                pass
-
-        if copied_count > 0:
-            print(f"✓ Installed {copied_count} rule files to {target_dir}")
-
-
-class PostDevelopCommand(develop):
-    """Post-installation for development mode."""
-
-    def run(self):
-        develop.run(self)
-        # 开发模式不自动安装 rules（避免污染开发环境）
-
-
-setup(
-    cmdclass={
-        "install": PostInstallCommand,
-        "develop": PostDevelopCommand,
-    },
-)

sqlobjects-1.0.11/sqlobjects.egg-info/requires.txt

@@ -1,9 +0,0 @@
-sqlalchemy[asyncio]>=2.0.43
-
-[amazonq]
-
-[claude]
-
-[cursor]
-
-[kiro]