Skip to content
This repository was archived by the owner on Dec 1, 2025. It is now read-only.

admin/remove-bioformats-extra#329

Merged
evamaxfield merged 3 commits into
mainfrom
unknown repository
Oct 8, 2021
Merged

admin/remove-bioformats-extra#329
evamaxfield merged 3 commits into
mainfrom
unknown repository

Conversation

@tlambert03

Copy link
Copy Markdown
Collaborator

Description

As per request from the OME team, this removes the [bioformats] extra and instructs users to install it manually with pip install bioformats_jar. cc @chris-allan, @joshmoore, @sbesson, @jrswedlow ... let us know if this is what you had in mind.

Pull request recommendations:

  • Name your pull request your-development-type/short-description. Ex: feature/read-tiff-files
  • Link to any relevant issue in the PR description. Ex: Resolves [Fix release #12], adds tiff file format support
  • Provide relevant tests for your feature or bug fix.
  • Provide or update documentation for any feature added by your pull request.

@codecov-commenter

codecov-commenter commented Oct 6, 2021

Copy link
Copy Markdown

Codecov Report

Merging #329 (e98a96f) into main (2bd5e38) will decrease coverage by 0.16%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #329      +/-   ##
==========================================
- Coverage   94.46%   94.30%   -0.17%     
==========================================
  Files          40       40              
  Lines        3018     3018              
==========================================
- Hits         2851     2846       -5     
- Misses        167      172       +5     
Impacted Files Coverage Δ
aicsimageio/readers/bioformats_reader.py 82.52% <ø> (ø)
aicsimageio/tests/conftest.py 92.30% <0.00%> (-3.85%) ⬇️
aicsimageio/tests/readers/test_czi_reader.py 96.29% <0.00%> (-3.71%) ⬇️
aicsimageio/readers/ome_tiff_reader.py 98.13% <0.00%> (-0.94%) ⬇️
aicsimageio/readers/czi_reader.py 95.43% <0.00%> (-0.36%) ⬇️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2bd5e38...e98a96f. Read the comment docs.

@evamaxfield evamaxfield left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Works for me. @toloudis we should make these changes to CZI + LIF as well unfortunately.

@toloudis

toloudis commented Oct 6, 2021

Copy link
Copy Markdown
Collaborator

Works for me. @toloudis we should make these changes to CZI + LIF as well unfortunately.

That would be fine. I still don't know what to do with the license/docs for aicspylibczi :)

@evamaxfield

Copy link
Copy Markdown
Collaborator

Going to wait for approval from one of @chris-allan, @joshmoore, @sbesson, @jrswedlow before merge.

@AetherUnbound AetherUnbound left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Dang, this is unfortunate but it's solid that we're respecting the licenses appropriately.

Comment thread setup.py
"lif": ["readlif>=0.6.4"],
"czi": ["aicspylibczi>=3.0.2"],
"bioformats": ["bioformats_jar", "wrapt>=1.12"],
# "bioformats": ["bioformats_jar"], # excluded for licensing reasons

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

I like the idea of leaving a note in here for future contributors (in addition to the other docs), but I'm not sure it needs to keep this form. Does this work?

Suggested change
# "bioformats": ["bioformats_jar"], # excluded for licensing reasons
# bioformats_jar ("bioformats") excluded for licensing reasons

@sbesson sbesson left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Many thanks @tlambert03 for opening this PR on this complex question.

I had forgotten to mention it in the initial PR but the closest scenario of the Bio-Formats side is the GNU Octave package where the wrappers are released under a BSD 2-clause license but the usage requires the separate installation of bioformats_package.jar - see the corresponding installation instructions.

From my side, the set of changes here align well with the scenario above and provide a good compromise between maintaining Bio-Formats support in aicsimageio and reducing the ambiguity and the risks associated with the extra_requirements usage. Users can still choose to install an aicsimagio-compatible Bio-Formats bindings in their environment using an user-friendly pip based workflow so the overhead is fairly minimal compared to the previous solution. On the other side, the requirement for the explicit installation of a third-party package is clarified both at the code and documentation level so that downstream consumers are aware of the licensing implications.

@tlambert03

Copy link
Copy Markdown
Collaborator Author

Going to wait for approval from one of @chris-allan, @joshmoore, @sbesson, @jrswedlow before merge.

lets additionally please wait for approval from @jrswedlow and @chris-allan

@evamaxfield

Copy link
Copy Markdown
Collaborator

Going to wait for approval from one of @chris-allan, @joshmoore, @sbesson, @jrswedlow before merge.

lets additionally please wait for approval from @jrswedlow and @chris-allan

Agree. Want to be thorough here.

@chris-allan

Copy link
Copy Markdown

Thanks for all the hard work and care all. Changes look great to me.

@jrswedlow

Copy link
Copy Markdown

Thumbs up from my side. Thanks much to the whole team for the work and consideration.

@evamaxfield evamaxfield merged commit 459e469 into AllenCellModeling:main Oct 8, 2021
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants