package otoggl

  1. Overview
  2. Docs
Bindings for Toggl API in OCaml

Install

Dune Dependency

Authors

Maintainers

Sources

dev-0.3.2.tbz
sha256=22ee2dc184836891b833d6791bea35f583e24bb2ce87ae4f6e5dcbdb272dc4c9
sha512=89508c18662001029e6d3707dae82edd67a17a7fecc200d7c0da3c4ac8f45b6676e0dec69483234f2170b31451f36735903c89e85cb2a713fe8a4df327964f74

Description

Bindings for Toggl API in OCaml

Published: 16 Mar 2022

README

OToggl

Bindings for Toggl API in OCaml.

Toggl Tracking is a time tracking solution that comes with multiple features that would be out of scope of this document.

This project tries to implement as many features as possible, starting with the ones needed to implement a basic time tracker synchronized with Toggl. As the Toggl API is quite rich and this is a one person's work, if you need specific endpoints to be implemented, please file an issue.

Installation

This package is not yet released on Opam so for the moment you need to pin it to this repository:

opam pin add otoggl https://github.com/unitrack-time-tracking/OToggl.git#0.2.1
opam install otoggl

Overview

Module Toggl.Auth

This module contains the necessary modules and functors to create an authenticated client to connect to the Toggl Tracking API.

Module Toggl.Api

This module contains a functor, which takes as argument a Client module created with the previous module, and which then gives access to the following modules.

TimeEntry

A time entry is the basic time tracking unit. It consists in a task with a description and certain time attributes (start and end times, duration), as well as specific identifiers (own id, workspace, user, project) and tags.

This module contains the manipulation functions to start, stop, create, get , delete and modify time entries.

Project

A project regroups time entries. A time entry can have at most one project, and we can get statistics by project.

Workspace

In Toggl, a Workspace is a high level entity that regroups projects and time entries, and it can have specific settings as well.

Contributing

Take a look at our Contributing Guide.

Dependencies (9)

  1. ptime >= "1.0.0"
  2. ppx_deriving build
  3. piaf >= "0.1.0" & < "0.2.0"
  4. containers >= "3.6"
  5. base64 >= "3"
  6. atdgen-runtime >= "2"
  7. atdgen build & >= "2"
  8. ocaml >= "4.08.0"
  9. dune >= "2.9"

Dev Dependencies (3)

  1. odoc with-doc
  2. alcotest-lwt with-test
  3. alcotest with-test

Used by

None

Conflicts

None

OCaml

Innovation. Community. Security.