snowleopard 0.3.0__tar.gz → 0.3.2__tar.gz

snowleopard-0.3.2/.claude/settings.local.json

@@ -0,0 +1,17 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(mkdir:*)",
+      "Bash(uv add:*)",
+      "Bash(uv run pytest:*)",
+      "WebFetch(domain:www.python-httpx.org)",
+      "Bash(python -c:*)",
+      "Bash(uv run python:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(uv run snowy response --help:*)",
+      "Bash(uv run:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

{snowleopard-0.3.0 → snowleopard-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: snowleopard
-Version: 0.3.0
+Version: 0.3.2
 Summary: snowleopard.ai client library
 Author-email: Snowy <hello@snowleopard.ai>
 License: MIT License

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/__init__.py

@@ -4,10 +4,14 @@
 
 from snowleopard.async_client import AsyncSnowLeopardClient
 from snowleopard.client import SnowLeopardClient
+from snowleopard.error import APIBadRequest, SnowLeopardHTTPError, SLException
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 
 __all__ = [
     "SnowLeopardClient",
     "AsyncSnowLeopardClient",
+    "SLException",
+    "APIBadRequest",
+    "SnowLeopardHTTPError",
 ]

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/async_client.py

@@ -7,8 +7,7 @@ from typing import AsyncGenerator, Optional, Dict, Any
 
 import httpx
 from snowleopard.client_base import SLClientBase
-from snowleopard.error import APIBadRequest
-from snowleopard.models import APIError, parse, ResponseDataObjects, RetrieveResponseObjects
+from snowleopard.models import parse, ResponseDataObjects, RetrieveResponseObjects
 
 
 class AsyncSnowLeopardClient(SLClientBase):
@@ -50,13 +49,9 @@ class AsyncSnowLeopardClient(SLClientBase):
             self._build_path(datafile_id, "response"),
             json=self._build_request_body(user_query, known_data),
         ) as resp:
-            if resp.status_code not in (400,):
-                resp.raise_for_status()
+            self._raise_for_status(resp)
             async for line in resp.aiter_lines():
-                resultObj = parse(json.loads(line))
-                if isinstance(resultObj, APIError) and resp.status_code == 400:
-                    raise APIBadRequest(resultObj.description)
-                yield resultObj
+                yield parse(json.loads(line))
 
     async def __aenter__(self):
         await self.client.__aenter__()

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/cli.py

@@ -10,7 +10,7 @@ from typing import List, Optional, Dict, Any
 
 from httpx import HTTPStatusError
 from snowleopard import __version__, SnowLeopardClient
-from snowleopard.error import APIBadRequest
+from snowleopard.error import APIBadRequest, SLException
 
 
 def _create_parser() -> argparse.ArgumentParser:
@@ -113,12 +113,9 @@ def _response(parsed_args):
                 datafile_id=parsed_args.datafile,
             ):
                 print(json.dumps(dataclasses.asdict(chunk)))
-    except APIBadRequest as e:
+    except SLException as e:
         print(f"error: {str(e)}", file=sys.stderr)
         hadErrors = True
-    except HTTPStatusError as e:
-        print(str(e), file=sys.stderr)
-        hadErrors = True
     if hadErrors:
         sys.exit(1)
 

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/client.py

@@ -7,8 +7,7 @@ from typing import Optional, Generator, Dict, Any
 
 import httpx
 from snowleopard.client_base import SLClientBase
-from snowleopard.error import APIBadRequest
-from snowleopard.models import APIError, parse, RetrieveResponseObjects, ResponseDataObjects
+from snowleopard.models import parse, RetrieveResponseObjects, ResponseDataObjects
 
 
 class SnowLeopardClient(SLClientBase):
@@ -50,12 +49,9 @@ class SnowLeopardClient(SLClientBase):
             url=self._build_path(datafile_id, "response"),
             json=self._build_request_body(user_query, known_data),
         ) as resp:
-            if resp.status_code not in (400,):
-                resp.raise_for_status()
+            self._raise_for_status(resp)
             for line in resp.iter_lines():
                 resultObj = parse(json.loads(line))
-                if isinstance(resultObj, APIError) and resp.status_code == 400:
-                    raise APIBadRequest(resultObj.description)
                 yield resultObj
 
     def __enter__(self):

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/client_base.py

@@ -9,8 +9,8 @@ from typing import Optional, Dict, Any
 
 import httpx
 
-from snowleopard.error import APIBadRequest
-from snowleopard.models import APIError, parse
+from snowleopard.error import APIBadRequest, SnowLeopardHTTPError
+from snowleopard.models import parse
 
 
 @dataclass
@@ -103,14 +103,17 @@ class SLClientBase:
         return body
 
     @staticmethod
-    def _parse_retrieve(resp):
-        if resp.status_code not in (400, 409):
+    def _raise_for_status(resp):
+        try:
             resp.raise_for_status()
+        except httpx.HTTPStatusError as e:
+            raise SnowLeopardHTTPError(e.response.status_code, e.response) from e
+
+    def _parse_retrieve(self, resp):
+        if resp.status_code != 409:
+            self._raise_for_status(resp)
         try:
-            resultObj = parse(resp.json())
+            return parse(resp.json())
         except Exception:
-            resp.raise_for_status()
+            self._raise_for_status(resp)
             raise
-        if isinstance(resultObj, APIError) and resp.status_code == 400:
-            raise APIBadRequest(resultObj.description)
-        return resultObj

snowleopard-0.3.2/src/snowleopard/error.py

@@ -0,0 +1,32 @@
+# -*- coding: utf-8 -*-
+# copyright 2026 Snow Leopard, Inc
+# released under the MIT license - see LICENSE file
+
+import httpx
+
+class SLException(Exception):
+    pass
+
+
+class APIBadRequest(SLException):
+    """Raised when the request is invalid due to bad input.
+
+    This is raised for client-side validation errors, such as an empty or
+    whitespace-only query string.
+    """
+
+
+class SnowLeopardHTTPError(SLException):
+    """Raised when the SnowLeopard API returns an unexpected HTTP error status."""
+
+    status_code: int
+    response: httpx.Response
+
+    def __init__(self, status_code: int, response: httpx.Response):
+        self.status_code = status_code
+        self.response = response
+        try:
+            body = response.text[:500]
+        except Exception:
+            body = "<response body unavailable>"
+        super().__init__(f"SnowLeopard API error (HTTP {status_code}): {body}")

{snowleopard-0.3.0 → snowleopard-0.3.2}/src/snowleopard/models.py

@@ -99,6 +99,7 @@ class ResponseStatus(StrEnum):
     SUCCESS = "SUCCESS"
     BAD_REQUEST = "BAD_REQUEST"
     NOT_FOUND_IN_SCHEMA = "NOT_FOUND_IN_SCHEMA"
+    UNABLE_TO_UNDERSTAND_QUESTION = "UNABLE_TO_UNDERSTAND_QUESTION"
     UNKNOWN = "UNKNOWN"
     INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR"
     AUTHORIZATION_FAILED = "AUTHORIZATION_FAILED"

snowleopard-0.3.0/src/snowleopard/error.py

@@ -1,10 +0,0 @@
-# -*- coding: utf-8 -*-
-# copyright 2026 Snow Leopard, Inc
-# released under the MIT license - see LICENSE file
-
-class SLException(Exception):
-    pass
-
-
-class APIBadRequest(SLException):
-    pass