chore(internal): codegen related update (#493)

Author: stainless-app[bot]

README.md

@@ -416,6 +416,17 @@ We take backwards-compatibility seriously and work hard to ensure you can rely o
 
 We are keen for your feedback; please open an [issue](https://www.github.com/Finch-API/finch-api-python/issues) with questions, bugs, or suggestions.
 
+### Determining the installed version
+
+If you've upgraded to the latest version but aren't seeing any new features you were expecting then your python environment is likely still using an older version.
+
+You can determine the version that is being used at runtime with:
+
+```py
+import finch
+print(finch.__version__)
+```
+
 ## Requirements
 
 Python 3.7 or higher.

pyproject.toml

@@ -15,7 +15,6 @@ dependencies = [
     "distro>=1.7.0, <2",
     "sniffio",
     "cached-property; python_version < '3.8'",
-
 ]
 requires-python = ">= 3.7"
 classifiers = [
@@ -36,8 +35,6 @@ classifiers = [
   "License :: OSI Approved :: Apache Software License"
 ]
 
-
-
 [project.urls]
 Homepage = "https://github.com/Finch-API/finch-api-python"
 Repository = "https://github.com/Finch-API/finch-api-python"
@@ -59,7 +56,6 @@ dev-dependencies = [
     "dirty-equals>=0.6.0",
     "importlib-metadata>=6.7.0",
     "rich>=13.7.1",
-
 ]
 
 [tool.rye.scripts]

src/finch/resources/access_tokens.py

@@ -20,10 +20,21 @@
 class AccessTokens(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AccessTokensWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AccessTokensWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AccessTokensWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AccessTokensWithStreamingResponse(self)
 
     def create(
@@ -87,10 +98,21 @@ def create(
 class AsyncAccessTokens(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncAccessTokensWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncAccessTokensWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncAccessTokensWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncAccessTokensWithStreamingResponse(self)
 
     async def create(

src/finch/resources/account.py

@@ -19,10 +19,21 @@
 class Account(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AccountWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AccountWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AccountWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AccountWithStreamingResponse(self)
 
     def disconnect(
@@ -67,10 +78,21 @@ def introspect(
 class AsyncAccount(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncAccountWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncAccountWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncAccountWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncAccountWithStreamingResponse(self)
 
     async def disconnect(

src/finch/resources/hris/benefits/benefits.py

@@ -43,10 +43,21 @@ def individuals(self) -> Individuals:
 
     @cached_property
     def with_raw_response(self) -> BenefitsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return BenefitsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> BenefitsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return BenefitsWithStreamingResponse(self)
 
     def create(
@@ -216,10 +227,21 @@ def individuals(self) -> AsyncIndividuals:
 
     @cached_property
     def with_raw_response(self) -> AsyncBenefitsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncBenefitsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncBenefitsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncBenefitsWithStreamingResponse(self)
 
     async def create(

src/finch/resources/hris/benefits/individuals.py

@@ -30,10 +30,21 @@
 class Individuals(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> IndividualsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return IndividualsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> IndividualsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return IndividualsWithStreamingResponse(self)
 
     def enroll_many(
@@ -202,10 +213,21 @@ def unenroll_many(
 class AsyncIndividuals(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncIndividualsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncIndividualsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncIndividualsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncIndividualsWithStreamingResponse(self)
 
     def enroll_many(

src/finch/resources/hris/company.py

@@ -18,10 +18,21 @@
 class CompanyResource(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> CompanyResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return CompanyResourceWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> CompanyResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return CompanyResourceWithStreamingResponse(self)
 
     def retrieve(
@@ -47,10 +58,21 @@ def retrieve(
 class AsyncCompanyResource(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncCompanyResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncCompanyResourceWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncCompanyResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncCompanyResourceWithStreamingResponse(self)
 
     async def retrieve(

src/finch/resources/hris/directory.py

@@ -23,10 +23,21 @@
 class Directory(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> DirectoryWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return DirectoryWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> DirectoryWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return DirectoryWithStreamingResponse(self)
 
     def list(
@@ -118,10 +129,21 @@ def list_individuals(
 class AsyncDirectory(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncDirectoryWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncDirectoryWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncDirectoryWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncDirectoryWithStreamingResponse(self)
 
     def list(

src/finch/resources/hris/employments.py

@@ -23,10 +23,21 @@
 class Employments(SyncAPIResource):
     @cached_property
     def with_raw_response(self) -> EmploymentsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return EmploymentsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> EmploymentsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return EmploymentsWithStreamingResponse(self)
 
     def retrieve_many(
@@ -69,10 +80,21 @@ def retrieve_many(
 class AsyncEmployments(AsyncAPIResource):
     @cached_property
     def with_raw_response(self) -> AsyncEmploymentsWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncEmploymentsWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncEmploymentsWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncEmploymentsWithStreamingResponse(self)
 
     def retrieve_many(

src/finch/resources/hris/hris.py

@@ -96,10 +96,21 @@ def benefits(self) -> Benefits:
 
     @cached_property
     def with_raw_response(self) -> HRISWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return HRISWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> HRISWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return HRISWithStreamingResponse(self)
 
 
@@ -134,10 +145,21 @@ def benefits(self) -> AsyncBenefits:
 
     @cached_property
     def with_raw_response(self) -> AsyncHRISWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return the
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#accessing-raw-response-data-eg-headers
+        """
         return AsyncHRISWithRawResponse(self)
 
     @cached_property
     def with_streaming_response(self) -> AsyncHRISWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/Finch-API/finch-api-python#with_streaming_response
+        """
         return AsyncHRISWithStreamingResponse(self)