Skip to content

Add unit tests and CLAUDE.md #236

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add unit tests and CLAUDE.md #236

wants to merge 4 commits into from

Conversation

chicham
Copy link
Collaborator

@chicham chicham commented Mar 18, 2025

Summary

  • Add unit tests for previously uncovered modules to improve test coverage
  • Create CLAUDE.md with build/test commands and code style guidelines for agent use

Details

  • Added test files:
    • test_store.py for testing data storage classes (100% coverage)
    • test_latent_class_mnl.py for testing latent class models with convergence tests
    • test_assortment_optimizer.py for optimizer factory functions
  • Created CLAUDE.md with essential information for coding agents:
    • Build, test, and lint commands
    • Code style guidelines including import structure, formatting rules, and naming conventions
  • Focused on proper convergence testing for model classes

Test plan

  • Run pytest to verify all new tests pass
  • Check for increased code coverage with pytest --cov

🤖 Generated with Claude Code

chicham and others added 4 commits November 19, 2024 11:02
- Add tests for previously uncovered modules:
  - store.py (data storage classes)
  - latent_class_mnl.py (latent class model)
  - assortment_optimizer.py (optimizer factory)
- Create CLAUDE.md with build/test commands and code style guidelines
- Focus on convergence testing for model classes
- Improve code coverage

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>
@chicham chicham requested a review from VincentAuriau as a code owner March 18, 2025 14:31
Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hello @chicham, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

Summary of Changes

This pull request focuses on enhancing the testing and documentation of the choice-learn library. It introduces unit tests for previously uncovered modules, specifically store.py, latent_class_mnl.py, and assortment_optimizer.py, to improve test coverage and ensure the reliability of these components. Additionally, a CLAUDE.md file is created to provide essential information for coding agents, including build/test commands and code style guidelines. The pull request also includes updates to GitHub Actions workflows to use newer versions of actions.

Highlights

  • Unit Tests: Added comprehensive unit tests for store.py, latent_class_mnl.py, and assortment_optimizer.py to increase code coverage and ensure proper functionality. The tests for latent_class_mnl.py include convergence tests to verify model training stability.
  • Documentation: Created CLAUDE.md to provide coding standards, build, test, and linting commands, and other essential information for developers contributing to the project.
  • GitHub Actions Updates: Updated GitHub Actions workflows (publish.yaml, ci.yaml, deploy_docs.yaml) to use the latest versions of actions/checkout (v4) and actions/setup-python (v5).

Changelog

Click here to see the changelog
  • .github/actions/publish/action.yaml
    • Updated actions/checkout to v4.
    • Updated actions/setup-python to v5.
  • .github/workflows/ci.yaml
    • Updated actions/checkout to v4.
    • Updated actions/setup-python to v5.
  • .github/workflows/deploy_docs.yaml
    • Updated actions/checkout to v4.
    • Updated actions/setup-python to v5.
  • CLAUDE.md
    • Created CLAUDE.md with coding standards and commands for choice-learn.
    • Added build, test, and lint commands.
    • Included code style guidelines such as import structure, formatting rules, and naming conventions.
  • tests/unit_tests/data/test_store.py
    • Created test_store.py to test data storage classes.
    • Implemented tests for Store, FeaturesStore, and OneHotStore classes, covering initialization, data handling, and property access.
  • tests/unit_tests/models/test_latent_class_mnl.py
    • Created test_latent_class_mnl.py to test the LatentClassSimpleMNL model.
    • Added tests for model instantiation, dataset integration, convergence during training, and prediction functionality.
  • tests/unit_tests/toolbox/test_assortment_optimizer.py
    • Created test_assortment_optimizer.py to test assortment optimizer factory functions.
    • Implemented tests for MNLAssortmentOptimizer, LatentClassAssortmentOptimizer, and LatentClassPricingOptimizer classes, covering solver selection and instantiation.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in issue comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist is currently in preview and may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments to provide feedback.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.


Did you know?

The term 'one-hot encoding,' frequently used in machine learning and data storage, comes from digital circuit design, where it refers to a group of bits among which only one is 'hot' (set to 1) at any given time.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces unit tests for previously uncovered modules and creates a CLAUDE.md file with build/test commands and code style guidelines. The addition of unit tests significantly improves the robustness and reliability of the codebase. The CLAUDE.md file provides valuable guidance for developers, ensuring consistency and maintainability. Overall, this is a well-structured and valuable contribution.

Merge Readiness

The pull request is well-structured and addresses the need for increased test coverage and coding guidelines. The addition of unit tests and the CLAUDE.md file are valuable contributions to the project. I am unable to approve the pull request, and recommend that others review and approve this code before merging. There are no critical or high severity issues, and the changes can be merged after addressing the medium and low severity issues.


def test_latent_class_mnl_convergence(test_dataset):
"""Test that the LatentClassSimpleMNL model converges during training."""
tf.config.run_functions_eagerly(True)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It's generally good practice to disable eager execution only when necessary, as it can impact performance. Consider if it's possible to run these tests without disabling eager execution.


def test_latent_class_mnl_prediction(test_dataset):
"""Test that the LatentClassSimpleMNL model can make predictions."""
tf.config.run_functions_eagerly(True)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It's generally good practice to disable eager execution only when necessary, as it can impact performance. Consider if it's possible to run these tests without disabling eager execution.

Copy link
Contributor

Coverage

Coverage Report for Python 3.9
FileStmtsMissCoverMissing
choice_learn
   __init__.py20100% 
   tf_ops.py480100% 
choice_learn/basket_models
   __init__.py30100% 
   dataset.py117497%71–74
   preprocessing.py947817%43–45, 128–364
   shopper.py3582792%165, 194, 343, 363, 378, 381, 395, 684–688, 781–785, 883–887, 1218, 1297, 1335–1336, 1440–1441, 1517–1518
choice_learn/basket_models/utils
   __init__.py00100% 
   permutation.py22195%37
choice_learn/data
   __init__.py30100% 
   choice_dataset.py6473395%198, 250, 283, 421, 463–464, 589, 724, 738, 840, 842, 937, 957–961, 1140, 1159–1161, 1179–1181, 1209, 1214, 1223, 1240, 1281, 1293, 1307, 1346, 1361, 1366, 1395, 1408, 1443–1444
   indexer.py2392092%20, 31, 60–67, 219–230, 265, 291, 577
   storage.py161696%22, 33, 51, 56, 61, 71
   store.py72199%254
choice_learn/datasets
   __init__.py40100% 
   base.py393599%43–44, 154–155, 715
   expedia.py1028319%37–301
   tafeng.py490100% 
choice_learn/datasets/data
   __init__.py00100% 
choice_learn/models
   __init__.py14286%15–16
   base_model.py2541295%144, 186, 283, 302, 342, 349, 378, 397, 428–429, 438–439
   baseline_models.py490100% 
   conditional_logit.py2362191%46, 49, 51, 82, 85, 88–92, 95–99, 133, 298, 335, 392, 467–473, 598, 632, 739, 743
   halo_mnl.py124298%186, 374
   latent_class_base_model.py2863289%55–61, 273–279, 288, 325–330, 497–500, 605, 624, 665, 672, 701, 715, 720, 751–752, 774–775, 869–870, 974
   latent_class_mnl.py62690%257–261, 296
   learning_mnl.py67396%157, 182, 188
   nested_logit.py2911296%55, 77, 160, 269, 351, 484, 530, 600, 679, 848, 900, 904
   reslogit.py132695%285, 360, 369, 374, 382, 432
   rumnet.py236399%748–751, 982
   simple_mnl.py139696%167, 275, 347, 355, 357, 359
   tastenet.py94397%142, 180, 188
choice_learn/toolbox
   __init__.py00100% 
   assortment_optimizer.py27678%28–30, 93–95, 160–162
   gurobi_opt.py2362360%3–675
   or_tools_opt.py2301195%103, 107, 296–305, 315, 319, 607, 611
TOTAL479161987% 

Tests Skipped Failures Errors Time
198 0 💤 11 ❌ 0 🔥 4m 46s ⏱️

Copy link
Contributor

Coverage

Coverage Report for Python 3.11
FileStmtsMissCoverMissing
choice_learn
   __init__.py20100% 
   tf_ops.py480100% 
choice_learn/basket_models
   __init__.py30100% 
   dataset.py117497%71–74
   preprocessing.py947817%43–45, 128–364
   shopper.py3582792%165, 194, 343, 363, 378, 381, 395, 684–688, 781–785, 883–887, 1218, 1297, 1335–1336, 1440–1441, 1517–1518
choice_learn/basket_models/utils
   __init__.py00100% 
   permutation.py22195%37
choice_learn/data
   __init__.py30100% 
   choice_dataset.py6473395%198, 250, 283, 421, 463–464, 589, 724, 738, 840, 842, 937, 957–961, 1140, 1159–1161, 1179–1181, 1209, 1214, 1223, 1240, 1281, 1293, 1307, 1346, 1361, 1366, 1395, 1408, 1443–1444
   indexer.py2392092%20, 31, 60–67, 219–230, 265, 291, 577
   storage.py161696%22, 33, 51, 56, 61, 71
   store.py72199%254
choice_learn/datasets
   __init__.py40100% 
   base.py393499%39, 154–155, 715
   expedia.py1028319%37–301
   tafeng.py490100% 
choice_learn/datasets/data
   __init__.py00100% 
choice_learn/models
   __init__.py14286%15–16
   base_model.py2541295%144, 186, 283, 302, 342, 349, 378, 397, 428–429, 438–439
   baseline_models.py490100% 
   conditional_logit.py2362191%46, 49, 51, 82, 85, 88–92, 95–99, 133, 298, 335, 392, 467–473, 598, 632, 739, 743
   halo_mnl.py124298%186, 374
   latent_class_base_model.py2863289%55–61, 273–279, 288, 325–330, 497–500, 605, 624, 665, 672, 701, 715, 720, 751–752, 774–775, 869–870, 974
   latent_class_mnl.py62690%257–261, 296
   learning_mnl.py67396%157, 182, 188
   nested_logit.py2911296%55, 77, 160, 269, 351, 484, 530, 600, 679, 848, 900, 904
   reslogit.py132695%285, 360, 369, 374, 382, 432
   rumnet.py236399%748–751, 982
   simple_mnl.py139696%167, 275, 347, 355, 357, 359
   tastenet.py94397%142, 180, 188
choice_learn/toolbox
   __init__.py00100% 
   assortment_optimizer.py27678%28–30, 93–95, 160–162
   gurobi_opt.py2382380%3–675
   or_tools_opt.py2301195%103, 107, 296–305, 315, 319, 607, 611
TOTAL479362087% 

Tests Skipped Failures Errors Time
198 0 💤 11 ❌ 0 🔥 5m 4s ⏱️

Copy link
Contributor

Coverage

Coverage Report for Python 3.10
FileStmtsMissCoverMissing
choice_learn
   __init__.py20100% 
   tf_ops.py480100% 
choice_learn/basket_models
   __init__.py30100% 
   dataset.py117497%71–74
   preprocessing.py947817%43–45, 128–364
   shopper.py3582792%165, 194, 343, 363, 378, 381, 395, 684–688, 781–785, 883–887, 1218, 1297, 1335–1336, 1440–1441, 1517–1518
choice_learn/basket_models/utils
   __init__.py00100% 
   permutation.py22195%37
choice_learn/data
   __init__.py30100% 
   choice_dataset.py6473395%198, 250, 283, 421, 463–464, 589, 724, 738, 840, 842, 937, 957–961, 1140, 1159–1161, 1179–1181, 1209, 1214, 1223, 1240, 1281, 1293, 1307, 1346, 1361, 1366, 1395, 1408, 1443–1444
   indexer.py2392092%20, 31, 60–67, 219–230, 265, 291, 577
   storage.py161696%22, 33, 51, 56, 61, 71
   store.py72199%254
choice_learn/datasets
   __init__.py40100% 
   base.py393499%39, 154–155, 715
   expedia.py1028319%37–301
   tafeng.py490100% 
choice_learn/datasets/data
   __init__.py00100% 
choice_learn/models
   __init__.py14286%15–16
   base_model.py2541295%144, 186, 283, 302, 342, 349, 378, 397, 428–429, 438–439
   baseline_models.py490100% 
   conditional_logit.py2362191%46, 49, 51, 82, 85, 88–92, 95–99, 133, 298, 335, 392, 467–473, 598, 632, 739, 743
   halo_mnl.py124298%186, 374
   latent_class_base_model.py2863289%55–61, 273–279, 288, 325–330, 497–500, 605, 624, 665, 672, 701, 715, 720, 751–752, 774–775, 869–870, 974
   latent_class_mnl.py62690%257–261, 296
   learning_mnl.py67396%157, 182, 188
   nested_logit.py2911296%55, 77, 160, 269, 351, 484, 530, 600, 679, 848, 900, 904
   reslogit.py132695%285, 360, 369, 374, 382, 432
   rumnet.py236399%748–751, 982
   simple_mnl.py139696%167, 275, 347, 355, 357, 359
   tastenet.py94397%142, 180, 188
choice_learn/toolbox
   __init__.py00100% 
   assortment_optimizer.py27678%28–30, 93–95, 160–162
   gurobi_opt.py2382380%3–675
   or_tools_opt.py2301195%103, 107, 296–305, 315, 319, 607, 611
TOTAL479362087% 

Tests Skipped Failures Errors Time
198 0 💤 11 ❌ 0 🔥 5m 17s ⏱️

Copy link
Contributor

Coverage

Coverage Report for Python 3.12
FileStmtsMissCoverMissing
choice_learn
   __init__.py20100% 
   tf_ops.py480100% 
choice_learn/basket_models
   __init__.py30100% 
   dataset.py117497%71–74
   preprocessing.py947817%43–45, 128–364
   shopper.py3582792%165, 194, 343, 363, 378, 381, 395, 684–688, 781–785, 883–887, 1218, 1297, 1335–1336, 1440–1441, 1517–1518
choice_learn/basket_models/utils
   __init__.py00100% 
   permutation.py22195%37
choice_learn/data
   __init__.py30100% 
   choice_dataset.py6473395%198, 250, 283, 421, 463–464, 589, 724, 738, 840, 842, 937, 957–961, 1140, 1159–1161, 1179–1181, 1209, 1214, 1223, 1240, 1281, 1293, 1307, 1346, 1361, 1366, 1395, 1408, 1443–1444
   indexer.py2392092%20, 31, 60–67, 219–230, 265, 291, 577
   storage.py161696%22, 33, 51, 56, 61, 71
   store.py72199%254
choice_learn/datasets
   __init__.py40100% 
   base.py393499%39, 154–155, 715
   expedia.py1028319%37–301
   tafeng.py490100% 
choice_learn/datasets/data
   __init__.py00100% 
choice_learn/models
   __init__.py14286%15–16
   base_model.py2541295%144, 186, 283, 302, 342, 349, 378, 397, 428–429, 438–439
   baseline_models.py490100% 
   conditional_logit.py2362191%46, 49, 51, 82, 85, 88–92, 95–99, 133, 298, 335, 392, 467–473, 598, 632, 739, 743
   halo_mnl.py124298%186, 374
   latent_class_base_model.py2863289%55–61, 273–279, 288, 325–330, 497–500, 605, 624, 665, 672, 701, 715, 720, 751–752, 774–775, 869–870, 974
   latent_class_mnl.py62690%257–261, 296
   learning_mnl.py67396%157, 182, 188
   nested_logit.py2911296%55, 77, 160, 269, 351, 484, 530, 600, 679, 848, 900, 904
   reslogit.py132695%285, 360, 369, 374, 382, 432
   rumnet.py236399%748–751, 982
   simple_mnl.py139696%167, 275, 347, 355, 357, 359
   tastenet.py94397%142, 180, 188
choice_learn/toolbox
   __init__.py00100% 
   assortment_optimizer.py27678%28–30, 93–95, 160–162
   gurobi_opt.py2382380%3–675
   or_tools_opt.py2301195%103, 107, 296–305, 315, 319, 607, 611
TOTAL479362087% 

Tests Skipped Failures Errors Time
198 0 💤 11 ❌ 0 🔥 6m 2s ⏱️

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.

1 participant