feat: add streamed-list-objects endpoint

[evansims]

Description

This introduces support for OpenFGA's POST /stores/{store_id}/streamed-list-objects endpoint.

The pull request introduces:

• Adds a new streamed_list_objects() method to the SDK client, simplifying the handling of the streaming endpoint for developers.
• Adds a new stream() method to the async/sync REST clients, which supports handling of streaming/chunked HTTP network requests.
• Adds a new build_request() method to the async/sync REST clients to handle the request-building steps shared by the request() and stream() methods.
• Adds a new handle_response_exception() method to the async/sync REST clients to handle the HTTP response exception processing shared between the request() and stream() methods.
• Adds a new _accumulate_json_lines() private method to the async/sync REST clients to help collect and reassemble partially delivered packets from streaming/chunked HTTP network requests. This method is used by stream().
• Adds the OpenAPI-generated streamed_list_objects_response and stream_result_of_streamed_list_objects_response models.
• Adds a new /example/streamed-list-objects example app, demonstrating usage through both the asynchronous and synchronous clients.
• Adds a new section to the README to demonstrate usage.
• Adds the pytest-asyncio dependency to simplify working with async method tests.
• Adds the test/rest_test.py and test/sync/rest_test.py test suites to target all methods in the refactored classes. It includes tests for the new streaming APIs.

It changes:

• Updates the async/sync API clients to use the streamlined REST client APIs.
• Updates the async/sync API clients to support a _streaming parameter on appropriate methods, which helps direct the flow of
• Updates the async/sync OAuth2 clients to use the streamlined REST client APIs.
• Updates the request() method of the async/sync REST clients.
• Refactors the async/sync REST clients to improve type-hinting.
• Updates other test suites to accommodate the streamlined REST client APIs.

And removes:

• Removes the GET(), HEAD(), OPTIONS(), POST(), PUT(), PATCH(), and DELETE() helper methods from the async/sync REST clients, to streamline the class and reduce redundant code.

Usage Example:

Using the async client:

# from openfga_sdk import OpenFgaClient # from openfga_sdk.client.models import ClientListObjectsRequest # Initialize the fga_client # fga_client = OpenFgaClient(configuration) results = [] documents = ClientListObjectsRequest( type="document", relation="writer", user="user:81684243-9356-4421-8fbf-a4f8d36aa31b", ) async for response in fga_client.streamed_list_objects(request): results.append(response) # results = ["document:...", ...]

You can also review the new /example/streamed-list-objects/asynchronous.py (or synchronous.py) app for a more detailed usage demo.

References

This code is generated using the SDK Generator; the pull request, including these changes, can be reviewed at its repository here: openfga/sdk-generator#469

The relevant issue for tracking this feature can be found her: openfga/sdk-generator#76

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

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 54.79452% with 198 lines in your changes missing coverage. Please review.

Project coverage is 69.56%. Comparing base (1d93d1b) to head (9eeb5d0).
Report is 30 commits behind head on main.

Files with missing lines	Patch %	Lines
...stream_result_of_streamed_list_objects_response.py	34.92%	41 Missing ⚠️
...enfga_sdk/models/streamed_list_objects_response.py	32.72%	37 Missing ⚠️
openfga_sdk/api/open_fga_api.py	5.55%	34 Missing ⚠️
openfga_sdk/sync/open_fga_api.py	5.55%	34 Missing ⚠️
openfga_sdk/sync/rest.py	81.89%	21 Missing ⚠️
openfga_sdk/sync/client/client.py	18.18%	9 Missing ⚠️
openfga_sdk/client/client.py	20.00%	8 Missing ⚠️
openfga_sdk/rest.py	90.47%	8 Missing ⚠️
openfga_sdk/api_client.py	66.66%	2 Missing ⚠️
openfga_sdk/models/expand_request.py	77.77%	2 Missing ⚠️
... and 1 more

❌ Your project status has failed because the head coverage (69.56%) is below the target coverage (80.00%). You can increase the head coverage or adjust the target coverage.

Additional details and impacted files

@@ Coverage Diff @@ ## main #163 +/- ## ========================================== + Coverage 69.49% 69.56% +0.07%  ========================================== Files 133 135 +2 Lines 10554 10839 +285 ========================================== + Hits 7334 7540 +206  - Misses 3220 3299 +79 

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.