Skip to content
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

Clarify __init__ params for decorator multi_cached #637

Merged

Conversation

padraic-shafer
Copy link
Contributor

Clarify __init__ params for decorator multi_cached

Docstring for multi_cached clarifies the use of

  • keys_from_attr,
  • key_builder,
  • their interaction, and
  • the expected mapping scheme of the dictionary returned by the decorated callable

Are there changes in behavior for the user?

No, this is an update to documentation only.

Related issue number

Checklist

  • [X ] I think the code is well written
  • [ N/A] Unit tests for the changes exist
  • [ X] Documentation reflects the changes
  • [X ] Add a new news fragment into the CHANGES folder
    • name it <issue_id>.<type> (e.g. 588.bugfix)
    • if you don't have an issue_id change it to the pr id after creating the PR
    • ensure type is one of the following:
      • .feature: Signifying a new feature.
      • .bugfix: Signifying a bug fix.
      • .doc: Signifying a documentation improvement.
      • .removal: Signifying a deprecation or removal of public API.
      • .misc: A ticket has been closed, but it is not of interest to users.
    • Make sure to use full sentences with correct case and punctuation, for example: Fix issue with non-ascii contents in doctest text files.

padraic-shafer and others added 2 commits January 10, 2023 16:36
Docstring for `multi_cached` clarifies the use of
* `keys_from_attr`,
* `key_builder`,
* their interaction, and
* the expected mapping scheme of the dictionary returned by the decorated callable
@padraic-shafer
Copy link
Contributor Author

Hopefully this is not too late for 0.12. Otherwise it's for the next release.

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.

Clarify documentation of keys_from_attr and key_builder parameters for initializing multi_cached decorator
2 participants