Skip to main content

cheesebread: a toolbox for data science

Project description

cheesebread is a data toolbox. In other words, it supports tools and shortcuts to get data from REST APIs into datasets without the hassle of explicitly handling every single step in the middle.

cheesebread handles:

  • data catalog and datasets
  • asynchronous communication to REST APIs
  • aggregate data into time series from REST APIs
  • authentication
  • expiring tokens
  • request limits and retry on failure
  • deduplication


More often than not, collectig data from REST APIs gets in the way of data analysis and machine learning. The toolbox implements a list of helpers that automate data collection.

Moreover, when we are given aggregate data, for instance, an API endpoint that returns a user’s number of interaction during a given period, the toolbox manages to create time series by asynchronously calling the API multiple times - a little bit hacky, but it wil get what we need.

The toolbox is aimed to a somewhat incipient data science team whose main focus is to get started with data analysis and not data collection.


Always suggest a version bump. We use Semantic Versioning.

Given a version number MAJOR.MINOR.PATCH, increment the:

  • MAJOR version when you make incompatible API changes,
  • MINOR version when you add functionality in a backwards-compatible manner, and
  • PATCH version when you make backwards-compatible bug fixes.


Copyright (C) 2020 Gabriel Stefanini Vicente. cheesebread is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cheesebread-0.0.2.tar.gz (12.6 kB view hashes)

Uploaded source

Built Distribution

cheesebread-0.0.2-py3-none-any.whl (26.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page