rustodbc-mi 0.1.0__tar.gz

rustodbc_mi-0.1.0/.env.example

@@ -0,0 +1,26 @@
+# rustodbc no carga .env por si sola al importar (ver AGENTS.md ss5).
+# Este archivo documenta las variables que Credentials.from_env()/EngineOptions.from_env()
+# leen; cargarlas es responsabilidad de la aplicacion consumidora (o llamar
+# explicitamente a rustodbc.load_dotenv()).
+
+# --- credenciales por cliente+entorno, convencion <VAR>_<CLIENTE>_<ENTORNO> ---
+DB_SYSTEM_ACME_DEV=
+DB_USER_ACME_DEV=
+DB_PASSWORD_ACME_DEV=
+
+# --- opcionales ---
+APP_ENV=dev
+# Si no se fija, se autodetecta con SQLDrivers (ver config.rs::PREFERRED_DRIVERS)
+DB_DRIVER=
+
+# --- tunables I/O-bound, deliberadamente NO cpu-aware ---
+BATCH_SIZE=1000
+MAX_WORKERS=4
+MIN_ROWS_PER_WORKER=500
+MERGE_CHUNK_SIZE=7000
+MERGE_MAX_WORKERS=3
+
+# --- especificas de rustodbc ---
+RUSTODBC_POOL_SIZE=4
+RUSTODBC_BLOCKING_THREADS=8
+RUSTODBC_FETCH_ARRAY_SIZE=

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

@@ -0,0 +1,99 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: fmt + clippy (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-2022, ubuntu-22.04]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install unixODBC dev headers (Linux only)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install --yes unixodbc-dev
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@v2
+
+      # Un solo paso para que el fmt NO tape los errores de clippy: se corre
+      # fmt (ignorando su salida), despues clippy (reporta errores de
+      # compilacion y lints), y al final fmt de nuevo como gatekeeper.
+      - name: cargo fmt + clippy
+        shell: bash
+        run: |
+          cargo fmt --check || true
+          cargo clippy --all-targets --all-features -- -D warnings
+          cargo fmt --check
+
+      # Invariante de AGENTS.md ss4: el GIL nunca se sostiene en el hilo
+      # bloqueante. Todo `Python::` en src/core/ (el FFI unsafe) es una
+      # violacion de esa regla. Se ignoran lineas de comentario/doc (//,
+      # ///, //!) -- los comentarios mencionan la regla, el codigo no debe
+      # usarla.
+      - name: Lint mecanico -- src/core/ nunca debe tocar el GIL
+        if: runner.os == 'Linux'
+        shell: bash
+        run: |
+          if grep -rn "Python::" src/core/ --include="*.rs" 2>/dev/null | grep -vE "^\s*[^:]+:[0-9]+:\s*(//|///|//!)" | grep -q "Python::"; then
+            echo "::error::src/core/ no debe referenciar Python:: (GIL) -- ver AGENTS.md ss4"
+            exit 1
+          fi
+
+  build:
+    name: build + smoke import (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-2022, ubuntu-22.04]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install unixODBC dev headers (Linux only)
+        if: runner.os == 'Linux'
+        run: sudo apt-get update && sudo apt-get install --yes unixodbc-dev
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: cargo check --all-targets --all-features
+        run: cargo check --all-targets --all-features
+
+      - name: pip install maturin
+        run: python -m pip install --upgrade pip "maturin>=1.7,<2.0"
+
+      # `maturin develop` requiere un virtualenv activo -- en CI no hay.
+      # Se usa `maturin build` + `pip install <wheel>` (estandar para CI).
+      - name: maturin build --release
+        run: maturin build --release
+
+      - name: Instalar wheel y smoke import
+        shell: bash
+        run: |
+          pip install --force-reinstall target/wheels/rustodbc_mi-*.whl
+          python -c "import rustodbc; print(rustodbc.__version__)"
+
+      # No hay job de integracion contra un IBM i real: requiere un
+      # sistema DB2 for i accesible, que no existe en runners de GitHub.
+      # Ver AGENTS.md ss9 "No hay integracion de CI".

rustodbc_mi-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,82 @@
+# Publica a PyPI los assets de un GitHub Release (sdist + wheels) via
+# Trusted Publishing (OIDC) -- sin token de larga vida que rotar.
+#
+# Requiere configurar, UNA vez, el "trusted publisher" en pypi.org:
+#   Proyecto "rustodbc-mi" -> Publisher: GitHub -> este repo ->
+#   workflow "publish.yml" -> environment "pypi".
+#
+# El release se arma con release.yml (workflow_dispatch manual) y sube el
+# sdist + wheels como assets; este workflow los baja y los publica a PyPI.
+
+name: Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g. 0.2.0). Leave empty for latest.'
+        required: false
+        type: string
+
+jobs:
+  publish-to-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/rustodbc-mi
+    permissions:
+      id-token: write
+      contents: read  # Required for gh release download
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Determine Release Tag
+        id: get_tag
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if [ -z "${{ inputs.version }}" ]; then
+            echo "No version provided, fetching latest release..."
+            LATEST_TAG=$(gh release list --limit 1 --json tagName --jq '.[0].tagName')
+            echo "Latest tag: $LATEST_TAG"
+            echo "tag=$LATEST_TAG" >> "$GITHUB_OUTPUT"
+          else
+            echo "Using provided version: v${{ inputs.version }}"
+            # Ensure v prefix if missing, though user prompt implies raw version
+            if [[ "${{ inputs.version }}" == v* ]]; then
+               echo "tag=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
+            else
+               echo "tag=v${{ inputs.version }}" >> "$GITHUB_OUTPUT"
+            fi
+          fi
+
+      - name: Validate release exists
+        id: check_release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="${{ steps.get_tag.outputs.tag }}"
+          if [ -z "$TAG" ] || [ "$TAG" = "null" ]; then
+            echo "::error::No se encontro ningun GitHub Release en este repo. Primero hay que correr release.yml (workflow_dispatch con la version) para crear el release con el sdist + wheels; despues volver a correr este publish.yml."
+            exit 1
+          fi
+          if ! gh release view "$TAG" --json tagName > /dev/null 2>&1; then
+            echo "::error::El release $TAG no existe. Correr release.yml primero para crear el release y subir los assets (sdist + wheels), y recien despues publicar con este workflow."
+            exit 1
+          fi
+          echo "Release $TAG encontrado."
+
+      - name: Download Release Assets
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          echo "Downloading assets for tag: ${{ steps.get_tag.outputs.tag }}"
+          gh release download ${{ steps.get_tag.outputs.tag }} --dir dist --pattern "*"
+
+      - name: List files
+        run: ls -R dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

rustodbc_mi-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,194 @@
+# Arma los artifacts de un release (sdist + wheels) y publica un GitHub
+# Release con todos ellos adjuntos. La publicacion a PyPI es un workflow
+# separado (publish.yml) para poder re-publicar sin tener que re-buildear.
+#
+# Wheels: rustodbc usa maturin + abi3-py312 (un solo wheel por plataforma
+# sirve 3.12/3.13/3.14+), asi que la build se hace con PyO3/maturin-action,
+# no con cibuildwheel (que arma un wheel POR version de CPython -- no aplica
+# aca). Ver AGENTS.md ss2 "Wheels".
+#
+# Plataformas: Windows x64 (odbc32.lib del Windows SDK, nada que vendorear) y
+# Linux x86_64 manylinux + musllinux (unixODBC-devel en build, excluyendo
+# libodbc.so.* del wheel -- en runtime lo da la imagen con ibm-iaccess). No
+# hay macOS ni aarch64 todavia: no hay evidencia de que el driver *IBM i
+# Access ODBC* exista para esas plataformas. Ver AGENTS.md ss2/ss9.
+
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version a liberar (ej. 0.2.0), sin la "v" inicial'
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  bump_version:
+    name: Bump version + tag
+    runs-on: ubuntu-latest
+    outputs:
+      tag: v${{ inputs.version }}
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Actualizar version en Cargo.toml y pyproject.toml
+        run: |
+          sed -i 's/^version = ".*"/version = "${{ inputs.version }}"/' Cargo.toml
+          sed -i 's/^version = ".*"/version = "${{ inputs.version }}"/' pyproject.toml
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add Cargo.toml pyproject.toml
+          # Si la version ya era la pedida (release repetido), no hay nada que
+          # commitear -- el commit no debe fallar por eso.
+          if git diff --cached --quiet; then
+            echo "No hay cambios que commitear (la version ya es ${{ inputs.version }})."
+          else
+            git commit -m "Bump version to ${{ inputs.version }}"
+            git push
+          fi
+          git tag -f v${{ inputs.version }}
+          # -f: si un run anterior fallo a mitad (tag local creado sin push), el
+          # re-run recrea el tag apuntando al HEAD correcto.
+          git push -f origin v${{ inputs.version }}
+
+  build_sdist:
+    name: Build sdist
+    needs: bump_version
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ needs.bump_version.outputs.tag }}
+
+      - name: Install unixODBC dev headers
+        run: sudo apt-get update && sudo apt-get install --yes unixodbc-dev
+
+      - name: maturin sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist__${{ github.sha }}
+          path: dist/*.tar.gz
+
+  build_windows_wheels:
+    name: Build wheels (Windows x64)
+    needs: bump_version
+    runs-on: windows-2022
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ needs.bump_version.outputs.tag }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: x86_64-pc-windows-msvc
+          args: --release --out dist --features tablesync
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels_windows__${{ github.sha }}
+          path: dist/*.whl
+
+  build_linux_manylinux:
+    name: Build wheels (manylinux x86_64)
+    needs: bump_version
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ needs.bump_version.outputs.tag }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      # cibuildwheel (igual que el repo dvicente-miatech/pyodbc): usa la
+      # imagen manylinux oficial de PyPA e instala unixODBC-devel DENTRO del
+      # contenedor. El repair de auditwheel (con --exclude libodbc.so.*)
+      # corre tambien dentro del contenedor, donde patchelf es nuevo.
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.1
+        env:
+          CIBW_MANYLINUX_X86_64_IMAGE: manylinux_2_28
+          CIBW_ARCHS_LINUX: x86_64
+          CIBW_BUILD: "cp312-manylinux_x86_64"
+          CIBW_BEFORE_ALL_LINUX: yum -y install unixODBC-devel
+          CIBW_TEST_COMMAND: ""
+          # libodbc.so.* NUNCA se vendorea (ver AGENTS.md ss2 "trampa
+          # CCSID/SQLWCHAR"): cargar el driver de IBM con opciones de
+          # SQLWCHAR distintas a las del sistema es un riesgo real.
+          CIBW_REPAIR_WHEEL_COMMAND_LINUX: auditwheel repair --exclude "libodbc.so.*" --wheel-dir {dest_dir} {wheel}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels_manylinux_x86_64__${{ github.sha }}
+          path: wheelhouse/*.whl
+
+  build_linux_musllinux:
+    name: Build wheels (musllinux x86_64)
+    needs: bump_version
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ needs.bump_version.outputs.tag }}
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      # cibuildwheel con la imagen musllinux_1_2 oficial de PyPA (Alpine,
+      # con apk) -- igual que el repo de referencia.
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.1
+        env:
+          CIBW_MUSLLINUX_X86_64_IMAGE: musllinux_1_2
+          CIBW_ARCHS_LINUX: x86_64
+          CIBW_BUILD: "cp312-musllinux_x86_64"
+          CIBW_BEFORE_ALL_LINUX: apk add unixodbc-dev
+          CIBW_TEST_COMMAND: ""
+          CIBW_REPAIR_WHEEL_COMMAND_LINUX: auditwheel repair --exclude "libodbc.so.*" --wheel-dir {dest_dir} {wheel}
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels_musllinux_x86_64__${{ github.sha }}
+          path: wheelhouse/*.whl
+
+  create_release:
+    name: Crear GitHub Release
+    needs:
+      - bump_version
+      - build_sdist
+      - build_windows_wheels
+      - build_linux_manylinux
+      - build_linux_musllinux
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Descargar todos los artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          pattern: '*__${{ github.sha }}'
+          merge-multiple: true
+
+      - name: Crear GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.bump_version.outputs.tag }}
+          files: dist/*
+          generate_release_notes: true

rustodbc_mi-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+/target/
+/dist/
+/build/
+*.pyd
+*.so
+*.dll
+__pycache__/
+*.pyc
+.venv/
+.env
+*.egg-info/
+
+AGENTS.md
+CLAUDE.md