smartsheet-python-sdk 3.7.1__py3-none-any.whl → 3.7.2__py3-none-any.whl

smartsheet/sights.py

@@ -16,8 +16,9 @@
 # under the License.
 
 import logging
+import warnings
 from datetime import datetime
-from typing import Union
+from typing import Optional, Union
 
 from .util import fresh_operation
 from .models import Error, IndexResult, Result, Share, Sight, SightPublish
@@ -33,28 +34,80 @@ class Sights:
         self._log = logging.getLogger(__name__)
 
     def list_sights(
-        self, page_size=None, page=None, include_all=None, modified_since=None
+        self,
+        page_size: Optional[int] = None,
+        page: Optional[int] = None,
+        include_all: Optional[bool] = None,
+        last_key: Optional[str] = None,
+        max_items: Optional[int] = None,
+        pagination_type: Optional[str] = None,
+        modified_since: Optional[datetime] = None
     ) -> Union[IndexResult[Sight], Error]:
         """Get the list of all Sights the User has access to, in alphabetical
         order, by name.
 
         Args:
-            page_size (int): The maximum number of items to
-                return per page.
-            page (int): Which page to return.
-            include_all (bool): If true, include all results
-                (i.e. do not paginate).
-            modified_since(datetime): return sights modified since datetime
+            page_size (int, optional): [DEPRECATED] The maximum number of items to
+                return per page. Use pagination_type='token' with max_items instead.
+            page (int, optional): [DEPRECATED] Which page to return.
+                Use pagination_type='token' with last_key instead.
+            include_all (bool, optional): [DEPRECATED] If true, include all results
+                (i.e. do not paginate). Use pagination_type='token' instead.
+            last_key (str, optional): Pagination cursor for next page (token pagination only).
+            max_items (int, optional): Maximum items per page (token pagination only).
+                Must be a positive integer.
+            pagination_type (str, optional): Use 'token' for efficient cursor-based pagination.
+                Defaults to legacy offset-based pagination if not specified.
+            modified_since (datetime, optional): Return sights modified since datetime.
 
         Returns:
             Union[IndexResult[Sight], Error]: The result of the operation, or an Error object if the request fails.
+                When using legacy pagination, contains paginated results with
+                total_count, total_pages, etc.
+
+        Raises:
+            ValueError: If pagination_type is not 'token' or None, or if max_items <= 0
+                when using token pagination.
         """
+        # Parameter validation
+        if pagination_type is not None and pagination_type not in ['token']:
+            raise ValueError("pagination_type must be 'token' or None")
+        if pagination_type == 'token' and max_items is not None and max_items <= 0:
+            raise ValueError("max_items must be a positive integer")
+
         _op = fresh_operation("list_sights")
         _op["method"] = "GET"
         _op["path"] = "/sights"
-        _op["query_params"]["pageSize"] = page_size
-        _op["query_params"]["page"] = page
-        _op["query_params"]["includeAll"] = include_all
+
+        # Issue deprecation warnings for old parameters when used
+        if page_size is not None:
+            warnings.warn(
+                "page_size parameter is deprecated. Use pagination_type='token' with max_items instead.",
+                DeprecationWarning,
+                stacklevel=2
+            )
+        if page is not None:
+            warnings.warn(
+                "page parameter is deprecated. Use pagination_type='token' with last_key instead.",
+                DeprecationWarning,
+                stacklevel=2
+            )
+        if include_all is not None:
+            warnings.warn(
+                "include_all parameter is deprecated. Use pagination_type='token' instead.",
+                DeprecationWarning,
+                stacklevel=2
+            )
+
+        if pagination_type == "token":
+            _op["query_params"]["lastKey"] = last_key
+            _op["query_params"]["maxItems"] = max_items
+            _op["query_params"]["paginationType"] = pagination_type
+        else:
+            _op["query_params"]["pageSize"] = page_size
+            _op["query_params"]["page"] = page
+            _op["query_params"]["includeAll"] = include_all
+
         if isinstance(modified_since, datetime):
             _op["query_params"]["modifiedSince"] = modified_since.isoformat()
 

smartsheet/smartsheet.py

@@ -38,6 +38,7 @@ from .session import pinned_session
 from .util import is_multipart, serialize
 
 from .attachments import Attachments
+from .cells import Cells
 from .contacts import Contacts
 from .discussions import Discussions
 from .events import Events
@@ -119,6 +120,7 @@ class Smartsheet:
     """Use this to make requests to the Smartsheet API."""
 
     Attachments: Attachments
+    Cells: Cells
     Contacts: Contacts
     Discussions: Discussions
     Events: Events

smartsheet/version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '3.7.1'
-__version_tuple__ = version_tuple = (3, 7, 1)
+__version__ = version = '3.7.2'
+__version_tuple__ = version_tuple = (3, 7, 2)
 
 __commit_id__ = commit_id = None

{smartsheet_python_sdk-3.7.1.dist-info → smartsheet_python_sdk-3.7.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: smartsheet-python-sdk
-Version: 3.7.1
+Version: 3.7.2
 Summary: Library that uses Python to connect to Smartsheet services (using API 2.0).
 License-Expression: Apache-2.0
 Classifier: Development Status :: 5 - Production/Stable

{smartsheet_python_sdk-3.7.1.dist-info → smartsheet_python_sdk-3.7.2.dist-info}/RECORD

@@ -18,14 +18,14 @@ smartsheet/server.py,sha256=_HGk5e6N4y8OceFVFXGaKoilrbSXk0OmnKnFFXfyR7A,1610
 smartsheet/session.py,sha256=TQ3IgVZ64r7Dszwo8rMISFezWxuwFYshhW9QhzoA428,2125
 smartsheet/sharing.py,sha256=N0FxpfFINjQ-cb6-zGnAy-a1ViM1YDIMzF1LWJ1hyNY,6623
 smartsheet/sheets.py,sha256=V_rgks6duwUu0mggn-uCse0AyADkHSiS4LXJMKlEW1s,79143
-smartsheet/sights.py,sha256=F5lQ1lowQFq1yIr3aD6GUH_BJ2b-krbOU2CjU1xH-cg,13254
-smartsheet/smartsheet.py,sha256=qvDHQmUUjiJzDxb5Tot9SUS3toCcHpdvcXd1xWzkSgk,25405
+smartsheet/sights.py,sha256=08HNkZzbNw2MvrEqTnFvqnHglv61bZDjYwXs43O_Ekw,15787
+smartsheet/smartsheet.py,sha256=8ESvLqmgfGozE1aQRnmC26oqPuNVL4AYISV7z7IA8gU,25447
 smartsheet/templates.py,sha256=LgFisxV1yU6OuUcxg8dKo-otG2eATMTwxE4tTfLDJDU,3245
 smartsheet/token.py,sha256=NDej84rGP55yOgkrtgAggL1F0HN3zFH9Xw0r2z-To7s,5128
 smartsheet/types.py,sha256=aIdRJ89jwclmiZ4RH3hnZHJTFWFxgNKW3d8fghm21eM,9126
 smartsheet/users.py,sha256=R5ssS7n-rJihyRexqCTZxiY3au8VmWlYwFf_eQMi1d0,21611
 smartsheet/util.py,sha256=-eNjczPYtmtlnSF28z1lUdb6X_DLsHFPSqG1AJpvj8c,6157
-smartsheet/version.py,sha256=9MjBMdn1ZPGLj9feYeo3MHJ_MYQCg5VstClhojAgSI8,704
+smartsheet/version.py,sha256=U56HPfvEIuf7OLsDIujfkDm-48o-vtgN9ELCjYsmg1s,704
 smartsheet/webhooks.py,sha256=pihpwFJ-IY8RRwWPlNZN71hdM6IsvzAoOzjSTqMGSi0,5492
 smartsheet/workspaces.py,sha256=4l2VH4ojvE8Mr5Mnm5xVmSWgk4owJ37eQqA5oE0IocE,25100
 smartsheet/models/__init__.py,sha256=wJter68K1D2T3Noq4r7SooPhahtdkJBKIrrUwJxymNQ,4860
@@ -187,9 +187,9 @@ smartsheet/models/enums/system_column_type.py,sha256=UfhNUBGD_0K1Pas7fujGEuax55O
 smartsheet/models/enums/update_request_status.py,sha256=xYF84x1dTFhJMYVi1q3G1T9u1IGN3szlR1jj5HHC0hE,777
 smartsheet/models/enums/user_status.py,sha256=SB7qRcA0dhdRimsOKHCGF3CB6fL0XuifxQEWZGNNS8Q,766
 smartsheet/models/enums/widget_type.py,sha256=VfVq59fLZsT4ks_ZBrtv52u2Cl60iAdlA6mGD_elz-k,1072
-smartsheet_python_sdk-3.7.1.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-smartsheet_python_sdk-3.7.1.dist-info/licenses/NOTICE,sha256=mXr2ryVjnCjykeW0J79kFfVXQG_Z9SV4BV_QPNENW1U,420
-smartsheet_python_sdk-3.7.1.dist-info/METADATA,sha256=8As266VqLAGOJlzNpzmODXfCZ3Y4urJ3a-HPcMY3II8,5618
-smartsheet_python_sdk-3.7.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-smartsheet_python_sdk-3.7.1.dist-info/top_level.txt,sha256=kozWEYiKjyJmSXzd6p5ugkQ5bhoHS9V3NnvLagUfcNw,11
-smartsheet_python_sdk-3.7.1.dist-info/RECORD,,
+smartsheet_python_sdk-3.7.2.dist-info/licenses/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+smartsheet_python_sdk-3.7.2.dist-info/licenses/NOTICE,sha256=mXr2ryVjnCjykeW0J79kFfVXQG_Z9SV4BV_QPNENW1U,420
+smartsheet_python_sdk-3.7.2.dist-info/METADATA,sha256=QUH-3fsmyGvlmBTQ5uyTGarnTEZCsjHr6Qw5bhz_x24,5618
+smartsheet_python_sdk-3.7.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+smartsheet_python_sdk-3.7.2.dist-info/top_level.txt,sha256=kozWEYiKjyJmSXzd6p5ugkQ5bhoHS9V3NnvLagUfcNw,11
+smartsheet_python_sdk-3.7.2.dist-info/RECORD,,

{smartsheet_python_sdk-3.7.1.dist-info → smartsheet_python_sdk-3.7.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any