Bug 24693 - GD is declared as an optional dependency but Koha dies without it
Summary: GD is declared as an optional dependency but Koha dies without it
Status: CLOSED FIXED
Alias: None
Product: Koha
Classification: Unclassified
Component: Architecture, internals, and plumbing (show other bugs)
Version: Main
Hardware: All All
: P5 - low normal
Assignee: Julian Maurice
QA Contact: Testopia
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2020-02-20 07:37 UTC by Julian Maurice
Modified: 2020-11-30 21:48 UTC (History)
3 users (show)

See Also:
Change sponsored?: ---
Patch complexity: ---
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:
20.05.00
Circulation function:


Attachments
Bug 24693: Move GD from recommends to requires in cpanfile (1.24 KB, patch)
2020-02-20 07:38 UTC, Julian Maurice
Details | Diff | Splinter Review
Bug 24693: Move GD from recommends to requires in cpanfile (1.38 KB, patch)
2020-02-23 23:00 UTC, Bernardo Gonzalez Kriegel
Details | Diff | Splinter Review
Bug 24693: Move GD from recommends to requires in cpanfile (1.45 KB, patch)
2020-02-24 12:44 UTC, Jonathan Druart
Details | Diff | Splinter Review

Note You need to log in before you can comment on or make changes to this bug.
Description Julian Maurice 2020-02-20 07:37:48 UTC

    
Comment 1 Julian Maurice 2020-02-20 07:38:18 UTC
Created attachment 99299 [details] [review]
Bug 24693: Move GD from recommends to requires in cpanfile

Without it, catalogue/detail.pl dies (and probably other scripts too)

Test plan:
1. Uninstall GD, reload starman
2. Go to catalogue/detail.pl. Confirm that it dies
3. Reinstall GD, reload starman
4. Go to catalogue/detail.pl. Confirm that it work normally
Comment 2 Bernardo Gonzalez Kriegel 2020-02-23 23:00:44 UTC
Created attachment 99475 [details] [review]
Bug 24693: Move GD from recommends to requires in cpanfile

Without it, catalogue/detail.pl dies (and probably other scripts too)

Test plan:
1. Uninstall GD, reload starman
2. Go to catalogue/detail.pl. Confirm that it dies
3. Reinstall GD, reload starman
4. Go to catalogue/detail.pl. Confirm that it work normally

Signed-off-by: Bernardo Gonzalez Kriegel <bgkriegel@gmail.com>
catalogue/detail.pl dies without GD.
Seems correct switch to require
No errors
Comment 3 Jonathan Druart 2020-02-24 11:38:36 UTC
It does not die for me, it dies if I enable LocalCoverImages, then try to upload an image.
Comment 4 Julian Maurice 2020-02-24 11:52:44 UTC
Maybe we should clarify what does *required* mean for us.

Personally I believe that every Perl module that we directly `use` or `require` without checking its presence should be flagged as required. Even if the require is behind a syspref check or something like that. Put more simply, if Koha dies because of a missing Perl module, that module is a required dependency.

Maybe later we can build something based on cpanfile's `feature` (https://metacpan.org/pod/distribution/Module-CPANfile/lib/cpanfile.pod#feature) to warn when an optional feature is enabled and the required modules for this feature are missing.
Comment 5 Martin Renvoize (ashimema) 2020-02-24 12:05:41 UTC
(In reply to Julian Maurice from comment #4)
> Maybe we should clarify what does *required* mean for us.
> 
> Personally I believe that every Perl module that we directly `use` or
> `require` without checking its presence should be flagged as required. Even
> if the require is behind a syspref check or something like that. Put more
> simply, if Koha dies because of a missing Perl module, that module is a
> required dependency.
> 
> Maybe later we can build something based on cpanfile's `feature`
> (https://metacpan.org/pod/distribution/Module-CPANfile/lib/cpanfile.
> pod#feature) to warn when an optional feature is enabled and the required
> modules for this feature are missing.

The whole 'feature' stuff from the cpanfile move came up earlier that I was expecting.. but I suspected it would raise it's head at some point.

I'm really not sure what way to fall on this one.. I don't like that changing a syspref can completely 'break', i.e lead to a die, koha.. but at the same time if a set of functionality is optional, the dependencies it requires really aught to be too.
Comment 6 Jonathan Druart 2020-02-24 12:43:43 UTC
(In reply to Jonathan Druart from comment #3)
> It does not die for me, it dies if I enable LocalCoverImages, then try to
> upload an image.

That was wrong, I removed libgd-perl, that removed koha-common. The alias restart_all got broken, as it did not correctly restart plack, etc.

So yes, detail.pl crashes with GD.
Comment 7 Jonathan Druart 2020-02-24 12:44:59 UTC
Created attachment 99510 [details] [review]
Bug 24693: Move GD from recommends to requires in cpanfile

Without it, catalogue/detail.pl dies (and probably other scripts too)

Test plan:
1. Uninstall GD, reload starman
2. Go to catalogue/detail.pl. Confirm that it dies
3. Reinstall GD, reload starman
4. Go to catalogue/detail.pl. Confirm that it work normally

Signed-off-by: Bernardo Gonzalez Kriegel <bgkriegel@gmail.com>
catalogue/detail.pl dies without GD.
Seems correct switch to require
No errors

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
Comment 8 Jonathan Druart 2020-02-24 12:45:43 UTC
We will make it (really) optional if there is a real need for that.
Comment 9 Martin Renvoize (ashimema) 2020-02-24 13:22:16 UTC
Nice work everyone!

Pushed to master for 20.05
Comment 10 Joy Nelson 2020-03-31 22:01:18 UTC
Does not apply to 19.11.x branch.  Not backported