-
Notifications
You must be signed in to change notification settings - Fork 26
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
Conversation
There was a problem hiding this 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
response_doc = doc_from_responses(responses) | ||
elements = split_method_params(params) | ||
_, _, _, query_params, _ = elements | ||
is_iterable = iterable_method(verb, query_params) |
There was a problem hiding this comment.
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!
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 |
I forgot to update the related test for the newest change to link the class and increase indentation. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM!
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.