Getting started

Before you start writing your first application that connects to the 1010data Insights Platform, you need to install Python and download the Python SDK files.

Requirements

You must have Python installed on your system. The 1010data Python SDK is available for Linux, macOS, and Windows.

Windows (32-bit and 64-bit) Linux macOS
Python 2.7, Python 3.5, Python 3.6, Python 3.7 Python 2.7 (two versions, for wide and narrow unicode), Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8 Python 2.7, Python 3.7, Python 3.8, Python 3.9

The 1010data Python SDK is available for 32-bit (Windows) and 64-bit operating systems.

Installation

You can download the Python SDK files from https://www2.1010data.com/downloads/tools/python/py1010.zip. The dist folder contains a list of .whl files. Find the appropriate .whl file for your operating system.

Refer to the following table for the appropriate .whl file:

File Description
Py1010-1.1.5-cp37-cp37m-macosx_10_14_x86_64.whl Python 3.7 and macOS
Py1010-1.1.5-cp38-cp38-macosx_10_14_x86_64.whl Python 3.8 and macOS
Py1010-1.1.5-cp39-cp39-macosx_10_14_x86_64.whl Python 3.9 and macOS
Py1010-1.1.6-cp27-cp27m-linux_x86_64.whl Python 2.7 and Linux (narrow unicode)
Py1010-1.1.6-cp27-cp27m-macosx_10_14_intel.whl Python 2.7 and macOS
Py1010-1.1.6-cp27-cp27m-manylinux2010_x86_64.whl Python 2.7 and any Linux (narrow unicode)
Py1010-1.1.6-cp27-cp27m-win_amd64.whl Python 2.7 and 64-bit Windows
Py1010-1.1.6-cp27-cp27m-win32.whl Python 2.7 and 32-bit Windows
Py1010-1.1.6-cp27-cp27mu-linux_x86_64.whl Python 2.7 and Linux (wide unicode)
Py1010-1.1.6-cp27-cp27mu-manylinux2010_x86_64.whl Python 2.7 and any Linux (wide unicode)
Py1010-1.1.6-cp34-cp34m-linux_x86_64.whl Python 3.4 and Linux
Py1010-1.1.6-cp34-cp34m-manylinux2010_x86_64.whl Python 3.4 and any Linux
Py1010-1.1.6-cp35-cp35m-linux_x86_64.whl Python 3.5 and Linux
Py1010-1.1.6-cp35-cp35m-manylinux2010_x86_64.whl Python 3.5 and any Linux
Py1010-1.1.6-cp35-cp35m-win_amd64.whl Python 3.5 and 64-bit Windows
Py1010-1.1.6-cp35-cp35m-win32.whl Python 3.5 and 32-bit Windows
Py1010-1.1.6-cp36-cp36m-linux_x86_64.whl Python 3.6 and Linux
Py1010-1.1.6-cp36-cp36m-manylinux2010_x86_64.whl Python 3.6 and any Linux
Py1010-1.1.6-cp36-cp36m-win_amd64.whl Python 3.6 and 64-bit Windows
Py1010-1.1.6-cp36-cp36m-win32.whl Python 3.6 and 32-bit Windows
Py1010-1.1.6-cp37-cp37m-linux_x86_64.whl Python 3.7 and Linux
Py1010-1.1.6-cp37-cp37m-manylinux2010_x86_64.whl Python 3.7 and any Linux
Py1010-1.1.6-cp37-cp37m-win_amd64.whl Python 3.7 and 64-bit Windows
Py1010-1.1.6-cp37-cp37m-win32.whl Python 3.7 and 32-bit Windows
Py1010-1.1.6-cp38-cp38-linux_x86_64.whl Python 3.8 and Linux
Py1010-1.1.6-cp38-cp38-manylinux2010_x86_64.whl Python 3.8 and any Linux
Note: The manylinux2010 versions are preferred if you are running Linux of any sort. If you run the regular linux version and it doesn't work, use manylinux2010.
After you identify the appropriate .whl file, install py1010 in your current Python environment. For example, you would install py1010 for Python 3.8 and Linux as follows:
pip install Py1010-1.1.6-cp38-cp38-manylinux2010_x86_64.whl
Note: You may need to have administrator/root privileges to do this.
You would install py1010 for Python 3.8 and Linux as a user alone as follows:
pip install --user Py1010-1.1.6-cp38-cp38-manylinux2010_x86_64.whl

Alternatively, you can copy the appropriate library files from the bin folder of the Python SDK to your working directory. Choose the folder that contains library files that match your operating system:

Operating System Version to use
Windows - 32-bit win32
Windows - 64-bit win64
Linux lin64
macOS osx

Using the single sign-on (SSO) feature

If you want to use the SSO feature of the Python SDK, you also need to copy the file sso_login to any directory on the PATH. Check your PATH environment variable for a list of directories by typing echo %PATH% (Windows) or echo $PATH (macOS/Linux) on the command line.

Example projects

The examples folder contains the following examples:
columnprinter.py
Prints the columns of a table one at a time.
dictslice.py
Exports results to a pandas DataFrame.
rowprinter.py
Prints the rows of a table one at a time.
server.py
Displays a complex web server example using multiple threads.
simplethread.py
Uses two threads to create two session objects, retrieves information from two tables, and downloads the data into two separate files.