Getting started

Requirements

You must have Python installed on your system. The 1010data Python SDK is available for Linux, macOS, and Windows (32-bit and 64-bit).


Windows 32-bit and 64-bit	Windows 64-bit only	Linux	macOS
Python 3.7, Python 3.8, Python 3.9	Python 3.6, 3.10	Python 3.6, Python 3.7, Python 3.8, Python 3.9, Python 3.10	Python 3.7, Python 3.8, Python 3.9, Python 3.10

Note: macOS users should use the x86_64 version of Python.

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:

Description	File name
Python 3.7 and 32-bit Windows	`Py1010-1.3.4-cp37-cp37m-win32.whl`
Python 3.8 and 32-bit Windows	`Py1010-1.3.4-cp38-cp38-win32.whl`
Python 3.9 and 32-bit Windows	`Py1010-1.3.4-cp39-cp39-win32.whl`
Python 3.6 and 64-bit Windows	`Py1010-1.3.4-cp36-cp36m-win_amd64.whl`
Python 3.7 and 64-bit Windows	`Py1010-1.3.4-cp37-cp37m-win_amd64.whl`
Python 3.8 and 64-bit Windows	`Py1010-1.3.4-cp38-cp38-win_amd64.whl`
Python 3.9 and 64-bit Windows	`Py1010-1.3.4-cp39-cp39-win_amd64.whl`
Python 3.10 and 64-bit Windows	`Py1010-1.3.4-cp310-cp310-win_amd64.whl`
Python 3.6 and Linux	`Py1010-1.3.4-cp36-cp36m-linux_x86_64.whl`
Python 3.6 and any Linux	`Py1010-1.3.4-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`
Python 3.7 and Linux	`Py1010-1.3.4-cp37-cp37m-linux_x86_64.whl`
Python 3.7 and any Linux	`Py1010-1.3.4-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`
Python 3.8 and Linux	`Py1010-1.3.4-cp38-cp38-linux_x86_64.whl`
Python 3.8 and any Linux	`Py1010-1.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`
Python 3.9 and Linux	`Py1010-1.3.4-cp39-cp39-linux_x86_64.whl`
Python 3.9 and any Linux	`Py1010-1.3.4-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`
Python 3.10 and Linux	`Py1010-1.3.4-cp310-cp310-linux_x86_64.whl`
Python 3.10 and any Linux	`Py1010-1.3.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl`
Python 3.7 and macOS	`Py1010-1.3.4-cp37-cp37m-macosx_10_15_x86_64.whl`
Python 3.8 and macOS	`Py1010-1.3.4-cp38-cp38-macosx_10_15_x86_64.whl`
Python 3.9 and macOS	`Py1010-1.3.4-cp39-cp39-macosx_10_15_x86_64.whl`
Python 3.10 and macOS	`Py1010-1.3.4-cp310-cp310-macosx_10_15_x86_64.whl`

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.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_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.3.4-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_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.