feat: report runtime properties

Propagate more information about the SDK's runtime including the API
version, package version, etc. to get more observability into the
SDKs usage.

Also removes the generation of the client/client.go file as it
doesn't depend on the OpenAPI specs and can be maintained manually.

Author: matoous

codegen/templates/client.py.tmpl

@@ -3,7 +3,7 @@ import os
 import httpx
 import typing
 
-from ._service import Resource, AsyncResource
+from ._service import Resource, AsyncResource, runtime_headers
 {{- range .Resources }}
 from .{{ .Package }} import {{ .Name }}Resource, Async{{ .Name }}Resource
 {{- end }}
@@ -25,6 +25,7 @@ class Sumup(Resource):
 			headers={
 				"User-Agent": f"sumup-py/{self.version()}",
 				"Authorization": f"Bearer {self.api_key}",
+				**runtime_headers(),
 			},
         ))
 
@@ -51,6 +52,7 @@ class AsyncSumup(AsyncResource):
 			headers={
 				"User-Agent": f"sumup-py/{self.version()}",
 				"Authorization": f"Bearer {self.api_key}",
+				**runtime_headers(),
 			},
         ))
 

sumup/_api_version.py

@@ -0,0 +1 @@
+__api_version__ = "1.0.0"

sumup/_client.py

@@ -3,7 +3,7 @@
 import httpx
 import typing
 
-from ._service import Resource, AsyncResource
+from ._service import Resource, AsyncResource, runtime_headers
 from .checkouts import CheckoutsResource, AsyncCheckoutsResource
 from .customers import CustomersResource, AsyncCustomersResource
 from .members import MembersResource, AsyncMembersResource
@@ -35,6 +35,7 @@ def __init__(
                 headers={
                     "User-Agent": f"sumup-py/{self.version()}",
                     "Authorization": f"Bearer {self.api_key}",
+                    **runtime_headers(),
                 },
             )
         )
@@ -127,6 +128,7 @@ def __init__(
                 headers={
                     "User-Agent": f"sumup-py/{self.version()}",
                     "Authorization": f"Bearer {self.api_key}",
+                    **runtime_headers(),
                 },
             )
         )

sumup/_service.py

@@ -1,4 +1,9 @@
 import httpx
+import platform
+import sys
+from functools import lru_cache
+
+from ._api_version import __api_version__
 from ._version import __version__
 
 HeaderTypes = dict[str, str]
@@ -10,6 +15,48 @@ def version():
         return f"v{__version__}"
 
 
+def runtime_headers() -> dict[str, str]:
+    return dict(_runtime_headers())
+
+
+@lru_cache(maxsize=1)
+def _runtime_headers() -> tuple[tuple[str, str], ...]:
+    arch_raw = platform.machine()
+    arch = arch_raw.lower() if arch_raw else ""
+    arch_map = {
+        "x86_64": "x86_64",
+        "x64": "x86_64",
+        "amd64": "x86_64",
+        "x86": "x86",
+        "i386": "x86",
+        "i686": "x86",
+        "ia32": "x86",
+        "x32": "x86",
+        "aarch64": "arm64",
+        "arm64": "arm64",
+        "arm": "arm",
+    }
+    arch = arch_map.get(arch, "unknown")
+
+    os_name = sys.platform
+    os_map = {
+        "win32": "windows",
+        "linux": "linux",
+        "darwin": "darwin",
+    }
+    os_name = os_map.get(os_name, os_name)
+
+    return (
+        ("X-Sumup-Api-Version", __api_version__),
+        ("X-Sumup-Lang", "python"),
+        ("X-Sumup-Package-Version", __version__),
+        ("X-Sumup-Os", os_name),
+        ("X-Sumup-Arch", arch),
+        ("X-Sumup-Runtime", "python"),
+        ("X-Sumup-Runtime-Version", platform.python_version()),
+    )
+
+
 class Resource(BaseResource):
     _client: httpx.Client