stackmachine 0.3.1__tar.gz → 0.3.2__tar.gz

{stackmachine-0.3.1 → stackmachine-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackmachine
-Version: 0.3.1
+Version: 0.3.2
 Summary: Python SDK for StackMachine.
 Project-URL: Homepage, https://github.com/stackmachine/sdks/tree/main/python
 Project-URL: Repository, https://github.com/stackmachine/sdks
@@ -61,15 +61,13 @@ stackmachine = StackMachine("sk_stackmachine_...")
 async_stackmachine = AsyncStackMachine("sk_stackmachine_...")
 ```
 
-Both clients accept JavaScript-style aliases during initialization:
+Both clients accept configuration options during initialization:
 
 ```python
-stackmachine = StackMachine.init(
-    {
-        "token": "sk_stackmachine_...",
-        "apiUrl": "https://api.stackmachine.com/graphql",
-        "maxNetworkRetries": 2,
-    }
+stackmachine = StackMachine(
+    "sk_stackmachine_...",
+    apiUrl="https://api.stackmachine.com/graphql",
+    maxNetworkRetries=2,
 )
 ```
 
@@ -101,10 +99,8 @@ async for app in apps:
 
 ```python
 deployment = stackmachine.deployments.create(
-    {
-        "file": "https://example.com/app.zip",
-        "name": "my-app",
-    }
+    upload_url="https://example.com/app.zip",
+    app_name="my-app",
 )
 
 version = deployment.wait()
@@ -112,10 +108,8 @@ version = deployment.wait()
 
 ```python
 deployment = stackmachine.apps.autobuild(
-    {
-        "file": "https://example.com/app.zip",
-        "name": "my-app",
-    }
+    upload_url="https://example.com/app.zip",
+    app_name="my-app",
 )
 ```
 
@@ -162,13 +156,15 @@ key = stackmachine.apps.ssh.users.authorized_keys.create(
 Most methods accept `request_options` for per-request configuration:
 
 ```python
+from stackmachine import RequestOptions
+
 app = stackmachine.apps.retrieve(
     "app_id",
-    request_options={
-        "api_key": "sk_stackmachine_other",
-        "timeout": 30,
-        "idempotency_key": "deploy-123",
-    },
+    request_options=RequestOptions(
+        api_key="sk_stackmachine_other",
+        timeout=30,
+        idempotency_key="deploy-123",
+    ),
 )
 ```
 

{stackmachine-0.3.1 → stackmachine-0.3.2}/README.md

@@ -39,15 +39,13 @@ stackmachine = StackMachine("sk_stackmachine_...")
 async_stackmachine = AsyncStackMachine("sk_stackmachine_...")
 ```
 
-Both clients accept JavaScript-style aliases during initialization:
+Both clients accept configuration options during initialization:
 
 ```python
-stackmachine = StackMachine.init(
-    {
-        "token": "sk_stackmachine_...",
-        "apiUrl": "https://api.stackmachine.com/graphql",
-        "maxNetworkRetries": 2,
-    }
+stackmachine = StackMachine(
+    "sk_stackmachine_...",
+    apiUrl="https://api.stackmachine.com/graphql",
+    maxNetworkRetries=2,
 )
 ```
 
@@ -79,10 +77,8 @@ async for app in apps:
 
 ```python
 deployment = stackmachine.deployments.create(
-    {
-        "file": "https://example.com/app.zip",
-        "name": "my-app",
-    }
+    upload_url="https://example.com/app.zip",
+    app_name="my-app",
 )
 
 version = deployment.wait()
@@ -90,10 +86,8 @@ version = deployment.wait()
 
 ```python
 deployment = stackmachine.apps.autobuild(
-    {
-        "file": "https://example.com/app.zip",
-        "name": "my-app",
-    }
+    upload_url="https://example.com/app.zip",
+    app_name="my-app",
 )
 ```
 
@@ -140,13 +134,15 @@ key = stackmachine.apps.ssh.users.authorized_keys.create(
 Most methods accept `request_options` for per-request configuration:
 
 ```python
+from stackmachine import RequestOptions
+
 app = stackmachine.apps.retrieve(
     "app_id",
-    request_options={
-        "api_key": "sk_stackmachine_other",
-        "timeout": 30,
-        "idempotency_key": "deploy-123",
-    },
+    request_options=RequestOptions(
+        api_key="sk_stackmachine_other",
+        timeout=30,
+        idempotency_key="deploy-123",
+    ),
 )
 ```
 

{stackmachine-0.3.1 → stackmachine-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stackmachine"
-version = "0.3.1"
+version = "0.3.2"
 description = "Python SDK for StackMachine."
 readme = "README.md"
 requires-python = ">=3.9"

{stackmachine-0.3.1 → stackmachine-0.3.2}/src/stackmachine/__init__.py

@@ -74,7 +74,7 @@ from ._uploads import create_zip
 try:
     __version__ = version("stackmachine")
 except PackageNotFoundError:
-    __version__ = "0.3.1"
+    __version__ = "0.3.2"
 
 __all__ = [
     "AppAlias",

{stackmachine-0.3.1 → stackmachine-0.3.2}/src/stackmachine/_async_client.py

@@ -25,24 +25,36 @@ class AsyncStackMachine:
         self,
         api_key: str,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: Optional[str] = None,
+        apiUrl: Optional[str] = None,
         headers: Optional[Headers] = None,
         timeout: float = DEFAULT_TIMEOUT,
-        max_network_retries: int = DEFAULT_MAX_NETWORK_RETRIES,
+        max_network_retries: Optional[int] = None,
+        maxNetworkRetries: Optional[int] = None,
         http_client: Optional[httpx.AsyncClient] = None,
         http_transport: Optional[httpx.AsyncBaseTransport] = None,
     ) -> None:
+        resolved_api_url = (
+            api_url if api_url is not None else apiUrl or DEFAULT_API_URL
+        )
+        resolved_max_retries = (
+            max_network_retries
+            if max_network_retries is not None
+            else maxNetworkRetries
+            if maxNetworkRetries is not None
+            else DEFAULT_MAX_NETWORK_RETRIES
+        )
         self.api_key = api_key
-        self.api_url = api_url
-        self.apiUrl = api_url
+        self.api_url = resolved_api_url
+        self.apiUrl = resolved_api_url
         self.timeout = timeout
-        self.max_network_retries = max_network_retries
-        self.maxNetworkRetries = max_network_retries
+        self.max_network_retries = resolved_max_retries
+        self.maxNetworkRetries = resolved_max_retries
         self._config = ClientConfig(
-            api_url=api_url,
+            api_url=resolved_api_url,
             headers=headers,
             timeout=timeout,
-            max_network_retries=max_network_retries,
+            max_network_retries=resolved_max_retries,
         )
         self._transport = AsyncTransport(
             api_key,

{stackmachine-0.3.1 → stackmachine-0.3.2}/src/stackmachine/_client.py

@@ -25,24 +25,36 @@ class StackMachine:
         self,
         api_key: str,
         *,
-        api_url: str = DEFAULT_API_URL,
+        api_url: Optional[str] = None,
+        apiUrl: Optional[str] = None,
         headers: Optional[Headers] = None,
         timeout: float = DEFAULT_TIMEOUT,
-        max_network_retries: int = DEFAULT_MAX_NETWORK_RETRIES,
+        max_network_retries: Optional[int] = None,
+        maxNetworkRetries: Optional[int] = None,
         http_client: Optional[httpx.Client] = None,
         http_transport: Optional[httpx.BaseTransport] = None,
     ) -> None:
+        resolved_api_url = (
+            api_url if api_url is not None else apiUrl or DEFAULT_API_URL
+        )
+        resolved_max_retries = (
+            max_network_retries
+            if max_network_retries is not None
+            else maxNetworkRetries
+            if maxNetworkRetries is not None
+            else DEFAULT_MAX_NETWORK_RETRIES
+        )
         self.api_key = api_key
-        self.api_url = api_url
-        self.apiUrl = api_url
+        self.api_url = resolved_api_url
+        self.apiUrl = resolved_api_url
         self.timeout = timeout
-        self.max_network_retries = max_network_retries
-        self.maxNetworkRetries = max_network_retries
+        self.max_network_retries = resolved_max_retries
+        self.maxNetworkRetries = resolved_max_retries
         self._config = ClientConfig(
-            api_url=api_url,
+            api_url=resolved_api_url,
             headers=headers,
             timeout=timeout,
-            max_network_retries=max_network_retries,
+            max_network_retries=resolved_max_retries,
         )
         self._transport = SyncTransport(
             api_key,

{stackmachine-0.3.1 → stackmachine-0.3.2}/tests/test_package.py

@@ -65,9 +65,10 @@ def test_file_upload_signature_uses_public_types() -> None:
     assert hints["request_options"] == Optional[stackmachine.RequestOptionsLike]
 
 
-def test_client_init_accepts_js_style_aliases() -> None:
-    client = StackMachine.init(
-        {"token": "token-1", "apiUrl": "https://api.example/graphql"},
+def test_client_constructor_accepts_configuration_aliases() -> None:
+    client = StackMachine(
+        "token-1",
+        apiUrl="https://api.example/graphql",
         maxNetworkRetries=3,
         http_transport=httpx.MockTransport(lambda _: graphql_response({})),
     )
@@ -81,6 +82,20 @@ def test_client_init_accepts_js_style_aliases() -> None:
         client.close()
 
 
+def test_client_init_accepts_mapping_settings() -> None:
+    client = StackMachine.init(
+        {"token": "token-1", "apiUrl": "https://api.example/graphql"},
+        maxNetworkRetries=3,
+        http_transport=httpx.MockTransport(lambda _: graphql_response({})),
+    )
+    try:
+        assert client.api_key == "token-1"
+        assert client.api_url == "https://api.example/graphql"
+        assert client.max_network_retries == 3
+    finally:
+        client.close()
+
+
 def test_sync_viewer_sends_auth_header_and_returns_model() -> None:
     seen: dict[str, Any] = {}