Miscellaneous improvements for 2024-W14

[khaeru]

• Migrate handing code for 4 sources of exogenous data from message_data.
  • Global Energy Assessment project.
  • Add fuzzed data for testing.
  • Global Fuel Economy Initiative.
  • Add fuzzed data for testing.
  • IEA Energy Efficiency Indicators.
  • For this source, no fuzzed data are added for testing. This is because the source uses a complicated, idiosyncratic file format. Duplicating this format is out of scope for the current PR. The lines are thus excluded from test coverage.
  • For the 2023-11 edition of these data, the IEA website at https://www.iea.org/data-and-statistics/data-product/energy-efficiency-indicators provides a "Demo and availability file", which we could use for testing purposes.
  • → #164
  • SHAPE project.
  • Add fuzzed data for testing.
• Improve docs of all of the above.
• Add path_fallback(), generalized from a utility function used in message_data/MESSAGEix-Transport.

Housekeeping:

• Adjust MANIFEST.in after #159.
• Remove snapshot files also available from Zenodo; these were committed in #159.
• Use nschloe/action-cached-lfs-checkout to reduce Git LFS bandwidth usage.
  • As we accumulate more Git LFS files (particularly, test data) in this repo, we are consuming the 300 GB monthly quota more and more quickly. One reason is that we currently run 18 jobs (6 upstream versions × 3 OSes), so even 100 MB of Git LFS files means a 1.8 GB hit towards that quota
  • This added, third-party action seems to be a response to others encountering the same issue. It appears the most developed, but is not 100% up to date; see some pending PRs https://github.com/nschloe/action-cached-lfs-checkout/pulls
  • We could mitigate by creating a fork or using someone else's.
• Configure Codecov to allow coverage to drop by 0.5% > 0.46% = 90 lines. This drop will (currently) always appear on PRs, because the snapshot and legacy reporting tests are only run on the main branch and a schedule trigger.
• Tidy a lot of nitpicks in docs.

How to review

Read the diff and note that the CI checks all pass.

PR checklist

• [x] Continuous integration checks all ✅
• [x] Add or expand tests; coverage checks both ✅
• [x] Add, expand, or update documentation.
• [x] Update doc/whatsnew.

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 99.61832% with 1 lines in your changes are missing coverage. Please review.

Project coverage is 75.5%. Comparing base (ad7d356) to head (7dc5385).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## main #162 +/- ## ======================================= - Coverage 76.0% 75.5% -0.5% ======================================= Files 94 101 +7 Lines 6428 6675 +247 ======================================= + Hits 4890 5046 +156 - Misses 1538 1629 +91 ``` | [Files](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?dropdown=coverage&src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa) | Coverage Δ | | |---|---|---| | [message\_ix\_models/model/bare.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Fbare.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvYmFyZS5weQ==) | `100.0% <ø> (ø)` | | | [message\_ix\_models/model/build.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Fbuild.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvYnVpbGQucHk=) | `100.0% <ø> (ø)` | | | [message\_ix\_models/model/disutility.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Fdisutility.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvZGlzdXRpbGl0eS5weQ==) | `100.0% <ø> (ø)` | | | [message\_ix\_models/model/emissions.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Femissions.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvZW1pc3Npb25zLnB5) | `98.0% <ø> (ø)` | | | [message\_ix\_models/model/macro.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Fmacro.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvbWFjcm8ucHk=) | `100.0% <ø> (ø)` | | | [message\_ix\_models/model/structure.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fmodel%2Fstructure.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvbW9kZWwvc3RydWN0dXJlLnB5) | `100.0% <ø> (ø)` | | | [message\_ix\_models/project/shape/data.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Fproject%2Fshape%2Fdata.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvcHJvamVjdC9zaGFwZS9kYXRhLnB5) | `100.0% <100.0%> (ø)` | | | [message\_ix\_models/report/\_\_init\_\_.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Freport%2F__init__.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvcmVwb3J0L19faW5pdF9fLnB5) | `97.4% <100.0%> (+<0.1%)` | :arrow_up: | | [message\_ix\_models/report/compat.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Freport%2Fcompat.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvcmVwb3J0L2NvbXBhdC5weQ==) | `99.2% <ø> (ø)` | | | [message\_ix\_models/report/config.py](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree&filepath=message_ix_models%2Freport%2Fconfig.py&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa#diff-bWVzc2FnZV9peF9tb2RlbHMvcmVwb3J0L2NvbmZpZy5weQ==) | `100.0% <ø> (ø)` | | | ... and [31 more](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa) | | ... and [4 files with indirect coverage changes](https://app.codecov.io/gh/iiasa/message-ix-models/pull/162/indirect-changes?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=iiasa)