8f327db5b9
* added cargo xtask msrv X.Y placeholder function * add placeholder function cargo xtask msrv (X.Y) * implement CLI arg vec, graceful errors, formatting * impl. xtask msrv insert,upsert,graceful failures * misc fixes - still need to update write method * interim commit before removing comments * updated per @djmitche suggestions. 2 fixes todo * impl unwrap error checks, file truncating, etc * removed test paths * updated toml with specific regex version * updated cargo toml and lock for regex version * updated cargo toml and lock for regex version * fixed clippy complaints * impl replace file content, not comments * accept djmitche suggestion to change comment documentation Co-authored-by: Dustin J. Mitchell <dustin@v.igoro.us> * refactored, need to fix Cow return * removed debug prints, unncessary if, etc. * fix non-idiomatic rust, arg.len error handling * add #MSRV to config files and test --------- Co-authored-by: iwyatt <sayhello+git@isaacwyatt.com> Co-authored-by: Dustin J. Mitchell <dustin@v.igoro.us>
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 five crates here:
- taskchampion - the core of the tool
- taskchampion-sync-server - the server against which
task syncoperates - taskchampion-lib - glue code to use taskchampion from C
- integration-tests (private) - integration tests covering taskchampion-cli, taskchampion-sync-server, 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.