taskchampion

Crates.iotaskchampion
lib.rstaskchampion
version0.9.0
sourcesrc
created_at2020-11-30 02:11:55.917356
updated_at2024-10-31 12:33:48.385787
descriptionPersonal task-tracking
homepagehttps://gothenburgbitfactory.github.io/taskchampion/
repositoryhttps://github.com/GothenburgBitFactory/taskchampion
max_upload_size
id318061
size394,155
Dustin J. Mitchell (djmitche)

documentation

https://docs.rs/crate/taskchampion

README

This crate implements the core of TaskChampion, the replica.

Users of this crate can manipulate a task database using this API, including synchronizing that task database with others via a synchronization server.

Example uses of this crate:

  • user interfaces for task management, such as mobile apps, web apps, or command-line interfaces
  • integrations for task management, such as synchronization with ticket-tracking systems or request forms.

Replica

A TaskChampion replica is a local copy of a user's task data. As the name suggests, several replicas of the same data can exist (such as on a user's laptop and on their phone) and can synchronize with one another.

Replicas are accessed using the [Replica] type.

Task Storage

Replicas access the task database via a storage object. Create a storage object with [StorageConfig].

The [storage] module supports pluggable storage for a replica's data. An implementation is provided, but users of this crate can provide their own implementation as well.

Server

Replica synchronization takes place against a server. Create a server with [ServerConfig].

The [server] module defines the interface a server must meet. Users can define their own server impelementations.

Feature Flags

Support for some optional functionality is controlled by feature flags.

  • server-gcp - sync to Google Cloud Platform
  • server-sync - sync to the taskchampion-sync-server
  • sync - enables all of the sync features above
  • bundled - activates bundling system libraries like sqlite
  • tls-native-roots - use native (system) TLS roots, instead of those bundled with rustls, by (indirectly) enabling the rustls feature rustls-tls-native-roots.

By default, sync and bundled are enabled.

See Also

See the TaskChampion Book for more information about the design and usage of the tool.

Minimum Supported Rust Version (MSRV)

This crate supports Rust version 1.73.0 and higher.

Commit count: 11791

cargo fmt