release: 0.10.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.9.5"
+  ".": "0.10.0"
 }

.stats.yml

@@ -1 +1 @@
-configured_endpoints: 23
+configured_endpoints: 34

CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.10.0 (2024-01-09)
+
+Full Changelog: [v0.9.5...v0.10.0](https://github.com/Finch-API/finch-api-python/compare/v0.9.5...v0.10.0)
+
+### Features
+
+* add `None` default value to nullable response properties ([#246](https://github.com/Finch-API/finch-api-python/issues/246)) ([a3c577c](https://github.com/Finch-API/finch-api-python/commit/a3c577c2408ca18de1cdfeaf513b2e92f06120c3))
+* **api:** add method to create access token ([#249](https://github.com/Finch-API/finch-api-python/issues/249)) ([3dedeb6](https://github.com/Finch-API/finch-api-python/commit/3dedeb6bc0912e18d0574005eabe41490434bea1))
+* **api:** add sandbox APIs ([#251](https://github.com/Finch-API/finch-api-python/issues/251)) ([3ac7bc5](https://github.com/Finch-API/finch-api-python/commit/3ac7bc52c912008baa9d2b6da548aea858b8fbde))
+
+
+### Bug Fixes
+
+* **client:** correctly use custom http client auth ([#242](https://github.com/Finch-API/finch-api-python/issues/242)) ([244aef9](https://github.com/Finch-API/finch-api-python/commit/244aef94986b9775df68c247dad9e1f576fd0415))
+
+
+### Chores
+
+* add .keep files for examples and custom code directories ([#250](https://github.com/Finch-API/finch-api-python/issues/250)) ([e5a7c17](https://github.com/Finch-API/finch-api-python/commit/e5a7c17686359f0a121c815635f70e83f0e21092))
+* **internal:** bump license ([#244](https://github.com/Finch-API/finch-api-python/issues/244)) ([b7b0145](https://github.com/Finch-API/finch-api-python/commit/b7b01454503efda4542805d4fb335f39b301bc1f))
+* **internal:** loosen type var restrictions ([#248](https://github.com/Finch-API/finch-api-python/issues/248)) ([f070165](https://github.com/Finch-API/finch-api-python/commit/f0701652f2e85b5d6b139eb68c2b3fe665618dd9))
+* **internal:** replace isort with ruff ([#245](https://github.com/Finch-API/finch-api-python/issues/245)) ([82a7085](https://github.com/Finch-API/finch-api-python/commit/82a7085b46391bbb1a08f45d1fa4469c1225e3dd))
+* **test:** update examples ([#252](https://github.com/Finch-API/finch-api-python/issues/252)) ([b802828](https://github.com/Finch-API/finch-api-python/commit/b802828c164bd32eab6e778128003a10d16d6dba))
+* use property declarations for resource members ([#247](https://github.com/Finch-API/finch-api-python/issues/247)) ([acd29fd](https://github.com/Finch-API/finch-api-python/commit/acd29fd6138c0fa23ac429aa2b92e31791560bf4))
+
 ## 0.9.5 (2023-12-22)
 
 Full Changelog: [v0.9.4...v0.9.5](https://github.com/Finch-API/finch-api-python/compare/v0.9.4...v0.9.5)

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2023 Finch
+   Copyright 2024 Finch
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

api.md

@@ -1,7 +1,12 @@
 # Shared Types
 
 ```python
-from finch.types import OperationSupport, OperationSupportMatrix, Paging
+from finch.types import (
+    IntrospectResponseConnectionStatus,
+    OperationSupport,
+    OperationSupportMatrix,
+    Paging,
+)
 ```
 
 # Finch
@@ -10,6 +15,19 @@ Methods:
 
 - <code>client.<a href="./src/finch/_client.py">get_access_token</a>(\*args) -> str</code>
 - <code>client.<a href="./src/finch/_client.py">get_auth_url</a>(\*args) -> str</code>
+- <code>client.<a href="./src/finch/_client.py">with_access_token</a>(\*args) -> Self</code>
+
+# AccessTokens
+
+Types:
+
+```python
+from finch.types import CreateAccessTokenResponse
+```
+
+Methods:
+
+- <code title="post /auth/token">client.access_tokens.<a href="./src/finch/resources/access_tokens.py">create</a>(\*\*<a href="src/finch/types/access_token_create_params.py">params</a>) -> <a href="./src/finch/types/create_access_token_response.py">CreateAccessTokenResponse</a></code>
 
 # HRIS
 
@@ -210,3 +228,111 @@ from finch.types.jobs import ManualAsyncJob
 Methods:
 
 - <code title="get /jobs/manual/{job_id}">client.jobs.manual.<a href="./src/finch/resources/jobs/manual.py">retrieve</a>(job_id) -> <a href="./src/finch/types/jobs/manual_async_job.py">ManualAsyncJob</a></code>
+
+# Auth
+
+Methods:
+
+- <code title="post /auth/token">client.auth.<a href="./src/finch/resources/auth.py">create_token</a>(\*\*<a href="src/finch/types/auth_create_token_params.py">params</a>) -> <a href="./src/finch/types/create_access_token_response.py">CreateAccessTokenResponse</a></code>
+
+# Sandbox
+
+## Connections
+
+Types:
+
+```python
+from finch.types.sandbox import ConnectionCreateResponse
+```
+
+Methods:
+
+- <code title="post /sandbox/connections">client.sandbox.connections.<a href="./src/finch/resources/sandbox/connections/connections.py">create</a>(\*\*<a href="src/finch/types/sandbox/connection_create_params.py">params</a>) -> <a href="./src/finch/types/sandbox/connection_create_response.py">ConnectionCreateResponse</a></code>
+
+### Accounts
+
+Types:
+
+```python
+from finch.types.sandbox.connections import AccountCreateResponse, AccountUpdateResponse
+```
+
+Methods:
+
+- <code title="post /sandbox/connections/accounts">client.sandbox.connections.accounts.<a href="./src/finch/resources/sandbox/connections/accounts.py">create</a>(\*\*<a href="src/finch/types/sandbox/connections/account_create_params.py">params</a>) -> <a href="./src/finch/types/sandbox/connections/account_create_response.py">AccountCreateResponse</a></code>
+- <code title="put /sandbox/connections/accounts">client.sandbox.connections.accounts.<a href="./src/finch/resources/sandbox/connections/accounts.py">update</a>(\*\*<a href="src/finch/types/sandbox/connections/account_update_params.py">params</a>) -> <a href="./src/finch/types/sandbox/connections/account_update_response.py">AccountUpdateResponse</a></code>
+
+## Company
+
+Types:
+
+```python
+from finch.types.sandbox import CompanyUpdateResponse
+```
+
+Methods:
+
+- <code title="put /sandbox/company">client.sandbox.company.<a href="./src/finch/resources/sandbox/company.py">update</a>(\*\*<a href="src/finch/types/sandbox/company_update_params.py">params</a>) -> <a href="./src/finch/types/sandbox/company_update_response.py">CompanyUpdateResponse</a></code>
+
+## Directory
+
+Types:
+
+```python
+from finch.types.sandbox import DirectoryCreateResponse
+```
+
+Methods:
+
+- <code title="post /sandbox/directory">client.sandbox.directory.<a href="./src/finch/resources/sandbox/directory.py">create</a>(\*\*<a href="src/finch/types/sandbox/directory_create_params.py">params</a>) -> <a href="./src/finch/types/sandbox/directory_create_response.py">DirectoryCreateResponse</a></code>
+
+## Individual
+
+Types:
+
+```python
+from finch.types.sandbox import IndividualUpdateResponse
+```
+
+Methods:
+
+- <code title="put /sandbox/individual/{individual_id}">client.sandbox.individual.<a href="./src/finch/resources/sandbox/individual.py">update</a>(individual_id, \*\*<a href="src/finch/types/sandbox/individual_update_params.py">params</a>) -> <a href="./src/finch/types/sandbox/individual_update_response.py">IndividualUpdateResponse</a></code>
+
+## Employment
+
+Types:
+
+```python
+from finch.types.sandbox import EmploymentUpdateResponse
+```
+
+Methods:
+
+- <code title="put /sandbox/employment/{individual_id}">client.sandbox.employment.<a href="./src/finch/resources/sandbox/employment.py">update</a>(individual_id, \*\*<a href="src/finch/types/sandbox/employment_update_params.py">params</a>) -> <a href="./src/finch/types/sandbox/employment_update_response.py">EmploymentUpdateResponse</a></code>
+
+## Payment
+
+Types:
+
+```python
+from finch.types.sandbox import PaymentCreateResponse
+```
+
+Methods:
+
+- <code title="post /sandbox/payment">client.sandbox.payment.<a href="./src/finch/resources/sandbox/payment.py">create</a>(\*\*<a href="src/finch/types/sandbox/payment_create_params.py">params</a>) -> <a href="./src/finch/types/sandbox/payment_create_response.py">PaymentCreateResponse</a></code>
+
+## Jobs
+
+### Configuration
+
+Types:
+
+```python
+from finch.types.sandbox.jobs import SandboxJobConfiguration, ConfigurationRetrieveResponse
+```
+
+Methods:
+
+- <code title="get /sandbox/jobs/configuration">client.sandbox.jobs.configuration.<a href="./src/finch/resources/sandbox/jobs/configuration.py">retrieve</a>() -> <a href="./src/finch/types/sandbox/jobs/configuration_retrieve_response.py">ConfigurationRetrieveResponse</a></code>
+- <code title="put /sandbox/jobs/configuration">client.sandbox.jobs.configuration.<a href="./src/finch/resources/sandbox/jobs/configuration.py">update</a>(\*\*<a href="src/finch/types/sandbox/jobs/configuration_update_params.py">params</a>) -> <a href="./src/finch/types/sandbox/jobs/sandbox_job_configuration.py">SandboxJobConfiguration</a></code>

examples/.keep

@@ -0,0 +1,4 @@
+File generated from our OpenAPI spec by Stainless.
+
+This directory can be used to store example files demonstrating usage of this SDK.
+It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "finch-api"
-version = "0.9.5"
+version = "0.10.0"
 description = "The official Python library for the Finch API"
 readme = "README.md"
 license = "Apache-2.0"
@@ -14,6 +14,7 @@ dependencies = [
     "anyio>=3.5.0, <5",
     "distro>=1.7.0, <2",
     "sniffio",
+    "cached-property; python_version < '3.8'",
 
 ]
 requires-python = ">= 3.7"
@@ -53,7 +54,6 @@ dev-dependencies = [
     "pytest",
     "pytest-asyncio",
     "ruff",
-    "isort",
     "time-machine",
     "nox",
     "dirty-equals>=0.6.0",
@@ -66,7 +66,6 @@ format = { chain = [
   "format:ruff",
   "format:docs",
   "fix:ruff",
-  "format:isort",
 ]}
 "format:black" = "black ."
 "format:docs" = "python bin/ruffen-docs.py README.md api.md"
@@ -127,16 +126,13 @@ reportImplicitOverride = true
 reportImportCycles = false
 reportPrivateUsage = false
 
-[tool.isort]
-profile = "black"
-length_sort = true
-extra_standard_library = ["typing_extensions"]
-
 [tool.ruff]
 line-length = 120
 output-format = "grouped"
 target-version = "py37"
 select = [
+  # isort
+  "I",
   # bugbear rules
   "B",
   # remove unused imports
@@ -163,6 +159,13 @@ ignore-init-module-imports = true
 [tool.ruff.format]
 docstring-code-format = true
 
+[tool.ruff.lint.isort]
+length-sort = true
+length-sort-straight = true
+combine-as-imports = true
+extra-standard-library = ["typing_extensions"]
+known-first-party = ["finch", "tests"]
+
 [tool.ruff.per-file-ignores]
 "bin/**.py" = ["T201", "T203"]
 "tests/**.py" = ["T201", "T203"]

requirements-dev.lock

@@ -24,7 +24,6 @@ httpx==0.25.2
 idna==3.4
 importlib-metadata==7.0.0
 iniconfig==2.0.0
-isort==5.10.1
 mypy==1.7.1
 mypy-extensions==1.0.0
 nodeenv==1.8.0

src/finch/__init__.py

@@ -3,17 +3,7 @@
 from . import types
 from ._types import NoneType, Transport, ProxiesTypes
 from ._utils import file_from_path
-from ._client import (
-    Finch,
-    Client,
-    Stream,
-    Timeout,
-    Transport,
-    AsyncFinch,
-    AsyncClient,
-    AsyncStream,
-    RequestOptions,
-)
+from ._client import Finch, Client, Stream, Timeout, Transport, AsyncFinch, AsyncClient, AsyncStream, RequestOptions
 from ._version import __title__, __version__
 from ._exceptions import (
     APIError,