feat: Add configuration and validation for Docker image factory

- Implemented configuration models in `config.py` for managing distributions, package groups, and variants.
- Introduced a validation system in `validator.py` to ensure configuration consistency and correctness.
- Created `PKG-INFO` and other metadata files for packaging the project.
- Defined entry points for command-line interface in `entry_points.txt`.
- Added dependencies and development requirements in `requires.txt`.

Author: prudhomm

.github/workflows/feelpp-env.yml

@@ -6,6 +6,8 @@ on:
       - master
     paths:
       - 'feelpp-env/**'
+      - 'src/feelpp/docker/factory/**'
+      - 'pyproject.toml'
       - '.github/workflows/feelpp-env.yml'
   workflow_dispatch:
     inputs:
@@ -52,8 +54,8 @@ jobs:
       fail-fast: true
       max-parallel: 4
       matrix: 
-        # Auto-generated from: feelpp-env/factory.sh matrix --format yaml
-        # To update: cd feelpp-env && ./factory.sh matrix --format yaml
+        # Auto-generated from: feelpp-factory matrix --format yaml
+        # To update: uv venv .venv && source .venv/bin/activate && uv pip install -e . && feelpp-factory matrix --format yaml
         include:
           - {service: feelpp-env, dist: trixie,   flavor: debian, version: "13",      tag: debian-13,      experimental: false, platforms: "linux/amd64,linux/arm64", dockerfile: Dockerfile}
           - {service: feelpp-env, dist: testing,  flavor: debian, version: "testing", tag: debian-testing, experimental: true,  platforms: "linux/amd64",              dockerfile: Dockerfile}
@@ -77,19 +79,17 @@ jobs:
     - name: Setup Python factory
       run: |
           echo "Setting up Python factory environment..."
-          cd feelpp-env
           uv venv .venv
           source .venv/bin/activate
-          uv pip install -q pyyaml jinja2 click rich pydantic
-          ./factory.sh validate
+          uv pip install -q -e .
+          .venv/bin/feelpp-factory validate
     - name: generate
       run: |
-          ./factory.sh generate --dist ${{ matrix.flavor }}:${{ matrix.version }}
+          .venv/bin/feelpp-factory generate --dist ${{ matrix.flavor }}:${{ matrix.version }} --output-dir feelpp-env
           dir="${{ matrix.flavor }}-${{ matrix.version }}-clang++"
           echo "context=feelpp-env/${dir}" >> "$GITHUB_OUTPUT"
           ls -lrt
       id: generate
-      working-directory: feelpp-env
     - name: Set up QEMU
       uses: docker/setup-qemu-action@v3
     - name: Set up Docker Buildx
@@ -135,19 +135,17 @@ jobs:
     - name: Setup Python factory
       run: |
           echo "Setting up Python factory environment..."
-          cd feelpp-env
           uv venv .venv
           source .venv/bin/activate
-          uv pip install -q pyyaml jinja2 click rich pydantic
-          ./factory.sh validate
+          uv pip install -q -e .
+          .venv/bin/feelpp-factory validate
     - name: generate
       run: |
-          ./factory.sh generate --dist ${{ inputs.flavor }}:${{ inputs.version }}
+          .venv/bin/feelpp-factory generate --dist ${{ inputs.flavor }}:${{ inputs.version }} --output-dir feelpp-env
           dir="${{ inputs.flavor }}-${{ inputs.version }}-clang++"
           echo "context=feelpp-env/${dir}" >> "$GITHUB_OUTPUT"
           ls -lrt
       id: generate
-      working-directory: feelpp-env
     - name: Set up QEMU
       uses: docker/setup-qemu-action@v3
     - name: Set up Docker Buildx
@@ -172,4 +170,4 @@ jobs:
         token: ${{ secrets.CR_PAT }}
         repository: feelpp/runners
         event-type: runner-update-baseimage
-        client-payload: '{"flavor":"${{ inputs.flavor }}","version":"${{ inputs.version }}"}'
+        client-payload: '{"flavor":"${{ inputs.flavor }}","version":"${{ inputs.version }}"}'

.github/workflows/test-factory.yml

@@ -4,10 +4,10 @@ run-name: "Test Factory [${{ github.event_name }}]"
 on:
   pull_request:
     paths:
-      - 'feelpp-env/factory/**'
+      - 'src/feelpp/docker/factory/**'
       - 'feelpp-env/config/**'
       - 'feelpp-env/templates/**'
-      - 'feelpp-env/factory.sh'
+      - 'pyproject.toml'
       - '.github/workflows/test-factory.yml'
   workflow_dispatch:
 
@@ -19,41 +19,33 @@ jobs:
     steps:
     - uses: actions/checkout@v5
 
-    - name: Install uv
-      run: |
-        curl -LsSf https://astral.sh/uv/install.sh | sh
-        echo "$HOME/.local/bin" >> $GITHUB_PATH
+    - name: Setup uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
 
     - name: Setup Python environment
-      working-directory: feelpp-env
       run: |
         uv venv .venv
         source .venv/bin/activate
-        uv pip install pyyaml jinja2 click rich pydantic
+        uv pip install -e .
     
     - name: Validate configuration
-      working-directory: feelpp-env
       run: |
-        source .venv/bin/activate
-        ./factory.sh validate
+        .venv/bin/feelpp-factory validate
     
     - name: Show configuration
-      working-directory: feelpp-env
       run: |
-        source .venv/bin/activate
-        ./factory.sh show --variant feelpp-env
+        .venv/bin/feelpp-factory show --variant feelpp-env
     
     - name: Generate all Dockerfiles
-      working-directory: feelpp-env
       run: |
-        source .venv/bin/activate
-        ./factory.sh generate --output-dir test-output
+        .venv/bin/feelpp-factory generate --output-dir feelpp-env/test-output
     
     - name: Verify ninja-build in all Dockerfiles
-      working-directory: feelpp-env
       run: |
         echo "Checking for ninja-build in generated Dockerfiles..."
-        for dockerfile in test-output/*/Dockerfile; do
+        for dockerfile in feelpp-env/test-output/*/Dockerfile; do
           if ! grep -q "ninja-build" "$dockerfile"; then
             echo "ERROR: ninja-build missing in $dockerfile"
             exit 1
@@ -62,10 +54,9 @@ jobs:
         done
     
     - name: Verify auxiliary files
-      working-directory: feelpp-env
       run: |
         echo "Checking for auxiliary files..."
-        for dir in test-output/*/; do
+        for dir in feelpp-env/test-output/*/; do
           for file in Dockerfile bashrc.feelpp feelpp.conf.sh start.sh WELCOME; do
             if [ ! -f "$dir/$file" ]; then
               echo "ERROR: $file missing in $dir"
@@ -76,11 +67,9 @@ jobs:
         done
     
     - name: Generate build matrix
-      working-directory: feelpp-env
       run: |
-        source .venv/bin/activate
         echo "Build matrix:"
-        ./factory.sh matrix
+        .venv/bin/feelpp-factory matrix
     
     - name: Lint Dockerfiles
       uses: hadolint/hadolint-action@v3.1.0

feelpp-env/compare.sh

@@ -3,6 +3,15 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+if [ ! -x ".venv/bin/feelpp-factory" ]; then
+    uv venv .venv
+    source .venv/bin/activate
+    uv pip install -q -e "${PROJECT_ROOT}"
+fi
+FACTORY=".venv/bin/feelpp-factory"
 
 echo "=== Dockerfile Comparison ==="
 echo ""
@@ -51,7 +60,7 @@ if [ -f ".github/workflows/feelpp-env.yml" ]; then
     echo "  Old workflow: ~$old_count distributions"
 fi
 
-new_count=$(./factory.sh matrix --format json | grep -c '"service"' || echo 0)
+new_count=$("$FACTORY" matrix --format json | grep -c '"service"' || echo 0)
 echo "  New factory:  $new_count distributions"
 
 echo ""

feelpp-env/config/variants.yaml

@@ -14,7 +14,7 @@ variants:
       - debian:testing
       - debian:sid
       - ubuntu:24.04
-      # - ubuntu:26.04  # Disabled: resolute repositories not yet available on mirrors
+      - ubuntu:26.04
       - fedora:42
     extra_packages:
       apt: []