Skip to content

Account for object default values when annotating models #1042

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 2 commits into
base: develop
Choose a base branch
from

Conversation

mochetts
Copy link

@mochetts mochetts commented May 7, 2025

Fix Default Value Handling for Objects with to_s Method

This PR updates the quote method in annotate_models.rb to properly handle default values that are objects implementing the to_s method. This change improves the annotation behavior when dealing with complex default values in model attributes.

Changes:

  • Updated the quote method to properly handle object default values
  • Added tests to verify the new behavior

Previous behavior:

  • Objects with to_s implementation weren't properly quoted in annotations

New behavior:

  • Objects with to_s implementation are now properly quoted in the annotations

This change ensures more accurate model annotations when dealing with complex default values.

With this change we can effectively annotate object defaults. This is an example with the woking fix in one of our repos:

Screenshot 2025-05-07 at 9 04 59 AM

mochetts added 2 commits May 7, 2025 08:47
Update quote method to account for default values that are objects that implement the `to_s` method
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 @mochetts, 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 addresses an issue in the annotate_models.rb file where default values that are objects implementing the to_s method were not being properly quoted in model annotations. The changes modify the quote method to handle these object default values correctly by calling to_s and wrapping the result in quotes. A new test case has been added to annotate_models_spec.rb to verify the updated behavior.

Highlights

  • Bug Fix: Corrects the handling of object default values with to_s method in model annotations.
  • Code Enhancement: Updates the quote method in annotate_models.rb to properly quote object default values.
  • Test Coverage: Adds a new test case to annotate_models_spec.rb to ensure the correct behavior of the quote method with object default values.

Changelog

  • lib/annotate/annotate_models.rb
    • Modified the quote method to handle object default values that implement the to_s method. Specifically, line 110 was changed to use value.to_s.inspect when value responds to to_s.
  • spec/lib/annotate/annotate_models_spec.rb
    • Added a new test context to verify the behavior of the quote method when the argument is an object that responds to to_s. This includes defining a mock object with a custom to_s method and asserting that the quote method returns the result of to_s wrapped in quotes (lines 156-168).
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.


A string's representation,
Can cause annotation,
To be quite a fright,
But to_s brings the light,
And quotes make it right.

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

The pull request addresses an important issue of properly handling object default values when annotating models. The changes are well-structured and include a test case to verify the fix. Overall, this is a valuable contribution to the project.

Merge Readiness

The code changes appear to be correct and include a test case. I recommend merging this pull request after addressing the review comments. I am unable to directly approve the pull request, and users should have others review and approve this code before merging.

@@ -107,7 +107,7 @@ def quote(value)
when BigDecimal then value.to_s('F')
when Array then value.map { |v| quote(v) }
else
value.inspect
value.respond_to?(:to_s) ? value.to_s.inspect : value.inspect

Choose a reason for hiding this comment

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

medium

This change looks good and correctly addresses the issue. However, consider adding a comment to explain why to_s.inspect is used instead of just inspect. This would help future developers understand the intent behind this specific implementation.

For example, you could add a comment like:

# Use to_s.inspect to ensure objects with custom string representations are properly quoted
        value.respond_to?(:to_s) ? value.to_s.inspect : value.inspect # Ensure objects with custom string representations are properly quoted

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