stackhelx 1.0.0__tar.gz

stackhelx-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,55 @@
+name: tests
+
+# Por push y no por pull_request. El evento de PR dejo de producir runs en este
+# repo el 6 de agosto: ni el push de un agente a una rama con PR abierto ni un
+# PR nuevo dispararon nada, con Actions habilitado y el workflow activo. Por
+# push cada rama corre sus tests igual, el PR muestra el check de su rama, y no
+# hay dos runs por commit como pasaria dejando los dos eventos.
+on:
+  push:
+  workflow_dispatch:
+
+# Empujar tres veces seguidas cancela las corridas viejas en vez de encolar tres
+# matrices de cuatro cuadros.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    # Uno solo: ruff lee el codigo, no el sistema operativo. Repetirlo en los
+    # cuatro cuadros de la matriz no dice nada nuevo.
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff
+      - run: ruff check stackhelx tests
+
+  test:
+    # El modulo de puertos habla directo con el SO y los tres sistemas divergen:
+    # SO_REUSEADDR en Windows, tabla de conexiones sin root en macOS. Correr en
+    # uno solo no prueba nada.
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python: ["3.13"]
+        include:
+          - os: ubuntu-latest
+            python: "3.10"
+          - os: ubuntu-latest
+            python: "3.11"
+          - os: ubuntu-latest
+            python: "3.12"
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: pip install -e ".[dev]"
+      - run: pytest -q -n auto

stackhelx-1.0.0/.github/workflows/release.yml

@@ -0,0 +1,52 @@
+name: release
+
+# Se dispara con el tag, no con el push a main: publicar es irreversible en PyPI
+# (un numero de version no se puede reusar ni despues de borrarlo) y merecer un
+# gesto explicito.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      # El numero sale de portmaster/__init__.py, que es la unica fuente. Si el
+      # tag no coincide, se corta antes de publicar: un v1.0.1 que sube un
+      # paquete que se llama 1.0.0 no se puede deshacer.
+      - name: El tag tiene que coincidir con la version del paquete
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          pkg=$(python -c "import re,pathlib; print(re.search(r'\"(.+)\"', pathlib.Path('stackhelx/__init__.py').read_text()).group(1))")
+          echo "tag=$tag paquete=$pkg"
+          [ "$tag" = "$pkg" ]
+
+      - run: pip install build
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    # El entorno permite exigir aprobacion manual desde la configuracion del
+    # repo antes de que corra este job.
+    environment: pypi
+    permissions:
+      # Trusted publishing: PyPI verifica este token de OIDC contra el publisher
+      # configurado para el repo. Sin API token en secrets, que es un secreto de
+      # larga vida que no caduca si se filtra.
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

stackhelx-1.0.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.env
+.gstack/
+# Grafo de codigo, 4 MB generados. Se rehace con `graphify update .`
+graphify-out/
+scratch/

stackhelx-1.0.0/AGENTS.md

@@ -0,0 +1,5 @@
+Las instrucciones del proyecto viven en [CLAUDE.md](CLAUDE.md).
+
+Este archivo existe para los agentes que buscan `AGENTS.md` por convención. Era
+una copia byte a byte de `CLAUDE.md`, y dos copias del mismo contrato divergen
+en el primer cambio.