Release 0.4.10

.devcontainer/.env.example

@@ -0,0 +1 @@
+UBUNTU_PASSWORD=put-your-devcontainer-user-password-here

.devcontainer/Dockerfile

@@ -0,0 +1,30 @@
+FROM ubuntu:24.04
+
+ARG DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+    bash-completion \
+    build-essential \
+    ca-certificates \
+    curl \
+    git \
+    openssh-client \
+    python3 \
+    python3-pip \
+    python3-venv \
+    sudo \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN update-alternatives --install /usr/bin/python python /usr/bin/python3 1
+
+RUN if ! id -u ubuntu >/dev/null 2>&1; then useradd -m -s /bin/bash ubuntu; fi \
+    && usermod -aG sudo ubuntu
+
+COPY .devcontainer/init-user.sh /usr/local/share/devcontainer/init-user.sh
+RUN chmod 755 /usr/local/share/devcontainer/init-user.sh
+
+WORKDIR /workspace
+
+ENTRYPOINT ["/usr/local/share/devcontainer/init-user.sh"]
+CMD ["sleep", "infinity"]

.devcontainer/devcontainer.json

@@ -0,0 +1,27 @@
+{
+  "name": "fxpmath-dev",
+  "dockerComposeFile": "docker-compose.yml",
+  "service": "dev",
+  "workspaceFolder": "/workspace",
+  "shutdownAction": "stopCompose",
+  "remoteUser": "ubuntu",
+  "updateRemoteUserUID": true,
+  "mounts": [
+    "source=${localEnv:SSH_AUTH_SOCK},target=/ssh-agent,type=bind",
+    "source=${localEnv:HOME}/.ssh,target=/home/ubuntu/.ssh,type=bind,consistency=cached"
+  ],
+  "remoteEnv": {
+    "SSH_AUTH_SOCK": "/ssh-agent"
+  },
+  "customizations": {
+    "vscode": {
+      "settings": {
+        "python.defaultInterpreterPath": "/usr/bin/python3"
+      },
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance"
+      ]
+    }
+  }
+}

.devcontainer/docker-compose.yml

@@ -0,0 +1,11 @@
+services:
+  dev:
+    build:
+      context: ..
+      dockerfile: .devcontainer/Dockerfile
+    env_file:
+      - .env
+    volumes:
+      - ..:/workspace:cached
+    working_dir: /workspace
+    command: sleep infinity

.devcontainer/init-user.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ -n "${UBUNTU_PASSWORD:-}" ]]; then
+    echo "ubuntu:${UBUNTU_PASSWORD}" | chpasswd
+else
+    echo "UBUNTU_PASSWORD is not set; sudo will keep asking for a password that does not exist." >&2
+fi
+
+exec "$@"

.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [develop]
+  pull_request:
+    branches: [develop, master]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint-and-test:
+    name: Lint and test (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 40
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, ubuntu-24.04, macos-14, windows-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          pip install flake8 pytest
+
+      - name: Lint
+        run: |
+          flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+      - name: Test
+        run: pytest -q

.github/workflows/manual-windows-tests.yml

@@ -0,0 +1,44 @@
+name: Manual Windows Tests
+
+on:
+  workflow_dispatch:
+    inputs:
+      python-version:
+        description: Python version to use
+        required: true
+        default: "3.11"
+        type: choice
+        options:
+          - "3.10"
+          - "3.11"
+          - "3.12"
+
+jobs:
+  windows-tests:
+    name: Windows tests (Python ${{ inputs.python-version }})
+    runs-on: windows-latest
+    timeout-minutes: 45
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ inputs.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install pytest
+
+      - name: Print environment details
+        run: |
+          python --version
+          pip --version
+          python -c "import platform, sys, numpy; print('platform:', platform.platform()); print('python:', sys.version.replace('\n', ' ')); print('numpy:', numpy.__version__)"
+
+      - name: Run full test suite
+        run: pytest -q

.github/workflows/master-release-gate.yml

@@ -0,0 +1,46 @@
+name: Master Release Gate
+
+on:
+  push:
+    branches: [master]
+
+concurrency:
+  group: master-release-gate-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  test-before-release:
+    name: Test before release (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 50
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-22.04, ubuntu-24.04, macos-14, windows-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r requirements.txt
+          pip install -r requirements-dev.txt
+          pip install pytest build
+
+      - name: Run tests
+        run: pytest -q
+
+      - name: Build package artifacts
+        run: python -m build

.gitignore

@@ -104,7 +104,7 @@ celerybeat.pid
 
 # Environments
 .env
-.venv
+.venv*
 env/
 venv/
 ENV/
@@ -143,7 +143,6 @@ results/*
 # !.vscode/launch.json
 # !.vscode/extensions.json
 *.code-workspace
-.devcontainer
 
 # Local History for Visual Studio Code
 .history/
@@ -164,3 +163,6 @@ temp/
 
 # docker
 docker/
+
+# local planning docs
+/development-plan.md