[PierreRaybaut]

Summary

Read the Docs builds of SigimaX pull requests fail whenever SigimaX requires a Sigima version that is not yet released on PyPI. RTD installs sigimax[doc] from PyPI only, so pip cannot resolve the dependency:

• PRs fix: preserve nested signal blocking and skip unused close timer #7, Keep restored dock sizes at startup with Qt 5 #8 and Show the model formula in interactive fit dialogs #10: No matching distribution found for Sigima>=1.3.0 (before Sigima 1.3.0 was released)
• PR Browse and import large HDF5 and NeXus experimental files #13: No matching distribution found for Sigima>=1.4.0

The GitHub Actions test workflows do not have this problem because they install Sigima from GitHub. Every development cycle therefore leaves the RTD checks red until Sigima is released, which hides real documentation issues.

Changes

• New scripts/rtd_install_sigima.py, run as a build.jobs.pre_install step in .readthedocs.yaml. It mirrors the GitHub Actions logic:
  • Tag builds and main (stable / latest): nothing changes, Sigima comes from PyPI.
  • Other branches and pull requests: Sigima is installed from the GitHub branch with the same name as the SigimaX branch, or from develop if no such branch exists. For PR builds, RTD only exposes the PR number, so the script finds the SigimaX branch whose head matches the built commit (git ls-remote). PRs from forks fall back to develop.
• The regular python.install step (pip install --upgrade-strategy only-if-needed .[doc]) then keeps the pre-installed Sigima, because it already satisfies the requirement.

Validation

• Branch selection checked for tag, main, develop, PR Browse and import large HDF5 and NeXus experimental files #13 (→ Sigima feature/experimental-data-integration), a PR from a fork and a branch with no Sigima counterpart (both → develop).
• Reproduced the RTD install sequence locally in a clean virtualenv for PR Browse and import large HDF5 and NeXus experimental files #13: Sigima 1.4.0 is installed from GitHub, then pip install --upgrade --upgrade-strategy only-if-needed .[doc] reports Requirement already satisfied: Sigima>=1.4.0 and succeeds.

Follow-up

Once this is merged, PR #13 needs to be rebased on develop, because RTD reads .readthedocs.yaml from the PR commit.

Note: the stable RTD build fails for an unrelated reason (missing Qt bindings for an old tag, already fixed in df03e92); it will recover with the next release.