smartsheet-python-sdk 1.2.3

Library that uses Python to connect to Smartsheet services (using API 2.0).

|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 [e-mail].

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

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

See [CHANGELOG.md](https://github.com/smartsheet-platform/smartsheet-python-sdk/blob/master/CHANGELOG.md)