release: 4.0.0-alpha.1 (#258)

* chore(internal): version bump (#254)

* feat(api): update via SDK Studio (#255)

* feat(api): update via SDK Studio (#256)

* feat(api): update via SDK Studio (#257)

* release: 4.0.0-alpha.1

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/release-doctor.yml

@@ -1,6 +1,8 @@
 name: Release Doctor
 on:
   pull_request:
+    branches:
+      - v3
   workflow_dispatch:
 
 jobs:

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0"
+  ".": "4.0.0-alpha.1"
 }

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 108
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/intercom%2Fintercom-a202b2b4aa0e356eb61376a3bf484132be2e9e3bff3796e1fe4606ab2a3734fd.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/intercom%2Fintercom-61fd2f21fb0fb6a94c5e87ea423d828bf37d1dd90ca1511eda9b91d58ccb5d39.yml

CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 4.0.0-alpha.1 (2024-07-19)
+
+Full Changelog: [v0.1.0...v4.0.0-alpha.1](https://github.com/intercom/python-intercom/compare/v0.1.0...v4.0.0-alpha.1)
+
+### Features
+
+* **api:** OpenAPI spec update ([7b99dc3](https://github.com/intercom/python-intercom/commit/7b99dc3ea6ce3c61845510a06f313624d92db628))
+* **api:** OpenAPI spec update ([632e659](https://github.com/intercom/python-intercom/commit/632e659f6a0694e1c262e77d8a1da664e67488fa))
+* **api:** OpenAPI spec update ([a561dff](https://github.com/intercom/python-intercom/commit/a561dffa1225722412e78890ea2668f58a3d6aa9))
+* **api:** update via SDK Studio ([44d360a](https://github.com/intercom/python-intercom/commit/44d360a2e477e2e3cbc2441a2f1ef6dae51e6331))
+* **api:** update via SDK Studio ([4f981c5](https://github.com/intercom/python-intercom/commit/4f981c5818eb35a61bcd98952c30322cce6b4e77))
+* **api:** update via SDK Studio ([1802937](https://github.com/intercom/python-intercom/commit/1802937e0c6c1366861f4d54d62335b132a6aca8))
+* **api:** update via SDK Studio ([c5ee578](https://github.com/intercom/python-intercom/commit/c5ee5781b766f90017b9e40e040dc6ee4010b403))
+* **api:** update via SDK Studio ([8d1d513](https://github.com/intercom/python-intercom/commit/8d1d5135cd2ad5a9e92116611e42e5ce471e4c55))
+* **api:** update via SDK Studio ([4b7275f](https://github.com/intercom/python-intercom/commit/4b7275faddb82e20d8beb21ad5d1edf8d1ff4e39))
+* **api:** update via SDK Studio ([cd48024](https://github.com/intercom/python-intercom/commit/cd480246a573bc08a1cc1182a318f1b3a3b6d709))
+* **api:** update via SDK Studio ([dfd8fba](https://github.com/intercom/python-intercom/commit/dfd8fbaea39b1e55b22ee632f7558e96a349e473))
+* **api:** update via SDK Studio ([0bd7ae4](https://github.com/intercom/python-intercom/commit/0bd7ae43a2ecfb9f6a190e50a72a139e772a279f))
+* **api:** update via SDK Studio ([638c48b](https://github.com/intercom/python-intercom/commit/638c48b6b6aa01b49232d89b8a8e8509055fc062))
+* **api:** update via SDK Studio ([bce089e](https://github.com/intercom/python-intercom/commit/bce089efbaf0406130d1ded51c15b752f332bc94))
+* **api:** update via SDK Studio ([635b1d1](https://github.com/intercom/python-intercom/commit/635b1d18a40f730ab28529301297a809e1c9d5dc))
+* **api:** update via SDK Studio ([b1b9219](https://github.com/intercom/python-intercom/commit/b1b92197c2758c1f121f52cf636033c4b9ba6f42))
+* **api:** update via SDK Studio ([e3069e9](https://github.com/intercom/python-intercom/commit/e3069e903f7188941c2a6f69a982bf6e49a04313))
+* **api:** update via SDK Studio ([6210114](https://github.com/intercom/python-intercom/commit/62101148adf4ecf0b5aeea53b110feaaba296ede))
+* **api:** update via SDK Studio ([aff3c46](https://github.com/intercom/python-intercom/commit/aff3c46f12717bee8bc2a662cd99f34c73e959af))
+* **api:** update via SDK Studio ([#255](https://github.com/intercom/python-intercom/issues/255)) ([8deb42a](https://github.com/intercom/python-intercom/commit/8deb42ab24714983c947bdef4efef870daaec3fc))
+* **api:** update via SDK Studio ([#256](https://github.com/intercom/python-intercom/issues/256)) ([0d233e4](https://github.com/intercom/python-intercom/commit/0d233e4dbe68cb7c248482730102077e0db7de08))
+* **api:** update via SDK Studio ([#257](https://github.com/intercom/python-intercom/issues/257)) ([e046f2f](https://github.com/intercom/python-intercom/commit/e046f2fd31706c3cb6c2b94e57d712a4f3323fc6))
+
+
+### Chores
+
+* **internal:** version bump ([#254](https://github.com/intercom/python-intercom/issues/254)) ([6d19734](https://github.com/intercom/python-intercom/commit/6d197342dd213266ed131ed30aba33ef2f8840b7))
+
 ## 0.1.0 (2024-07-17)
 
 Full Changelog: [v0.0.1...v0.1.0](https://github.com/intercom/python-intercom/compare/v0.0.1...v0.1.0)

README.md

@@ -283,6 +283,12 @@ client = Intercom(
 )
 ```
 
+You can also customize the client on a per-request basis by using `with_options()`:
+
+```python
+client.with_options(http_client=DefaultHttpxClient(...))
+```
+
 ### Managing HTTP resources
 
 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.

api.md

@@ -86,6 +86,12 @@ Methods:
 
 # HelpCenter
 
+Types:
+
+```python
+from python_intercom.types import HelpCenter, HelpCenterList
+```
+
 ## Collections
 
 Types:
@@ -104,16 +110,10 @@ Methods:
 
 ## HelpCenters
 
-Types:
-
-```python
-from python_intercom.types.help_center import HelpCenter, HelpCenterList
-```
-
 Methods:
 
 - <code title="get /help_center/help_centers/{id}">client.help_center.help_centers.<a href="./src/python_intercom/resources/help_center/help_centers.py">retrieve</a>(id) -> <a href="./src/python_intercom/types/help_center/help_center.py">HelpCenter</a></code>
-- <code title="get /help_center/help_centers">client.help_center.help_centers.<a href="./src/python_intercom/resources/help_center/help_centers.py">list</a>() -> <a href="./src/python_intercom/types/help_center/help_center_list.py">HelpCenterList</a></code>
+- <code title="get /help_center/help_centers">client.help_center.help_centers.<a href="./src/python_intercom/resources/help_center/help_centers.py">list</a>() -> <a href="./src/python_intercom/types/help_center_list.py">HelpCenterList</a></code>
 
 # Companies
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-intercom"
-version = "0.1.0"
+version = "4.0.0-alpha.1"
 description = "The official Python library for the intercom API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/python_intercom/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "python_intercom"
-__version__ = "0.1.0"  # x-release-please-version
+__version__ = "4.0.0-alpha.1"  # x-release-please-version

src/python_intercom/resources/help_center/help_centers.py

@@ -17,8 +17,8 @@
     async_to_streamed_response_wrapper,
 )
 from ..._base_client import make_request_options
+from ...types.help_center_list import HelpCenterList
 from ...types.help_center.help_center import HelpCenter
-from ...types.help_center.help_center_list import HelpCenterList
 
 __all__ = ["HelpCentersResource", "AsyncHelpCentersResource"]
 

src/python_intercom/types/__init__.py

@@ -35,6 +35,7 @@
 from .team_list import TeamList as TeamList
 from .admin_list import AdminList as AdminList
 from .data_export import DataExport as DataExport
+from .help_center import HelpCenter as HelpCenter
 from .ticket_list import TicketList as TicketList
 from .ticket_type import TicketType as TicketType
 from .article_list import ArticleList as ArticleList
@@ -48,6 +49,7 @@
 from .data_attribute import DataAttribute as DataAttribute
 from .contact_deleted import ContactDeleted as ContactDeleted
 from .contact_archived import ContactArchived as ContactArchived
+from .help_center_list import HelpCenterList as HelpCenterList
 from .ticket_type_list import TicketTypeList as TicketTypeList
 from .conversation_list import ConversationList as ConversationList
 from .contact_unarchived import ContactUnarchived as ContactUnarchived

src/python_intercom/types/help_center/__init__.py

@@ -5,7 +5,6 @@
 from .collection import Collection as Collection
 from .help_center import HelpCenter as HelpCenter
 from .collection_list import CollectionList as CollectionList
-from .help_center_list import HelpCenterList as HelpCenterList
 from .deleted_collection import DeletedCollection as DeletedCollection
 from .collection_create_params import CollectionCreateParams as CollectionCreateParams
 from .collection_update_params import CollectionUpdateParams as CollectionUpdateParams

src/python_intercom/types/help_center/help_center_list.py renamed to src/python_intercom/types/help_center_list.py

@@ -3,8 +3,8 @@
 from typing import List, Optional
 from typing_extensions import Literal
 
-from ..._models import BaseModel
-from .help_center import HelpCenter
+from .._models import BaseModel
+from .help_center.help_center import HelpCenter
 
 __all__ = ["HelpCenterList"]
 

tests/api_resources/help_center/test_help_centers.py

@@ -9,7 +9,8 @@
 
 from tests.utils import assert_matches_type
 from python_intercom import Intercom, AsyncIntercom
-from python_intercom.types.help_center import HelpCenter, HelpCenterList
+from python_intercom.types import HelpCenterList
+from python_intercom.types.help_center import HelpCenter
 
 base_url = os.environ.get("TEST_API_BASE_URL", "http://127.0.0.1:4010")