2 unstable releases
0.2.0 | Feb 5, 2024 |
---|---|
0.1.0 | Feb 4, 2024 |
#779 in Text processing
18KB
327 lines
marktask
marktask
is a command-line interface (CLI) application designed for parsing and manipulating Markdown tasks.
It allows users to filter, extract, and transform task information seamlessly within their shell environment.
Features
- Parse Markdown-formatted tasks.
- Extract tasks with due dates, scheduled dates, and start dates.
- Filter tasks based on completion status.
- Filter out or include overdue tasks with the
--overdue
option. - Output tasks in plain text or JSON format for easy consumption by other tools.
- Filter tasks within a specific date range using
--from
and--to
options.
Installation
cargo build --release
mv target/release/marktask /usr/local/bin
Usage
marktask
can be used with pipes and with other commands in a shell environment. Below are some examples to get you started:
Display Tasks from a File
marktask < tasks.md # or
cat tasks.md | marktask
Filter Tasks Containing Specific Text
cat tasks.md | marktask | grep "Project A"
This command sequence reads tasks from tasks.md
, parses them, and then uses grep
to filter tasks related to "Project A".
Convert Tasks to JSON
For integration with other tools that consume JSON, marktask
can output tasks in JSON format:
cat tasks.md | marktask --json
Filter Overdue Tasks
To exclude overdue tasks from the output, use the --overdue=false
option. By default, all tasks, including overdue ones, are shown:
cat tasks.md | marktask --overdue=false
Filter Tasks by Date Range
To include tasks starting from a specific date or from a relative date like one week from today:
cat tasks.md | marktask --from 2024-01-01
cat tasks.md | marktask --from +1w # Tasks starting from one week from today
To include tasks up to a specific date or up to a relative period like two days from now:
cat tasks.md | marktask --to 2024-01-31
cat tasks.md | marktask --to +2d # Tasks up to two days from today
To include tasks within a specific date range or within a relative period:
cat tasks.md | marktask --from 2024-01-01 --to 2024-01-31
cat tasks.md | marktask --from -1w --to +1m # Tasks from last week to one month from today
License
This project is licensed under the Apache License Version 2.0 - see the LICENSE file for details.
Dependencies
~5–7.5MB
~129K SLoC