Metadata-Version: 2.0
Name: smartsheet-python-sdk
Version: 1.2.1
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
Author-email: api@smartsheet.com
License: Apache-2.0
Keywords: Smartsheet,Collaboration,Project Management,Excel,spreadsheet
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
Requires-Dist: certifi
Requires-Dist: python-dateutil
Requires-Dist: requests
Requires-Dist: requests-toolbelt
Requires-Dist: six (>=1.9)
Provides-Extra: develop
Requires-Dist: coverage; extra == 'develop'
Requires-Dist: coveralls[yaml]; extra == 'develop'
Requires-Dist: pytest; extra == 'develop'
Requires-Dist: pytest-instafail; extra == 'develop'
Provides-Extra: test
Requires-Dist: coverage; extra == 'test'
Requires-Dist: coveralls; extra == 'test'
Requires-Dist: pytest; extra == 'test'

|Build Status| |Coverage Status|

Smartsheet Python SDK
=====================

This library is intended to simplify connecting to the `Smartsheet
API <http://smartsheet-platform.github.io/api-docs/>`__ from Python
applications.

System Requirements
-------------------

The SDK currently supports Python 2.7, 3.3, 3.4, 3.5, 3.6, pypy, and pypy3.
The following packages are required.

-  `requests <https://pypi.python.org/pypi/requests>`__
-  `requests-toolbelt <https://pypi.python.org/pypi/requests-toolbelt>`__
-  `six <https://pypi.python.org/pypi/six>`__
-  `certifi <https://pypi.python.org/pypi/certifi>`__
-  `python-dateutil <https://pypi.python.org/pypi/python-dateutil>`__

Installation
------------

The SDK can be installed by using a package manager (pip) or manually by
downloading the SDK directly from Git. These two steps are outlined
below.

Install with pip
~~~~~~~~~~~~~~~~

If unfamiliar with pip, please review the `pip
documentation <http://www.pip-installer.org/>`__.

This SDK's Python package is called **smartsheet-python-sdk**. To
install using pip:

``$ pip install smartsheet-python-sdk``

Install manually
~~~~~~~~~~~~~~~~

To install this SDK manually, download the source code from
`GitHub <https://github.com/smartsheet-platform/smartsheet-python-sdk>`__
and then run:

``$ python setup.py install``

Documentation
-------------

The SDK documentation can be viewed online at
http://smartsheet-platform.github.io/smartsheet-python-sdk/.

Getting Started
---------------

Getting started with the Python SDK is easy:

1. Set **SMARTSHEET\_ACCESS\_TOKEN** in your environment. Find out more
   about getting `direct API
   access <https://smartsheet-platform.github.io/api-docs/index.html#direct-api-access>`__
   in the Smartsheet API Documentation.

2. Install the Smartsheet Python SDK from the `Python Package
   Index <http://pypi.python.org/pypi/smartsheet-python-sdk>`__, or by
   using "pip install smartsheet-python-sdk".

3. Import the smartsheet module: ``import smartsheet``

4. Refer to the `Smartsheet API
   Documentation <https://smartsheet-platform.github.io/api-docs/?python#python-sample-code>`__
   for Python SDK usage examples.

Contributing
------------

If you would like to contribute a change to the SDK, please fork a
branch and then submit a pull request. More info
`here <https://help.github.com/articles/using-pull-requests>`__.

Support
-------

If you have any questions or issues with this SDK please post on
StackOverflow using the tag
`"smartsheet-api" <http://stackoverflow.com/questions/tagged/smartsheet-api>`__
or contact us directly at api@smartsheet.com.

Release Notes
-------------

Each specific release is available for download via
`Github <https://github.com/smartsheet-platform/smartsheet-python-sdk/tags>`__.

**1.1.0 (March 15, 2017)** \* SDK updates through Smartsheet API level 2.0.10

**1.0.1 (Jan 11, 2016)** \* Fix package version in User-Agent string \*
Fix integer ID handling on Python 2.x for Windows

**1.0.0 (Jan 5, 2016)** \* Initial Release of the Smartsheet Python SDK
for Smartsheet API 2.0

.. |Build Status| image:: https://travis-ci.org/smartsheet-platform/smartsheet-python-sdk.svg
   :target: https://travis-ci.org/smartsheet-platform/smartsheet-python-sdk
.. |Coverage Status| image:: https://coveralls.io/repos/smartsheet-platform/smartsheet-python-sdk/badge.svg?branch=master&service=github
   :target: https://coveralls.io/github/smartsheet-platform/smartsheet-python-sdk?branch=master


