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

[CIVIS-1614] DOC specify response type in Returns documentation. #438

Merged
merged 3 commits into from
Dec 1, 2021

Conversation

gkcivis
Copy link
Contributor

@gkcivis gkcivis commented Nov 30, 2021

Ticket: https://civisanalytics.atlassian.net/browse/CIVIS-1614

These changes are to specify the civis response type (regular vs paginated) in https://civis-python.readthedocs.io/en/v1.15.1/api_resources.html

TODO: update CHANGELOG, if this implementation is good.

Copy link
Member

@jacksonlee-civis jacksonlee-civis left a comment

Choose a reason for hiding this comment

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

This is great! I've left in-line comments about Sphinx formatting.

Reminders:

  • changelog entry needed (I also see you have this one in the PR description)
  • add "DOC" to the PR title; see other merged commits/PRs for examples

civis/resources/_resources.py Outdated Show resolved Hide resolved
civis/resources/_resources.py Outdated Show resolved Hide resolved
response_doc = doc_from_responses(responses)
elements = split_method_params(params)
_, _, _, query_params, _ = elements
is_iterable = iterable_method(verb, query_params)
Copy link
Member

Choose a reason for hiding this comment

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

So glad that the codebase already has this handy iterable_method function!

@jacksonlee-civis jacksonlee-civis added this to the v1.16.0 milestone Dec 1, 2021
@gkcivis gkcivis changed the title [CIVIS-1614] specify response type in Returns documentation. [CIVIS-1614] DOC specify response type in Returns documentation. Dec 1, 2021
@gkcivis
Copy link
Contributor Author

gkcivis commented Dec 1, 2021

Added change to CHANGELOG.md; made Jackson's recommended changes to add link to response class and indenting response attributes by one level. Converting to formal PR

@gkcivis gkcivis marked this pull request as ready for review December 1, 2021 14:31
@gkcivis
Copy link
Contributor Author

gkcivis commented Dec 1, 2021

I forgot to update the related test for the newest change to link the class and increase indentation.

Copy link
Member

@jacksonlee-civis jacksonlee-civis left a comment

Choose a reason for hiding this comment

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

LGTM!

@gkcivis gkcivis merged commit 2acdccc into master Dec 1, 2021
@gkcivis gkcivis deleted the update-returns-docs branch December 1, 2021 16:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants