Start finalizing the imcflibs-1.5.0 release

.coveragerc

@@ -0,0 +1,17 @@
+[run]
+source =
+    src/imcflibs
+
+omit =
+    conftest.py
+    tests/*
+    # omit anything in a venv / venv2 directory
+    ./venv/*
+    ./venv2/*
+
+[report]
+## NOTE: `exclude_also` is only supported for coverage 7.2 and newer, which
+## won't work when testing with Python2 (coverage 5.5 is the latest one
+## supporting Python2), hence we cannot use it:
+; exclude_also =
+;   if _python_platform.python_implementation\(\) == \"Jython\":

.github/codecov.yml

@@ -0,0 +1,13 @@
+coverage:
+  precision: 0
+  round: nearest
+  range:
+  - 0
+  - 75
+  # notification blocks
+  # https://docs.codecov.io/docs/codecovyml-reference#section-coverage-notify
+  # notify:
+  # status:
+  #   project:
+  #   patch:
+  #   changes: off

.github/workflows/build.yml

@@ -1,30 +1,44 @@
-name: build
+name: 🚚🌍 Publish to 🔬☕ SciJava and 🎪 PyPI
 
 on:
-  push:
-    branches:
-      - master
-    tags:
-      - "*-[0-9]+.*"
-  pull_request:
-    branches:
-      - master
+
+  release:
+    types:
+      - published  # A release, pre-release, or draft of a release was published.
+
+  workflow_dispatch:
+
+  ## Do NOT run on pushes or PR's, as they won't have a 'release.properties',
+  ## which is required by the build-tooling (see the comment at the "Inspect" /
+  ## "check-if-release.sh" section below for details).
+  # push:
+  # pull_request:
+
 
 jobs:
-  build:
+
+  publish-to-scijava:
+
+    name: 🔬☕ publish to SciJava
+
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
-      - name: Set up Java
+
+      - uses: actions/checkout@v4
+        name: 📥 Checkout repo
+
+      - name: ☕ Set up Java
         uses: actions/setup-java@v3
         with:
           java-version: '8'
           distribution: 'zulu'
           cache: 'maven'
-      - name: Set up CI environment
+
+      - name: 🪐 Set up CI environment
         run: .github/setup.sh
-      - name: Execute the build
+
+      - name: 👷 Build and publish on 🔬☕ SciJava
         run: .github/build.sh
         env:
           GPG_KEY_NAME: ${{ secrets.GPG_KEY_NAME }}
@@ -33,3 +47,137 @@ jobs:
           MAVEN_PASS: ${{ secrets.MAVEN_PASS }}
           OSSRH_PASS: ${{ secrets.OSSRH_PASS }}
           SIGNING_ASC: ${{ secrets.SIGNING_ASC }}
+
+
+  build-via-poetry:
+
+    name: 👷 build via 🎭 Poetry
+
+    runs-on: ubuntu-22.04
+
+    steps:
+    - uses: actions/checkout@v4
+      name: 📥 Checkout repo
+
+    - name: 🗃 Cache 📦 APT Packages
+      uses: awalsh128/cache-apt-pkgs-action@v1.4.3
+      with:
+        packages: xmlstarlet
+        version: 1.0
+
+    - name: 🕵 Inspect if this is a proper "scijava-scripts" release
+      run: scripts/check-if-release.sh
+      # This will make sure the file 'release.properties' exists, meaning
+      # `release-version.sh` from the 'scijava-scripts' repo has been run to
+      # prepare the release and modify 'pom.xml' (which is in turn
+      # required by the local 'scripts/run-poetry.sh' script for building the
+      # Python package through Poetry.
+
+    - name: 🐍 Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.10"
+
+    - name: 🗃 Cache 🎭 Poetry install
+      uses: actions/cache@v4
+      with:
+        path: ~/.local
+        key: poetry-2.0.1-0
+
+    # The key configuration value here is `virtualenvs-in-project: true`: this
+    # creates the venv as a `.venv` in your testing directory, which allows
+    # the next step to easily cache it.
+    - name: 🔩🔧 Install 🎭 Poetry
+      uses: snok/install-poetry@v1
+      with:
+        version: 2.0.1
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+
+    ### No dependencies and project installation required, we're just packaging.
+    # # Cache dependencies (i.e. all the stuff in your `pyproject.toml`).
+    # - name: 🗃 Cache 🧾 Dependencies
+    #   id: cache-deps
+    #   uses: actions/cache@v4
+    #   with:
+    #     path: .venv
+    #     key: pydeps-${{ hashFiles('**/poetry.lock') }}
+
+    ### No poetry-dynamic-versioning here, we're using the POM instead!
+    # - name: 🎭 Install Poetry dynamic-versioning 🔌 plugin
+    #   run: poetry self add "poetry-dynamic-versioning[plugin]"
+
+    ### No dependencies and project installation required, we're just packaging.
+    # # Install dependencies. `--no-root` means "install all dependencies but
+    # # not the project itself", which is what you want to avoid caching _your_
+    # # code. The `if` statement ensures this only runs on a cache miss.
+    # - name: 🎭 Install 🧾 Dependencies
+    #   run: scripts/run-poetry.sh install --no-interaction --no-root
+    #   if: steps.cache-deps.outputs.cache-hit != 'true'
+
+    # - name: 🎭 Install 🛖 project
+    #   run: scripts/run-poetry.sh install --no-interaction
+
+    - name: 🎭👷 Build 🧱 project
+      run: scripts/run-poetry.sh build
+      env:
+        IGNORE_DEPS_PYTHON: true  # required to build "py2.py3" wheels
+
+    - name: 📤 Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: release-dists
+        path: dist/
+
+
+  publish-to-pypi:
+
+    name: 🚚🌍 publish to 🎪 PyPI
+
+    runs-on: ubuntu-latest
+
+    needs:
+      - build-via-poetry
+
+    permissions:
+      id-token: write
+
+    environment:
+      name: release
+
+    steps:
+      - name: 📥 Retrieve release 📦 distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: release-dists
+          path: dist/
+
+      - name: 🥁 Publish release distributions to 🎪 PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+
+  trigger-foreign-workflows:
+
+    name: 🚀 Dispatch foreign workflows
+
+    strategy:
+      matrix:
+        repo: ['imcf/imcf.github.io']
+
+    runs-on: ubuntu-latest
+
+    needs:
+      - publish-to-pypi
+
+    steps:
+      - name: 🏹 Fire event on `${{ matrix.repo }}`
+        run: |
+          curl -L \
+            -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.DISPATCH_DEPLOY_PAGES }}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/${{ matrix.repo }}/dispatches \
+            -d '{"event_type":"dispatch-event"}'

.github/workflows/dispatch-deploy-pages.yml

@@ -0,0 +1,25 @@
+name: 🚀 Dispatch foreign workflows
+
+on:
+  workflow_dispatch:
+
+jobs:
+
+  trigger-event:
+
+    strategy:
+      matrix:
+        repo: ['imcf/imcf.github.io']
+
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 🏹 Fire event on `${{ matrix.repo }}`
+        run: |
+          curl -L \
+            -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.DISPATCH_DEPLOY_PAGES }}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            https://api.github.com/repos/${{ matrix.repo }}/dispatches \
+            -d '{"event_type":"dispatch-event"}'

.github/workflows/lint.yml

@@ -0,0 +1,23 @@
+name: 🔎 Code Linting ⚡
+
+on:
+  push:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+
+  lint:
+    name: Ruff ⚡🕵
+
+    runs-on: ubuntu-latest
+
+    steps:
+
+      - name: 📥 Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Run Ruff checks ⚡
+        uses: astral-sh/ruff-action@v3
+        with:
+          args: check

.github/workflows/pytest-poetry.yml

@@ -0,0 +1,107 @@
+## action file inspired by https://jacobian.org/til/github-actions-poetry/
+
+name: 🧪 pytest (via 🎭 Poetry)
+
+on:
+  push:
+    branches:
+    - master
+    tags:
+      - run-pytest*
+      - py3-pytest*
+      - "*-[0-9]+.*"
+  pull_request:
+    branches:
+    - master
+    - devel
+
+jobs:
+  pytest-poetry:
+    # runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
+
+    steps:
+
+    - uses: actions/checkout@v4
+      name: 📥 Checkout repo
+
+    - name: 🗃 Cache 📦 APT Packages
+      uses: awalsh128/cache-apt-pkgs-action@v1.4.3
+      with:
+        packages: xmlstarlet
+        version: 1.0
+
+    # If you wanted to use multiple Python versions, you'd have specify a
+    # matrix in the job and reference the matrix python version here.
+    - name: 🐍 Set up Python
+      uses: actions/setup-python@v5.4.0
+      with:
+        python-version: "3.10"
+
+    # Cache the installation of Poetry itself, e.g. the next step. This
+    # prevents the workflow from installing Poetry every time, which can be
+    # slow. Note the use of the Poetry version number in the cache key, and
+    # the "-0" suffix: this allows you to invalidate the cache manually
+    # if/when you want to upgrade Poetry, or if something goes wrong (could be
+    # done mildly cleaner by using an environment variable).
+    - name: 🗃 Cache 🎭 Poetry install
+      uses: actions/cache@v4
+      with:
+        path: ~/.local
+        key: poetry-1.8.2-0
+
+    # Install Poetry. You could do this manually, or there are several actions
+    # that do this. `snok/install-poetry` seems to be minimal yet complete,
+    # and really just calls out to Poetry's default install script, which
+    # feels correct. I pin the Poetry version here because Poetry does
+    # occasionally change APIs between versions and I don't want my actions to
+    # break if it does.
+    #
+    # The key configuration value here is `virtualenvs-in-project: true`: this
+    # creates the venv as a `.venv` in your testing directory, which allows
+    # the next step to easily cache it.
+    - name: 🔩🔧 Install 🎭 Poetry
+      uses: snok/install-poetry@v1
+      with:
+        version: 1.8.2
+        virtualenvs-create: true
+        virtualenvs-in-project: true
+
+    # Cache your dependencies (i.e. all the stuff in your `pyproject.toml`).
+    # Note the cache key: if you're using multiple Python versions, or
+    # multiple OSes, you'd need to include them in the cache key. I'm not, so
+    # it can be simple and just depend on the poetry.lock.
+    - name: 🗃 Cache 🧾 Dependencies
+      id: cache-deps
+      uses: actions/cache@v4
+      with:
+        path: .venv
+        key: pydeps-${{ hashFiles('**/poetry.lock') }}
+
+    ### No poetry-dynamic-versioning here, we're using the POM instead!
+    # - name: 🎭 Install Poetry dynamic-versioning 🔌 plugin
+    #   run: poetry self add "poetry-dynamic-versioning[plugin]"
+
+    # Install dependencies. `--no-root` means "install all dependencies but
+    # not the project itself", which is what you want to avoid caching _your_
+    # code. The `if` statement ensures this only runs on a cache miss.
+    - name: 🎭 Install 🧾 Dependencies
+      run: scripts/run-poetry.sh install --no-interaction --no-root --verbose
+      if: steps.cache-deps.outputs.cache-hit != 'true'
+
+    # Now install _your_ project. This isn't necessary for many types of
+    # projects -- particularly things like Django apps don't need this. But
+    # it's a good idea since it fully-exercises the pyproject.toml and makes
+    # that if you add things like console-scripts at some point that they'll
+    # be installed and working.
+    - name: 🎭 Install 🛖 project
+      run: scripts/run-poetry.sh install --no-interaction --verbose
+
+    # And finally run the tests.
+    - name: 🧪🎭 Run Tests
+      run: scripts/run-poetry.sh run pytest --color=yes --cov --cov-report=xml -vv
+
+    - name: 📤 Upload 📊 coverage reports to ☂ Codecov
+      uses: codecov/codecov-action@v5
+      with:
+        token: ${{ secrets.CODECOV_TOKEN }}