feat(enrichr): retrieve gene sets incl. MSigDB collections (#139)

[Elarwei001]

Resolves #139

What this adds

gget enrichr can now fetch the gene sets behind an Enrichr library — so users can pull MSigDB collections (Hallmark, Oncogenic, Computational, …) directly, not just run enrichment.

• enrichr_library(name) — member genes of any library (e.g. MSigDB_Hallmark_2020) as a long-format gene_set/gene data frame. gene_set= returns a single set; descriptions=True adds each set's description. CLI: --get_library/-gl, --gene_set, --descriptions/-desc.
• enrichr_libraries(species="human", filter=None) — list the available libraries (name, term count, gene coverage) to discover what can be fetched. CLI: --list_libraries/-ll.

Existing enrichment behaviour is unchanged.

Testing

Extended tests/test_enrichr.py with offline tests (mocked library parsing, descriptions, and listing) plus live tests that skip on transient upstream errors. Docs updated (en + es).

[codecov-commenter]

Codecov Report

❌ Patch coverage is 96.15385% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 57.26%. Comparing base (e43a804) to head (72aa2ed).
⚠️ Report is 2 commits behind head on dev.

Files with missing lines	Patch %	Lines
gget/gget_enrichr.py	95.89%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##              dev     #241      +/-   ##
==========================================
+ Coverage   56.70%   57.26%   +0.55%     
==========================================
  Files          29       29              
  Lines        9392     9469      +77     
==========================================
+ Hits         5326     5422      +96     
+ Misses       4066     4047      -19     

☔ View full report in Codecov by Harness.
📢 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.

[Elarwei001]

Hi @lauraluebbert — quick summary of #241 (resolves #139):

1. Fetch a library's gene sets. enrichr_library(name) returns the member genes of any Enrichr library (e.g. MSigDB_Hallmark_2020) as a long-format gene_set/gene data frame; gene_set= narrows to a single set and descriptions=True adds each set's description. CLI: --get_library/-gl, --gene_set, --descriptions/-desc.

2. Discover libraries. enrichr_libraries(filter="MSigDB") lists the available libraries (name, term count, gene coverage) so users can find the exact name to pass. CLI: --list_libraries/-ll. species="mouse" maps to the human/Enrichr variant, matching enrichr and enrichr_library.

3. Enrichment CLI unchanged. --get_library/--list_libraries don't take genes/database, so I moved those required-checks from argparse into the handler (the new modes return before reaching them). Running enrichment without genes or -db still raises the same error.

4. Docs + citations. en/es docs updated, and MSigDB references (Subramanian 2005; Liberzon 2011/2015; Castanza 2023 for mouse) added to the References section, per the per-source citation convention.

btw, tests are network-free where possible; the live ones skipTest (not fail) on transient Enrichr/Ensembl errors, while still asserting real errors like bad library names.

Happy to change anything — would appreciate a review when you have a moment. Thanks!