chore(internal): codegen related update

Author: stainless-app[bot]

.github/workflows/create-releases.yml

@@ -0,0 +1,38 @@
+name: Create releases
+on:
+  schedule:
+    - cron: '0 5 * * *' # every day at 5am UTC
+  push:
+    branches:
+      - main
+
+jobs:
+  release:
+    name: release
+    if: github.ref == 'refs/heads/main' && github.repository == 'openintegrations/python-sdk'
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: stainless-api/trigger-release-please@v1
+        id: release
+        with:
+          repo: ${{ github.event.repository.full_name }}
+          stainless-api-key: ${{ secrets.STAINLESS_API_KEY }}
+
+      - name: Install Rye
+        if: ${{ steps.release.outputs.releases_created }}
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.35.0'
+          RYE_INSTALL_OPTION: '--yes'
+
+      - name: Publish to PyPI
+        if: ${{ steps.release.outputs.releases_created }}
+        run: |
+          bash ./bin/publish-pypi
+        env:
+          PYPI_TOKEN: ${{ secrets.OPENINT_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/publish-pypi.yml

@@ -0,0 +1,27 @@
+# workflow for re-running publishing to PyPI in case it fails for some reason
+# you can run this workflow by navigating to https://www.github.com/openintegrations/python-sdk/actions/workflows/publish-pypi.yml
+name: Publish PyPI
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: publish
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rye
+        run: |
+          curl -sSf https://rye.astral.sh/get | bash
+          echo "$HOME/.rye/shims" >> $GITHUB_PATH
+        env:
+          RYE_VERSION: '0.35.0'
+          RYE_INSTALL_OPTION: '--yes'
+
+      - name: Publish to PyPI
+        run: |
+          bash ./bin/publish-pypi
+        env:
+          PYPI_TOKEN: ${{ secrets.OPENINT_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.github/workflows/release-doctor.yml

@@ -0,0 +1,22 @@
+name: Release Doctor
+on:
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  release_doctor:
+    name: release doctor
+    runs-on: ubuntu-latest
+    if: github.repository == 'openintegrations/python-sdk' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check release environment
+        run: |
+          bash ./bin/check-release-environment
+        env:
+          STAINLESS_API_KEY: ${{ secrets.STAINLESS_API_KEY }}
+          PYPI_TOKEN: ${{ secrets.OPENINT_PYPI_TOKEN || secrets.PYPI_TOKEN }}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.1-alpha.0"
+}

CONTRIBUTING.md

@@ -37,7 +37,7 @@ $ pip install -r requirements-dev.lock
 
 Most of the SDK is generated code. Modifications to code will be persisted between generations, but may
 result in merge conflicts between manual patches and changes from the generator. The generator will never
-modify the contents of the `src/openint/lib/` and `examples/` directories.
+modify the contents of the `src/openint_sdk/lib/` and `examples/` directories.
 
 ## Adding and running examples
 
@@ -63,7 +63,7 @@ If you’d like to use the repository from source, you can either install from g
 To install via git:
 
 ```sh
-$ pip install git+ssh://git@github.com/stainless-sdks/openint-python.git
+$ pip install git+ssh://git@github.com/openintegrations/python-sdk.git
 ```
 
 Alternatively, you can build from source and install the wheel file:
@@ -121,7 +121,7 @@ the changes aren't made through the automated pipeline, you may want to make rel
 
 ### Publish with a GitHub workflow
 
-You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/stainless-sdks/openint-python/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
+You can release to package managers by using [the `Publish PyPI` GitHub action](https://www.github.com/openintegrations/python-sdk/actions/workflows/publish-pypi.yml). This requires a setup organization or repository secret to be set up.
 
 ### Publish manually
 

README.md

@@ -1,6 +1,6 @@
 # Openint Python API library
 
-[![PyPI version](https://img.shields.io/pypi/v/openint.svg)](https://pypi.org/project/openint/)
+[![PyPI version](https://img.shields.io/pypi/v/openint_sdk.svg)](https://pypi.org/project/openint_sdk/)
 
 The Openint Python library provides convenient access to the Openint REST API from any Python 3.8+
 application. The library includes type definitions for all request params and response fields,
@@ -15,38 +15,45 @@ The REST API documentation can be found on [docs.openint.dev](https://docs.openi
 ## Installation
 
 ```sh
-# install from this staging repo
-pip install git+ssh://git@github.com/stainless-sdks/openint-python.git
+# install from the production repo
+pip install git+ssh://git@github.com/openintegrations/python-sdk.git
 ```
 
 > [!NOTE]
-> Once this package is [published to PyPI](https://app.stainless.com/docs/guides/publish), this will become: `pip install --pre openint`
+> Once this package is [published to PyPI](https://app.stainless.com/docs/guides/publish), this will become: `pip install --pre openint_sdk`
 
 ## Usage
 
 The full API of this library can be found in [api.md](api.md).
 
 ```python
-from openint import Openint
+import os
+from openint_sdk import Openint
 
 client = Openint(
-    api_key="My API Key",
+    api_key=os.environ.get("OPENINT_API_KEY"),  # This is the default and can be omitted
 )
 
 response = client.get_connection()
 print(response.items)
 ```
 
+While you can provide an `api_key` keyword argument,
+we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
+to add `OPENINT_API_KEY="My API Key"` to your `.env` file
+so that your API Key is not stored in source control.
+
 ## Async usage
 
 Simply import `AsyncOpenint` instead of `Openint` and use `await` with each API call:
 
 ```python
+import os
 import asyncio
-from openint import AsyncOpenint
+from openint_sdk import AsyncOpenint
 
 client = AsyncOpenint(
-    api_key="My API Key",
+    api_key=os.environ.get("OPENINT_API_KEY"),  # This is the default and can be omitted
 )
 
 
@@ -71,29 +78,27 @@ Typed requests and responses provide autocomplete and documentation within your
 
 ## Handling errors
 
-When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `openint.APIConnectionError` is raised.
+When the library is unable to connect to the API (for example, due to network connection problems or a timeout), a subclass of `openint_sdk.APIConnectionError` is raised.
 
 When the API returns a non-success status code (that is, 4xx or 5xx
-response), a subclass of `openint.APIStatusError` is raised, containing `status_code` and `response` properties.
+response), a subclass of `openint_sdk.APIStatusError` is raised, containing `status_code` and `response` properties.
 
-All errors inherit from `openint.APIError`.
+All errors inherit from `openint_sdk.APIError`.
 
 ```python
-import openint
-from openint import Openint
+import openint_sdk
+from openint_sdk import Openint
 
-client = Openint(
-    api_key="My API Key",
-)
+client = Openint()
 
 try:
     client.get_connection()
-except openint.APIConnectionError as e:
+except openint_sdk.APIConnectionError as e:
     print("The server could not be reached")
     print(e.__cause__)  # an underlying Exception, likely raised within httpx.
-except openint.RateLimitError as e:
+except openint_sdk.RateLimitError as e:
     print("A 429 status code was received; we should back off a bit.")
-except openint.APIStatusError as e:
+except openint_sdk.APIStatusError as e:
     print("Another non-200-range status code was received")
     print(e.status_code)
     print(e.response)
@@ -121,13 +126,12 @@ Connection errors (for example, due to a network connectivity problem), 408 Requ
 You can use the `max_retries` option to configure or disable retry settings:
 
 ```python
-from openint import Openint
+from openint_sdk import Openint
 
 # Configure the default for all requests:
 client = Openint(
     # default is 2
     max_retries=0,
-    api_key="My API Key",
 )
 
 # Or, configure per-request:
@@ -140,19 +144,17 @@ By default requests time out after 1 minute. You can configure this with a `time
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/#fine-tuning-the-configuration) object:
 
 ```python
-from openint import Openint
+from openint_sdk import Openint
 
 # Configure the default for all requests:
 client = Openint(
     # 20 seconds (default is 1 minute)
     timeout=20.0,
-    api_key="My API Key",
 )
 
 # More granular control:
 client = Openint(
     timeout=httpx.Timeout(60.0, read=5.0, write=10.0, connect=2.0),
-    api_key="My API Key",
 )
 
 # Override per-request:
@@ -194,21 +196,19 @@ if response.my_field is None:
 The "raw" Response object can be accessed by prefixing `.with_raw_response.` to any HTTP method call, e.g.,
 
 ```py
-from openint import Openint
+from openint_sdk import Openint
 
-client = Openint(
-    api_key="My API Key",
-)
+client = Openint()
 response = client.with_raw_response.get_connection()
 print(response.headers.get('X-My-Header'))
 
 client = response.parse()  # get the object that `get_connection()` would have returned
 print(client.items)
 ```
 
-These methods return an [`APIResponse`](https://github.com/stainless-sdks/openint-python/tree/main/src/openint/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/openintegrations/python-sdk/tree/main/src/openint_sdk/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/stainless-sdks/openint-python/tree/main/src/openint/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+The async client returns an [`AsyncAPIResponse`](https://github.com/openintegrations/python-sdk/tree/main/src/openint_sdk/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
 
 #### `.with_streaming_response`
 
@@ -270,7 +270,7 @@ You can directly override the [httpx client](https://www.python-httpx.org/api/#c
 
 ```python
 import httpx
-from openint import Openint, DefaultHttpxClient
+from openint_sdk import Openint, DefaultHttpxClient
 
 client = Openint(
     # Or use the `OPENINT_BASE_URL` env var
@@ -279,7 +279,6 @@ client = Openint(
         proxy="http://my.test.proxy.example.com",
         transport=httpx.HTTPTransport(local_address="0.0.0.0"),
     ),
-    api_key="My API Key",
 )
 ```
 
@@ -294,11 +293,9 @@ client.with_options(http_client=DefaultHttpxClient(...))
 By default the library closes underlying HTTP connections whenever the client is [garbage collected](https://docs.python.org/3/reference/datamodel.html#object.__del__). You can manually close the client using the `.close()` method if desired, or with a context manager that closes when exiting.
 
 ```py
-from openint import Openint
+from openint_sdk import Openint
 
-with Openint(
-    api_key="My API Key",
-) as client:
+with Openint() as client:
   # make requests here
   ...
 
@@ -315,7 +312,7 @@ This package generally follows [SemVer](https://semver.org/spec/v2.0.0.html) con
 
 We take backwards-compatibility seriously and work hard to ensure you can rely on a smooth upgrade experience.
 
-We are keen for your feedback; please open an [issue](https://www.github.com/stainless-sdks/openint-python/issues) with questions, bugs, or suggestions.
+We are keen for your feedback; please open an [issue](https://www.github.com/openintegrations/python-sdk/issues) with questions, bugs, or suggestions.
 
 ### Determining the installed version
 
@@ -324,8 +321,8 @@ If you've upgraded to the latest version but aren't seeing any new features you
 You can determine the version that is being used at runtime with:
 
 ```py
-import openint
-print(openint.__version__)
+import openint_sdk
+print(openint_sdk.__version__)
 ```
 
 ## Requirements

api.md

@@ -3,11 +3,15 @@
 Types:
 
 ```python
-from openint.types import CheckHealthResponse, GetConnectionResponse, GetConnectionConfigResponse
+from openint_sdk.types import (
+    CheckHealthResponse,
+    GetConnectionResponse,
+    GetConnectionConfigResponse,
+)
 ```
 
 Methods:
 
-- <code title="get /health">client.<a href="./src/openint/_client.py">check_health</a>() -> str</code>
-- <code title="get /connection">client.<a href="./src/openint/_client.py">get_connection</a>() -> <a href="./src/openint/types/get_connection_response.py">GetConnectionResponse</a></code>
-- <code title="get /connector-config">client.<a href="./src/openint/_client.py">get_connection_config</a>() -> <a href="./src/openint/types/get_connection_config_response.py">GetConnectionConfigResponse</a></code>
+- <code title="get /health">client.<a href="./src/openint_sdk/_client.py">check_health</a>() -> str</code>
+- <code title="get /connection">client.<a href="./src/openint_sdk/_client.py">get_connection</a>() -> <a href="./src/openint_sdk/types/get_connection_response.py">GetConnectionResponse</a></code>
+- <code title="get /connector-config">client.<a href="./src/openint_sdk/_client.py">get_connection_config</a>() -> <a href="./src/openint_sdk/types/get_connection_config_response.py">GetConnectionConfigResponse</a></code>

bin/check-release-environment

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+
+errors=()
+
+if [ -z "${STAINLESS_API_KEY}" ]; then
+  errors+=("The STAINLESS_API_KEY secret has not been set. Please contact Stainless for an API key & set it in your organization secrets on GitHub.")
+fi
+
+if [ -z "${PYPI_TOKEN}" ]; then
+  errors+=("The OPENINT_PYPI_TOKEN secret has not been set. Please set it in either this repository's secrets or your organization secrets.")
+fi
+
+lenErrors=${#errors[@]}
+
+if [[ lenErrors -gt 0 ]]; then
+  echo -e "Found the following errors in the release environment:\n"
+
+  for error in "${errors[@]}"; do
+    echo -e "- $error\n"
+  done
+
+  exit 1
+fi
+
+echo "The environment is ready to push releases!"

mypy.ini

@@ -8,7 +8,7 @@ show_error_codes = True
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ^(src/openint/_files\.py|_dev/.*\.py|tests/.*)$
+exclude = ^(src/openint_sdk/_files\.py|_dev/.*\.py|tests/.*)$
 
 strict_equality = True
 implicit_reexport = True