smartsheet-python-sdk 3.7.1__tar.gz → 3.7.2__tar.gz

{smartsheet_python_sdk-3.7.1 → smartsheet_python_sdk-3.7.2}/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [x.x.x] - Unreleased
 
+## [3.7.2] - 2026-01-29
+
+### Added
+
+- Add `Cells` class to `Smartsheet` class for IDE autocomplete support. Now auto-complete like `smart.Cells.get_cell_history()` and `smart.Cells.add_image_to_cell()` will work.
+
 ## [3.7.1] - 2025-12-12
 
 ### Fixed

{smartsheet_python_sdk-3.7.1/smartsheet_python_sdk.egg-info → smartsheet_python_sdk-3.7.2}/PKG-INFO

@@ -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 → smartsheet_python_sdk-3.7.2}/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_python_sdk-3.7.1 → smartsheet_python_sdk-3.7.2}/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_python_sdk-3.7.1 → smartsheet_python_sdk-3.7.2}/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 = 'gb407d36d8'
+__commit_id__ = commit_id = 'g76a2ad575'

{smartsheet_python_sdk-3.7.1 → smartsheet_python_sdk-3.7.2/smartsheet_python_sdk.egg-info}/PKG-INFO

@@ -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