migrator-gen 1.0.0__tar.gz

migrator_gen-1.0.0/.gitignore

@@ -0,0 +1,72 @@
+# ── OS ──────────────────────────────────────────────
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+*~
+
+# ── IDE ─────────────────────────────────────────────
+.vscode/
+.idea/
+*.code-workspace
+
+# ── Environment ─────────────────────────────────────
+.env
+.env.*
+!.env.example
+!.env.test
+
+# ── Python ──────────────────────────────────────────
+.venv/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.bak
+bandit-report.json
+safety_report.json
+pip_audit_report.json
+
+# ── Node / Next.js ─────────────────────────────────
+node_modules/
+.next/
+out/
+.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+*.tsbuildinfo
+next-env.d.ts
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# ── Project-specific ────────────────────────────────
+# Generated output
+generated/
+generated_migrator/
+generated_migrator_md/
+
+# Auth DB (local dev)
+webapp/auth.db
+webapp/data/user-packs/*.json
+
+# Synced engine files (copied from sdk/python at build time)
+webapp/python/engine/
+
+# Vercel
+.vercel/
+
+# Coverage
+webapp/coverage/

migrator_gen-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Aayush Gid
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+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.

migrator_gen-1.0.0/PKG-INFO

@@ -0,0 +1,204 @@
+Metadata-Version: 2.5
+Name: migrator-gen
+Version: 1.0.0
+Summary: Python SDK for MigratorGen — automatically migrate Python code across library versions
+Project-URL: Homepage, https://github.com/aayush598/MigratorGen
+Project-URL: Repository, https://github.com/aayush598/MigratorGen
+Project-URL: Issues, https://github.com/aayush598/MigratorGen/issues
+Project-URL: Documentation, https://github.com/aayush598/MigratorGen#readme
+Author-email: Aayush Gid <aayushgid598@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ast,codemod,libcst,migration,migrator-gen,sdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: all
+Requires-Dist: httpx>=0.27.0; extra == 'all'
+Requires-Dist: libcst>=1.0.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.3; extra == 'dev'
+Provides-Extra: local
+Requires-Dist: libcst>=1.0.0; extra == 'local'
+Provides-Extra: remote
+Requires-Dist: httpx>=0.27.0; extra == 'remote'
+Description-Content-Type: text/markdown
+
+# migrator-gen
+
+[![PyPI version](https://badge.fury.io/py/migrator-gen.svg)](https://pypi.org/project/migrator-gen/)
+[![Python](https://img.shields.io/pypi/pyversions/migrator-gen)](https://pypi.org/project/migrator-gen/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Python SDK for **MigratorGen** — automatically migrate Python code across library versions using structured changelog rules and AST-accurate transformations.
+
+## Features
+
+- **Transactional migrations** — atomic all-or-nothing file modifications with checkpoint-based rollback
+- **AST-aware transformations** — powered by [LibCST](https://github.com/Instagram/LibCST) for syntax-tree-level precision
+- **Idempotency guards** — safe to re-run migrations without duplicating changes
+- **Confidence scoring** — per-rule confidence metrics and safety classification (`safe` / `review_required` / `risky`)
+- **Structured changelogs** — JSON-based rule packs describing renames, argument changes, module moves, and more
+- **Sync and async clients** — use locally or connect to a remote MigratorGen API server
+
+## Installation
+
+```bash
+pip install migrator-gen
+```
+
+For the full local engine (LibCST-based transformations):
+
+```bash
+pip install migrator-gen[local]
+```
+
+For remote API access:
+
+```bash
+pip install migrator-gen[remote]
+```
+
+## Quick Start
+
+### Local Engine
+
+```python
+from migrator_gen import SyncMigrationClient, Rule, ChangeType
+
+client = SyncMigrationClient()
+
+# Define a migration rule
+rule = Rule(
+    id="REQ-001",
+    change_type=ChangeType.RENAME_FUNCTION,
+    description="requests.get renamed to httpx.get",
+    old_name="requests.get",
+    new_name="httpx.get",
+    version_introduced="2.0.0",
+)
+
+# Migrate code
+result = client.migrate_code(
+    source_code="import requests\nresp = requests.get(url)",
+    rules=[rule],
+    target_version="2.0.0",
+)
+
+print(result.transformed_code)
+# import httpx
+# resp = httpx.get(url)
+```
+
+### Remote API
+
+```python
+from migrator_gen import MigrationClient
+
+async with MigrationClient(base_url="https://api.migratorgen.dev") as client:
+    result = await client.migrate(
+        source_code=open("my_app.py").read(),
+        rules=open("migration-pack.json").read(),
+        target_version="2.0.0",
+    )
+    print(result.transformed_code)
+```
+
+### Preview Changes (Dry Run)
+
+```python
+preview = client.preview_migration(source_code, rules)
+print(preview)  # Unified diff output
+```
+
+### Validate Rules
+
+```python
+report = client.validate_rules("migration-pack.json")
+if report.valid:
+    print("All rules are valid")
+else:
+    for error in report.errors:
+        print(f"Error: {error}")
+```
+
+## Rule Structure
+
+Rules are defined as JSON objects conforming to the `MigrationRule` schema:
+
+```json
+{
+  "id": "H001",
+  "change_type": "rename_function",
+  "version_introduced": "1.0.0",
+  "description": "Rename escape() to html.escape()",
+  "old_name": "cgi.escape",
+  "new_name": "html.escape",
+  "safety": "safe",
+  "confidence_hint": "high"
+}
+```
+
+### Supported Change Types
+
+| Change Type | Description |
+|---|---|
+| `rename_function` | Rename a function or method |
+| `rename_class` | Rename a class |
+| `rename_import` | Update import path |
+| `add_argument` | Add a new function argument |
+| `remove_argument` | Remove a function argument |
+| `rename_argument` | Rename a function argument |
+| `change_argument_default` | Change a default parameter value |
+| `deprecate_function` | Mark a function as deprecated |
+| `move_to_module` | Move code to a different module |
+| `wrap_in_context_manager` | Wrap a call in a context manager |
+| `sync_to_async` | Convert sync code to async |
+| `enum_migration` | Migrate enum definitions |
+
+See `migrator_gen.core.constants.ChangeType` for the full list.
+
+## Configuration
+
+```python
+from migrator_gen import SDKConfig
+
+config = SDKConfig(
+    base_url="https://api.migratorgen.dev",
+    timeout=30,
+    max_retries=3,
+)
+client = SyncMigrationClient(config=config)
+```
+
+## Development
+
+```bash
+git clone https://github.com/aayush598/MigratorGen.git
+cd MigratorGen/sdk/python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Author
+
+**Aayush Gid** — [GitHub](https://github.com/aayush598) · [LinkedIn](https://www.linkedin.com/in/aayush-gid)

migrator_gen-1.0.0/README.md

@@ -0,0 +1,163 @@
+# migrator-gen
+
+[![PyPI version](https://badge.fury.io/py/migrator-gen.svg)](https://pypi.org/project/migrator-gen/)
+[![Python](https://img.shields.io/pypi/pyversions/migrator-gen)](https://pypi.org/project/migrator-gen/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Python SDK for **MigratorGen** — automatically migrate Python code across library versions using structured changelog rules and AST-accurate transformations.
+
+## Features
+
+- **Transactional migrations** — atomic all-or-nothing file modifications with checkpoint-based rollback
+- **AST-aware transformations** — powered by [LibCST](https://github.com/Instagram/LibCST) for syntax-tree-level precision
+- **Idempotency guards** — safe to re-run migrations without duplicating changes
+- **Confidence scoring** — per-rule confidence metrics and safety classification (`safe` / `review_required` / `risky`)
+- **Structured changelogs** — JSON-based rule packs describing renames, argument changes, module moves, and more
+- **Sync and async clients** — use locally or connect to a remote MigratorGen API server
+
+## Installation
+
+```bash
+pip install migrator-gen
+```
+
+For the full local engine (LibCST-based transformations):
+
+```bash
+pip install migrator-gen[local]
+```
+
+For remote API access:
+
+```bash
+pip install migrator-gen[remote]
+```
+
+## Quick Start
+
+### Local Engine
+
+```python
+from migrator_gen import SyncMigrationClient, Rule, ChangeType
+
+client = SyncMigrationClient()
+
+# Define a migration rule
+rule = Rule(
+    id="REQ-001",
+    change_type=ChangeType.RENAME_FUNCTION,
+    description="requests.get renamed to httpx.get",
+    old_name="requests.get",
+    new_name="httpx.get",
+    version_introduced="2.0.0",
+)
+
+# Migrate code
+result = client.migrate_code(
+    source_code="import requests\nresp = requests.get(url)",
+    rules=[rule],
+    target_version="2.0.0",
+)
+
+print(result.transformed_code)
+# import httpx
+# resp = httpx.get(url)
+```
+
+### Remote API
+
+```python
+from migrator_gen import MigrationClient
+
+async with MigrationClient(base_url="https://api.migratorgen.dev") as client:
+    result = await client.migrate(
+        source_code=open("my_app.py").read(),
+        rules=open("migration-pack.json").read(),
+        target_version="2.0.0",
+    )
+    print(result.transformed_code)
+```
+
+### Preview Changes (Dry Run)
+
+```python
+preview = client.preview_migration(source_code, rules)
+print(preview)  # Unified diff output
+```
+
+### Validate Rules
+
+```python
+report = client.validate_rules("migration-pack.json")
+if report.valid:
+    print("All rules are valid")
+else:
+    for error in report.errors:
+        print(f"Error: {error}")
+```
+
+## Rule Structure
+
+Rules are defined as JSON objects conforming to the `MigrationRule` schema:
+
+```json
+{
+  "id": "H001",
+  "change_type": "rename_function",
+  "version_introduced": "1.0.0",
+  "description": "Rename escape() to html.escape()",
+  "old_name": "cgi.escape",
+  "new_name": "html.escape",
+  "safety": "safe",
+  "confidence_hint": "high"
+}
+```
+
+### Supported Change Types
+
+| Change Type | Description |
+|---|---|
+| `rename_function` | Rename a function or method |
+| `rename_class` | Rename a class |
+| `rename_import` | Update import path |
+| `add_argument` | Add a new function argument |
+| `remove_argument` | Remove a function argument |
+| `rename_argument` | Rename a function argument |
+| `change_argument_default` | Change a default parameter value |
+| `deprecate_function` | Mark a function as deprecated |
+| `move_to_module` | Move code to a different module |
+| `wrap_in_context_manager` | Wrap a call in a context manager |
+| `sync_to_async` | Convert sync code to async |
+| `enum_migration` | Migrate enum definitions |
+
+See `migrator_gen.core.constants.ChangeType` for the full list.
+
+## Configuration
+
+```python
+from migrator_gen import SDKConfig
+
+config = SDKConfig(
+    base_url="https://api.migratorgen.dev",
+    timeout=30,
+    max_retries=3,
+)
+client = SyncMigrationClient(config=config)
+```
+
+## Development
+
+```bash
+git clone https://github.com/aayush598/MigratorGen.git
+cd MigratorGen/sdk/python
+pip install -e ".[dev]"
+pytest
+```
+
+## License
+
+MIT License. See [LICENSE](LICENSE) for details.
+
+## Author
+
+**Aayush Gid** — [GitHub](https://github.com/aayush598) · [LinkedIn](https://www.linkedin.com/in/aayush-gid)

migrator_gen-1.0.0/pyproject.toml

@@ -0,0 +1,74 @@
+[project]
+name = "migrator-gen"
+version = "1.0.0"
+description = "Python SDK for MigratorGen — automatically migrate Python code across library versions"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Aayush Gid", email = "aayushgid598@gmail.com"},
+]
+keywords = ["migrator-gen", "migration", "codemod", "libcst", "sdk", "ast"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "pydantic>=2.0.0",
+    "PyYAML>=6.0",
+]
+
+[project.optional-dependencies]
+local = ["libcst>=1.0.0"]
+remote = ["httpx>=0.27.0"]
+all = ["migrator-gen[local,remote]"]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.3",
+    "mypy>=1.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/aayush598/MigratorGen"
+Repository = "https://github.com/aayush598/MigratorGen"
+Issues = "https://github.com/aayush598/MigratorGen/issues"
+Documentation = "https://github.com/aayush598/MigratorGen#readme"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/migrator_gen"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = "-v --tb=short"
+asyncio_mode = "auto"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+lint.select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
+lint.ignore = ["E501"]
+lint.per-file-ignores = {"__init__.py" = ["F401"]}
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true

migrator_gen-1.0.0/src/migrator_gen/__init__.py

@@ -0,0 +1,78 @@
+from ._version import __version__
+from .api import MigrationClient, SyncMigrationClient
+from .config import SDKConfig
+from .core import (
+    ChangeType,
+    DiffPreview,
+    EngineMode,
+    HealthStatus,
+    LibraryInfo,
+    MigrateResponse,
+    MigrationFile,
+    MigrationJob,
+    MigrationReport,
+    MigrationStatus,
+    MigrationStep,
+    ResolvedPath,
+    Rule,
+    RuleResultSummary,
+    RuleWhenCondition,
+    SafetyLevel,
+    ValidationReport,
+    VersionChangelog,
+)
+from .exceptions import (
+    APIError,
+    AuthenticationError,
+    ConfigurationError,
+    ConflictError,
+    EngineError,
+    MigrationEngineError,
+    MigrationError,
+    MigrationParseError,
+    MigrationValidationError,
+    NotFoundError,
+    RateLimitError,
+    SDKError,
+    TimeoutError,
+    ValidationError,
+)
+
+__all__ = [
+    "__version__",
+    "MigrationClient",
+    "SyncMigrationClient",
+    "SDKConfig",
+    "ChangeType",
+    "SafetyLevel",
+    "MigrationStatus",
+    "EngineMode",
+    "Rule",
+    "RuleWhenCondition",
+    "VersionChangelog",
+    "MigrationFile",
+    "LibraryInfo",
+    "RuleResultSummary",
+    "MigrateResponse",
+    "DiffPreview",
+    "ValidationReport",
+    "MigrationJob",
+    "MigrationReport",
+    "MigrationStep",
+    "ResolvedPath",
+    "HealthStatus",
+    "SDKError",
+    "ConfigurationError",
+    "APIError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "NotFoundError",
+    "ConflictError",
+    "MigrationError",
+    "MigrationParseError",
+    "MigrationValidationError",
+    "MigrationEngineError",
+    "EngineError",
+    "TimeoutError",
+]

migrator_gen-1.0.0/src/migrator_gen/_version.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as _pkg_version
+
+__version__: str
+try:
+    __version__ = _pkg_version("migrator-gen")
+except PackageNotFoundError:
+    __version__ = "1.0.0"
+
+VERSION_MAJOR, VERSION_MINOR, VERSION_PATCH = (int(x) for x in __version__.split(".")[:3])
+VERSION_TRIPLE: str = f"{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_PATCH}"
+SDK_NAME: str = "migrator-gen"
+USER_AGENT: str = f"migrator-gen-sdk/{__version__}"

migrator_gen-1.0.0/src/migrator_gen/api/__init__.py

@@ -0,0 +1,2 @@
+from .client_async import MigrationClient
+from .client_sync import SyncMigrationClient