Initial commit

Author: Sébastien Rolland

.dockerignore

@@ -0,0 +1,10 @@
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.so
+*.DS_Store
+.git/
+.gitignore
+.venv
+.vscode

.github/workflows/ci.yml

@@ -0,0 +1,94 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+env:
+  IMAGE_NAME: ${{ github.repository }}
+
+
+jobs:
+  ruff_lint:
+    name: Ruff Lint
+    runs-on: ubuntu-latest
+
+    continue-on-error: ${{ github.ref != 'refs/heads/main' && !(github.event_name == 'pull_request' && github.base_ref == 'main') }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Run Ruff
+        uses: astral-sh/ruff-action@v3
+        with:
+          version: "0.14.2"
+          args: "check --config pyproject.toml qazpt"
+
+  pip_audit:
+    name: pip-audit
+    runs-on: ubuntu-latest
+
+    continue-on-error: ${{ github.ref != 'refs/heads/main' && !(github.event_name == 'pull_request' && github.base_ref == 'main') }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.14"
+
+      - name: Run pip-audit
+        uses: pypa/gh-action-pip-audit@v1.1.0
+        with:
+          inputs: .
+
+  build_and_push:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+    needs: [ruff_lint, pip_audit]
+
+    if: github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v')
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/${{ env.IMAGE_NAME }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=raw,value=latest
+            type=sha
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.gitignore

@@ -0,0 +1,12 @@
+__pycache__
+**/.DS_Store
+.venv/
+.env
+.env.*
+*.egg-info/
+dist/
+build/
+.ruff_cache/
+.pytest_cache/
+.idea/
+.vscode/

.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.2
+    hooks:
+      - id: ruff-check
+        args: [--config, pyproject.toml, qazpt]
+        always_run: true
+        pass_filenames: false
+
+  - repo: https://github.com/pypa/pip-audit
+    rev: v2.7.3
+    hooks:
+      - id: pip-audit
+        args: ["."]
+        always_run: true
+        pass_filenames: false

.python-version

@@ -0,0 +1 @@
+3.14

CONTRIBUTING.md

@@ -0,0 +1,44 @@
+# Contributing to QAZPT
+
+Thank you for your interest in contributing to QAZPT!
+
+## Getting started
+
+1. Fork the repository and clone your fork.
+2. Install the development dependencies:
+
+   ```sh
+   uv sync --group dev
+   pre-commit install
+   ```
+
+3. Create a branch for your change:
+
+   ```sh
+   git checkout -b my-feature
+   ```
+
+## Development workflow
+
+- **Linting:** `ruff check --config pyproject.toml qazpt`
+- **Formatting:** `ruff format qazpt`
+- **Dependency audit:** `pip-audit .`
+- **Pre-commit hooks:** both checks run automatically on every commit once you have run `pre-commit install`.
+
+## Submitting changes
+
+1. Make sure pre-commit passes locally (`pre-commit run --all-files`).
+2. Push your branch and open a pull request against `main`.
+3. Describe what the change does and why. Include steps to reproduce if you are fixing a bug.
+
+## Reporting issues
+
+Open an issue on GitHub. Include:
+
+- The QAZPT version (`qazpt --version` or the git commit hash).
+- The command you ran and the full error output.
+- Any relevant context about your EntraID environment (without sensitive data).
+
+## License
+
+By contributing you agree that your contributions will be licensed under the [Apache 2.0 License](LICENSE).

Dockerfile

@@ -0,0 +1,57 @@
+FROM python:3.14-slim AS base
+
+ARG AZURE_CLI_VERSION=2.77.0
+
+ENV PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1 \
+    UV_NO_CACHE=1 \
+    DEBIAN_FRONTEND=noninteractive \
+    UV_TOOL_BIN_DIR=/usr/local/bin \
+    UV_TOOL_DIR=/usr/local/share/uv/tools \
+    AZ_DIST=bookworm
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+       curl ca-certificates gnupg jq \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install Azure CLI from the official Microsoft apt repository.
+# The Microsoft GPG key is verified by gpg before being trusted.
+RUN curl -sLS https://packages.microsoft.com/keys/microsoft.asc \
+       | gpg --dearmor \
+       | install -o root -g root -m 644 /dev/stdin /etc/apt/trusted.gpg.d/microsoft.gpg \
+    && printf 'deb [arch=%s signed-by=/etc/apt/trusted.gpg.d/microsoft.gpg] https://packages.microsoft.com/repos/azure-cli/ %s main\n' \
+       "$(dpkg --print-architecture)" "${AZ_DIST}" \
+       > /etc/apt/sources.list.d/azure-cli.list \
+    && apt-get update \
+    && apt-get install -y --no-install-recommends "azure-cli=${AZURE_CLI_VERSION}-1~${AZ_DIST}" \
+    && rm -rf /var/lib/apt/lists/*
+
+# Install uv from the official pinned image — integrity guaranteed by Docker
+# content-addressable storage, no curl | bash.
+COPY --from=ghcr.io/astral-sh/uv:0.11.2 /uv /uvx /usr/local/bin/
+
+RUN useradd -m -U qazptuser
+
+WORKDIR /app
+
+# Copy packaging files first for better layer caching
+COPY --chown=qazptuser:qazptuser pyproject.toml README.md ./
+
+# Copy sources
+COPY --chown=qazptuser:qazptuser qazpt ./qazpt
+
+COPY --chown=qazptuser:qazptuser entrypoint.sh /usr/local/bin/
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+# Install the app & its deps
+RUN uv tool install .
+
+WORKDIR /home/qazptuser
+
+RUN rm -rf /app
+
+USER qazptuser
+
+
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]