release: v0.4.2

Author: evansims

CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## v0.4.2
+
+### [0.4.2](https://github.com/openfga/python-sdk/compare/v0.4.1...v0.4.2) (2024-04-04)
+
+- feat: support for modular models metadata
+- feat: support auto-retry of failed network requests
+- refactor: remove Python 2 code
+- fix: limit the number of network retries
+- fix: Configuration class `api_scheme`, `min_wait_in_ms` and `disabled_client_side_validations` validation issues
+- chore: update aiohttp to 3.9.2
+- chore: update black to 24.3.0
+
 ## v0.4.1
 
 ### [0.4.1](https://github.com/openfga/python-sdk/compare/v0.4.0...v0.4.1) (2024-02-13)

README.md

@@ -41,6 +41,7 @@ This is an autogenerated python SDK for OpenFGA. It provides a wrapper around th
     - [Assertions](#assertions)
       - [Read Assertions](#read-assertions)
       - [Write Assertions](#write-assertions)
+  - [Retries](#retries)
   - [API Endpoints](#api-endpoints)
   - [Models](#models)
 - [Contributing](#contributing)
@@ -956,6 +957,32 @@ response = await fga_client.write_assertions(body, options)
 ```
 
 
+### Retries
+
+If a network request fails with a 429 or 5xx error from the server, the SDK will automatically retry the request up to 15 times with a minimum wait time of 100 milliseconds between each attempt.
+
+To customize this behavior, create a `RetryParams` object and assign values to the `max_retry` and `min_wait_in_ms` constructor parameters. `max_retry` determines the maximum number of retries (up to 15), while `min_wait_in_ms` sets the minimum wait time between retries in milliseconds.
+
+Apply your custom retry values by passing the object to the `ClientConfiguration` constructor's `retry_params` parameter.
+
+```python
+from openfga_sdk import ClientConfiguration, OpenFgaClient
+from openfga_sdk.configuration import RetryParams
+from os import environ
+
+async def main():
+    # Configure the client with custom retry settings
+    config = ClientConfiguration(
+        api_url=environ.get("FGA_API_URL"),
+        retry_params=RetryParams(max_retry=3, min_wait_in_ms=250)
+    )
+
+    # Create a client instance and read authorization models
+    async with OpenFgaClient(config) as client:
+        return await client.read_authorization_models()
+```
+
+
 ### API Endpoints
 
 Class | Method | HTTP request | Description

VERSION.txt

@@ -1 +1 @@
-0.4.1
+0.4.2

example/example1/requirements.txt

@@ -4,7 +4,7 @@ attrs >= 23.1.0
 frozenlist >= 1.4.1
 idna >= 3.6
 multidict >= 6.0.4
-openfga-sdk >= 0.4.1
+openfga-sdk >= 0.4.2
 python-dateutil >= 2.8.2
 urllib3 >= 2.1.0
 yarl >= 1.9.4

openfga_sdk/__init__.py

@@ -10,7 +10,7 @@
    NOTE: This file was auto generated by OpenAPI Generator (https://openapi-generator.tech). DO NOT EDIT.
 """
 
-__version__ = "0.4.1"
+__version__ = "0.4.2"
 
 from openfga_sdk.api.open_fga_api import OpenFgaApi
 from openfga_sdk.api_client import ApiClient

openfga_sdk/api_client.py

@@ -33,7 +33,7 @@
     ServiceException,
 )
 
-DEFAULT_USER_AGENT = "openfga-sdk python/0.4.1"
+DEFAULT_USER_AGENT = "openfga-sdk python/0.4.2"
 
 
 def random_time(loop_count, min_wait_in_ms):

openfga_sdk/configuration.py

@@ -469,7 +469,7 @@ def to_debug_report(self):
             "OS: {env}\n"
             "Python Version: {pyversion}\n"
             "Version of the API: 0.1\n"
-            "SDK Package Version: 0.4.1".format(env=sys.platform, pyversion=sys.version)
+            "SDK Package Version: 0.4.2".format(env=sys.platform, pyversion=sys.version)
         )
 
     def get_host_settings(self):

openfga_sdk/oauth2.py

@@ -80,7 +80,7 @@ async def _obtain_token(self, client):
             {
                 "Accept": "application/json",
                 "Content-Type": "application/x-www-form-urlencoded",
-                "User-Agent": "openfga-sdk (python) 0.4.1",
+                "User-Agent": "openfga-sdk (python) 0.4.2",
             }
         )
 

openfga_sdk/sync/api_client.py

@@ -33,7 +33,7 @@
 )
 from openfga_sdk.sync import oauth2, rest
 
-DEFAULT_USER_AGENT = "openfga-sdk python/0.4.1"
+DEFAULT_USER_AGENT = "openfga-sdk python/0.4.2"
 
 
 def random_time(loop_count, min_wait_in_ms):

openfga_sdk/sync/oauth2.py

@@ -80,7 +80,7 @@ def _obtain_token(self, client):
             {
                 "Accept": "application/json",
                 "Content-Type": "application/x-www-form-urlencoded",
-                "User-Agent": "openfga-sdk (python) 0.4.1",
+                "User-Agent": "openfga-sdk (python) 0.4.2",
             }
         )