Add utility to fetch and prepare ZIM illustration ; make this utility directly accessible from illustration metadata

[benoit74]

Fix #254

Nota : code has been adapted from libretexts/warc2zim version to also optimize the image, hence fixing the issue found recently (openzim/warc2zim#448)

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 100.00%. Comparing base (fef63f8) to head (dab6ba2).
Report is 3 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #260   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           39        40    +1     
  Lines         2455      2484   +29     
  Branches       331       335    +4     
=========================================
+ Hits          2455      2484   +29     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[benoit74]

Rebased on main for simplicity of review

[rgaudin]

Thank you it's great.

I would have preferred not to extend the Illustration Metadata constructor. That seems unnecessary and it shifts the (unwritten) spirit of that API towards a more logic-intensive approach than I expected it to be.

I like that it's designed to receive proper values with safety-net-like checks that prevents breaking our convention. Sending inappropriate data and store a transformed version feels off to me.

Parsing, downloading, converting, optimizing, it's a lot. I expect shit to happen and I find cleaner to do that as a separate step then put the successful result into the metadata.

Let me know what you think