feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 5
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/cas-parser%2Fcas-parser-b7fdba3d3f97c7debc22c7ca30b828bce81bcd64648df8c94029b27a3321ebb9.yml
 openapi_spec_hash: 03f1315f1d32ada42445ca920f047dff
-config_hash: 1de8a243a3962065e289ca915dfc6127
+config_hash: d9c1f7b95d5659724df3e026c4fab291

README.md

@@ -33,11 +33,12 @@ from cas_parser import CasParser
 
 client = CasParser(
     api_key=os.environ.get("CAS_PARSER_API_KEY"),  # This is the default and can be omitted
-    # defaults to "production".
-    environment="local",
 )
 
-unified_response = client.cas_parser.cams_kfintech()
+unified_response = client.cas_parser.smart_parse(
+    password="ABCDF",
+    pdf_url="https://your-cas-pdf-url-here.com",
+)
 print(unified_response.demat_accounts)
 ```
 
@@ -57,13 +58,14 @@ from cas_parser import AsyncCasParser
 
 client = AsyncCasParser(
     api_key=os.environ.get("CAS_PARSER_API_KEY"),  # This is the default and can be omitted
-    # defaults to "production".
-    environment="local",
 )
 
 
 async def main() -> None:
-    unified_response = await client.cas_parser.cams_kfintech()
+    unified_response = await client.cas_parser.smart_parse(
+        password="ABCDF",
+        pdf_url="https://your-cas-pdf-url-here.com",
+    )
     print(unified_response.demat_accounts)
 
 
@@ -96,7 +98,10 @@ async def main() -> None:
         api_key="My API Key",
         http_client=DefaultAioHttpClient(),
     ) as client:
-        unified_response = await client.cas_parser.cams_kfintech()
+        unified_response = await client.cas_parser.smart_parse(
+            password="ABCDF",
+            pdf_url="https://your-cas-pdf-url-here.com",
+        )
         print(unified_response.demat_accounts)
 
 
@@ -128,7 +133,10 @@ from cas_parser import CasParser
 client = CasParser()
 
 try:
-    client.cas_parser.cams_kfintech()
+    client.cas_parser.smart_parse(
+        password="ABCDF",
+        pdf_url="https://you-cas-pdf-url-here.com",
+    )
 except cas_parser.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
@@ -171,7 +179,10 @@ client = CasParser(
 )
 
 # Or, configure per-request:
-client.with_options(max_retries=5).cas_parser.cams_kfintech()
+client.with_options(max_retries=5).cas_parser.smart_parse(
+    password="ABCDF",
+    pdf_url="https://you-cas-pdf-url-here.com",
+)
 ```
 
 ### Timeouts
@@ -194,7 +205,10 @@ client = CasParser(
 )
 
 # Override per-request:
-client.with_options(timeout=5.0).cas_parser.cams_kfintech()
+client.with_options(timeout=5.0).cas_parser.smart_parse(
+    password="ABCDF",
+    pdf_url="https://you-cas-pdf-url-here.com",
+)
 ```
 
 On timeout, an `APITimeoutError` is thrown.
@@ -235,10 +249,13 @@ The "raw" Response object can be accessed by prefixing `.with_raw_response.` to
 from cas_parser import CasParser
 
 client = CasParser()
-response = client.cas_parser.with_raw_response.cams_kfintech()
+response = client.cas_parser.with_raw_response.smart_parse(
+    password="ABCDF",
+    pdf_url="https://you-cas-pdf-url-here.com",
+)
 print(response.headers.get('X-My-Header'))
 
-cas_parser = response.parse()  # get the object that `cas_parser.cams_kfintech()` would have returned
+cas_parser = response.parse()  # get the object that `cas_parser.smart_parse()` would have returned
 print(cas_parser.demat_accounts)
 ```
 
@@ -253,7 +270,10 @@ The above interface eagerly reads the full response body when you make the reque
 To stream the response body, use `.with_streaming_response` instead, which requires a context manager and only reads the response body once you call `.read()`, `.text()`, `.json()`, `.iter_bytes()`, `.iter_text()`, `.iter_lines()` or `.parse()`. In the async client, these are async methods.
 
 ```python
-with client.cas_parser.with_streaming_response.cams_kfintech() as response:
+with client.cas_parser.with_streaming_response.smart_parse(
+    password="ABCDF",
+    pdf_url="https://you-cas-pdf-url-here.com",
+) as response:
     print(response.headers.get("X-My-Header"))
 
     for line in response.iter_lines():

src/cas_parser/__init__.py

@@ -6,7 +6,6 @@
 from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
 from ._utils import file_from_path
 from ._client import (
-    ENVIRONMENTS,
     Client,
     Stream,
     Timeout,
@@ -72,7 +71,6 @@
     "AsyncStream",
     "CasParser",
     "AsyncCasParser",
-    "ENVIRONMENTS",
     "file_from_path",
     "BaseModel",
     "DEFAULT_TIMEOUT",

src/cas_parser/_client.py

@@ -3,8 +3,8 @@
 from __future__ import annotations
 
 import os
-from typing import Any, Dict, Union, Mapping, cast
-from typing_extensions import Self, Literal, override
+from typing import Any, Union, Mapping
+from typing_extensions import Self, override
 
 import httpx
 
@@ -31,7 +31,6 @@
 )
 
 __all__ = [
-    "ENVIRONMENTS",
     "Timeout",
     "Transport",
     "ProxiesTypes",
@@ -42,11 +41,6 @@
     "AsyncClient",
 ]
 
-ENVIRONMENTS: Dict[str, str] = {
-    "production": "https://portfolio-parser.api.casparser.in",
-    "local": "http://localhost:5000",
-}
-
 
 class CasParser(SyncAPIClient):
     cas_parser: cas_parser.CasParserResource
@@ -57,14 +51,11 @@ class CasParser(SyncAPIClient):
     # client options
     api_key: str
 
-    _environment: Literal["production", "local"] | NotGiven
-
     def __init__(
         self,
         *,
         api_key: str | None = None,
-        environment: Literal["production", "local"] | NotGiven = NOT_GIVEN,
-        base_url: str | httpx.URL | None | NotGiven = NOT_GIVEN,
+        base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
@@ -95,31 +86,10 @@ def __init__(
             )
         self.api_key = api_key
 
-        self._environment = environment
-
-        base_url_env = os.environ.get("CAS_PARSER_BASE_URL")
-        if is_given(base_url) and base_url is not None:
-            # cast required because mypy doesn't understand the type narrowing
-            base_url = cast("str | httpx.URL", base_url)  # pyright: ignore[reportUnnecessaryCast]
-        elif is_given(environment):
-            if base_url_env and base_url is not None:
-                raise ValueError(
-                    "Ambiguous URL; The `CAS_PARSER_BASE_URL` env var and the `environment` argument are given. If you want to use the environment, you must pass base_url=None",
-                )
-
-            try:
-                base_url = ENVIRONMENTS[environment]
-            except KeyError as exc:
-                raise ValueError(f"Unknown environment: {environment}") from exc
-        elif base_url_env is not None:
-            base_url = base_url_env
-        else:
-            self._environment = environment = "production"
-
-            try:
-                base_url = ENVIRONMENTS[environment]
-            except KeyError as exc:
-                raise ValueError(f"Unknown environment: {environment}") from exc
+        if base_url is None:
+            base_url = os.environ.get("CAS_PARSER_BASE_URL")
+        if base_url is None:
+            base_url = f"https://portfolio-parser.api.casparser.in"
 
         super().__init__(
             version=__version__,
@@ -161,7 +131,6 @@ def copy(
         self,
         *,
         api_key: str | None = None,
-        environment: Literal["production", "local"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.Client | None = None,
@@ -197,7 +166,6 @@ def copy(
         return self.__class__(
             api_key=api_key or self.api_key,
             base_url=base_url or self.base_url,
-            environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
             max_retries=max_retries if is_given(max_retries) else self.max_retries,
@@ -253,14 +221,11 @@ class AsyncCasParser(AsyncAPIClient):
     # client options
     api_key: str
 
-    _environment: Literal["production", "local"] | NotGiven
-
     def __init__(
         self,
         *,
         api_key: str | None = None,
-        environment: Literal["production", "local"] | NotGiven = NOT_GIVEN,
-        base_url: str | httpx.URL | None | NotGiven = NOT_GIVEN,
+        base_url: str | httpx.URL | None = None,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
         max_retries: int = DEFAULT_MAX_RETRIES,
         default_headers: Mapping[str, str] | None = None,
@@ -291,31 +256,10 @@ def __init__(
             )
         self.api_key = api_key
 
-        self._environment = environment
-
-        base_url_env = os.environ.get("CAS_PARSER_BASE_URL")
-        if is_given(base_url) and base_url is not None:
-            # cast required because mypy doesn't understand the type narrowing
-            base_url = cast("str | httpx.URL", base_url)  # pyright: ignore[reportUnnecessaryCast]
-        elif is_given(environment):
-            if base_url_env and base_url is not None:
-                raise ValueError(
-                    "Ambiguous URL; The `CAS_PARSER_BASE_URL` env var and the `environment` argument are given. If you want to use the environment, you must pass base_url=None",
-                )
-
-            try:
-                base_url = ENVIRONMENTS[environment]
-            except KeyError as exc:
-                raise ValueError(f"Unknown environment: {environment}") from exc
-        elif base_url_env is not None:
-            base_url = base_url_env
-        else:
-            self._environment = environment = "production"
-
-            try:
-                base_url = ENVIRONMENTS[environment]
-            except KeyError as exc:
-                raise ValueError(f"Unknown environment: {environment}") from exc
+        if base_url is None:
+            base_url = os.environ.get("CAS_PARSER_BASE_URL")
+        if base_url is None:
+            base_url = f"https://portfolio-parser.api.casparser.in"
 
         super().__init__(
             version=__version__,
@@ -357,7 +301,6 @@ def copy(
         self,
         *,
         api_key: str | None = None,
-        environment: Literal["production", "local"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
         http_client: httpx.AsyncClient | None = None,
@@ -393,7 +336,6 @@ def copy(
         return self.__class__(
             api_key=api_key or self.api_key,
             base_url=base_url or self.base_url,
-            environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
             http_client=http_client,
             max_retries=max_retries if is_given(max_retries) else self.max_retries,