toucan-data-sdk

Toucan data SDK


License
BSD-3-Clause
Install
pip install toucan-data-sdk==7.5.0

Documentation

Pypi-v Pypi-pyversions Pypi-l Pypi-wheel CircleCI codecov

Toucan Data SDK

Develop your Toucan Toco data pipeline from the confort of your favorite environment.

Installation

pip install toucan_data_sdk

Usage

Get data sources

import getpass
from toucan_data_sdk import ToucanDataSdk

instance_url = 'https://api-demo.toucantoco.com'
auth = ('<username>', getpass.getpass())

sdk = ToucanDataSdk(instance_url, small_app='demo', auth=auth)
dfs = sdk.get_dfs()

API

ToucanDataSdk class

ToucanDataSdk.sdk

  • property,
  • uses the client to send a request to the back end to send the data sources as DataFrames,
  • uses an internal cache.

ToucanDataSdk.invalidate_cache()

Invalidates the cache. Next time you will access to the sdk property, a request will be sent to the client.

Utils

cf. https://docs.toucantoco.com/concepteur/data-sources/00-generalities.html#utility-functions

For example:

from toucan_data_sdk.utils import add_missing_row

Development

Makefile

Use the makefile to test, build...

$ make test

Development

PEP8

New code must be PEP8-valid (with a maximum of 100 chars): tests wont pass if code is not. To see PEP8 errors, run pycodestyle <path_to_file_name> or recursively: pycodestyle -r .