ember-cfd 0.1.0__tar.gz

ember_cfd-0.1.0/.flake8

@@ -0,0 +1,2 @@
+[flake8]
+extend-ignore = E501

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

@@ -0,0 +1,101 @@
+name: CI
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+  # Called by publish.yml so a release tag cannot publish past a red CI.
+  workflow_call:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install build dependencies
+        run: sudo apt-get update && sudo apt-get install -y gfortran ninja-build
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --no-install-project
+
+      - name: Build wheel
+        run: uv build --wheel
+
+      - name: Install wheel
+        run: uv pip install --no-deps dist/*.whl
+
+      - name: Test
+        run: uv run --no-sync pytest tests
+
+      - name: Lint
+        run: uv run --no-sync ruff check src tests
+
+      - name: Check SPEC 0 compliance
+        run: uv run --no-sync python tools/check_spec0.py
+
+  build-wheels:
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # setuptools-scm needs full history and tags to compute the version
+          fetch-depth: 0
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v4.1.0
+
+      - name: Build sdist
+        run: pipx run build --sdist --outdir wheelhouse
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels
+          path: |
+            wheelhouse/*.whl
+            wheelhouse/*.tar.gz
+
+  verify-install:
+    needs: build-wheels
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        # Keep in sync with [tool.cibuildwheel] build = "..." in pyproject.toml.
+        python-version: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: wheelhouse
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Start local package index
+        run: |
+          mkdir -p packages
+          pipx run --spec pypiserver pypi-server run -p 8080 -a . -P . packages &
+          # First run has to install pypiserver into a fresh pipx venv, so
+          # poll for readiness instead of assuming a fixed startup delay.
+          for i in $(seq 1 30); do
+            curl -sf http://localhost:8080/simple/ && break
+            sleep 1
+          done
+          curl -sf http://localhost:8080/simple/
+
+      - name: Publish wheels to local index
+        run: pipx run twine upload --repository-url http://localhost:8080/ -u x -p x wheelhouse/*.whl
+
+      - name: Install from local index
+        run: |
+          python -m venv verify-venv
+          verify-venv/bin/pip install --index-url http://localhost:8080/simple/ ember-cfd
+
+      - name: Smoke test the installed wheel
+        run: |
+          verify-venv/bin/python -c "from ember.fortran import set_residual; print('OK')"

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

@@ -0,0 +1,64 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  ci:
+    # Runs test, build-wheels and verify-install so a release tag cannot
+    # publish past a red CI or an unverified wheel.
+    uses: ./.github/workflows/ci.yml
+
+  publish-testpypi:
+    needs: ci
+    runs-on: ubuntu-latest
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: wheelhouse
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          packages-dir: wheelhouse/
+          # Re-running a tag must not fail here just because TestPyPI already
+          # holds that version; publish-pypi is gated on this job succeeding.
+          skip-existing: true
+
+      - name: Install from TestPyPI
+        run: |
+          python -m venv testpypi-venv
+          # Dependencies (numpy, h5py, ...) generally aren't published on
+          # TestPyPI, so fall back to real PyPI for anything it's missing.
+          testpypi-venv/bin/pip install \
+            --index-url https://test.pypi.org/simple/ \
+            --extra-index-url https://pypi.org/simple/ \
+            ember-cfd
+
+      - name: Smoke test the installed package
+        run: |
+          testpypi-venv/bin/python -c "from ember.fortran import set_residual; print('OK')"
+
+  publish-pypi:
+    needs: publish-testpypi
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wheels
+          path: wheelhouse
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: wheelhouse/

ember_cfd-0.1.0/.gitignore

@@ -0,0 +1,65 @@
+# setuptools-scm generated version file
+src/ember/_version.py
+
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+.coverage
+
+examples/.ipynb_checkpoints
+
+# Virtual environments
+.venv
+
+# Claude Code project instructions
+CLAUDE.md
+.claude/
+
+*so
+*.mod
+
+# Editable install directory
+/ember/
+
+# Benchmark scripts
+benchmark_*.py
+
+doc/_build/
+doc/_static/
+docs/_build/
+
+# sphinx-gallery generated output. plot_*.py examples are cheap and always
+# regenerated, so their output stays ignored. run_*.py examples are expensive
+# (see examples/README.txt) -- their generated output is committed so RTD and
+# other clean-clone builds reuse it via sphinx-gallery's md5 cache instead of
+# re-running the example; run `make docs-full` and `git add` the results
+# after changing a run_*.py example.
+docs/auto_examples/*
+!docs/auto_examples/run_*
+!docs/auto_examples/images
+docs/auto_examples/images/*
+!docs/auto_examples/images/sphx_glr_run_*.png
+!docs/auto_examples/images/thumb
+docs/auto_examples/images/thumb/*
+!docs/auto_examples/images/thumb/sphx_glr_run_*.png
+docs/sg_execution_times.rst
+
+*.pkl
+for-reference/
+
+# Reference papers, profiler dumps, Fortran sources
+*.pdf
+*.lprof
+*.f
+
+# Archived/untracked scratch scripts and study outputs
+archive/
+
+matplotlibrc
+
+# PGO profile data (EMBER_PGO=generate); regenerate with tools/pgo_train.py
+.pgo/

ember_cfd-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,76 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-merge-conflict
+      - id: check-yaml
+      - id: check-toml
+      - id: debug-statements
+
+  - repo: local
+    hooks:
+      - id: check-fortran
+        name: check fortran syntax
+        entry: tools/check_compile.sh
+        language: script
+        # check_compile.sh syntax-checks the whole .f90 set (pass_filenames:
+        # false), so run it on every commit -- not only when a .f90 is staged --
+        # to catch a latent bad line already in the tree (e.g. an over-length
+        # free-form line) on the next commit of any file, not just a .f90 edit.
+        always_run: true
+        pass_filenames: false
+
+      - id: check-no-typing
+        name: check no type annotations
+        entry: tools/check_no_typing.sh
+        language: script
+        files: ^src/ember/.*\.py$
+        pass_filenames: false
+
+      - id: check-dead-code
+        name: check dead code
+        entry: tools/check_dead_code.sh
+        language: script
+        pass_filenames: false
+
+      - id: check-stale-build-artifacts
+        name: check stale build artifacts
+        entry: tools/check_stale_build_artifacts.sh
+        language: script
+        pass_filenames: false
+
+      - id: check-member-order
+        name: check class member order
+        entry: uv run python tools/check_member_order.py
+        language: system
+        files: ^src/ember/.*\.py$
+        pass_filenames: true
+
+      - id: run-tests
+        name: run tests
+        entry: uv run pytest tests -q --tb=short
+        language: system
+        pass_filenames: false
+        always_run: true
+
+      - id: build-docs
+        name: build docs
+        entry: tools/build_docs.sh
+        language: script
+        files: ^(docs/.*|src/ember/.*\.py)$
+        pass_filenames: false
+
+      - id: no-claude-in-commit-msg
+        name: no Claude in commit message
+        entry: tools/check_no_claude_commit_msg.sh
+        language: script
+        stages: [commit-msg]
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.12.8
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format

ember_cfd-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

ember_cfd-0.1.0/.readthedocs.yaml

@@ -0,0 +1,24 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.13"
+  # gfortran is required to compile the Fortran extension module from
+  # source (there are no prebuilt wheels to install here).
+  apt_packages:
+    - gfortran
+  jobs:
+    install:
+      # dependency-groups support (--group) needs pip>=25.1
+      - pip install --upgrade pip
+      - pip install --group docs -e .
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+   configuration: docs/conf.py