Skip to content

docs: include retry information in the readme for SDKs#333

Merged
rhamzeh merged 9 commits intomainfrom
chore/document-retries
Apr 4, 2024
Merged

docs: include retry information in the readme for SDKs#333
rhamzeh merged 9 commits intomainfrom
chore/document-retries

Conversation

@ewanharris
Copy link
Member

@ewanharris ewanharris commented Mar 27, 2024

Description

Adds a process for documenting the retry strategy of each SDK in the readme following the other SDK specific readme pieces by introducing a README_retries.mustache file that will be rendered into the readme.

  • 8db7d1a - Introduces retry handling on the oauth2 client for dotnet, this is exercised by the test added in api client.
  • b33b16d - Introduces retry handling on the oauth2 client for java, this is verified manually as unfortunately the features of the HTTP mocking library there are limited. It can only register one response per URL and I can’t workaround this using the doAction feature (e.g track number of requests and change response depending on request count), because any request after the first fails for reason my limited Java knowledge can’t debug. From what I can tell it's only built to handle one request per URL.

Given that last one, I'm putting this into draft to prevent any merge.

References

#320

Review Checklist

  • I have clicked on "allow edits by maintainers".
  • I have added documentation for new/changed functionality in this PR or in a PR to openfga.dev [Provide a link to any relevant PRs in the references section above]
  • The correct base branch is being used, if not main
  • I have added tests to validate that the change in functionality is working as expected

@ewanharris ewanharris requested a review from a team as a code owner March 27, 2024 18:07
@ewanharris ewanharris force-pushed the chore/document-retries branch 2 times, most recently from 094aaa1 to 414ba17 Compare March 27, 2024 18:08
@ewanharris
Copy link
Member Author

Heh, I guess this would need to be conditionally rendered in the readme of SDKs that aren't yet compliant with retries

@ewanharris ewanharris force-pushed the chore/document-retries branch from 414ba17 to d885627 Compare March 28, 2024 18:15
@ewanharris ewanharris force-pushed the chore/document-retries branch from d885627 to b948b03 Compare March 28, 2024 18:30
@ewanharris ewanharris force-pushed the chore/document-retries branch from b948b03 to e07ce50 Compare March 28, 2024 18:37
@ewanharris ewanharris marked this pull request as draft March 28, 2024 18:46
@evansims
Copy link
Contributor

evansims commented Apr 2, 2024

👋 I've added config/clients/python/template/README_retries.mustache to the PR to cover the retry support merged with a175fb2 earlier today.

I realize the wording is quite different, but I thought I'd propose an alternative approach. I'll be happy to update it if the other approach is preferred, of course. 😄

@ewanharris
Copy link
Member Author

@evansims that sounds much better thank you! I'll apply the edits to the other SDKs tomorrow alongside the changes to source the values from the config!

@ewanharris ewanharris requested review from evansims and rhamzeh April 3, 2024 19:34
@ewanharris ewanharris marked this pull request as ready for review April 3, 2024 19:34
@ewanharris ewanharris changed the title chore: setup basis for including retry information in the readme for SDKs docs: include retry information in the readme for SDKs Apr 3, 2024
github-merge-queue bot pushed a commit to openfga/dotnet-sdk that referenced this pull request Apr 3, 2024
## Description

Adds retries onto the client credential request.

## References

Generated from openfga/sdk-generator/pull/333

Closes #24

## Review Checklist
- [x] I have clicked on ["allow edits by
maintainers"](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork).
- [] I have added documentation for new/changed functionality in this PR
or in a PR to [openfga.dev](https://github.com/openfga/openfga.dev)
[Provide a link to any relevant PRs in the references section above]
- [x] The correct base branch is being used, if not `main`
- [ ] I have added tests to validate that the change in functionality is
working as expected
@rhamzeh rhamzeh added this pull request to the merge queue Apr 4, 2024
Merged via the queue into main with commit 8e912be Apr 4, 2024
@rhamzeh rhamzeh deleted the chore/document-retries branch April 4, 2024 15:38
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.

3 participants

Comments