Pypi Package

pip install python-toggl

Manual installation

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

from toggl.api_client import TogglClientApi

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

response = toggle_client.get_workspaces()

Tests Dependencies

To run the tests, you will need the following packages

• unittest

• json

• httpretty

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