smartsheet-python-sdk 3.5.1__py2.py3-none-any.whl → 3.5.2__py2.py3-none-any.whl

smartsheet/models/__init__.py

@@ -122,3 +122,4 @@ from .widget import Widget
 from .widget_content import WidgetContent
 from .workspace import Workspace
 from .user_plan import UserPlan
+from .asset_shares_paginated_result import AssetSharesPaginatedResult

smartsheet/models/asset_shares_paginated_result.py

@@ -0,0 +1,84 @@
+# pylint: disable=C0111,R0902,R0904,R0912,R0913,R0915,E1101
+# Smartsheet Python SDK.
+#
+# Copyright 2018 Smartsheet.com, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License"): you may
+# not use this file except in compliance with the License. You may obtain
+# a copy of the License at
+#
+#    http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+# License for the specific language governing permissions and limitations
+# under the License.
+
+from __future__ import absolute_import
+
+from typing import TypeVar, List
+from ..types import String, json, TypedList, importlib
+from ..util import deserialize, serialize
+from . import Share
+
+T = TypeVar('T')
+
+
+class AssetSharesPaginatedResult:
+    """Smartsheet AssetSharesPaginatedResult data model with generic type support.
+    Use only for deserializing the response from GET /2.0/shares.
+    Created because GET /2.0/shares returns items in the response body instead of data.
+    As a result TokenPaginatedResult cannot be used.
+    """
+
+    def __init__(self, props=None, dynamic_data_type=None, base_obj=None):
+        """Initialize the TokenPaginatedResult model."""
+        self._base = None
+        if base_obj is not None:
+            self._base = base_obj
+
+        self._dynamic_data_type = None
+        if dynamic_data_type is not None:
+            self._dynamic_data_type = dynamic_data_type
+
+        self._items = TypedList(object)
+        self._last_key = String()
+
+        if props:
+            deserialize(self, props)
+
+        self.request_response = None
+        self.__initialized = True
+
+    @property
+    def items(self) -> List[Share]:
+        return self._items
+
+    @items.setter
+    def items(self, value):
+        class_ = getattr(
+            importlib.import_module("smartsheet.models"), self._dynamic_data_type
+        )
+        if isinstance(value, list):
+            self._items = [class_(x, self._base) for x in value]
+        else:
+            self._items = class_(value, self._base)
+
+
+    @property
+    def last_key(self):
+        return self._last_key.value
+
+    @last_key.setter
+    def last_key(self, value):
+        self._last_key.value = value
+
+    def to_dict(self):
+        return serialize(self)
+
+    def to_json(self):
+        return json.dumps(self.to_dict())
+
+    def __str__(self):
+        return self.to_json()

smartsheet/sharing.py

@@ -43,7 +43,7 @@ class Sharing:
             sharing_include (ShareScope): Scope of share to include in response
 
         Returns:
-            IndexResult
+            AssetSharesPaginatedResult
         """
         _op = fresh_operation('list_asset_shares')
         _op['method'] = 'GET'
@@ -54,7 +54,7 @@ class Sharing:
         _op['query_params']['lastKey'] = last_key
         _op['query_params']['sharingInclude'] = sharing_include.name if sharing_include else None
 
-        expected = ['IndexResult', 'Share']
+        expected = ['AssetSharesPaginatedResult', 'Share']
 
         prepped_request = self._base.prepare_request(_op)
         response = self._base.request(prepped_request, expected, _op)
@@ -132,7 +132,7 @@ class Sharing:
         _op['query_params']['assetId'] = asset_id
         _op['json'] = share_obj
 
-        expected = ['Result', 'Share']
+        expected = 'Share'
 
         prepped_request = self._base.prepare_request(_op)
         response = self._base.request(prepped_request, expected, _op)

smartsheet/smartsheet.py

@@ -185,6 +185,8 @@ class Smartsheet:
         self._api_base = api_base
         self._assume_user = None
         self._test_scenario_name = None
+        self._wiremock_test_name = None
+        self._wiremock_request_id = None
         self._change_agent = None
 
     def assume_user(self, email=None):
@@ -227,6 +229,18 @@ class Smartsheet:
         """
         self._test_scenario_name = name
 
+    def with_wiremock_test_case(self, test_name: str, request_id: str):
+        """
+        Configure client with x-test-name and x-request-id headers.
+        Used for wiremock test cases.
+
+        Args:
+            test_name (str): The name of the wiremock test case.
+            request_id (str): The unique request ID for this test scenario.
+        """
+        self._wiremock_test_name = test_name
+        self._wiremock_request_id = request_id
+
     def with_change_agent(self, change_agent):
         """
         Request headers will contain the 'Smartsheet-Change-Agent' header value
@@ -437,6 +451,9 @@ class Smartsheet:
                 del prepped_request.headers["Api-Scenario"]
             except KeyError:
                 pass
+        if self._wiremock_test_name is not None and self._wiremock_request_id is not None:
+            prepped_request.headers["X-Test-Name"] = self._wiremock_test_name
+            prepped_request.headers["X-Request-ID"] = self._wiremock_request_id
 
         if self._change_agent is not None:
             prepped_request.headers.update(

smartsheet/version.py

@@ -1,4 +1,4 @@
 # file generated by setuptools_scm
 # don't change, don't track in version control
-__version__ = version = '3.5.1'
-__version_tuple__ = version_tuple = (3, 5, 1)
+__version__ = version = '3.5.2'
+__version_tuple__ = version_tuple = (3, 5, 2)

{smartsheet_python_sdk-3.5.1.dist-info → smartsheet_python_sdk-3.5.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: smartsheet-python-sdk
-Version: 3.5.1
+Version: 3.5.2
 Summary: Library that uses Python to connect to Smartsheet services (using API 2.0).
 Home-page: http://smartsheet-platform.github.io/api-docs/
 Author: Smartsheet

{smartsheet_python_sdk-3.5.1.dist-info → smartsheet_python_sdk-3.5.2.dist-info}/RECORD

@@ -16,22 +16,23 @@ smartsheet/reports.py,sha256=0B5bdQwVJHwu-V04aMSJ-Y7HaILK4rgjjMtn0--kcig,12835
 smartsheet/search.py,sha256=ffy1dkVl3GtuYgCxvuR-vwahOBWIehGv_zwzLoJMimA,3394
 smartsheet/server.py,sha256=9wySsa_y_G-VO88tEHGHp919zRVFS0kCFIhiM6crWEU,1429
 smartsheet/session.py,sha256=TQ3IgVZ64r7Dszwo8rMISFezWxuwFYshhW9QhzoA428,2125
-smartsheet/sharing.py,sha256=ztkh5uQOLKHT2AkjRnm_3yDRbFFUzNdBSCZbL5FhLVA,5839
+smartsheet/sharing.py,sha256=vonbDFD5nXrhcRTjTdBmZVZs4TB1BWVk2eOJslydmUE,5857
 smartsheet/sheets.py,sha256=2SUhanCsRFKCsbN-oAIRMsuYnk1aSFlXKzfZhxMo7d0,70603
 smartsheet/sights.py,sha256=IZgy8CJZBJ-pQo6vNwkDSBuoLCv5RAW39kNUMMNJ-oc,11569
-smartsheet/smartsheet.py,sha256=1E08a6cvfsFTJZ9RcKoapJyHEKMHN-ZnvvTeS0EeJtc,23673
+smartsheet/smartsheet.py,sha256=bx5uAH6sH5SXBui2XILuNsFo06lnc8Z8_eo1Uzzd6as,24454
 smartsheet/templates.py,sha256=z_Tj-4jZsu3RkLNbCAZWM2W05Zbio9T_uyU33rUPxzE,2898
 smartsheet/token.py,sha256=5uz-IG5adx_zr2-uepH-W8ATv0dq9aZNjYLeZNwldqI,4703
 smartsheet/types.py,sha256=aIdRJ89jwclmiZ4RH3hnZHJTFWFxgNKW3d8fghm21eM,9126
 smartsheet/users.py,sha256=1KnqKJIzJEPMNy26BQY1b9jb3dItbzglrljV1MGD5ic,15887
 smartsheet/util.py,sha256=12Y6eluecB8k4Ns-at81AEM18ND2TCKa9bF4BlNRrKM,5633
-smartsheet/version.py,sha256=5Ls--dDSIb4Gb1CckUN1UCuP27ISasaw5cQluvYJUYU,160
+smartsheet/version.py,sha256=OQ0f_DFwVp2oC6nqaYeOMvAmplmRtX58iNhel24HEag,160
 smartsheet/webhooks.py,sha256=7F7g4Ks0GyS3QxsNWm1SFtrOr00jBisCjj7-hcToHM8,4637
 smartsheet/workspaces.py,sha256=r81xh3HfYsX--ll5pQ-h7kSSJELokYV-bSjuD0WloeU,22651
-smartsheet/models/__init__.py,sha256=4P6wKY8TpbV_rI5Z5c1ifxiwJEWL5bsvecVcjtUSJ9U,4754
+smartsheet/models/__init__.py,sha256=lH951xll0kO3GA6CrgW4UgMOcXu2x7BjvZBFQfpgqKY,4824
 smartsheet/models/access_token.py,sha256=sKHL5cFRWPTjymX06ZIXaCDp8ZJQEVpXN8mns1DAvGM,2564
 smartsheet/models/account.py,sha256=nLg_5O4Vnc7aNf9p1kIcsgdAm23IC2H7cKkxjLxwS9U,1941
 smartsheet/models/alternate_email.py,sha256=n8zqWkY-uzSw_CVKBvYUc6pGSR0v4yTx8S5PaIiX_AU,2263
+smartsheet/models/asset_shares_paginated_result.py,sha256=kSee44-T_7hn-hz7kgKAVAa6vFs06IhFQ7AIpohe7WE,2531
 smartsheet/models/attachment.py,sha256=5DgnZ4fj19rtIgN3INqlP0zYh8JNa0DRleeAS52tQ2o,4684
 smartsheet/models/auto_number_format.py,sha256=LRNIkasbspWKJFg0hwMvhSe4HmuuNRrvH_jerCbKooM,2091
 smartsheet/models/automation_action.py,sha256=_1cb_ubhR4Xx56UNGi3dLXdfoBkA7oyjDWu2wA98p-Q,4526
@@ -185,9 +186,57 @@ 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.5.1.dist-info/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-smartsheet_python_sdk-3.5.1.dist-info/METADATA,sha256=Da7bdcVnu2Z36izClrsFZtvMOLOPG6Jj3uozESGld3o,4734
-smartsheet_python_sdk-3.5.1.dist-info/NOTICE,sha256=mXr2ryVjnCjykeW0J79kFfVXQG_Z9SV4BV_QPNENW1U,420
-smartsheet_python_sdk-3.5.1.dist-info/WHEEL,sha256=Kh9pAotZVRFj97E15yTA4iADqXdQfIVTHcNaZTjxeGM,110
-smartsheet_python_sdk-3.5.1.dist-info/top_level.txt,sha256=kozWEYiKjyJmSXzd6p5ugkQ5bhoHS9V3NnvLagUfcNw,11
-smartsheet_python_sdk-3.5.1.dist-info/RECORD,,
+tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/integration/README.md,sha256=URfm5x5IdE---oMkO3vMePPJ8ZdESJTvPzMdjzv6TnY,1352
+tests/integration/conftest.py,sha256=8YxuffY8hOZ1NtU7mw95-H6i5wcChxJIketxIO6OrD0,5275
+tests/integration/test_attachments.py,sha256=3MxrAa05CRCgPqNu2W5m0Arum1oJAdEO7LhBwhF0q80,3631
+tests/integration/test_columns.py,sha256=noHTyMKjq8vMIgkh033YQEkXiY52nxAmp-Mto36Jv4E,2951
+tests/integration/test_contacts.py,sha256=uN3qSeuhId0x5MinvsKXgRyPaDHL1NLH7CccXWtZ4FY,910
+tests/integration/test_cross_sheet_references.py,sha256=RqiTayGNlIXLqNT3OQbk3zcCcX4HlLnKwTJbSDNb_OE,1330
+tests/integration/test_discussions.py,sha256=9ltns9SN73be0WVGi38PCLzwKLX5qxmbHP7mmDgBiEg,7370
+tests/integration/test_events.py,sha256=pMMoywNP1xDiGkCJm0ImM2p2jYN0buB6PLP4R4xP_7c,2582
+tests/integration/test_favorites.py,sha256=NhoqXhcZu2vNkXex3ZaSXSPOdMPx-AyMztu3_6NUjcM,1130
+tests/integration/test_folders.py,sha256=2ZoMCerrIkx9IGd7izhDORDy2RjeGyGenFkGZrLzZlY,5200
+tests/integration/test_groups.py,sha256=vWwreXgiuxlOolD0MgNKHn2ANTH3avuLH7U6xZlkvUQ,2846
+tests/integration/test_home.py,sha256=a95auUi1rggg2oS6dXxyL5GgEr0VvYfv9RrmM0NbDpk,3449
+tests/integration/test_model_attributes.py,sha256=vcF89w8E6x3Ir5WnUqNwyM6Zp2wDFfkEm1ZOkHdnxlE,100219
+tests/integration/test_multi_picklist.py,sha256=xHlbxtpmk_vTwisJ57M6U3bMeQtnea2KVC5YwO48SXs,2537
+tests/integration/test_object_value.py,sha256=mCmFwGoN0t3D8wXiZ63dzlPDPciWtSUDNVUYhpBFEBc,4224
+tests/integration/test_passthrough.py,sha256=vRg9OTBb-y7u5p25fjYnQSKGbSZcanSzReesaVqwYEc,1603
+tests/integration/test_regression.py,sha256=KOMP6vqAVFrN_UCAKD90V3s0eGpWSsUxxphHRFBOAFs,8208
+tests/integration/test_reports.py,sha256=37iTenbbnCP0p2I9UzbQoWwjF4eFFGrBRlSnop0N1FQ,4712
+tests/integration/test_rows.py,sha256=MNzLZOHSBZGWslC8peuD9p_dQ9Jj_V3QHN6C16u4BJY,7596
+tests/integration/test_server_info.py,sha256=atoRjGEFwbja51wyui_5-CeiK27-xLTvQXl4-nUA810,268
+tests/integration/test_sharing.py,sha256=XuMCybgDyZaudEiomOV-XbP-kLY8lY4xfp7Uc-gYREY,2694
+tests/integration/test_sheet_summary.py,sha256=siRtHTZVLaCV3dDrcpApXHLSWmnpncQdMm7OTlk_f6s,3357
+tests/integration/test_sheets.py,sha256=hL5C_hs8y2FyoGBaKcQDsll2RCQeqdFQoGGcDc9BFyQ,14531
+tests/integration/test_templates.py,sha256=vbgxkPkO0DzZ4AfA5wecUKYLQ7Dm_Qux7HB7TxQmWvQ,799
+tests/integration/test_update_requests.py,sha256=Qx-jRLCbTnoJG48J98OzB7g8f8IRmNISiqQNwsArZo4,2726
+tests/integration/test_users.py,sha256=SLWU0D-QfCAp3ymgBoySq_8svet5L31H7WCH9eBaQ5w,4609
+tests/integration/test_webhooks.py,sha256=5pDyfv3BREscXHk7AUOrLDlvsQIZHvPcW6dvZfVI2Hg,1901
+tests/integration/test_workspaces.py,sha256=Xn7mAi0dOIPHZE7Qnff1K16X1FYTc7CbdYims8NIEus,11202
+tests/integration/test_zsearch.py,sha256=fUCCYO25dfX_aby6VVJVpGWsI_-9c-dO__cnRmcPAfI,1101
+tests/integration/fixtures/calling_all_curs.txt,sha256=w6y8iLcnN7Cr2qzTW85n-Y0piB7TWNCJBzYBeC85gNM,61
+tests/integration/fixtures/curly.jpg,sha256=EAgX6jplNdLuy12xTPR_IUO8aBd4FH0wBojP_j8qnKo,17988
+tests/integration/fixtures/moe-curly.jpg,sha256=GeM6RLaXEaAU92RC7pP6kCoO84VPS72qB3Al2reZ9-4,65440
+tests/integration/fixtures/quote.txt,sha256=mC4gL6QbbtpBUXDJHUV7JJNbe0lZRDehuhi05ejYBKk,20
+tests/integration/fixtures/stooges_v1.jpg,sha256=6_FT9q2QK9yxymbhS5c_e8gx6PQnwXj2Z83X47ZP9hc,90832
+tests/integration/fixtures/stooges_v2.jpg,sha256=MSUu7Uh2rTjlnjXgvQFn4s8hErUD5AqbyO0AzMfntJg,30550
+tests/mock_api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/mock_api/mock_api_test_helper.py,sha256=6Kmp0yrA68gOTItiHEhHYhqh3LpGnqV_5O3DNgw2tdY,2191
+tests/mock_api/test_mock_api_automation_rules.py,sha256=tEsSkFRF9frJciXD7y_A3T1QF5NFLb6HUC_34Q4gcDc,1609
+tests/mock_api/test_mock_api_columns.py,sha256=9-jvgluH5hWyNEKgfPIB5nPtW40KjD6Q7GUr-EzcMis,1490
+tests/mock_api/test_mock_api_folders.py,sha256=MUDeVv0rn5vAs6GDtrKfIaap-jBO-syoy5MBb2vYJ0E,6755
+tests/mock_api/test_mock_api_rows.py,sha256=2xNqQsvqnk4T_dsWrmu1BPVhNvTlb_gffClaz_LIbpg,20972
+tests/mock_api/test_mock_api_sharing.py,sha256=6psgcUXvc2nCq3OS1M9-pQ0YJZmhVDs2pCYAmvgzF_U,15085
+tests/mock_api/test_mock_api_sheets.py,sha256=61mhb0iUnR8j4_5XTrfI9aQHOGGX3RTc3tGsn8G0V2k,1225
+tests/mock_api/test_mock_api_sights.py,sha256=UazPkjGu2UnT_dRz189v1DMhMBDeTRKtWxux6aYao2k,2203
+tests/mock_api/test_mock_api_workspaces.py,sha256=8QzRrkRoenCCD5tB5crmpGzXNmSP9kLjEUU046DJ1AE,9419
+tests/mock_api/test_mock_change_agent.py,sha256=WDd6MKERhqGQJ3QrTQK5ylXMhZ65o5vnhscBlisFjoM,757
+tests/mock_api/test_mock_serialization.py,sha256=0veKtirhYve8BZL8M3yPuREpw-a8TzYK7tH7aLD7LqQ,18174
+smartsheet_python_sdk-3.5.2.dist-info/LICENSE.md,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+smartsheet_python_sdk-3.5.2.dist-info/METADATA,sha256=tbNMz9R8y4hJo70xPGAQv2bWvOtLz_WojhK0Wv_A-hs,4734
+smartsheet_python_sdk-3.5.2.dist-info/NOTICE,sha256=mXr2ryVjnCjykeW0J79kFfVXQG_Z9SV4BV_QPNENW1U,420
+smartsheet_python_sdk-3.5.2.dist-info/WHEEL,sha256=Kh9pAotZVRFj97E15yTA4iADqXdQfIVTHcNaZTjxeGM,110
+smartsheet_python_sdk-3.5.2.dist-info/top_level.txt,sha256=ACM1Ryc7rQRwrJIuN7H4aEMO-wUGjiYQshvRPoiOYT4,17
+smartsheet_python_sdk-3.5.2.dist-info/RECORD,,

{smartsheet_python_sdk-3.5.1.dist-info → smartsheet_python_sdk-3.5.2.dist-info}/top_level.txt

@@ -1 +1,2 @@
 smartsheet
+tests

tests/integration/README.md

@@ -0,0 +1,37 @@
+# smartsheet-python-sdk unit tests
+
+## Setup
+
+From the root directory of this repository:
+
+```python
+    python setup.py develop
+```
+
+## Running the tests
+
+Again, from the root directory of this repository:
+
+```python
+    python setup.py test
+```
+
+## Requirements
+
+Some tests carry requirements. We're testing the real service here, not just using mocks. In order to do that, some configuration is necessary for some tests.
+
+The test suite expects these environment variables to be present:
+
+```shell
+    export SMARTSHEET_ACCESS_TOKEN="SSSSSSSSSSSSSSSSSSSSSSSSSS"
+    export LOG_CFG="debug" # optional
+    export SMARTSHEET_FIXTURE_USERS='{"admin":{"id":9999999999999999},"larry":{"id":0000000000000000},"curly":{"id":1111111111111111},"moe":{"id":2222222222222222}}'
+```
+
+**Please note:** the user nicknames (admin, larry, curly, moe) are not essential. However, valid IDs of users within the Smartsheet organization the access token belongs to are required.
+
+In addition, reports tests will be skipped unless there is a report within the organization. The report will not be modified or deleted, but must exist in order to acceptance-test the API methods pertaining to Reports.
+
+The `admin` user needs at least one Contact.
+
+Finally, the user corresponding to `moe` needs to be a Licensed User. `larry` and `curly` do not need to be Licensed Users.

tests/integration/conftest.py

@@ -0,0 +1,174 @@
+import pytest
+import smartsheet
+from datetime import datetime
+from dateutil.tz import *
+import json
+import os
+import six
+
+
+@pytest.fixture(scope="module")
+def smart_setup(request):
+    # set up a test session folder with basic starting points
+    smart = smartsheet.Smartsheet(max_retry_time=60)
+    now = datetime.now(tzlocal()).strftime("%Y-%m-%d %H:%M:%S")
+
+    users = os.environ.get('SMARTSHEET_FIXTURE_USERS', None)
+    if users is None:
+        pytest.exit('Environment not setup correctly...aborting')
+
+    users = json.loads(users)
+    fixusers = {}
+    for nick,info in six.iteritems(users):
+        profile = smart.Users.get_user(info['id'])
+        assert isinstance(profile, smart.models.UserProfile)
+        fixusers[nick] = profile
+    action = smart.Groups.list_groups(include_all=True)
+    assert isinstance(action, smart.models.IndexResult)
+    grps = action.result
+    groups = {}
+    need_exec = True
+    for gp in grps:
+        groups[gp.name] = gp
+        if gp.name == 'exec':
+            need_exec = False
+
+    if need_exec:
+        group = smart.models.Group({
+            'name': 'exec',
+            'members': [
+                smart.models.GroupMember({
+                    'email': fixusers['moe'].email
+                }),
+                smart.models.GroupMember({
+                    'email': fixusers['admin'].email
+                })
+            ]
+        })
+        action = smart.Groups.create_group(group)
+        assert action.message == 'SUCCESS'
+
+    # test run base folders
+    folder_name = 'pytest ' + now
+    action = smart.Home.create_folder(folder_name)
+    assert action.message == 'SUCCESS'
+    test_folder = action.result
+
+    # add a sheet to mess around with
+    sheet = smart.models.Sheet({
+        'name': 'pytest_fixture_sheet ' + now,
+        'columns': [{
+            'title': 'The First Column',
+            'primary': True,
+            'type': 'TEXT_NUMBER'
+        }, {
+            'title': 'Favorite',
+            'type': 'CHECKBOX',
+            'symbol': 'STAR'
+        }, {
+            'title': 'Disposable',
+            'type': 'TEXT_NUMBER'
+        }]
+    })
+    action = smart.Folders.create_sheet_in_folder(test_folder.id, sheet)
+    assert action.message == 'SUCCESS'
+    sheet = action.result
+
+    # get primary column id
+    for idx, col in enumerate(sheet.columns):
+        if col.primary:
+            break
+    sheet_primary_col = col
+
+    # add a row
+    action = sheet.add_rows([smart.models.Row({
+        'to_top': True,
+        'cells': [{
+            'column_id': sheet_primary_col.id,
+            'value': 'The first column of the first row.'
+        }]
+    })])
+    assert action.message == 'SUCCESS'
+
+    sheet = smart.Sheets.get_sheet(sheet.id)
+    assert isinstance(sheet, smart.models.Sheet)
+
+    sheet_b = smart.models.Sheet({
+        'name': 'pytest_fixture_sheetB ' + now,
+        'columns': [{
+            'title': 'Brand',
+            'primary': True,
+            'type': 'TEXT_NUMBER'
+        }]
+    })
+    action = smart.Folders.create_sheet_in_folder(test_folder.id, sheet_b)
+    assert action.message == 'SUCCESS'
+    sheet_b = action.result
+    for idx, col in enumerate(sheet_b.columns):
+        if col.primary:
+            break
+    sheet_b_primary_col = col
+
+    action = sheet_b.add_rows([
+        smart.models.Row({
+            'to_top': True,
+            'cells': [{
+                'column_id': sheet_b_primary_col.id,
+                'value': 'Nike'
+            }]
+        }),
+        smart.models.Row({
+            'to_top': True,
+            'cells': [{
+                'column_id': sheet_b_primary_col.id,
+                'value': 'Google'
+            }]
+        }),
+        smart.models.Row({
+            'to_top': True,
+            'cells': [{
+                'column_id': sheet_b_primary_col.id,
+                'value': 'Adidas'
+            }]
+        }),
+        smart.models.Row({
+            'to_top': True,
+            'cells': [{
+                'column_id': sheet_b_primary_col.id,
+                'value': 'Keen'
+            }]
+        })])
+    assert action.message == 'SUCCESS'
+
+    sheet_b = smart.Sheets.get_sheet(sheet_b.id)
+    assert isinstance(sheet_b, smart.models.Sheet)
+
+    fixture = {
+        'smart': smart,
+        'folder': test_folder,
+        'sheet': sheet,
+        'sheet_primary_col': sheet_primary_col,
+        'sheet_b': sheet_b,
+        'sheet_b_primary_col': sheet_b_primary_col,
+        'now': now,
+        'users': fixusers,
+        'groups': groups
+    }
+
+    def smart_teardown():
+        action = fixture['smart'].Sheets.delete_sheet(fixture['sheet'].id)
+        assert action.message == 'SUCCESS'
+        print("deleted fixture sheet")
+        action = fixture['smart'].Sheets.delete_sheet(fixture['sheet_b'].id)
+        assert action.message == 'SUCCESS'
+        print("deleted fixture sheet_b")
+        action = fixture['smart'].Folders.delete_folder(fixture['folder'].id)
+        assert action.message == 'SUCCESS'
+        print("deleted fixture folder")
+        if 'folder_b' in fixture:
+            action = fixture['smart'].Folders.delete_folder(fixture['folder_b'].id)
+            assert action.message == 'SUCCESS'
+            print("deleted fixture folder_b")
+
+    request.addfinalizer(smart_teardown)
+    return fixture

tests/integration/fixtures/calling_all_curs.txt

@@ -0,0 +1 @@
+Curly: "Hmmm, n'yuk, n'yuk, n'yuk. He must be a Pointsetter!"

tests/integration/fixtures/quote.txt

@@ -0,0 +1 @@
+n'yuk, n'yuk, n'yuk!

tests/integration/test_attachments.py

@@ -0,0 +1,99 @@
+import pytest
+import os.path
+
+_dir = os.path.dirname(os.path.abspath(__file__))
+
+@pytest.mark.usefixtures("smart_setup")
+class TestAttachments:
+    row_url_attachment = None
+    sheet_file_attachment = None
+
+    # SEE TestDiscussions for this test
+    # def test_attach_url_to_comment(self, smart_setup):
+    #     smart = smart_setup['smart']
+
+    def test_attach_url_to_sheet(self, smart_setup):
+        smart = smart_setup['smart']
+        url = smart.models.Attachment({
+            'name': 'find stuff',
+            'description': 'Maybe you have heard of this.',
+            'url': 'http://www.google.com/',
+            'attachment_type': 'LINK'
+        })
+        action = smart_setup['sheet_b'].attach_url(url)
+        assert action.message == 'SUCCESS'
+
+    def test_attach_url_to_row(self, smart_setup):
+        smart = smart_setup['smart']
+        url = smart.models.Attachment({
+            'name': 'find stuff',
+            'description': 'Maybe you have heard of this.',
+            'url': 'http://www.google.com/',
+            'attachment_type': 'LINK'
+        })
+        action = smart.Attachments.attach_url_to_row(
+            smart_setup['sheet_b'].id,
+            smart_setup['sheet_b'].rows[0].id,
+            url
+        )
+        assert action.message == 'SUCCESS'
+        TestAttachments.row_url_attachment = action.result
+
+    def test_attach_file_to_sheet(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.attach_file_to_sheet(
+            smart_setup['sheet_b'].id,
+            ('stooges.jpg', open(_dir + '/fixtures/stooges_v1.jpg', 'rb'), 'image/jpeg')
+        )
+        assert action.message == 'SUCCESS'
+        TestAttachments.sheet_file_attachment = action.result
+
+    def test_list_all_attachments(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.list_all_attachments(
+            smart_setup['sheet_b'].id
+        )
+        assert action.total_count > 0
+
+    def test_attach_new_version(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.attach_new_version(
+            smart_setup['sheet_b'].id,
+            TestAttachments.sheet_file_attachment.id,
+            ('stooges.jpg', open(_dir + '/fixtures/stooges_v2.jpg', 'rb'), 'image/jpeg')
+        )
+        assert action.message == 'SUCCESS'
+
+    def test_list_attachment_versions(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.list_attachment_versions(
+            smart_setup['sheet_b'].id,
+            TestAttachments.sheet_file_attachment.id
+        )
+        assert action.total_count > 0
+        vlist = action.result
+        assert isinstance(action.result[0], smart.models.attachment.Attachment)
+
+    def test_delete_attachment(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.delete_attachment(
+            smart_setup['sheet_b'].id,
+            TestAttachments.row_url_attachment.id
+        )
+        assert action.message == 'SUCCESS'
+
+    def test_get_attachment(self, smart_setup):
+        smart = smart_setup['smart']
+        file = smart.Attachments.get_attachment(
+            smart_setup['sheet_b'].id,
+            TestAttachments.sheet_file_attachment.id
+        )
+        assert file.name == 'stooges.jpg'
+
+    def test_delete_attachment_versions(self, smart_setup):
+        smart = smart_setup['smart']
+        action = smart.Attachments.delete_attachment_versions(
+            smart_setup['sheet_b'].id,
+            TestAttachments.sheet_file_attachment.id
+        )
+        assert action.message == 'SUCCESS'