3 个版本

0.5.2 2023年9月1日
0.5.1 2022年9月14日
0.4.4 2022年9月7日
0.4.1 2022年8月30日
0.1.4 2022年8月24日

#2#保险库

每月33次下载

GPL-2.0-only

86KB
2K SLoC

托鲁

一个(目前处于开发中)用于命令行的待办事项应用程序。


设计

托鲁的一般想法是拥有一个待办事项应用程序,它使用独特的、相互排斥的保险箱任务,配置以人类可读和易于导出和导入的格式(以完全分离个人、工作、学习等),但在保险箱内,使用标签和依赖项作为组织笔记的手段,而不是相互排斥的文件夹。

例如,在给定的保险箱中,可能有一个正在进行的重大项目。这个项目和所有子任务都列在最顶层(而不是根据项目组织)。为了方便组织和查看任务,可以使用标签和依赖项,并过滤搜索任务以获取所需信息。这允许您对任务进行分类,即使它们不属于任何明显的类别。


安装

最简单的方法是使用 cargo 从 crates.io 安装

cargo install toru

或者您可以从源代码构建

git clone https://github.com/aaron-jack-manning/toru.git
cd toru
cargo build --release

这将创建一个在 /target/release/toru 的可执行文件。


入门

只需在终端中键入 toru 即可显示每个命令的帮助信息

toru 0.5.1
Aaron Manning <contact@aaronmanning.net>
A command line task manager.

USAGE:
    toru <SUBCOMMAND>

OPTIONS:
    -h, --help       Print help information
    -V, --version    Print version information

SUBCOMMANDS:
    complete      Mark a task as complete
    config        For making changes to global configuration
    delete        Delete a task (move file to trash)
    edit          Edit a task directly
    git           Run Git commands at the root of the vault
    gitignore     Adds the recommended .gitignore file to the vault
    list          Lists tasks according to the specified fields, ordering and filters
    new           Create a new task
    stats         For statistics about the state of your vault
    svn           Run Subversion commands at the root of the vault
    svn:ignore    Adds the recommended svn:ignore property to the top level of the vault
    switch        Switches to the specified vault
    track         For tracking time against a task
    vault         Commands for interacting with vaults
    view          Displays the specified task in detail

您可以通过传递 -h--help 标志来查看任何帮助屏幕,内部文档旨在使使用 Toru 的方法显而易见。

要启动,您需要一个用于存储任务的保险箱,您可以通过运行 toru vault new <NAME> <PATH> 来创建。

如果您想查看所有保险箱,包括当前是哪个,请运行 toru vault list

然后您可以运行 toru new 来创建您的第一个任务。


备份和同步

为了使数据易于备份、跨设备同步以及轻松导出,托鲁将任务和其他元数据本地存储在保险箱文件夹中。然而,由于托鲁使用顺序 ID,使用 Git 等异步方式在计算机之间共享保险箱可能会导致不同的笔记相互冲突。如果在使用之前完全同步设备上的所有保险箱元数据,则可以避免此类冲突。

依赖项

~5–35MB
~485K SLoC