Crate taskchampion
source ·Expand description
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.
Sync server client support:
server-gcp
- sync to Google Cloud Platformserver-sync
- sync to the taskchampion-sync-server
§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.70.0 and higher.
Re-exports§
pub use server::Server;
pub use server::ServerConfig;
pub use storage::StorageConfig;
pub use chrono;
Modules§
Structs§
- An annotation for a task
- DependencyMap stores information on task dependencies between pending tasks.
- A replica represents an instance of a user’s task data, providing an easy interface for querying and modifying that data.
- A Tag is a descriptor for a task, that is either present or absent, and can be used for filtering. Tags composed of all uppercase letters are reserved for synthetic tags.
- A task, as publicly exposed by this crate.
- A mutable task, with setter methods.
- Re-exported type from the
uuid
crate, for ease of compatibility for consumers of this crate. A Universally Unique Identifier (UUID). - A WorkingSet represents a snapshot of the working set from a replica.
Enums§
- Errors returned from taskchampion operations
- The status of a task, as defined by the task data model.