Annotate cat_list()

[glatterf42]

This PR comes from me wanting to showcase a small, completely typed function in the UBA presentation on Tuesday as an example for how to use docstrings. I didn't want to spend too much time looking, cat_list() seems fine, but is missing some annotations. This PR provides them.

How to review

No need to merge this (quickly), I'm mainly interested in the docs built from this PR. But of course, this is a small improvement we can bring in anytime :)

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

PR checklist

• Continuous integration checks all ✅
• [ ] Add or expand tests; coverage checks both ✅ Just adding annotations.
• Add, expand, or update documentation.
• [ ] Update release notes. Just adding annotations.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 95.6%. Comparing base (ab9b707) to head (ab60564).
Report is 52 commits behind head on main.

Additional details and impacted files

@@          Coverage Diff          @@
##            main    #896   +/-   ##
=====================================
  Coverage   95.6%   95.6%           
=====================================
  Files         46      46           
  Lines       4338    4338           
=====================================
  Hits        4148    4148           
  Misses       190     190           

Files with missing lines	Coverage Δ
message_ix/core.py	97.7% <100.0%> (ø)

[khaeru]

Should we now merge this?

[glatterf42]

Good to merge anytime :)

[khaeru]

The stalled check "Code scanning results / CodeQL" seems to be spurious, due to some change in GitHub's behaviour. I'll ignore it and merge.