chore: revert custom changes to autogenerated code (#181)

# The issue
The v2 python client has some minor breaking changes for our users, both
related to keyword parameters:

* The PartitionRequest class is now a pydantic model which does not
support positional arguments in the constructor. Therefore we always
have to name the `partition_parameters` field.

```
    req = operations.PartitionRequest(
        shared.PartitionParameters(
            ....
            ....
        )
    )
```

becomes

```
    req = operations.PartitionRequest(
        partition_parameters=shared.PartitionParameters(
            ....
            ....
        )
    )

```

* Likewise, the function signature for `general.partition` no longer
allows for positional args.

Instead of 

```
    response = client.general.partition(req)
```

we have to do 

```
    response = client.general.partition(request=req)
```

# The first approach

These are minimal changes, but they will disrupt a number of users who
have copied our sample snippets in the past. My workaround for this was
to manually patch the autogenerated code to bring back positional
params. However, this will be messy in the long term, as we now have to
apply our changes after every regenerate. Instead, let's embrace the
version bump to 0.16.0 and just document the breaking change.

Update: The python snippet in the serverless dashboard uses keyword
args, so users who copied this out are unaffected.

# Changes

- Revert my manual edits to:
- Allow `request` as a positional arg in `general.partition`
(`general.py`)
- Add a constructor to `PartitionRequest` so we don't have to use a
keyword arg
- Remove the patch file containing these changes
- Update some makefile commands to reuse in other repos

Author: awalker4

Makefile

@@ -14,6 +14,11 @@ install:
 	python scripts/prepare-readme.py
 	poetry install
 
+## install-speakeasy-cli:			download the speakeasy cli tool
+.PHONY: install-speakeasy-cli
+install-speakeasy-cli:
+	curl -fsSL https://raw.githubusercontent.com/speakeasy-api/speakeasy/main/install.sh | sh
+
 #################
 # Test and Lint #
 #################
@@ -48,24 +53,21 @@ lint:
 # Speakeasy #
 #############
 
+## client-generate:			Pull the openapi spec from the free hosted API and generate the SDK
 .PHONY: client-generate
 client-generate:
 	wget -nv -q -O openapi.json https://api.unstructured.io/general/openapi.json
 	speakeasy overlay validate -o ./overlay_client.yaml
 	speakeasy overlay apply -s ./openapi.json -o ./overlay_client.yaml > ./openapi_client.json
 	speakeasy generate sdk -s ./openapi_client.json -o ./ -l python
 
+## client-generate-local:			Generate the SDK using a local copy of openapi.json
 .PHONY: client-generate-local
 client-generate-local:
-	wget -nv -q -O openapi.json http://localhost:5000/general/openapi.json
 	speakeasy overlay validate -o ./overlay_client.yaml
 	speakeasy overlay apply -s ./openapi.json -o ./overlay_client.yaml > ./openapi_client.json
 	speakeasy generate sdk -s ./openapi_client.json -o ./ -l python
 
-.PHONY: patch-custom-code
-patch-custom-code:
-	git apply _custom_code.patch
-
 .PHONY: publish
 publish:
 	./scripts/publish.sh

_custom_code.patch

@@ -356,7 +356,7 @@ async def mock_send(_, request: httpx.Request, **kwargs):
         )
 
     req = operations.PartitionRequest(
-        shared.PartitionParameters(
+        partition_parameters=shared.PartitionParameters(
             files=files,
             split_pdf_page=True,
             split_pdf_allow_failed=False,

_test_unstructured_client/integration/test_decorators.py

@@ -122,11 +122,11 @@ def mock_post(request):
         files = shared.Files(content=f.read(), file_name=filename)
 
     req = operations.PartitionRequest(
-        shared.PartitionParameters(files=files)
+        partition_parameters=shared.PartitionParameters(files=files)
     )
 
     with pytest.raises(Exception, match=f"Status {status_code}"):
-        session.general.partition(req, retries=retries)
+        session.general.partition(request=req, retries=retries)
 
     if expect_retry:
         assert number_of_requests[0] > 1

_test_unstructured_client/unit/test_custom_hooks.py

@@ -11,10 +11,10 @@
 class General(BaseSDK):
     def partition(
         self,
+        *,
         request: Union[
             operations.PartitionRequest, operations.PartitionRequestTypedDict
         ],
-        *,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,
@@ -116,10 +116,10 @@ def partition(
 
     async def partition_async(
         self,
+        *,
         request: Union[
             operations.PartitionRequest, operations.PartitionRequestTypedDict
         ],
-        *,
         retries: OptionalNullable[utils.RetryConfig] = UNSET,
         server_url: Optional[str] = None,
         timeout_ms: Optional[int] = None,

src/unstructured_client/general.py

@@ -25,9 +25,6 @@ class PartitionRequestTypedDict(TypedDict):
 
 
 class PartitionRequest(BaseModel):
-    def __init__(self, partition_parameters, **kwargs):
-        BaseModel.__init__(self, partition_parameters=partition_parameters, **kwargs)
-
     partition_parameters: Annotated[
         shared_partition_parameters.PartitionParameters,
         FieldMetadata(request=RequestMetadata(media_type="multipart/form-data")),