ddlglot 0.1.0__tar.gz

ddlglot-0.1.0/.commitlintrc.json

@@ -0,0 +1,6 @@
+{
+  "extends": ["@commitlint/config-conventional"],
+  "rules": {
+    "type-enum": [2, "always", ["feat", "fix", "docs", "style", "refactor", "test", "chore", "ci", "build", "perf", "revert"]]
+  }
+}

ddlglot-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,25 @@
+## Description
+
+<!-- Describe your changes -->
+
+## Type of Change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Breaking change
+- [ ] Documentation update
+- [ ] Refactoring
+
+## Checklist
+
+- [ ] My code follows the style guidelines
+- [ ] I have performed a self-review
+- [ ] I have commented my code where necessary
+- [ ] I have updated the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective
+- [ ] New and existing tests pass locally
+
+## Related Issue
+
+<!-- Link to related issue (e.g., "Closes #123") -->

ddlglot-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint
+        run: uv run ruff check src tests
+
+      - name: Format check
+        run: uv run ruff format --check src tests
+
+      - name: Commitlint
+        uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: .commitlintrc.json
+
+      - name: Type check
+        run: uv run mypy src
+
+      - name: Run tests
+        run: uv run pytest tests --cov=ddlglot --cov-report=term-missing --cov-report=xml
+
+      - name: Upload coverage
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage
+          path: coverage.xml
+          retention-days: 1
+
+      - name: Upload to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+        continue-on-error: true
+
+  build:
+    name: Build
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Install build
+        run: uv pip install --system build hatch
+
+      - name: Build package
+        run: python -m build
+
+      - name: Verify build
+        run: |
+          pip install dist/*.whl --force-reinstall
+          python -c "import ddlglot; print('ddlglot imported successfully')"
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 5

ddlglot-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,56 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Install docs dependencies
+        run: uv sync --extra docs
+
+      - name: Build docs
+        run: |
+          uv run sphinx-build -b html docs docs/_build/html
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/_build/html
+
+  deploy:
+    name: Deploy
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

ddlglot-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,60 @@
+name: Release Please
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      releases_created: ${{ steps.release-please.outputs.releases_created }}
+      version: ${{ steps.release-please.outputs.version }}
+      sha: ${{ steps.release-please.outputs.sha }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: googleapis/release-please-action@v4
+        id: release-please
+        with:
+          release-type: python
+          config-file: .release-please-config.json
+          manifest-file: .release-please-manifest.json
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.releases_created }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/ddlglot/
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.release-please.outputs.sha }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: |
+          uv pip install --system build hatch
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip_existing: true

ddlglot-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+*.pyc
+.git/
+
+# Docs build
+docs/_build/
+

ddlglot-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,23 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-toml
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.8
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/alessandrojcm/commitlint-pre-commit-hook
+    rev: v9.24.0
+    hooks:
+      - id: commitlint
+        stages: [commit-msg]
+        additional_dependencies: ["@commitlint/config-conventional"]

ddlglot-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

ddlglot-0.1.0/.release-please-config.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://github.com/googleapis/release-please/raw/main/schemas/config.json",
+  "packages": {
+    ".": {
+      "package-name": "ddlglot",
+      "release-type": "python"
+    }
+  }
+}
+

ddlglot-0.1.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0"
+}

ddlglot-0.1.0/AGENTS.md

@@ -0,0 +1,248 @@
+# AGENTS.md - Developer Guide for ddlglot
+
+## Overview
+
+`ddlglot` is a Python library that provides a fluent builder API for generating DDL (Data Definition Language) statements using SQLGlot's AST. It supports multiple SQL dialects (PostgreSQL, SQLite, DuckDB, Spark/Delta Lake, etc.).
+
+---
+
+## 1. Commands
+
+### Build & Install
+
+```bash
+# Install the package in editable mode
+pip install -e .
+
+# Build the package
+hatch build
+```
+
+### Testing
+
+```bash
+# Run all tests
+pytest
+
+# Run a single test file
+pytest tests/test_core.py
+
+# Run a single test function
+pytest tests/test_core.py::test_create_table_basic
+
+# Run tests with verbose output
+pytest -v
+
+# Run tests with coverage
+pytest --cov=ddlglot --cov-report=term-missing
+```
+
+### Linting & Type Checking
+
+```bash
+# Run ruff (linter + formatter)
+ruff check .
+ruff format .
+
+# Run mypy (type checking)
+mypy src/ddlglot
+```
+
+---
+
+## 2. Code Style Guidelines
+
+### General
+
+- **Language**: English for all code, comments, and documentation
+- **Python version**: 3.13+
+- **Build system**: hatchling (via `pyproject.toml`)
+
+### Imports
+
+```python
+# Standard library first
+from __future__ import annotations
+from typing import Any, Dict, List, Optional, Tuple, Union
+
+# Third-party packages
+from sqlglot import expressions as exp
+
+# Local modules
+from ddlglot.builder import CreateBuilder, create
+from ddlglot.variants.spark_delta import create_spark_delta
+```
+
+- Use `from __future__ import annotations` for forward references
+- Always use explicit relative imports for package modules (`from ..builder import ...`)
+- Alphabetize imports within each group
+
+### Formatting
+
+- **Line length**: 100 characters max
+- **Indentation**: 4 spaces (no tabs)
+- **Quotes**: Double quotes for strings, except when string contains double quotes
+- **Trailing commas**: Use in multi-line expressions
+
+```python
+# Good
+def example(
+    arg1: str,
+    arg2: int,
+) -> Dict[str, Any]:
+    return {"arg1": arg1, "arg2": arg2}
+
+# Bad
+def example(arg1: str, arg2: int) -> Dict[str, Any]:
+    return {"arg1": arg1, "arg2": arg2}
+```
+
+### Types
+
+- Use explicit type hints for all function parameters and return types
+- Use `Optional[X]` instead of `X | None` for Python < 3.10 compatibility
+- Prefer type aliases for complex types:
+
+```python
+Lit = Union[str, int, float, bool]
+```
+
+### Naming Conventions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Modules | snake_case | `spark_delta.py` |
+| Classes | PascalCase | `CreateBuilder` |
+| Functions | snake_case | `create()`, `to_ast()` |
+| Variables | snake_case | `self._table` |
+| Constants | UPPER_SNAKE_CASE | `DELTA_FORMAT` |
+| Private members | `_leading_underscore` | `self._columns` |
+
+### Classes & Methods
+
+- Use fluent builder pattern: methods return `self` for chaining
+- Use `__init__` for object construction
+- Use `@staticmethod` for pure utility functions
+
+```python
+class CreateBuilder:
+    def name(self, table: str) -> "CreateBuilder":
+        self._table = table
+        return self
+```
+
+### Error Handling
+
+- Use explicit exceptions with descriptive messages
+- Raise `ValueError` for invalid arguments
+
+```python
+def to_ast(self) -> exp.Create:
+    if not self._table:
+        raise ValueError("Falta .name(<tabla>)")
+```
+
+### Docstrings
+
+- Use Google-style docstrings for public APIs:
+
+```python
+def sql(self, dialect: Optional[str] = None, pretty: bool = False) -> str:
+    """Generate SQL DDL string.
+    
+    Args:
+        dialect: SQL dialect (e.g., "postgres", "spark").
+        pretty: Enable pretty formatting.
+    
+    Returns:
+        The generated SQL string.
+    """
+    return self.to_ast().sql(dialect=dialect, pretty=pretty)
+```
+
+- **Do not add comments** unless explicitly requested
+
+### Testing
+
+- Place tests in `tests/` directory
+- Use `pytest` as test runner
+- Follow naming: `test_<module>.py`
+- One test class per module, test functions prefixed with `test_`
+
+```python
+# tests/test_core.py
+import pytest
+from ddlglot import create
+
+def test_create_table_basic():
+    sql = (
+        create("table")
+        .name("public.users")
+        .column("id", "INT", not_null=True)
+        .sql(dialect="postgres")
+    )
+    assert "CREATE TABLE" in sql
+```
+
+---
+
+## 3. Project Structure
+
+```
+ddlglot/
+├── pyproject.toml
+├── src/ddlglot/
+│   ├── __init__.py
+│   ├── builder.py          # Core fluent builder
+│   ├── properties.py       # Property helpers
+│   └── variants/
+│       ├── __init__.py
+│       └── spark_delta.py  # Spark + Delta preset
+└── tests/
+    ├── test_core.py
+    └── test_spark_delta.py
+```
+
+---
+
+## 4. Key Libraries
+
+- **sqlglot**: AST and SQL generation (installed as dependency)
+- **pytest**: Testing framework
+- **ruff**: Linting and formatting
+- **mypy**: Static type checking
+
+---
+
+## 5. Dialect-Specific Notes
+
+- The builder is **dialect-agnostic** at the AST level
+- Dialect-specific generation happens at `.sql(dialect=...)` call
+- Supported dialects: `postgres`, `sqlite`, `duckdb`, `spark`, `databricks`, etc.
+- SQLGlot's `Generator` handles dialect-specific syntax (e.g., `PARTITIONED BY` placement)
+
+---
+
+## 6. Common Tasks
+
+### Adding a New Dialect Preset
+
+1. Create `src/ddlglot/variants/<dialect>.py`
+2. Extend `CreateBuilder` following the pattern in `spark_delta.py`
+3. Export factory function `<dialect>_builder()`
+4. Add tests in `tests/test_<dialect>.py`
+
+### Adding New DDL Properties
+
+1. Add method to `CreateBuilder` (e.g., `.tblproperties()`)
+2. Implement property building in `_build_properties()`
+3. Use appropriate SQLGlot expression type (e.g., `exp.Properties`, `exp.Property`)
+4. Add tests covering the new property
+
+---
+
+## 7. Git Workflow
+
+- Use Conventional Commits: `feat(scope): description`, `fix(scope): description`
+- Run `pytest` and `ruff check .` before committing
+- Never commit directly to `main`; use feature branches

ddlglot-0.1.0/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [26.4.0](https://github.com/alexmarco/ddlglot/compare/v26.3.2...v26.4.0) (2026-03-21)
+
+
+### Features
+
+* **ci:** add release-please and commitlint for automated versioning ([5fb6b81](https://github.com/alexmarco/ddlglot/commit/5fb6b8136da4cc9898783f3db3cfbbf8a8dbdf11))
+* **ci:** add release-please and commitlint for automated versioning ([b8f3db1](https://github.com/alexmarco/ddlglot/commit/b8f3db16c430d7b9c3684a82adcf89d8e3739b31))
+
+
+### Bug Fixes
+
+* **docs:** remove tag trigger to avoid environment protection rules ([cb26ded](https://github.com/alexmarco/ddlglot/commit/cb26dedc10ac526b361403b86444770b2c62ae73))
+
+## [26.3.2] - 2026-03-21
+
+### Added
+
+- `.sql()` now accepts `indent`, `pad`, and `max_text_width` parameters for fine-grained pretty printing control
+
+## [26.3.1] - 2026-03-21
+
+### Fixed
+
+- CREATE TABLE now produces correct SQL without spurious `AS` clause
+
+## [26.3.0] - 2026-03-20
+
+### Added
+
+- Core builder with fluent API for DDL generation
+- Support for multiple SQL dialects:
+  - Spark+Delta Lake with CDF support
+  - Apache Hive with SERDE/ROW FORMAT
+  - PostgreSQL
+  - DuckDB
+  - BigQuery
+- Plugin registry system for custom variants
+- Dialect-specific validation
+- Comprehensive test suite (92 tests)
+- GitHub Actions CI/CD
+- Sphinx documentation
+- Pre-commit hooks
+
+### Features
+
+- `create()` factory function for generic DDL
+- `create_spark_delta()`, `create_hive()`, etc. for dialect-specific DDL
+- Fluent method chaining for all DDL operations
+- Type hints and validation
+- SQLGlot-powered AST generation