Merge branch 'main' into patch-1

Author: tiwarishubham635

CHANGES.md

@@ -3,6 +3,12 @@ twilio-python Changelog
 
 Here you can see the full list of changes between each twilio-python release.
 
+[2025-04-07] Version 9.5.2
+--------------------------
+**Studio**
+- Add documentation for parent_step_sid field in Step resource
+
+
 [2025-03-20] Version 9.5.1
 --------------------------
 **Accounts**

README.md

@@ -193,6 +193,8 @@ The library automatically handles paging for you. Collections, such as `calls` a
 
 `list` eagerly fetches all records and returns them as a list, whereas `stream` returns an iterator and lazily retrieves pages of records as you iterate over the collection. You can also page manually using the `page` method.
 
+`page_size` as a parameter is used to tell how many records should we get in every page and `limit` parameter is used to limit the max number of records we want to fetch.
+
 #### Use the `list` method
 
 ```python
@@ -206,6 +208,21 @@ for sms in client.messages.list():
   print(sms.to)
 ```
 
+```python
+client.messages.list(limit=20, page_size=20)
+```
+This will make 1 call that will fetch 20 records from backend service.
+
+```python
+client.messages.list(limit=20, page_size=10)
+```
+This will make 2 calls that will fetch 10 records each from backend service.
+
+```python
+client.messages.list(limit=20, page_size=100)
+```
+This  will make 1 call which will fetch 100 records but user will get only 20 records.
+
 ### Asynchronous API Requests
 
 By default, the Twilio Client will make synchronous requests to the Twilio API. To allow for asynchronous, non-blocking requests, we've included an optional asynchronous HTTP client. When used with the Client and the accompanying `*_async` methods, requests made to the Twilio API will be performed asynchronously.

setup.py

@@ -13,7 +13,7 @@
 
 setup(
     name="twilio",
-    version="9.5.1",
+    version="9.5.2",
     description="Twilio API client and TwiML generator",
     author="Twilio",
     help_center="https://www.twilio.com/help/contact",

twilio/__init__.py

@@ -1,2 +1,2 @@
-__version_info__ = ("9", "5", "1")
+__version_info__ = ("9", "5", "2")
 __version__ = ".".join(__version_info__)

twilio/rest/__init__.py

@@ -29,6 +29,7 @@
     from twilio.rest.insights import Insights
     from twilio.rest.intelligence import Intelligence
     from twilio.rest.ip_messaging import IpMessaging
+    from twilio.rest.knowledge import Knowledge
     from twilio.rest.lookups import Lookups
     from twilio.rest.marketplace import Marketplace
     from twilio.rest.messaging import Messaging
@@ -142,6 +143,7 @@ def __init__(
         self._insights: Optional["Insights"] = None
         self._intelligence: Optional["Intelligence"] = None
         self._ip_messaging: Optional["IpMessaging"] = None
+        self._knowledge: Optional["Knowledge"] = None
         self._lookups: Optional["Lookups"] = None
         self._marketplace: Optional["Marketplace"] = None
         self._messaging: Optional["Messaging"] = None
@@ -361,6 +363,19 @@ def ip_messaging(self) -> "IpMessaging":
             self._ip_messaging = IpMessaging(self)
         return self._ip_messaging
 
+    @property
+    def knowledge(self) -> "Knowledge":
+        """
+        Access the Knowledge Twilio Domain
+
+        :returns: Knowledge Twilio Domain
+        """
+        if self._knowledge is None:
+            from twilio.rest.knowledge import Knowledge
+
+            self._knowledge = Knowledge(self)
+        return self._knowledge
+
     @property
     def lookups(self) -> "Lookups":
         """

twilio/rest/knowledge/KnowledgeBase.py

@@ -0,0 +1,44 @@
+r"""
+  This code was generated by
+  ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+   |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+   |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+
+  NOTE: This class is auto generated by OpenAPI Generator.
+  https://openapi-generator.tech
+  Do not edit the class manually.
+"""
+
+from typing import Optional
+
+from twilio.base.domain import Domain
+from twilio.rest import Client
+from twilio.rest.knowledge.v1 import V1
+
+
+class KnowledgeBase(Domain):
+
+    def __init__(self, twilio: Client):
+        """
+        Initialize the Knowledge Domain
+
+        :returns: Domain for Knowledge
+        """
+        super().__init__(twilio, "https://knowledge.twilio.com")
+        self._v1: Optional[V1] = None
+
+    @property
+    def v1(self) -> V1:
+        """
+        :returns: Versions v1 of Knowledge
+        """
+        if self._v1 is None:
+            self._v1 = V1(self)
+        return self._v1
+
+    def __repr__(self) -> str:
+        """
+        Provide a friendly representation
+        :returns: Machine friendly representation
+        """
+        return "<Twilio.Knowledge>"

twilio/rest/knowledge/v1/__init__.py

@@ -0,0 +1,43 @@
+r"""
+    This code was generated by
+   ___ _ _ _ _ _    _ ____    ____ ____ _    ____ ____ _  _ ____ ____ ____ ___ __   __
+    |  | | | | |    | |  | __ |  | |__| | __ | __ |___ |\ | |___ |__/ |__|  | |  | |__/
+    |  |_|_| | |___ | |__|    |__| |  | |    |__] |___ | \| |___ |  \ |  |  | |__| |  \
+
+    Twilio - Knowledge
+    This is the public Twilio REST API.
+
+    NOTE: This class is auto generated by OpenAPI Generator.
+    https://openapi-generator.tech
+    Do not edit the class manually.
+"""
+
+from typing import Optional
+from twilio.base.version import Version
+from twilio.base.domain import Domain
+from twilio.rest.knowledge.v1.knowledge import KnowledgeList
+
+
+class V1(Version):
+
+    def __init__(self, domain: Domain):
+        """
+        Initialize the V1 version of Knowledge
+
+        :param domain: The Twilio.knowledge domain
+        """
+        super().__init__(domain, "v1")
+        self._knowledge: Optional[KnowledgeList] = None
+
+    @property
+    def knowledge(self) -> KnowledgeList:
+        if self._knowledge is None:
+            self._knowledge = KnowledgeList(self)
+        return self._knowledge
+
+    def __repr__(self) -> str:
+        """
+        Provide a friendly representation
+        :returns: Machine friendly representation
+        """
+        return "<Twilio.Knowledge.V1>"