mirror of
https://github.com/oh-my-fish/oh-my-fish
synced 2024-11-03 15:40:32 +00:00
[split] Move ta plugin to oh-my-fish/plugin-ta
https://github.com/oh-my-fish/plugin-ta
This commit is contained in:
Justin Hileman
parent
6d2dcbdbf1
commit
11e980d310
@ -1,21 +0,0 @@
|
|||||||
The MIT License (MIT)
|
|
||||||
|
|
||||||
Copyright (c) 2015 Jorge Bucaran
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
|
||||||
in the Software without restriction, including without limitation the rights
|
|
||||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
copies of the Software, and to permit persons to whom the Software is
|
|
||||||
furnished to do so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
@ -1,265 +0,0 @@
|
|||||||
<a name="ta"></a><em>
|
|
||||||
<p align="center">
|
|
||||||
:ledger: <b>ta</b>
|
|
||||||
|
|
|
||||||
<b><a href="#features">Features</a></b>
|
|
||||||
|
|
|
||||||
<b><a href="#rationale">Rationale</a></b>
|
|
||||||
|
|
|
||||||
<b><a href="#install">Install</a></b>
|
|
||||||
|
|
|
||||||
<b><a href="#synopsis">Synopsis</a></b>
|
|
||||||
|
|
|
||||||
<b><a href="#issues">Issues</a></b>
|
|
||||||
|
|
|
||||||
<b><a href="#about">?</a></b>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<img width=65% height=65% src ="images/ta.png">
|
|
||||||
</p>
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
___ta___ is a CLI-based _to-done_ task manager. The advantage over _to-do_ lists are:
|
|
||||||
|
|
||||||
1. You __don't__ change your routine or habits.
|
|
||||||
|
|
||||||
2. You __don't__ need to follow a predictable workflow.
|
|
||||||
|
|
||||||
3. You focus on completing stuff first. Log. Repeat.
|
|
||||||
|
|
||||||
4. Tasks are [inmutable](#undoing-tasks). Like time travel.
|
|
||||||
|
|
||||||
See [rationale](#rationale) for a more lengthy discussion.
|
|
||||||
|
|
||||||
## <a name="features">Features</a>
|
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<tr>
|
|
||||||
<th>1. <a href="#adding-tasks">Adding Tasks</a></th>
|
|
||||||
<th>2. <a href="#undoing-tasks">Undoing Tasks</a></th>
|
|
||||||
<th>3. <a href="#searching-tasks">Searching Tasks</a></th>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<td><img src="images/add.png"></td>
|
|
||||||
<td><img src="images/undo.png"></td>
|
|
||||||
<td><img src="images/tags.png"></td>
|
|
||||||
</tr>
|
|
||||||
</tr>
|
|
||||||
<tr>
|
|
||||||
<th>4. <a href="#searching-tasks">Regex</a></th>
|
|
||||||
<th>5. <a href="#navigating-tasks">Navigating Tasks</a></th>
|
|
||||||
<th>6. <a href="#recent-tasks">Recent Task Marker</a></th>
|
|
||||||
<tr>
|
|
||||||
<td><img src="images/regex.png"></td>
|
|
||||||
<td><img src="images/list.png"></td>
|
|
||||||
<td><img src="images/recent.png"></td>
|
|
||||||
</tr>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<hr>
|
|
||||||
|
|
||||||
|
|
||||||
### <a name="adding-tasks">Adding Tasks</a>
|
|
||||||
|
|
||||||
* `ta "called #mom"`
|
|
||||||
* `ta "pushed ta to #gh #projects"`
|
|
||||||
|
|
||||||
### <a name="undoing-tasks">Undoing Tasks</a>
|
|
||||||
|
|
||||||
Tasks in _ta_ are, by definition, inmutable. It's like time travel. You are not allowed.
|
|
||||||
|
|
||||||
It _is_ possible, however, to undo _only_ the most recent task:
|
|
||||||
|
|
||||||
* `ta -u` or `ta --undo`
|
|
||||||
|
|
||||||
> __Note__: _ta_ is a productivity tool to help you improve your workflow, but it's not a task scheduler. If you are looking for a traditional _to-do_ manager I recommend looking at [Swatto/td](https://github.com/Swatto/td).
|
|
||||||
|
|
||||||
### <a name="searching-tasks">Searching Tasks</a>
|
|
||||||
|
|
||||||
Use `-s --search <tag>` to search for tasks tagged by `<tag>`.
|
|
||||||
|
|
||||||
* `ta -s spanish+jul`
|
|
||||||
|
|
||||||
List _#spanish_ tasks in July.
|
|
||||||
|
|
||||||
* `ta -s work+opensource`
|
|
||||||
|
|
||||||
List _#work_ __and__ _#opensource_ tasks.
|
|
||||||
|
|
||||||
* `ta --search family+friends -n5`
|
|
||||||
|
|
||||||
List _#family_ __and__ _#friends_ tasks. _5 max._
|
|
||||||
|
|
||||||
Use `--regex -s <query>` or `-rs <query>` to search by an arbitrary regular expression.
|
|
||||||
|
|
||||||
* `ta -rs "workout|cardio|gym"`
|
|
||||||
|
|
||||||
List __all__ _#workout_, _#cardio_ __or__ _#gym_ tasks
|
|
||||||
|
|
||||||
### <a name="navigating-tasks">Navigating Tasks</a>
|
|
||||||
|
|
||||||
Simply type `ta` to display all tasks. The task at the top is the most recent one.
|
|
||||||
|
|
||||||
The list dump is piped into [`less`](http://linux.die.net/man/1/less) so you can easily navigate up and down, run inline searches, etc.
|
|
||||||
|
|
||||||
[See here](http://bit.ly/17qd1KM) for a full list of options.
|
|
||||||
|
|
||||||
<p align="center">
|
|
||||||
<img width=80% height=80% src ="images/full-list.png">
|
|
||||||
</p>
|
|
||||||
|
|
||||||
You can also limit the number of tasks using the `-n --number <number>` option.
|
|
||||||
|
|
||||||
### <a name="recent-tasks">Recent Tasks</a>
|
|
||||||
|
|
||||||
If you complete any task within ten minutes of the previously added task, the `*` marker will turn red. It's up to you to interpret that as either a good or a bad sign.
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
|
|
||||||
## <a name="rationale">Rationale</a>
|
|
||||||
|
|
||||||
In a todo-like system, each task is a promise scheduled to be fulfilled
|
|
||||||
in the future. In practice, promises can be hard to keep and prioritize.
|
|
||||||
|
|
||||||
GTD-like methods offer good strategies to help with this, but they often
|
|
||||||
require breaking die-to-hard habits and can be too complicated for users.
|
|
||||||
|
|
||||||
Information flux is unpredictable, and dividing how this information is
|
|
||||||
collected and processed in often overlapping stages is challenging.
|
|
||||||
|
|
||||||
A to-done approach is not incompatible with traditional todo-lists, but
|
|
||||||
it was created in a world where todo lists are not prominent.
|
|
||||||
|
|
||||||
The premise is, as information flow crosses over the singularity threshold,
|
|
||||||
data-collection and sorting becomes impossible and unwieldy. The contract
|
|
||||||
is to spend _less_ time prioritizing and concentrate in completing only _one_
|
|
||||||
task at a time. Only completed tasks can be logged into the system.
|
|
||||||
|
|
||||||
Overall happiness and motivation increase will be directly proportional
|
|
||||||
to the number of completed tasks.
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
|
|
||||||
## <a name="install">Install</a>
|
|
||||||
|
|
||||||
### Fish
|
|
||||||
|
|
||||||
#### _Oh-my-fish_
|
|
||||||
Add the `ta` plugin to `$fish_plugins` via `~/.config/fish` or from your prompt:
|
|
||||||
```fish
|
|
||||||
set -g fish_plugins $fish_plugins ta
|
|
||||||
```
|
|
||||||
|
|
||||||
#### _Standalone_
|
|
||||||
|
|
||||||
Trust me and run:
|
|
||||||
```fish
|
|
||||||
curl -L http://git.io/install-ta | fish
|
|
||||||
ta "just installed #ta #right-move"
|
|
||||||
```
|
|
||||||
or if you are so inclined have a look at [`tools/install`](tools/install)
|
|
||||||
|
|
||||||
You can also specify the installation path:
|
|
||||||
|
|
||||||
```fish
|
|
||||||
curl -L http://git.io/install-ta | env INSTALL_PATH="to/your/path/" fish
|
|
||||||
ta "just installed #ta #right-move"
|
|
||||||
```
|
|
||||||
|
|
||||||
#### <a name="uninstall"></a> Uninstall
|
|
||||||
|
|
||||||
```fish
|
|
||||||
fish $ta_path/tools/uninstall
|
|
||||||
```
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
|
|
||||||
## <a name="synopsis">Synopsis</a>
|
|
||||||
|
|
||||||
```
|
|
||||||
ta [<task #tag1 #tag2...">]
|
|
||||||
[-u --undo]
|
|
||||||
[-s --search <key[+key...]>]
|
|
||||||
[-r --regex]
|
|
||||||
[-n --number <number>]
|
|
||||||
[-h --help]
|
|
||||||
[--version]
|
|
||||||
```
|
|
||||||
|
|
||||||
### ta _task_
|
|
||||||
|
|
||||||
Add a completed task. Append a :hash: to keywords to apply tags.
|
|
||||||
|
|
||||||
Simply run `ta` without arguments to list all completed tasks.
|
|
||||||
|
|
||||||
### -s --search _key_[, ...]
|
|
||||||
Search tasks tagged by _key_.
|
|
||||||
|
|
||||||
Use `+` to search tasks with all the specified tags.
|
|
||||||
|
|
||||||
Use the `-r` option and concatenate keys with `|` to search for all tasks with any of the specified tags.
|
|
||||||
|
|
||||||
#### Special Tags
|
|
||||||
|
|
||||||
The following tags are never displayed in results, but available to use in search queries:
|
|
||||||
|
|
||||||
* Weekdays: `mon...sun`
|
|
||||||
* Month: `jan...dec`
|
|
||||||
* Day: `1st, 2nd, 3rd, 4th...31st`
|
|
||||||
* Time: `12am...12pm`
|
|
||||||
|
|
||||||
> __Note__: These tags are added automatically to each task depending on the current time and date.
|
|
||||||
|
|
||||||
### -r --regex
|
|
||||||
Use together with `-s` and evaluate _key_ as a regular expression.
|
|
||||||
|
|
||||||
### -n --number _N_
|
|
||||||
|
|
||||||
Truncate number of results to _N_.
|
|
||||||
|
|
||||||
### -u --undo
|
|
||||||
|
|
||||||
Delete most recent task.
|
|
||||||
|
|
||||||
> __Note__: Using this option locks the ability to undo until a new task is committed protecting users from engaging in useless housekeeping habits.
|
|
||||||
|
|
||||||
### -h --help
|
|
||||||
|
|
||||||
Show usage help.
|
|
||||||
|
|
||||||
### --version
|
|
||||||
|
|
||||||
Show version information and trivia info.
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
|
|
||||||
## <a name="issues">Issues</a>
|
|
||||||
|
|
||||||
I welcome your [feedback, comments, opinions, bug reports](https://github.com/bucaran/ta/issues) and/or [PR](https://github.com/bucaran/ta/issues)s. Thanks.
|
|
||||||
|
|
||||||
|
|
||||||
## <a name="about">About</a>
|
|
||||||
|
|
||||||
If you are curious, ___ta___ or rather __た__, is a conjugation / deflection used in
|
|
||||||
Japanese to indicate the completion of an action ([perfective aspect](http://en.wikipedia.org/wiki/Perfective_aspect)), roughly corresponding
|
|
||||||
to the past tense in western languages.
|
|
||||||
|
|
||||||
<p align="right">
|
|
||||||
<a href="#ta">:arrow_up:</a> <a href="#ta">Top</a></p>
|
|
||||||
|
|
||||||
## <a name="license">License</a>
|
|
||||||
|
|
||||||
[MIT](http://opensource.org/licenses/MIT) :heart: [Jorge Bucaran](https://github.com/bucaran)
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
function ta.cli.clear
|
|
||||||
set -l bright_color (set_color FF1493)
|
|
||||||
set -l normal_color (set_color normal)
|
|
||||||
|
|
||||||
set -l question "[$bright_color"Y"$normal_color/n]"
|
|
||||||
|
|
||||||
if not test -e $__ta_file_data
|
|
||||||
echo "Nothing to clear."
|
|
||||||
return $__ta_error_no_tasks
|
|
||||||
end
|
|
||||||
|
|
||||||
echo -n "Delete all data? $question: "
|
|
||||||
|
|
||||||
head -n 1 | read answer
|
|
||||||
switch $answer
|
|
||||||
case Y yes
|
|
||||||
rm $__ta_file_data
|
|
||||||
echo "Done"
|
|
||||||
end
|
|
||||||
end
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
function ta.cli.commit -a task
|
|
||||||
# We delay the elapsed counter until the first task is committed.
|
|
||||||
set -q __ta_elapsed
|
|
||||||
or set -g __ta_elapsed (date "+%s")
|
|
||||||
|
|
||||||
set -l now (date "+%s")
|
|
||||||
set __ta_delta (math $now - $__ta_elapsed)
|
|
||||||
set __ta_elapsed $now
|
|
||||||
|
|
||||||
set -l meta (ta.util.tags.get.meta)
|
|
||||||
# Trim extra whitespace and save file.
|
|
||||||
echo -se (echo "$task" \
|
|
||||||
| tr -s '[:space:]' ' ')\t"$meta" >> $__ta_file_data
|
|
||||||
|
|
||||||
if test $status -eq 0
|
|
||||||
ta.cli.search "" | head -n2
|
|
||||||
# Unlock undo stack.
|
|
||||||
set __ta_undo_lock false
|
|
||||||
end
|
|
||||||
end
|
|
||||||
@ -1,13 +0,0 @@
|
|||||||
function ta.cli.help
|
|
||||||
echo "
|
|
||||||
USAGE
|
|
||||||
ta [<task #tag #tag...>]
|
|
||||||
[-u --undo]
|
|
||||||
[-s --search <key[+key...]>]
|
|
||||||
[-r --regex]
|
|
||||||
[-n --number <number>]
|
|
||||||
[-h --help]
|
|
||||||
[--clear]
|
|
||||||
[--version]
|
|
||||||
"
|
|
||||||
end
|
|
||||||
@ -1,82 +0,0 @@
|
|||||||
function ta.cli.search -a keys number
|
|
||||||
if not test -e $__ta_file_data
|
|
||||||
echo "There are no tasks."
|
|
||||||
return $__ta_error_no_tasks
|
|
||||||
end
|
|
||||||
|
|
||||||
set -l result
|
|
||||||
set -l flags
|
|
||||||
set -q argv[3]
|
|
||||||
and set flags $argv[3..-1]
|
|
||||||
|
|
||||||
# UI colors.
|
|
||||||
set -l tag_color "1;93"
|
|
||||||
set -l grep_color "0;103;1;90"
|
|
||||||
set -l text_color (set_color 777)
|
|
||||||
set -l query_color (set_color FF1493)
|
|
||||||
set -l normal_color (set_color normal)
|
|
||||||
|
|
||||||
if test -n "$number"
|
|
||||||
# Truncate results via tail -n$number
|
|
||||||
set number "n$number"
|
|
||||||
end
|
|
||||||
|
|
||||||
if contains -- regex $flags
|
|
||||||
set result (env GREP_COLOR="$grep_color" \
|
|
||||||
grep --color=always -E "$keys" $__ta_file_data)
|
|
||||||
else
|
|
||||||
set result (cat $__ta_file_data)
|
|
||||||
if test -n "$keys"
|
|
||||||
for key in (echo "$keys" | tr + \n)
|
|
||||||
# grep results consecutively to produce an AND operator.
|
|
||||||
# Notice we append a `#' to the $key to filter only tags.
|
|
||||||
set result (printf "%s\n" $result | grep "#$key")
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
if test -z "$result"
|
|
||||||
echo "Nothing to see here."
|
|
||||||
return $__ta_error_no_tasks
|
|
||||||
end
|
|
||||||
|
|
||||||
# Trim special flags, print results in reverse and color #tags.
|
|
||||||
if set result (printf "%s\n" $result \
|
|
||||||
| cut -d\t -f1 | tail -r"$number" \
|
|
||||||
| ta.util.color.tags $tag_color)
|
|
||||||
# Append |$ at the end of the tag regex to make sure grep prints all
|
|
||||||
# incoming lines from the tail pipe, but colors only tags. $ matches
|
|
||||||
# the end of all lines but has nothing to colorize.
|
|
||||||
|
|
||||||
set -l count (count $result)
|
|
||||||
|
|
||||||
set -l s # Plural?
|
|
||||||
test $count -gt 1; and set s "s"
|
|
||||||
|
|
||||||
# If both keys and number are empty just print tasks.
|
|
||||||
if test -z "$keys" -a -z "$number"
|
|
||||||
# set count (ta.util.tasks.count)
|
|
||||||
echo $text_color"$count task$s completed."$normal_color
|
|
||||||
|
|
||||||
if test $count -gt 0
|
|
||||||
set -l mark_color (set_color blue)
|
|
||||||
# Task marker is red if the task was completed within 10 mins.
|
|
||||||
if test $__ta_delta -gt 0 -a $__ta_delta -lt 600
|
|
||||||
set mark_color (set_color red)
|
|
||||||
end
|
|
||||||
echo -n $mark_color\* $normal_color
|
|
||||||
end
|
|
||||||
else
|
|
||||||
if test -n "$keys"
|
|
||||||
echo /$query_color"$keys"$normal_color/ | begin
|
|
||||||
# Only for tag search, colorize `+' characters for love.
|
|
||||||
if not contains -- regex $keys
|
|
||||||
sed "s/+/$normal_color+$query_color/g"
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
echo $text_color"$count result$s."$normal_color
|
|
||||||
end
|
|
||||||
printf "%s\n" $result
|
|
||||||
end
|
|
||||||
end
|
|
||||||
@ -1,21 +0,0 @@
|
|||||||
function ta.cli.undo
|
|
||||||
if test $__ta_undo_lock = false
|
|
||||||
if test (ta.util.tasks.count) -gt 0
|
|
||||||
# Display task for the last time.
|
|
||||||
ta.util.get.tail | grep -E --color=always ".*"
|
|
||||||
|
|
||||||
if sed -Ei.bak '$ d' $__ta_file_data
|
|
||||||
rm $__ta_file_data.bak
|
|
||||||
else
|
|
||||||
set -l code $status
|
|
||||||
cp $__ta_file_data.bak $__ta_file_data
|
|
||||||
return $code
|
|
||||||
end
|
|
||||||
set -g __ta_undo_lock true
|
|
||||||
else
|
|
||||||
echo "There are no tasks."
|
|
||||||
return $__ta_error_no_tasks
|
|
||||||
end
|
|
||||||
end
|
|
||||||
echo "The undo stack is locked until a new task is added."
|
|
||||||
end
|
|
||||||
@ -1,15 +0,0 @@
|
|||||||
function ta.cli.version
|
|
||||||
set -l name (ta.util.tafile.get.key name)
|
|
||||||
set -l tagline (ta.util.tafile.get.key tagline)
|
|
||||||
set -l ver (ta.util.tafile.get.key version)
|
|
||||||
|
|
||||||
echo $name - (set_color yellow)$tagline(set_color normal) $ver
|
|
||||||
|
|
||||||
echo -s (set_color 777)"
|
|
||||||
If you are curious, ta or rather た, is a particle / deflection used in
|
|
||||||
Japanese to indicate the completion of an action, roughly corresponding
|
|
||||||
to the past tense in some western languages.
|
|
||||||
"(set_color normal)\
|
|
||||||
"
|
|
||||||
Now go get some stuff done!"
|
|
||||||
end
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
name,ta
|
|
||||||
tagline,to-done manager
|
|
||||||
version,1.0
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 19 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 224 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 26 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 22 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 26 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 228 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 27 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 15 KiB |
@ -1,16 +0,0 @@
|
|||||||
import plugins/fish-spec
|
|
||||||
import plugins/ta
|
|
||||||
|
|
||||||
function describe_ta -d "ta: to-done task manager"
|
|
||||||
function before_all
|
|
||||||
end
|
|
||||||
|
|
||||||
function after_all
|
|
||||||
end
|
|
||||||
|
|
||||||
function it_does_something
|
|
||||||
end
|
|
||||||
|
|
||||||
end
|
|
||||||
|
|
||||||
# spec.run $argv
|
|
||||||
@ -1,143 +0,0 @@
|
|||||||
# NAME
|
|
||||||
# ta - to-done manager
|
|
||||||
#
|
|
||||||
# SYNOPSIS
|
|
||||||
# ta [<task #tag #tag...>]
|
|
||||||
# [-u --undo]
|
|
||||||
# [-s --search <key[+key...]>]
|
|
||||||
# [-r --regex]
|
|
||||||
# [-n --number <number>]
|
|
||||||
# [-h --help]
|
|
||||||
# [--clear]
|
|
||||||
# [--version]
|
|
||||||
#
|
|
||||||
# USAGE
|
|
||||||
# [<task>]
|
|
||||||
# Add new completed task. Append a `#' to keywords to apply tags.
|
|
||||||
# Simply run ta without arguments to list all completed tasks.
|
|
||||||
#
|
|
||||||
# -s --search <key[,...]>
|
|
||||||
# Search tasks tagged by <key>. Use `+' to search tasks with all
|
|
||||||
# the specified tags. Use -r and `|' to search for tasks with at
|
|
||||||
# least one of the specified tags
|
|
||||||
#
|
|
||||||
# Some tags are automatically created based in the current date:
|
|
||||||
#
|
|
||||||
# Weekdays mon...sun
|
|
||||||
# Month jan...dec
|
|
||||||
# Day 1st, 2nd, 3rd, 4th...31st
|
|
||||||
# Time 12am...12pm
|
|
||||||
#
|
|
||||||
# -r --regex {-s<key>}
|
|
||||||
# Use <key> as a regular expression.
|
|
||||||
#
|
|
||||||
# -n --number <number>
|
|
||||||
# Truncate results to <number>.
|
|
||||||
#
|
|
||||||
# -u --undo
|
|
||||||
# Delete most recent task. Using this option locks the ability to undo
|
|
||||||
# until a new task is committed. This protects users from engaging in
|
|
||||||
# useless housekeeping habits.
|
|
||||||
#
|
|
||||||
# -h --help
|
|
||||||
# Show usage help.
|
|
||||||
#
|
|
||||||
# --clear
|
|
||||||
# Clear all data. Use with caution.
|
|
||||||
#
|
|
||||||
# --version
|
|
||||||
# Show version information.
|
|
||||||
#
|
|
||||||
# EXAMPLES
|
|
||||||
# Add a task.
|
|
||||||
# ta "talked to #mom #family"
|
|
||||||
#
|
|
||||||
# List all `spanish` tasks in July.
|
|
||||||
# ta -s spanish+jul
|
|
||||||
#
|
|
||||||
# List all `work` AND `opensource` tasks.
|
|
||||||
# ta -s work+opensource
|
|
||||||
#
|
|
||||||
# List all `workout` OR `cardio` OR `gym` tasks.
|
|
||||||
# ta -rs workout\|cardio\|gym
|
|
||||||
#
|
|
||||||
# List all `family` AND `friends` tasks. Show 5 most recent.
|
|
||||||
# ta --search family+friends -n5
|
|
||||||
#
|
|
||||||
# DESCRIPTION
|
|
||||||
# In a todo-like system, each task is a promise scheduled to be fullfilled
|
|
||||||
# in the future. In practice, promises can be hard to keep and prioritize.
|
|
||||||
#
|
|
||||||
# GTD-like methods offer good strategies to help with this, but they often
|
|
||||||
# require breaking die-to-hard habits and can be too complicated for users.
|
|
||||||
#
|
|
||||||
# Information flux is unpredictable, and dividing how this information is
|
|
||||||
# collected and processed in often overlapping stages is challenging.
|
|
||||||
#
|
|
||||||
# A to-done approach is not incompatible with traditional todo-lists, but
|
|
||||||
# it was created in a world where todo lists are not prominent.
|
|
||||||
#
|
|
||||||
# The premise is as information flow crosses over the singularity threshold
|
|
||||||
# data-collection and sorting becomes impossible and unwieldy. The contract
|
|
||||||
# is to spend less time prioritizing and concentrate in completing only one
|
|
||||||
# task at a time. Only completed tasks can be logged into the system.
|
|
||||||
#
|
|
||||||
# Overall happiness and motivation increase will be directly proportional
|
|
||||||
# to the number of completed tasks.
|
|
||||||
#
|
|
||||||
# AUTHORS
|
|
||||||
# Jorge Bucaran <jbucaran@me.com>
|
|
||||||
#/
|
|
||||||
function ta -d "to-done manager"
|
|
||||||
set -l flags
|
|
||||||
|
|
||||||
while set opts (getopts ":s:search: n:number: r:regex
|
|
||||||
u:undo h:help clear version" $argv)
|
|
||||||
switch $opts[1]
|
|
||||||
case s n
|
|
||||||
set flags $flags search
|
|
||||||
if test $opts[1] = n
|
|
||||||
set number $opts[2]
|
|
||||||
else
|
|
||||||
set search $opts[2]
|
|
||||||
end
|
|
||||||
case r
|
|
||||||
set flags $flags regex
|
|
||||||
case u
|
|
||||||
set flags undo
|
|
||||||
case h
|
|
||||||
set flags help
|
|
||||||
case clear
|
|
||||||
set flags clear
|
|
||||||
case version
|
|
||||||
set flags version
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
if test $status -gt 1
|
|
||||||
ta.cli.help
|
|
||||||
return $__ta_error_bad_input
|
|
||||||
|
|
||||||
else if contains -- undo $flags
|
|
||||||
ta.cli.undo
|
|
||||||
|
|
||||||
else if contains -- search $flags
|
|
||||||
# Pipe to less with color, left-width and verbose status bar.
|
|
||||||
ta.cli.search "$search" "$number" $flags \
|
|
||||||
| less -JM --raw-control-chars
|
|
||||||
|
|
||||||
else if contains -- version $flags
|
|
||||||
ta.cli.version
|
|
||||||
|
|
||||||
else if contains -- clear $flags
|
|
||||||
ta.cli.clear
|
|
||||||
|
|
||||||
else if test -n "$opts"
|
|
||||||
ta.cli.commit "$opts"
|
|
||||||
|
|
||||||
else if contains -- help $flags
|
|
||||||
ta.cli.help
|
|
||||||
else
|
|
||||||
ta --search ""
|
|
||||||
end
|
|
||||||
end
|
|
||||||
@ -1,46 +0,0 @@
|
|||||||
set -g __ta_error 1
|
|
||||||
set -g __ta_error_bad_input 2
|
|
||||||
set -g __ta_error_no_tasks 3
|
|
||||||
|
|
||||||
# Standalone installation.
|
|
||||||
if set -q ta_path
|
|
||||||
for file in $ta_path/**
|
|
||||||
switch $file
|
|
||||||
case \*.fish
|
|
||||||
set -l dir (dirname $file)
|
|
||||||
# Skip completions and spec directories.
|
|
||||||
if test (basename $dir) != "completions" -a \
|
|
||||||
(basename $dir) != "spec"
|
|
||||||
if not contains -- "$dir" $fish_function_path
|
|
||||||
set fish_function_path "$dir" $fish_function_path
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
# Oh-my-fish installation.
|
|
||||||
else if set -q fish_path
|
|
||||||
set -g ta_path $fish_path/plugins/ta
|
|
||||||
# Oh-my-fish lets you import modules easily. For standalone fish
|
|
||||||
# installations, fish getopts is already included in the path.
|
|
||||||
import plugins/getopts
|
|
||||||
else
|
|
||||||
# Neither $INSTALL_PATH or $fish_path exists.
|
|
||||||
echo "Please review the installation instructions and try again." ^&2
|
|
||||||
exit $__ta_error
|
|
||||||
end
|
|
||||||
|
|
||||||
set -g __ta_file_info $ta_path/config/tafile
|
|
||||||
set -g __ta_file_data $ta_path/data/tasks
|
|
||||||
|
|
||||||
# Regular expression used to extract tags from tasks.
|
|
||||||
set -g __ta_regex "#\S*"
|
|
||||||
|
|
||||||
# Seconds elapsed between last and current task to commit.
|
|
||||||
set -g __ta_delta 0
|
|
||||||
|
|
||||||
# Flag to track whether the undo stack is locked. Tasks are usually
|
|
||||||
# inmutable except for the most recent task to allow simple mistake
|
|
||||||
# correction.
|
|
||||||
set -q __ta_undo_lock
|
|
||||||
or set -g __ta_undo_lock false
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
function ta.util.color.tags -a color
|
|
||||||
env GREP_COLOR="$color" grep --color=always -E "$__ta_regex|\$"
|
|
||||||
end
|
|
||||||
@ -1,4 +0,0 @@
|
|||||||
function ta.util.get.tail
|
|
||||||
tail -rn1 $__ta_file_data \
|
|
||||||
| cut -f1
|
|
||||||
end
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
function ta.util.tafile.get.key -a key
|
|
||||||
grep -E "\b$key\b" $__ta_file_info | cut -d, -f2
|
|
||||||
end
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
function ta.util.tags.get -a task
|
|
||||||
echo "$task" | tr -s "[:space:]" \n | grep -Eo "$__ta_regex" | cut -c2-
|
|
||||||
end
|
|
||||||
@ -1,20 +0,0 @@
|
|||||||
function ta.util.tags.get.meta
|
|
||||||
set -l week (date +%a)
|
|
||||||
set -l day (date +%d)
|
|
||||||
switch $day
|
|
||||||
case 1 21 31
|
|
||||||
set $day "$day"st
|
|
||||||
case 2 22
|
|
||||||
set $day "$day"nd
|
|
||||||
case 3 23
|
|
||||||
set $day "$day"rd
|
|
||||||
case \*
|
|
||||||
set $day "$day"th
|
|
||||||
end
|
|
||||||
set -l month (date +%b)
|
|
||||||
set -l year (date +%Y)
|
|
||||||
set -l hour (date "+%r" | \
|
|
||||||
sed -E "s/0?([1-9][0-9]?).*(..)/\1\2/")
|
|
||||||
|
|
||||||
printf "#%s " $week $day $month $year $hour | awk '{print tolower}'
|
|
||||||
end
|
|
||||||
@ -1,3 +0,0 @@
|
|||||||
function ta.util.tasks.count
|
|
||||||
wc -l < $__ta_file_data | awk '{print $1}'
|
|
||||||
end
|
|
||||||
Loading…
Reference in New Issue
Block a user