feat(examples): rewrite examples from Rust to Python

Author: francescobianco

docs/readme-pypi.md

@@ -0,0 +1,33 @@
+"""
+Step 2 — API Calls
+==================
+Use a previously generated bearer token to call Openapi endpoints.
+Run token_generation.py first, then paste the token below (or pass it via env).
+
+Usage:
+    OPENAPI_TOKEN=<token> python examples/api_calls.py
+"""
+
+import os
+
+from openapi_python_sdk.client import Client
+
+token = os.environ.get("OPENAPI_TOKEN", "<your_token>")
+
+client = Client(token=token)
+
+# GET request with query params
+resp = client.request(
+    method="GET",
+    url="https://test.imprese.openapi.it/advance",
+    params={"denominazione": "altravia", "provincia": "RM", "codice_ateco": "6201"},
+)
+print("GET response:", resp)
+
+# POST request with a JSON payload
+resp = client.request(
+    method="POST",
+    url="https://test.postontarget.com/fields/country",
+    payload={"limit": 0, "query": {"country_code": "IT"}},
+)
+print("POST response:", resp)

examples/api_calls.py

@@ -0,0 +1,33 @@
+"""
+Step 1 — Token Generation
+=========================
+Authenticate with your credentials and create a short-lived bearer token
+scoped to the API endpoints you need to call.
+
+Usage:
+    OPENAPI_USERNAME=<user> OPENAPI_APIKEY=<key> python examples/token_generation.py
+"""
+
+import os
+
+from openapi_python_sdk.client import OauthClient
+
+username = os.environ.get("OPENAPI_USERNAME", "<your_username>")
+apikey = os.environ.get("OPENAPI_APIKEY", "<your_apikey>")
+
+oauth = OauthClient(username=username, apikey=apikey, test=True)
+
+# Create a token valid for 1 hour, scoped to the endpoints you need
+resp = oauth.create_token(
+    scopes=[
+        "GET:test.imprese.openapi.it/advance",
+        "POST:test.postontarget.com/fields/country",
+    ],
+    ttl=3600,
+)
+token = resp["token"]
+print(f"Token created: {token}")
+
+# Revoke the token when you are done
+oauth.delete_token(id=token)
+print("Token revoked.")