CASMCMS-9225: Create generic API client class #398
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR creates a generic API client class, built on top of the API endpoint classes from this PR. The
APIClient
is a subclass ofRequestsRetryManager
frombos.common.utils
, and that is a subclasss of theRequestsRetryManager
class from therequests-retry-session
Python package.Basically, the
RetrySessionManager
class can be used to turn any other class into a context manager that contains a requests session, one that is only initialized if it is used. And this request session (and its underlying HTTP adapter) will both be closed out automatically by the context manager.The
bos.common.utils
subclass just specified the default argument values that BOS uses for its requests sessions.The
APIClient
subclass includes a method (get_endpoint
) which will be used to retrieve endpoints for specific API endpoints. It initializes them on demand, and passes in its managed request session. When used as a context manager, it clears its record of the endpoints that it initialized (because the session they are using is also cleaned up when the context manager exits).This will be used as the building block for the API clients coming in the next PRs. Right now, this PR does not modify anything to use this client class.