Skip to content

Handle tables via pip as pandas extra instead of separate conda install (and update installation instructions)#3214

Open
deruyter92 wants to merge 4 commits intomainfrom
jaap/fix_pytables_dependency
Open

Handle tables via pip as pandas extra instead of separate conda install (and update installation instructions)#3214
deruyter92 wants to merge 4 commits intomainfrom
jaap/fix_pytables_dependency

Conversation

@deruyter92
Copy link
Collaborator

@deruyter92 deruyter92 commented Feb 23, 2026

Motivation:
The separate conda installation of pytables, and it's potential mismatch with the pandas version has been causing some problems in the past (e.g. see recent issues and PRs #3111, #3162, #3163, #3171). Installing pytables from PyPI as dependency of pandas via the [hdf5] extra, would resolve these issues.

PR #3184 already addresses this issue by updating the pyproject.toml to the newest PEP standards, but untill that PR is merged, this could PR provide a bridging alternative. Also, the installation instructions with respect to the tables requirement need to be adjusted anyway, so this is addressed in the current PR.

Changes:

  • Update requirements.txt and setup.py: add hdf5 extra (pandas -> pandas[hdf5,performance]). This automatically installs the required tables dependency.
  • Update Readme, beginners guide, and installation: remove instructions to install tables separately.

NOTE: CircleCI is expected to fail on this PR, since the current workflow is set up to explicitly fail when the requirements.txt change with respect to the cached environment. I verified that the tests pass when I temporarily remove this caching restriction (succeeds👍).

I am keeping the CI workflow in the original state now. @MMathisLab Let me know in case you prefer me to remove the caching restriction for the future (see example in commit bc3ff85).

Copy link
Collaborator

@C-Achard C-Achard left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's try and get this merged & released ASAP; let me know if anything needs to be updated/released on the napari-DLC side as well and I will work on that @deruyter92

@C-Achard
Copy link
Collaborator

C-Achard commented Feb 26, 2026

Is the failing CI a drift due to the requirements.txt file ? This may need adjustment in #3184 as well

@deruyter92
Copy link
Collaborator Author

@C-Achard the failing CircleCI is a result of the caching setup in the workflow: by default it loads the cached environment, and compares it against the new requirements, failing if there is a mismatch.

I verified that removing the caching step from the CircleCI resolves the problem.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file Installation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

UserWarning: Pandas requires version '2.8.4'

2 participants