Skip to content

Catalog infrastructure updates#767

Draft
edwardchalstrey1 wants to merge 102 commits intomasterfrom
catalog/758
Draft

Catalog infrastructure updates#767
edwardchalstrey1 wants to merge 102 commits intomasterfrom
catalog/758

Conversation

@edwardchalstrey1
Copy link
Member

@edwardchalstrey1 edwardchalstrey1 commented Feb 13, 2026

Issues closed by this PR

Closes #758
Closes #759
Closes #761

Description of the changes in this PR

This PR adds

  • The option to generate games for the catalog from code via game family functions (and add as many variants as you want)
  • The ability to filter the catalog search on attributes of Game objects
  • Adds to the documentation: pygambit API reference for catalog functions
  • Updates the Catalog page to include descriptions and download links (and hides the old "Samples" page, but this isn't removed completely)
  • Also updates the games in the catalog so far to correctly link to the Bibliography

How to review this PR

  • Check whether adding to families.py works as a way for adding games to the catalog. Review the change to the contributor doc which explains how to do this.
  • Review the updates to the games() function which allow filtering on attributes of Game objects
  • Review the updates to the Catalog docs page

Help me answer these questions:

  1. I have added one_shot_trust as an example game family in this PR, simply to demonstrate the functionality. Is there a better example we definitely want included in the catalog?
  2. I think I will open a new issue after closing [Catalog] Search feature #759 to add the ability to filter based on metadata not associated with a Game object, to be looked at once the catalog is larger, if at all. Do you agree with this/ do we need it at all? If so, what is an example of a filter that would be useful when searching the catalog?

@edwardchalstrey1 edwardchalstrey1 changed the title [WIP] Add ability to have coded game families and filter by metadata [WIP] Add ability to have coded game families and filter by Game metadata Mar 2, 2026
@edwardchalstrey1 edwardchalstrey1 changed the title [WIP] Add ability to have coded game families and filter by Game metadata Add ability to have coded game families and filter by Game metadata Mar 2, 2026
@edwardchalstrey1 edwardchalstrey1 marked this pull request as ready for review March 2, 2026 14:56
@tturocy
Copy link
Member

tturocy commented Mar 3, 2026

@rahulsavani @edwardchalstrey1 are we thinking of this as something for 16.6 or more for 16.7 once we let the catalog settle a bit and get it populated more? (And also because we've got a backlog on 16.6 to deal with so at least for my part I'm a bit limited in mindspace as to how we might want to commit to some of these design decisions.)

@edwardchalstrey1
Copy link
Member Author

@rahulsavani @edwardchalstrey1 are we thinking of this as something for 16.6 or more for 16.7 once we let the catalog settle a bit and get it populated more? (And also because we've got a backlog on 16.6 to deal with so at least for my part I'm a bit limited in mindspace as to how we might want to commit to some of these design decisions.)

@tturocy Fine with me, I'll move this back to draft for now

@edwardchalstrey1 edwardchalstrey1 marked this pull request as draft March 4, 2026 09:40
@edwardchalstrey1 edwardchalstrey1 mentioned this pull request Mar 11, 2026
* add failing test for games(include_descriptions=True) which gets used in update script

* Add description field to df when selected

* refactor to reduce code duplication

* correctly show descriptions on catalog page

* Add biblio links to all games in catalog

* fix biblio links

* update table row spacing

* hide samples page

* Add download links

* generate rst table instead of CSV for Catalog of games page

* Refactor table such that descriptions are nested under titles
@edwardchalstrey1 edwardchalstrey1 changed the title Add ability to have coded game families and filter by Game metadata Catalog infrastructure updates Mar 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Catalog, Documentation]: Improvements to Catalog of games docs page [Catalog] Search feature [Catalog] Autogenerate game families

2 participants