capytaine 2.2.1__tar.gz → 2.3.1__tar.gz

{capytaine-2.2.1 → capytaine-2.3.1}/.github/workflows/build_docs.yml

@@ -31,18 +31,22 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
+      - name: Set up Just
+        run: sudo apt install -y just
 
-      - name: Install Capytaine and other dependencies
-        run: pip install .[optional,docs]
+      - name: Set up UV
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
 
       - name: Build documentation
-        run: cd docs && make
+        run: just build_docs
 
       - name: Deploy pages
-        if: github.ref == 'refs/heads/master'  # Only deploy the version merged into the master branch
+        if: |
+          github.repository_owner == 'capytaine' &&
+          github.ref == 'refs/heads/master'
+        # Only deploy the version merged into the master branch of capytaine/capytaine
         uses: JamesIves/github-pages-deploy-action@releases/v4
         with:
           folder: ./docs/_build/html/

capytaine-2.3.1/.github/workflows/build_wheels.yaml

@@ -0,0 +1,107 @@
+name: Build wheels
+
+on:
+  workflow_dispatch:
+  push:
+    tags:
+      - v*
+  schedule:
+    - cron: '6 6 6/16 * *'  # On the 6th and 22nd of each month at 6:06
+
+
+jobs:
+  "build_wheels_on_windows":
+    name: Build wheels on Windows
+    runs-on: windows-2025
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: fortran-lang/setup-fortran@v1
+        with:
+          compiler: 'gcc'
+          version: '13'
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.0
+        env:
+          CIBW_SKIP: "*win32* cp314t*"
+          CIBW_BEFORE_BUILD_WINDOWS: pip install delvewheel
+          CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: "delvewheel show {wheel} && delvewheel repair -w {dest_dir} {wheel} --no-mangle-all"
+          # Package the DLL dependencies in the wheel for windows (done by default for the other platforms).
+          # delvewheel cannot mangle the libraries, stripping does not work.
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-windows
+          path: ./wheelhouse/*.whl
+
+  "build_wheels_on_ubuntu":
+    name: Build wheels on Ubuntu
+    runs-on: ubuntu-22.04
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: fortran-lang/setup-fortran@v1
+        with:
+          compiler: 'gcc'
+          version: '13'
+
+      - name: Build wheels on Ubuntu
+        uses: pypa/cibuildwheel@v3.2.0
+        env:
+          CIBW_SKIP: "*i686* *musllinux*"
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-ubuntu
+          path: ./wheelhouse/*.whl
+
+
+  "build_wheels_on_macos_intel":
+    name: Build wheels on MacOS Intel
+    runs-on: macos-13
+    # Should be replaced by macos-15-intel soon, but it does not seem to be
+    # supported by setup-fortran?
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: fortran-lang/setup-fortran@v1
+        with:
+          compiler: 'gcc'
+          version: '13'
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.0
+        env:
+          CIBW_ENVIRONMENT: MACOSX_DEPLOYMENT_TARGET=13.0
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-intel
+          path: ./wheelhouse/*.whl
+
+
+  "build_wheels_on_macos_arm":
+    name: Build wheels on MacOS ARM
+    runs-on: macos-14
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: fortran-lang/setup-fortran@v1
+        with:
+          compiler: 'gcc'
+          version: '13'
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v3.2.0
+        env:
+          CIBW_ENVIRONMENT: MACOSX_DEPLOYMENT_TARGET=14.0
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-macos-arm
+          path: ./wheelhouse/*.whl

{capytaine-2.2.1 → capytaine-2.3.1}/.github/workflows/test_new_commits.yaml

@@ -16,7 +16,6 @@ on:
 
 env:
   FORCE_COLOR: 3
-  # Colors for nox
 
 # The following block is meant to cancel the workflow if a newer commit is pushed on the pull request
 # From https://stackoverflow.com/questions/66335225/how-to-cancel-previous-runs-in-the-pr-when-you-push-new-commitsupdate-the-curre
@@ -25,31 +24,35 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  build_and_test:
+  "build_and_test":
 
     runs-on: ubuntu-latest
 
     strategy:
       matrix:
-        python-version: ['3.8', '3.12']
+        python-version: ['38', '312']
 
     steps:
 
     - name: Checkout repository
       uses: actions/checkout@v4
 
-    - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v5
-      with:
-        python-version: ${{ matrix.python-version }}
+    # - name: Set up Just
+    #   uses: extractions/setup-just@v3
+    #   with:
+    #       just-version: 1.40
+    - name: Set up Just
+      run: sudo apt install -y just
 
-    - name: Set up nox
-      uses: wntrblm/nox@2024.04.15
+    - name: Set up UV
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
 
-    - name: Run nox session
-      run: nox --force-python ${{ matrix.python-version }} -s build_and_test_on_locked_env
+    - name: Run tests
+      run: just test_in_py${{ matrix.python-version }}_reference_env
 
-  compile_fortran:
+  "compile_fortran":
 
     runs-on: ubuntu-latest
 
@@ -69,7 +72,11 @@ jobs:
     #     version: '13'
 
     - name: Compile and run example
-      working-directory: capytaine/green_functions/libDelhommeau/
+      working-directory: src/capytaine/green_functions/libDelhommeau/
       run: make example && examples/minimal/minimal_example.bin
       # Soundness of the results is not tested, only that the compiling and
       # execution are succeeding.
+
+    - name: Run simple benchmark
+      working-directory: src/capytaine/green_functions/libDelhommeau/
+      run: make run_bench_rankine && make run_bench_waves

capytaine-2.3.1/.github/workflows/test_with_latest_dependencies.yaml

@@ -0,0 +1,48 @@
+name: Build and test using latest available dependencies
+
+on:
+  workflow_dispatch:
+  schedule:
+    - cron: '5 5 5/15 * *'  # On the 5th and 20th of each month at 5:05
+
+env:
+  FORCE_COLOR: 3
+
+jobs:
+  "test_in_latest_env":
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up UV
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Set up Just
+      run: sudo apt install -y just
+
+    - name: Run tests
+      run: just test_in_latest_env
+
+  "test_in_nightly_env":
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up UV
+      uses: astral-sh/setup-uv@v5
+      with:
+        enable-cache: true
+
+    - name: Set up Just
+      run: sudo apt install -y just
+
+    - name: Run tests
+      run: just test_in_nightly_env

{capytaine-2.2.1 → capytaine-2.3.1}/.gitignore

@@ -1,3 +1,4 @@
+uv.lock
 .idea/
 pytest/Nemoh_verification_cases/*/results/
 docs/_static/

{capytaine-2.2.1 → capytaine-2.3.1}/.pre-commit-config.yaml

@@ -37,4 +37,4 @@ repos:
     rev: "v2.2.5"
     hooks:
       - id: codespell
-        args: ["-L", "ba,informations,inout,ist,lamda,ment,noe,periode,sur", "--skip", "capytaine/green_functions/libDelhommeau/src/old_Prony_decomposition.f90"]
+        args: ["-L", "ans,ba,informations,inout,ist,lamda,ment,noe,periode,sur", "--skip", "src/capytaine/green_functions/libDelhommeau/src/old_Prony_decomposition.f90"]

capytaine-2.3.1/CONTRIBUTING.md

@@ -0,0 +1,18 @@
+# How to contribute
+
+Thank you for your interest into Capytaine.
+
+## Contact
+
+The best place to report a bug or to propose an enhancement is the [issue
+tracker](https://github.com/mancellin/capytaine/issues) of Capytaine's Github
+repository.
+
+The [discussion page](https://github.com/mancellin/capytaine/discussions) can
+also be used to ask questions and submit ideas.
+
+## Submitting changes
+
+Pull requests are welcome.
+See the [developer manual](https://capytaine.org/master/developer_manual) for
+instructions.

capytaine-2.3.1/Justfile

@@ -0,0 +1,154 @@
+set shell := ["bash", "-c"]
+set windows-shell := ["powershell.exe", "-c"]
+
+default:
+    just --list
+
+editable_install:
+    uv pip install -r pyproject.toml \
+        --group editable_install \
+        --group dev
+    pip install --no-build-isolation --editable .
+    # Meson-backed editable install is not (yet?) supported by uv (https://github.com/astral-sh/uv/issues/10214)
+
+# Define the temporary directory differently based on OS
+TEMP_DIR := if os_family() == 'windows' {
+    `$temp = Join-Path $env:TEMP ('capytainedev-' + [System.IO.Path]::GetRandomFileName()); New-Item -ItemType Directory -Path $temp -Force | Out-Null; Write-Output $temp`
+} else {
+    `mktemp --directory --tmpdir capytainedev-XXXXX`
+}
+
+ENV := "MPLBACKEND=pdf CAPYTAINE_PROGRESS_BAR=False CAPYTAINE_CACHE_DIR=" + TEMP_DIR + "/cache/"
+
+TEST_DIR := justfile_directory() / 'pytest'
+NEMOH_CASES := TEST_DIR / 'Nemoh_verification_cases' / 'Cylinder'
+
+EXAMPLES_DIR := justfile_directory() / 'docs' / 'examples' / 'src'
+EXAMPLES_FILES := ' \
+    A1_radiation_cylinder.py \
+    A2_multibody.py \
+    A3_finite_depth_cylinder.py \
+    A4_custom_dofs.py \
+    A5_convergence_study.py \
+    A7_elasticity_of_beam.py \
+    A8_export_dataset.py \
+    B1_pressure_on_hull.py \
+    B2_haskind.py \
+    B3_free_surface_elevation.py \
+    B4_kochin.py \
+    B5_plot_velocity_in_domain.py \
+    B8_pressure_infinite_frequency.py \
+    C5_plot_influence_matrix.py \
+    C8_compare_Green_functions.py \
+    C9_custom_Green_function.py \
+'
+
+## Reason for skipping some example files:
+# A6_irregular_frequency_removal.py \     # Slow
+# B6_animate_free_surface.py  \           # Requires VTK
+# B7_boat_animation.py  \                 # Requires VTK
+# C6_axisymmetric_buoy.py  \              # Requires VTK
+# C7_h_matrices_with_preconditionner.py \ # Slow
+# C10_custom_linear_solver_on_gpu.py \    # Requires torch
+
+# Run the test suite and the example files assuming a virtual environment has been activated
+[unix]
+_test:
+    #!/usr/bin/env bash
+    set -euxo pipefail
+    uv pip list | grep -Ei "numpy|xarray|capytaine" || true
+    cd {{TEMP_DIR}}
+    export {{ENV}}
+    python -c "import capytaine; print(capytaine.__version__)"
+    python -m pytest {{TEST_DIR}}
+    capytaine --help
+    capytaine {{NEMOH_CASES}}/Nemoh.cal
+    capytaine {{NEMOH_CASES}}/Nemoh_v3.cal
+    set +x  # Stop displaying commands
+    for f in {{EXAMPLES_FILES}}; do
+        echo -e "\n---> Running $f";
+        python {{EXAMPLES_DIR}}/$f;
+    done
+
+# Simplified version of the above, working on Windows
+[windows]
+_test:
+    #! powershell
+    cd {{TEMP_DIR}}
+    python -c "import capytaine; print(capytaine.__version__)"
+    python -m pytest {{TEST_DIR}}
+    capytaine --help
+    capytaine {{NEMOH_CASES}}/Nemoh.cal
+    capytaine {{NEMOH_CASES}}/Nemoh_v3.cal
+
+
+test_in_latest_env:
+    uv run \
+        --isolated --no-editable \
+        --only-group test \
+        just _test
+
+test_in_py38_reference_env:
+    uv run \
+        --isolated --no-editable \
+        --only-group test \
+        --python 3.8 \
+        --with-requirements {{TEST_DIR}}/envs/2023-08-01-py3.8.txt \
+        just _test
+    # TODO: Also build Capytaine in this environment?
+
+test_in_py312_reference_env:
+    uv run \
+        --isolated --no-editable \
+        --only-group test \
+        --python 3.12 \
+        --with-requirements {{TEST_DIR}}/envs/2025-04-18-py3.12.txt \
+        just _test
+    # TODO: Also build Capytaine in this environment?
+
+test_in_nightly_env:
+    uv run \
+        --isolated --no-editable \
+        --pre --extra-index-url https://pypi.anaconda.org/scientific-python-nightly-wheels/simple \
+        --index-strategy unsafe-best-match \
+        --python 3.13 \
+        --only-group test \
+        just _test
+    # "--index-strategy unsafe-best-match" means uv should not ignore wheels
+    # from PyPI during universal resolution
+    # TODO: Also build Capytaine in this environment?
+
+# How the requirements files from the above recipes where generated.
+create_test_env_file python="3.8" date="2023-08-01":
+    uv pip compile \
+        pyproject.toml editable_install_requirements.txt \
+        --python-version {{python}} \
+        --exclude-newer {{date}} \
+        --extra optional --extra test \
+        -o {{TEST_DIR}}/envs/{{date}}-py{{python}}.txt
+
+# Compile the Fortran code without parallelism for easier reading of the errors.
+test_fortran_compilation:
+    # It is assumed that meson and ninja are already installed (e.g. with editable_install).
+    meson setup --wipe {{TEMP_DIR}}/build && meson compile -C {{TEMP_DIR}}/build -j 1
+
+
+build_docs:
+    uv run \
+        --isolated --no-editable \
+        --only-group docs \
+        -- \
+        make --directory="./docs/"
+
+
+clean:
+    rm -f src/capytaine/green_functions/libs/*.so
+    rm -rf build/
+    rm -rf dist/
+    rm -rf src/capytaine.egg-info/
+    rm -rf docs/_build
+    rm -rf .pytest_cache/
+    rm -rf .venv/
+    rm -rf __pycache__ */__pycache__ */*/__pycache__ */*/*/__pycache__
+    rm -rf $HOME/.cache/capytaine/*
+    rm -rf /tmp/capytainedev-*/

{capytaine-2.2.1 → capytaine-2.3.1}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.1
 Name: capytaine
-Version: 2.2.1
+Version: 2.3.1
 Summary: Python BEM solver for linear potential flow, based on Nemoh
-Author-Email: Matthieu Ancellin <matthieu.ancellin@eurobios.com>
+Author-Email: Matthieu Ancellin <matthieu.ancellin@mews-labs.com>
 License:                     GNU GENERAL PUBLIC LICENSE
                                 Version 3, 29 June 2007
          
@@ -683,25 +683,21 @@ Classifier: Programming Language :: Fortran
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Topic :: Scientific/Engineering
+Project-URL: homepage, https://capytaine.org
 Project-URL: repository, https://github.com/capytaine/capytaine
 Requires-Python: >=3.8
 Requires-Dist: numpy>=1.20; python_version >= "3.9"
 Requires-Dist: numpy>=1.24; python_version == "3.8"
 Requires-Dist: scipy
-Requires-Dist: pandas>=1.3
+Requires-Dist: pandas<3,>=1.3
 Requires-Dist: xarray
 Requires-Dist: rich
 Provides-Extra: optional
 Requires-Dist: matplotlib; extra == "optional"
 Requires-Dist: joblib>=1.3; extra == "optional"
 Requires-Dist: meshio; extra == "optional"
-Provides-Extra: test
-Requires-Dist: pytest; extra == "test"
-Provides-Extra: docs
-Requires-Dist: sphinx; extra == "docs"
-Requires-Dist: sphinx-toolbox; extra == "docs"
-Requires-Dist: sphinxcontrib-proof; extra == "docs"
-Requires-Dist: sphinxcontrib-mermaid; extra == "docs"
+Requires-Dist: netcdf4; extra == "optional"
+Requires-Dist: vtk; extra == "optional"
 Description-Content-Type: text/markdown
 
 # Capytaine: a linear potential flow BEM solver with Python.

{capytaine-2.2.1 → capytaine-2.3.1}/docs/Makefile

@@ -28,4 +28,4 @@ test: show
 
 autodoc:
 	rm -rf developer_manual/api/capytaine*.rst
-	sphinx-apidoc -o developer_manual/api/ ../capytaine --separate --doc-project "API documentation"
+	sphinx-apidoc -o developer_manual/api/ ../src/capytaine --separate --doc-project "API documentation"