Skip to main content
Help us improve Python packaging – donate today!

Python Wrapper for Toggl API

Project Description

toggl-python-api-client

Toggl is an “insanely simple time tracking” service.

This specific library is a Python-based REST client to interface with the Toggle API utilizing requests.

This library is a pure api client to help other python apps interface with Toggl. I created this project primarily to help with a bigger internal project that I am doing at work while at the same time getting my feet wet in Python.

Others out there

There is already a similar library, toggl_target though it is more of an application and the client api is not separate repo. Some ideas/concepts on the client api were taken from there but I had needed a client api only to help interface with my bigger app.

Usage

Pypi Package

pip install python-toggl

Manual installation

Download to a location of your choice and do the following.

from toggl-python-api-client.api_client import TogglClientApi

settings = {
    'token': 'xxx',
    'user_agent': 'your app name'
}
toggle_client = TogglClientApi(settings)

response = toggle_client.get_workspaces()

Dependencies

Tests Dependencies

To run the tests, you will need the following packages

Tests

Tests created under /tests are primarily integration tests and are not strictly unit tests. They consists of an offline and online(live) test.

Offline

tests/tests_offline.py

These tests are for the logic of the api client. They do not connect to the actual Toggl servers - instead use httpretty to mock the responses. Sample responses are included in tests/json_responses and are based on Toggle responses for V8 of the main api and V2 of the report api.

Online/Live

tests/tests_live.py

These tests are to check the connections to Toggl’s API and to ensure that the client is handling the live responses from Toggl as expected.

To avoid adding sensitive data to version control, no api credentials have been included. To enable live tests, - make a copy of tests/tests_live_config.json.sample as tests/tests_live_config.json - update the settings on tests/tests_live_config.json as needed

Release history Release notifications

This version
History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
python_toggl-0.1.4-py2.7.egg (9.2 kB) Copy SHA256 hash SHA256 Egg 2.7 Nov 19, 2015
python-toggl-0.1.4.tar.gz (3.5 kB) Copy SHA256 hash SHA256 Source None Nov 19, 2015

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page