init decorator and add comments noting human code

Author: Coniferish

src/unstructured_client/general.py

@@ -4,6 +4,8 @@
 from typing import Any, List, Optional
 from unstructured_client import utils
 from unstructured_client.models import errors, operations, shared
+from unstructured_client.utils._decorators import suggest_defining_url_if_401 # human code
+
 
 class General:
     sdk_configuration: SDKConfiguration
@@ -12,7 +14,7 @@ def __init__(self, sdk_config: SDKConfiguration) -> None:
         self.sdk_configuration = sdk_config
 
 
-    
+    @suggest_defining_url_if_401 # human code
     def partition(self, request: Optional[shared.PartitionParameters], retries: Optional[utils.RetryConfig] = None) -> operations.PartitionResponse:
         r"""Pipeline 1"""
         base_url = utils.template_url(*self.sdk_configuration.get_server_details())

src/unstructured_client/sdk.py

@@ -6,15 +6,15 @@
 from typing import Callable, Dict, Union
 from unstructured_client import utils
 from unstructured_client.models import shared
-from unstructured_client.utils._decorators import clean_server_url
+from unstructured_client.utils._decorators import clean_server_url # human code
 
 class UnstructuredClient:
     r"""Unstructured Pipeline API: Partition documents with the Unstructured library"""
     general: General
 
     sdk_configuration: SDKConfiguration
 
-    @clean_server_url
+    @clean_server_url # human code
     def __init__(self,
                  api_key_auth: Union[str, Callable[[], str]],
                  server: str = None,

src/unstructured_client/utils/_decorators.py

@@ -1,9 +1,15 @@
 from __future__ import annotations
 
 import functools
-from typing import cast, Callable, Optional
+from typing import cast, Callable, TYPE_CHECKING, Optional
 from typing_extensions import ParamSpec
 from urllib.parse import urlparse, urlunparse, ParseResult
+import warnings
+
+from unstructured_client.models import errors
+
+if TYPE_CHECKING:
+    from unstructured_client.general import General
 
 
 _P = ParamSpec("_P")
@@ -44,3 +50,18 @@ def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> None:
         return func(*args, **kwargs)
 
     return wrapper
+
+
+def suggest_defining_url_if_401(func: Callable[_P, None]) -> Callable[_P, None]:
+
+    @functools.wraps(func)
+    def wrapper(*args: _P.args, **kwargs: _P.kwargs) -> None:
+        try:
+            return func(*args, **kwargs)
+        except errors.SDKError:
+            general_obj: General = args[0]
+            if not general_obj.sdk_configuration.server_url:
+                warnings.warn("If intending to use the paid API, please define `server_url` in your request.")
+            return func(*args, **kwargs)
+
+    return wrapper