f054a4061e
This crate has been moved to https://github.com/GothenburgBitFactory/taskchampion-sync-server. The integration-tests repo used the sync server to test integration between taskchampion and the sync-server. We should do that again, but after taskchampion moves to its own repo (#3209). In the interim, the cross-sync integration test can simply test syncing between local servers, but the snapshot test is no longer useful as the local server does not support snapshots. |
||
|---|---|---|
| .. | ||
| .changelogs | ||
| docs | ||
| integration-tests | ||
| lib | ||
| scripts | ||
| taskchampion | ||
| xtask | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| POLICY.md | ||
| README.md | ||
| RELEASING.md | ||
| SECURITY.md | ||
TaskChampion
TaskChampion implements the task storage and synchronization behind Taskwarrior. It includes an implementation with Rust and C APIs, allowing any application to maintain and manipulate its own replica. It also includes a specification for tasks and how they are synchronized, inviting alternative implementations of replicas or task servers.
See the documentation for more!
NOTE: Taskwarrior is currently in the midst of a change to use TaskChampion as its storage. Until that is complete, the information here may be out-of-date.
Structure
There are four crates here:
- taskchampion - the core of the tool
- taskchampion-lib - glue code to use taskchampion from C
- integration-tests (private) - integration tests covering taskchampion and taskchampion-lib.
- xtask (private) - implementation of the
cargo xtask codegencommand
Code Generation
The taskchampion_lib crate uses a bit of code generation to create the lib/taskchampion.h header file.
To regenerate this file, run cargo xtask codegen.
Rust API
The Rust API, as defined in the docs, supports simple creation and manipulation of replicas and the tasks they contain.
The Rust API follows semantic versioning.
As this is still in the 0.x phase, so breaking changes may occur but will be indicated with a change to the minor version.
C API
The taskchampion-lib crate generates libraries suitable for use from C (or any C-compatible language).
It is a "normal" Cargo crate that happens to export a number of extern "C" symbols, and also contains a taskchampion.h defining those symbols.
WARNING: the C API is not yet stable!
It is your responsibility to link this into a form usable in your own build process.
For example, in a typical CMake C++ project, CMakeRust can do this for you.
In many cases, this is as simple as a rust crate with src/lib.rs containing
pub use taskchampion_lib::*;
Arrange to use the header file, lib/taskchampion.h, by copying it or adding its directory to your include search path.
Future work will provide better automation for this process.