Compare commits
8 Commits
19dde076cf
...
archive/co
| Author | SHA1 | Date | |
|---|---|---|---|
|
f4145348d0 | ||
|
|
c9a158338b | ||
|
|
6132bdeb47 | ||
|
|
213f6afa38 | ||
|
|
7db3a2de13 | ||
|
|
4f504b26c9 | ||
|
|
6c950429f6 | ||
|
|
9fb52d04e6 |
BIN
.github/example.gif
vendored
BIN
.github/example.gif
vendored
Binary file not shown.
|
Before Width: | Height: | Size: 657 KiB |
3
.gitignore
vendored
3
.gitignore
vendored
@@ -1,6 +1,3 @@
|
||||
VERSION-FILE
|
||||
tests/test-results
|
||||
tests/trash\ directory.*
|
||||
done.txt
|
||||
report.txt
|
||||
todo.txt
|
||||
|
||||
@@ -1,6 +0,0 @@
|
||||
# Note: "shell" would be more appropriate
|
||||
language: python
|
||||
|
||||
install: make dist && sudo make install
|
||||
|
||||
script: make test
|
||||
410
CHANGELOG.md
410
CHANGELOG.md
@@ -1,410 +0,0 @@
|
||||
# Changelog
|
||||
All notable changes to this project will be documented in this file.
|
||||
|
||||
The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
|
||||
and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [2.11.0] - 2018-03-26
|
||||
### Added
|
||||
- Added support for `$XDG_CONFIG_HOME` config file/actions location
|
||||
- Created [CODE_OF_CONDUCT.md](/CODE_OF_CONDUCT.md) ([#217])
|
||||
- Created [CHANGELOG.md](/CHANGELOG.md) ([#218])
|
||||
|
||||
|
||||
### Changed
|
||||
- Updated `add` command to accept lowercase priority ([#230])
|
||||
- Clean tests and version file in Makefile. Don't ignore errors in tests.
|
||||
- Updated [README.md](/README.md) ([#219])
|
||||
- Update Downloads links to point at the Releases page ([#228])
|
||||
- Set the executable bit when preparing releases ([#156])
|
||||
|
||||
### Fixes
|
||||
- Update links to use https
|
||||
- Suppress todo.sh error messages when invoked during completion ([#8])
|
||||
|
||||
|
||||
## [2.10.0] - 2013-12-06
|
||||
### Added
|
||||
- Enable term filtering for listcon.
|
||||
- Add make install command.
|
||||
- Enable use of global config file in `/etc/todo/config`. `make install` installs a global config file.
|
||||
- Allow use of `post_filter_command` for `listall` and `listpri`.
|
||||
- Print usage help for custom action and all passed actions.
|
||||
- Allow configuring null data files (done.txt and report.txt) and don't create
|
||||
them.
|
||||
- Color contexts and projects without an add-on, just by setting vars in the
|
||||
config file.
|
||||
- Place add-ons in subfolders (for easier git clone).
|
||||
|
||||
### Changed
|
||||
- Improve code commenting/documentation.
|
||||
- Refactor code for speed/better organization.
|
||||
- Improve test coverage and test library.
|
||||
|
||||
### Removed
|
||||
- Removed add date from line completion, ie, `todo.sh ls 10[tab]`.
|
||||
|
||||
### Fixed
|
||||
- Properly replace date when replacing task with priority and date.
|
||||
- Handle `-h`, `shorthelp`, and `help` when a Fatal Error happens.
|
||||
- Fix `todo_completion` problem with Bash 3.1.
|
||||
|
||||
## [2.9.0] - 2012-04-08
|
||||
### Added
|
||||
- Added tab auto-completion of projects and contexts from `todo.txt` and `done.txt`. Type `@<Tab>` or `+<Tab>` while entering a task.
|
||||
- Added new listaddons command displays installed addons.
|
||||
- List priorities within a range using listpri. For example, to see tasks prioritized A-B, use `todo.sh listpri A-B`
|
||||
|
||||
### Fixed
|
||||
- Fixed various cosmetic issues, bugs, and added developer test library enhancements.
|
||||
|
||||
|
||||
## [2.8.0] - 2011-09-13
|
||||
### Added
|
||||
- `listpri`/`lsp` now filters by term. For example, `todo.sh lsp A book` will only return tasks prioritized `A` with the word book in them.
|
||||
- Added support for todo directory paths with spaces in them.
|
||||
- Tasks with priority included and auto prepend date on (`-t`) get the date where expected.
|
||||
- Smarter action completion messaging: `do`, `pri`, and `depri` all let you know if a task is already done, prioritized, or deprioritized.
|
||||
- Made more parameters available to offer more control to custom actions (`-c`, `-A`, `-N`, `-T`)
|
||||
|
||||
### Changed
|
||||
- Improved portability for Dropbox or USB key users. If not specified, todo.sh checks for a config file in its own directory; default todo.txt location is todo.sh's directory.
|
||||
- Improved script performance thanks to optimized code
|
||||
- Exposed `cleaninput()` for use in addons
|
||||
- Improved testing framework:
|
||||
- Better escaped input handling
|
||||
- Abstracted make_action function to test custom action behavior
|
||||
- Added tests for source code compliance
|
||||
- Cleaner, simpler, modernized, optimized code
|
||||
|
||||
### Fixed
|
||||
- Custom action output no longer prefaced by `TODO:` so it's easier to see when the core script vs. addon is performing an action
|
||||
- `listpri` complains if specified priority is invalid
|
||||
- Don't abort task listing when items contain certain escape sequences (`\c \033`)
|
||||
- Condense whitespace ONLY whe task is quoted; automatically convert CRLF to space
|
||||
- Don't delete `|` (pipe) from task input
|
||||
- `-+` and `-@` no longer break task coloring if context or project appears at the end of the line
|
||||
|
||||
|
||||
## [2.7.0] - 2010-08-03
|
||||
### Added
|
||||
- Added generalization of the _PRI_X_ color support to all priorities
|
||||
- Added highlighting of done, but not yet archived tasks via *COLOR_DONE*
|
||||
- Color map (BLACK, ...) now supports spaces in the color definitions, making it possible to override the default ANSI escape codes with e.g. Conky tags (`${color black}`)
|
||||
|
||||
### Changed
|
||||
- Cleanup: help messages, consistent output messages
|
||||
- Exporting `die()` function for use in custom commands
|
||||
- `prepend` and `replace` actions keep prepended date, `append` considers sentence delimiters
|
||||
- Tests: several regression tests added
|
||||
|
||||
## [2.6.0] - 2010-05-11
|
||||
### Added
|
||||
- Added a case for the fixed replace command.
|
||||
|
||||
### Changed
|
||||
- Changed odd tabs to spaces.
|
||||
- Faster help/useage document outputs.
|
||||
- Consolidated `TODOTXT_VERBOSE` tests.
|
||||
- Refactored various add functionality to one function.
|
||||
- Updated `_list()` output to match updated `addto`.
|
||||
|
||||
### Fixed
|
||||
- Quoting regexp to parse properly.
|
||||
- Fixed erroneous hide/show comments.
|
||||
- Correctly fixed regexp quoting issue for bash v3.1.x and v3.2.x.
|
||||
- Old versions of bash do not have `=~`
|
||||
- Fix line endings.
|
||||
- Fixed bug for replace command.
|
||||
|
||||
## [2.5.0] - 2010-05-05
|
||||
### Added
|
||||
- Support use of `$HOME/.todo/` for all todo.sh configuration
|
||||
- Added new multiple do capability to help message
|
||||
- Added option to disable final filter
|
||||
- Added a new variable `$TODO_FULL_SH`
|
||||
- Added new action `addm`
|
||||
- Added support PAGER pipe for help output
|
||||
- Added some additional mappings, plus a project context
|
||||
|
||||
### Changed
|
||||
- Added 'silent' to a bunch of calls
|
||||
|
||||
### Fixed
|
||||
- Fixing prepend and priority issue.
|
||||
- Replace with `priority` set
|
||||
- Multiple `do` items
|
||||
- `prepend` not correct on prioritized tasks
|
||||
- Invalid date range. Changed regex `[ -~]` to `[ ~-]`.
|
||||
- `do`: no safeguard to `do` twice. Tests item is not marked done before attempting to mark item as "done".
|
||||
- Fixed `add` does not escape line breaks
|
||||
- `append` and `replace` unexpected behavior if there's an `&` in task (even in quotes)
|
||||
- Tasks whose `ID` begins with `0` ought to be ignored.
|
||||
- Fixed auto-complete function name for contexts
|
||||
|
||||
|
||||
## [2.4.0] - 2009-05-11
|
||||
### Added
|
||||
- Added support for `TODOTXT_FINAL_FILTER` to provide a final custom list filter.
|
||||
- Added support for custom sorting (can set in `todo.cfg`)
|
||||
- Added parameterize for `.todo.actions.d` directory
|
||||
|
||||
### Removed
|
||||
- Removed annoying trailing space on `pri` tasks
|
||||
- Don't set colors in default `todo.cfg`.
|
||||
- Don't set sort command in default `todo.cfg`.
|
||||
|
||||
### Fixed
|
||||
- `listcon` and `listproj` now work correctly on Mac OS X 10.5
|
||||
- `pri` accepted priorities of more than a single letter
|
||||
- Support commands combination for `TODOTXT_SORT_COMMAND`; e.g. piped commands can be used: `export TODOTXT_SORT_COMMAND=" env LC_COLLATE=C sort -f -k2 - | grep -m 10 ."`
|
||||
- Replace now echoes old item AND new item, like it used to.
|
||||
- `depri` no longer wipes out tasks with more than just the priority in parentheses
|
||||
- Now throws an error if you try to prioritize with more than one letter, ie, `todo.sh pri AA` doesn't work any more.
|
||||
|
||||
## [2.3.0] - 2009-04-02
|
||||
### Added
|
||||
- Added hide priority, context, and projects options now enabled `-P`, `-@` and `-+`
|
||||
- Enabled recursive call of todo.sh from add-ons
|
||||
- Exported variables for use in add-ons
|
||||
- Added `-vv` option for debugging output
|
||||
- Added short usage statement (that fits on one screen) with `-h`
|
||||
- Added Makefile dist infrastructure for versioned releases in Downloads area on GitHub
|
||||
|
||||
### Changed
|
||||
- Separated `_list` function for reuse by various versions of list command to reduce duplicate code
|
||||
- Set `ls` as the default action
|
||||
|
||||
|
||||
## [2.2.0] - 2009-03-??
|
||||
### Fixed
|
||||
- For awhile here during the GitHub transition, we stripped the version number from todo.sh and updated it kind of willy-nilly, so we're back-versioning all unversioned copies v 2.2.
|
||||
|
||||
|
||||
## [2.1.0] - 2009-02-23
|
||||
### Added
|
||||
- Added "pluggability" with `~/.todo.actions.d/` support (via [Tammy and Ed](http://tech.groups.yahoo.com/group/todotxt/message/1739))
|
||||
- Added `-t` param, off by default. When specified, it automatically prepends the current date to new todo's on add
|
||||
- Searches for more Unix-y `~/.todo.cfg` if `~/todo.cfg` doesn't exist (via [Ed](http://tech.groups.yahoo.com/group/todotxt/message/1767))
|
||||
|
||||
### Fixed
|
||||
- Corrected "ambiguous redirect" bug with done file (via [Jeff](http://tech.groups.yahoo.com/group/todotxt/message/1764))
|
||||
- Corrected usage and help message with new params
|
||||
- Corrected config file miscomment about colors
|
||||
|
||||
|
||||
## [2.0.1] - 2009-02-17
|
||||
### Fixed
|
||||
- Restored `-d` parameter functionality broken in 2.0 (d'oh, thanks Jason, you made the changelog! )
|
||||
|
||||
|
||||
## [2.0.0] - 2009-02-17
|
||||
### Added
|
||||
- Added `addto [DEST] "Text to add"` will append text to any file in the todo directory, like `ideas.txt` or `maybelater.txt`.
|
||||
- Added `mv # [DEST]` will move a task from `todo.txt` to another file `[DEST]` in the todo directory, like if you decide your `"Learn French"` task should go into your `maybelater.txt` file.
|
||||
- `depri #` removes priority from a task.
|
||||
- `rm # [TERM]` or `del # [TERM]` will delete just the `[TERM]` from the task on line # in todo.txt.
|
||||
- `listfile [SRC] [TERM]` or `lf [SRC] [TERM]` will list the contents of any text file in the todo directory, and filter by keyword `[TERM]`.
|
||||
- `listcon` (`lsc`) and `listproj` (`lsprj`) lists contexts and projects, respectively, that appear in todo.txt. (Requires `gawk`)
|
||||
- On task deletion, line number preservation is on by default (known issue, leaves blank lines). Optional, can be turned off with `-n` option.
|
||||
- Auto-archive on task completion is now on by default; can be turned off with `-a` parameter.
|
||||
|
||||
### Changed
|
||||
- Separated config file into a non hidden dot file.
|
||||
|
||||
### Fixed
|
||||
- Better error handling throughout for all commands.
|
||||
- Archive now defrags the file (removes blank lines; see line preservation option.)
|
||||
- Using `/bin/bash` instead of `/bin/sh`
|
||||
|
||||
|
||||
## [1.7.3] - 2006-07-29
|
||||
### Added
|
||||
- Added short action aliases – `add/a`, `list/ls`, `listpri/lsp`, `listall/lsa`, `prepend/prep`, `append/app`, `del/rm`
|
||||
|
||||
|
||||
## [1.7.2] - 2006-07-28
|
||||
### Added
|
||||
- `listpri` automatically capitalizes lowercase priorities
|
||||
- `listpri` now displays friendly error message, and the # of tasks returned in verbose mode
|
||||
|
||||
### Changed
|
||||
- `do` action removes priority from task automatically
|
||||
Update:
|
||||
|
||||
### Fixed
|
||||
- Actions are now case-insensitive (ie, `todo.sh Add` will work)
|
||||
|
||||
|
||||
## [1.7.1] - 2006-07-21
|
||||
### Changed
|
||||
- I'm a big dummy and didn't keep track of what I fixed here. Sorry!
|
||||
|
||||
|
||||
## [1.7.0] - 2006-07-19
|
||||
### Added
|
||||
- Interactive `add`, `append`, `prepend`, and `replace` (tx, Ben!)
|
||||
- Action `listall` displays tasks from both todo.txt and done.txt
|
||||
- Option `-f` forces delete action and disables interactive input (for todobot.pl)
|
||||
- Option `-h` displays full help message.
|
||||
|
||||
### Deprecated
|
||||
- Option `-q` deprecated; Use `-v` to turn on verbose mode
|
||||
|
||||
### Changed
|
||||
- A very short version of usage message displays by default instead of the long version.
|
||||
- Comment in info about `.todo` file being required
|
||||
|
||||
### Fixed
|
||||
- No colors display for done tasks (tx, Tanja!)
|
||||
- Sort is now case-insensitive (tx, Lonnie!)
|
||||
|
||||
|
||||
## [1.6.3] - 2006-07-06
|
||||
### Added
|
||||
- Line numbers now padded, up to 100 characters. (tx, Tanja!)
|
||||
|
||||
|
||||
## [1.6.2] - 2006-07-05
|
||||
### Fixed
|
||||
- Windows config files with spaces now work (tx Ron)
|
||||
|
||||
|
||||
## [1.6.1] - 2006-07-05
|
||||
### Changed
|
||||
- The default location of your `.todo` file is now `$HOME/.todo`
|
||||
|
||||
### Fixed
|
||||
- No colors mode (`-p`) now works as expected
|
||||
|
||||
|
||||
## [1.6.0] - 2006-07-04
|
||||
### Added
|
||||
- Action `prepend` adds text to an item at the beginning of the line.
|
||||
- Configuration file is now separated from script into `.todo` file
|
||||
- Specify a config file other than `.todo` using the `-d` option
|
||||
- Option `-q` quiets todo.sh's chattiness.
|
||||
- Option `-V` shows version and license information.
|
||||
|
||||
### Changed
|
||||
- The option to turn off colors is now `-p` (no longer `-nc` as in 1.5.2)
|
||||
|
||||
|
||||
## [1.5.2] - 2006-06-26
|
||||
### Fixed
|
||||
- Items that start with `x ` (an x with a space after) are archived now to avoid lines that start with a word like `xander` from being archived. (tx, Tannie!)
|
||||
- Report now only archives items that start with `x ` as well.
|
||||
|
||||
|
||||
## [1.5.1] - 2006-06-26
|
||||
### Fixed
|
||||
- Items with an `x` in them at all were being deleted on archive with 1.5; all fixed now.
|
||||
|
||||
|
||||
## [1.5.0] - 2006-06-24
|
||||
### Added
|
||||
- Option to turn off colors (to avoid characters in piped text files or IM bot), ie `todo.sh -nc [COMMAND]`
|
||||
- A date is added to a completed todo, ie `x 2006-06-24` (tx SETH)
|
||||
- Action `remdup` removes exact duplicate lines from todo.txt (tx Tannie)
|
||||
- Action `del` removes any blank lines from todo.txt (tx Tannie)
|
||||
|
||||
### Changed
|
||||
- Using `sed -i` instead of copying tmp file (tx Tannie)
|
||||
|
||||
### Fixed
|
||||
- Colors show in OS/X 10.4 (tx SETH & misha)
|
||||
|
||||
|
||||
## [1.4.0] - 2006-06-17
|
||||
### Added
|
||||
- Tasks are color-coded by priority in Cygwin (Thanks, Abraham, Manuel and Luis!)
|
||||
|
||||
### Changed
|
||||
- Switched endless `if-then` to a `case` statement, and tightened up `wc -l` regex. (Thanks, Sash!)
|
||||
|
||||
### Fixed
|
||||
- If you `replace`/`do`/`append` to a non-existent task, your todo.txt is no longer overwritten and the error is handled gracefully. (Thanks, Scott!)
|
||||
|
||||
|
||||
## [1.3.0] - 2006-05-29
|
||||
### Added
|
||||
- Displays the number of newly added todo (Thanks, Amy!)
|
||||
- Confirms whether or not you really want to delete a todo
|
||||
- Displays success messages and confirmations on `append`, `replace`, `do`, etc.
|
||||
- Added licensing information in comments. GPL, baby!
|
||||
|
||||
### Changed
|
||||
- Alphabetized command workflow in if/then construction
|
||||
- Tightened up `sed` commands, removed unnecessary `grep`s and `cat`s (Thanks, Sash!)
|
||||
- Stripped whitespace around number lines from wc results
|
||||
|
||||
### Removed
|
||||
- Removed filenames from `report.txt` format, for easier graphing or Excel imports.
|
||||
|
||||
### Fixed
|
||||
- Todos are now sorted alphabetically when listed by a term. (ie: `todo list flowers)
|
||||
|
||||
|
||||
## [1.2.0] - 2006-05-15
|
||||
### Added
|
||||
- `list` is case insenstive. ie, `todo list Mac` will match lines with "mac" and "Mac"
|
||||
|
||||
### Changed
|
||||
- `todo list` matches multiple [TERM]s. ie, `todo list mac offline` will match all lines that contain the words "mac" and "offline"
|
||||
- `repri` and `pri` actions combined into `pri` action (Thanks Mike!)
|
||||
- Quotes no longer required with `add` and `replace` (Thanks Karl!)
|
||||
- Any priority added to a todo must be uppercase to preserve sort order, enforced now. ie `todo pri 1 a` will return a usage error.
|
||||
|
||||
### Fixed
|
||||
- File "sanity checks" and cleanup function, test script and various fantastic stylistic improvements added. Extra big thanks to Karl!
|
||||
|
||||
|
||||
## [1.1.0] - 2006-05-12
|
||||
### Added
|
||||
- Supports file paths with spaces (ie `C:\Documents and Settings\gina\todo.txt`)
|
||||
|
||||
|
||||
## 1.0.0 - 2006-05-11
|
||||
### Added
|
||||
- Consolidated into one master script with usage notes and released.
|
||||
|
||||
|
||||
[Unreleased]: https://github.com/todotxt/todo.txt-cli/compare/v2.11.0...HEAD
|
||||
[2.11.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.10.0...v2.11.0
|
||||
[2.10.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.9.0...v2.10.0
|
||||
[2.9.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.8.0...v2.9.0
|
||||
[2.8.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.7.0...v2.8.0
|
||||
[2.7.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.6.0...v2.7.0
|
||||
[2.6.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.5.0...v2.6.0
|
||||
[2.5.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.4.0...v2.5.0
|
||||
[2.4.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.3.0...v2.4.0
|
||||
[2.3.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.2.0...v2.3.0
|
||||
[2.2.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.1.0...v2.2.0
|
||||
[2.1.0]: https://github.com/todotxt/todo.txt-cli/compare/v2.0.1...v2.1.0
|
||||
[2.0.1]: https://github.com/todotxt/todo.txt-cli/compare/v2.0.0...v2.0.1
|
||||
[2.0.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.7.3...v2.0.0
|
||||
[1.7.3]: https://github.com/todotxt/todo.txt-cli/compare/v1.7.2...v1.7.3
|
||||
[1.7.2]: https://github.com/todotxt/todo.txt-cli/compare/v1.7.1...v1.7.2
|
||||
[1.7.1]: https://github.com/todotxt/todo.txt-cli/compare/v1.7.0...v1.7.1
|
||||
[1.7.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.6.3...v1.7.0
|
||||
[1.6.3]: https://github.com/todotxt/todo.txt-cli/compare/v1.6.2...v1.6.3
|
||||
[1.6.2]: https://github.com/todotxt/todo.txt-cli/compare/v1.6.1...v1.6.2
|
||||
[1.6.1]: https://github.com/todotxt/todo.txt-cli/compare/v1.6.0...v1.6.1
|
||||
[1.6.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.5.2...v1.6.0
|
||||
[1.5.2]: https://github.com/todotxt/todo.txt-cli/compare/v1.5.1...v1.5.2
|
||||
[1.5.1]: https://github.com/todotxt/todo.txt-cli/compare/v1.5.0...v1.5.1
|
||||
[1.5.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.4.0...v1.5.0
|
||||
[1.4.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.3.0...v1.4.0
|
||||
[1.3.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.2.0...v1.3.0
|
||||
[1.2.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.1.0...v1.2.0
|
||||
[1.1.0]: https://github.com/todotxt/todo.txt-cli/compare/v1.0.0...v1.1.0
|
||||
|
||||
[#230]: https://github.com/todotxt/todo.txt-cli/pull/230
|
||||
[#228]: https://github.com/todotxt/todo.txt-cli/pull/228
|
||||
[#219]: https://github.com/todotxt/todo.txt-cli/pull/219
|
||||
[#218]: https://github.com/todotxt/todo.txt-cli/pull/218
|
||||
[#217]: https://github.com/todotxt/todo.txt-cli/pull/217
|
||||
[#156]: https://github.com/todotxt/todo.txt-cli/pull/156
|
||||
[#8]: https://github.com/todotxt/todo.txt-cli/pull/8
|
||||
@@ -1,46 +0,0 @@
|
||||
# Contributor Covenant Code of Conduct
|
||||
|
||||
## Our Pledge
|
||||
|
||||
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
|
||||
|
||||
## Our Standards
|
||||
|
||||
Examples of behavior that contributes to creating a positive environment include:
|
||||
|
||||
* Using welcoming and inclusive language
|
||||
* Being respectful of differing viewpoints and experiences
|
||||
* Gracefully accepting constructive criticism
|
||||
* Focusing on what is best for the community
|
||||
* Showing empathy towards other community members
|
||||
|
||||
Examples of unacceptable behavior by participants include:
|
||||
|
||||
* The use of sexualized language or imagery and unwelcome sexual attention or advances
|
||||
* Trolling, insulting/derogatory comments, and personal or political attacks
|
||||
* Public or private harassment
|
||||
* Publishing others' private information, such as a physical or electronic address, without explicit permission
|
||||
* Other conduct which could reasonably be considered inappropriate in a professional setting
|
||||
|
||||
## Our Responsibilities
|
||||
|
||||
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
|
||||
|
||||
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
|
||||
|
||||
## Scope
|
||||
|
||||
This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
|
||||
|
||||
## Enforcement
|
||||
|
||||
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at TBD@TBD.tld. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
|
||||
|
||||
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
|
||||
|
||||
## Attribution
|
||||
|
||||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
|
||||
|
||||
[homepage]: http://contributor-covenant.org
|
||||
[version]: http://contributor-covenant.org/version/1/4/
|
||||
@@ -1,97 +0,0 @@
|
||||
# Contributing
|
||||
|
||||
:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
|
||||
|
||||
It's people like you that make [todo.txt] such a great tool.
|
||||
|
||||
The following is a set of guidelines for contributing to [todo.txt] and its packages. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
|
||||
|
||||
Following these guidelines helps to communicate that you respect the time of the developers managing and developing this open source project. In return, they should reciprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.
|
||||
|
||||
[todo.txt] is an open source project and we love to receive contributions from our community — you! There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests or writing code which can be incorporated into [todo.txt] itself.
|
||||
|
||||
Please, don't use the issue tracker for support questions. Check whether our [Gitter.im] channel can help with your issue. Stack Overflow is also worth considering.
|
||||
|
||||
# Ground Rules
|
||||
|
||||
## Responsibilities
|
||||
|
||||
- Be welcoming to newcomers and encourage diverse new contributors from all backgrounds. See our [Code of Conduct].
|
||||
- Ensure cross-platform compatibility for every change that's accepted. Windows, Mac, Linux.
|
||||
- Create issues for any major changes and enhancements that you wish to make. Discuss things transparently and get community feedback.
|
||||
- Don't add any classes to the codebase unless absolutely needed. Err on the side of using functions.
|
||||
- Keep feature versions as small as possible, preferably one new feature per version.
|
||||
|
||||
# Your First Contribution
|
||||
|
||||
Unsure where to begin contributing? You can start by looking through these beginner and help-wanted issues:
|
||||
|
||||
- Beginner issues - issues which should only require a few lines of code, and a test or two.
|
||||
- Help wanted issues - issues which should be a bit more involved than beginner issues.
|
||||
|
||||
Both issue lists are sorted by total number of comments. While not perfect, number of comments is a reasonable proxy for impact a given change will have.
|
||||
|
||||
At this point, you're ready to make your changes! Feel free to ask for help; everyone is a beginner at first :smile_cat:
|
||||
|
||||
If a maintainer asks you to "rebase" your PR, they're saying that a lot of code has changed, and that you need to update your branch so it's easier to merge.
|
||||
|
||||
# Getting started
|
||||
|
||||
For something that is bigger than a one or two line fix:
|
||||
|
||||
1. Create your own fork of the code.
|
||||
1. Do the changes in your fork.
|
||||
1. If you like the change and think the project could use it:
|
||||
- Be sure you have followed the code style for the project.
|
||||
- Note the [Code of Conduct].
|
||||
|
||||
As a rule of thumb, changes are obvious fixes if they do not introduce any new functionality or creative thinking. As long as the change does not affect functionality, some likely examples include the following:
|
||||
|
||||
- Spelling / grammar fixes
|
||||
- Typo correction, white space and formatting changes
|
||||
- Comment clean up
|
||||
- Bug fixes that change default return values or error codes stored in constants
|
||||
- Adding logging messages or debugging output
|
||||
- Changes to ‘metadata’ files like .gitignore, build scripts, etc.
|
||||
- Moving source files from one directory or package to another
|
||||
|
||||
# How to report a bug
|
||||
|
||||
## Security Vulnerability
|
||||
|
||||
If you find a security vulnerability, do NOT open an issue. Get ahold of the maintainers personally.
|
||||
|
||||
In order to determine whether you are dealing with a security issue, ask yourself these two questions:
|
||||
|
||||
- Can I access something that's not mine, or something I shouldn't have access to?
|
||||
- Can I disable something for other people?
|
||||
|
||||
If the answer to either of those two questions are "yes", then you're probably dealing with a security issue. Note that even if you answer "no" to both questions, you may still be dealing with a security issue, so if you're unsure, just email us directly.
|
||||
|
||||
## Bug
|
||||
|
||||
When filing an issue, make sure to answer these five questions:
|
||||
|
||||
1. What version of shell are you using (`echo $0` or `$(echo $SHELL) --version)`)?
|
||||
1. What operating system and processor architecture are you using?
|
||||
1. What did you do?
|
||||
1. What did you expect to see?
|
||||
1. What did you see instead?
|
||||
|
||||
# How to suggest a feature or enhancement
|
||||
|
||||
The [todo.txt] philosophy is to provide a plain-text, software-agnostic way to keep track of your tasks.
|
||||
|
||||
If you find yourself wishing for a feature that doesn't exist, you are probably not alone. There are bound to be others out there with similar needs. Many of the features that todo.txt-cli has today have been added because our users saw the need. Open an issue on our issues list on GitHub which describes the feature you would like to see, why you need it, and how it should work.
|
||||
|
||||
# Code review process
|
||||
|
||||
The core team looks at Pull Requests on a regular basis. After feedback has been given we expect responses within two weeks. After two weeks we may close the pull request if it isn't showing any activity.
|
||||
|
||||
# Community
|
||||
|
||||
You can chat with the core team on https://gitter.im/todotxt/.
|
||||
|
||||
[todo.txt]: https://github.com/todotxt/
|
||||
[Code of Conduct]: /CODE_OF_CONDUCT.md
|
||||
[Gitter.im]: https://gitter.im/todotxt/
|
||||
@@ -8,7 +8,7 @@ LF='
|
||||
'
|
||||
|
||||
if test -d .git -o -f .git &&
|
||||
VN=$(git describe --abbrev=0 --tags 2>/dev/null) &&
|
||||
VN=$(git describe --abbrev=4 HEAD 2>/dev/null) &&
|
||||
case "$VN" in
|
||||
*$LF*) (exit 1) ;;
|
||||
v[0-9]*)
|
||||
|
||||
@@ -1,22 +0,0 @@
|
||||
**Do you want to request a *feature* or report a *bug*?**
|
||||
|
||||
|
||||
**What is the current behavior?**
|
||||
|
||||
|
||||
**If the current behavior is a bug, please provide the steps to reproduce and if possible a minimal demo of the problem.**
|
||||
|
||||
|
||||
**What is the expected behavior?**
|
||||
|
||||
|
||||
**Which versions todo.sh are you using?**
|
||||
> Run `todo.sh -V`
|
||||
|
||||
|
||||
**Which Operating System are you using?**
|
||||
|
||||
|
||||
**Which version of bash are you using?**
|
||||
> Run `bash --version`
|
||||
|
||||
8
LICENSE
8
LICENSE
@@ -1,7 +1,7 @@
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
@@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found.
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
@@ -664,11 +664,11 @@ might be different; for a GUI interface, you would use an "about box".
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<https://www.gnu.org/licenses/>.
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<https://www.gnu.org/licenses/why-not-lgpl.html>.
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
40
Makefile
40
Makefile
@@ -2,22 +2,6 @@
|
||||
# Makefile for todo.txt
|
||||
#
|
||||
|
||||
SHELL = /bin/sh
|
||||
|
||||
INSTALL = /usr/bin/install
|
||||
INSTALL_PROGRAM = $(INSTALL)
|
||||
INSTALL_DATA = $(INSTALL) -m 644
|
||||
|
||||
prefix = /usr/local
|
||||
|
||||
# The directory to install todo.sh in.
|
||||
bindir = $(prefix)/bin
|
||||
|
||||
# The directory to install the config file in.
|
||||
sysconfdir = $(prefix)/etc
|
||||
|
||||
datarootdir = $(prefix)/share
|
||||
|
||||
# Dynamically detect/generate version file as necessary
|
||||
# This file will define a variable called VERSION.
|
||||
.PHONY: .FORCE-VERSION-FILE
|
||||
@@ -36,35 +20,15 @@ dist: $(DISTFILES) todo.sh
|
||||
mkdir -p $(DISTNAME)
|
||||
cp -f $(DISTFILES) $(DISTNAME)/
|
||||
sed -e 's/@DEV_VERSION@/'$(VERSION)'/' todo.sh > $(DISTNAME)/todo.sh
|
||||
chmod +x $(DISTNAME)/todo.sh
|
||||
tar cf $(DISTNAME).tar $(DISTNAME)/
|
||||
gzip -f -9 $(DISTNAME).tar
|
||||
zip -9r $(DISTNAME).zip $(DISTNAME)/
|
||||
rm -r $(DISTNAME)
|
||||
|
||||
.PHONY: clean
|
||||
clean: test-pre-clean
|
||||
clean:
|
||||
rm -f $(DISTNAME).tar.gz $(DISTNAME).zip
|
||||
rm VERSION-FILE
|
||||
|
||||
install: installdirs
|
||||
$(INSTALL_PROGRAM) todo.sh $(DESTDIR)$(bindir)/todo.sh
|
||||
$(INSTALL_DATA) todo_completion $(DESTDIR)$(datarootdir)/bash_completion.d/todo
|
||||
[ -e $(DESTDIR)$(sysconfdir)/todo/config ] || \
|
||||
sed "s/^\(export[ \t]*TODO_DIR=\).*/\1~\/.todo/" todo.cfg > $(DESTDIR)$(sysconfdir)/todo/config
|
||||
|
||||
uninstall:
|
||||
rm -f $(DESTDIR)$(bindir)/todo.sh
|
||||
rm -f $(DESTDIR)$(datarootdir)/bash_completion.d/todo
|
||||
rm -f $(DESTDIR)$(sysconfdir)/todo/config
|
||||
|
||||
rmdir $(DESTDIR)$(datarootdir)/bash_completion.d
|
||||
rmdir $(DESTDIR)$(sysconfdir)/todo
|
||||
|
||||
installdirs:
|
||||
mkdir -p $(DESTDIR)$(bindir) \
|
||||
$(DESTDIR)$(sysconfdir)/todo \
|
||||
$(DESTDIR)$(datarootdir)/bash_completion.d
|
||||
|
||||
#
|
||||
# Testing
|
||||
@@ -78,7 +42,7 @@ test-pre-clean:
|
||||
aggregate-results: $(TESTS)
|
||||
|
||||
$(TESTS): test-pre-clean
|
||||
cd tests && ./$(notdir $@) $(TEST_OPTIONS)
|
||||
-cd tests && ./$(notdir $@) $(TEST_OPTIONS)
|
||||
|
||||
test: aggregate-results
|
||||
tests/aggregate-results.sh tests/test-results/t*-*
|
||||
|
||||
@@ -1,9 +0,0 @@
|
||||
**Before submitting a pull request,** please make sure the following is done:
|
||||
|
||||
- [ ] Fork [the repository](https://github.com/todotxt/todo.txt-cli) and create your branch from `master`.
|
||||
- [ ] If you've added code that should be tested, add tests!
|
||||
- [ ] Ensure the test suite passes.
|
||||
- [ ] Format your code with [ShellCheck](https://www.shellcheck.net/).
|
||||
- [ ] Include a human-readable description of what the pull request is trying to accomplish.
|
||||
- [ ] Steps for the reviewer(s) on how they can manually QA the changes.
|
||||
- [ ] Have a `fixes #XX` reference to the issue that this pull request fixes.
|
||||
99
README.md
99
README.md
@@ -1,99 +0,0 @@
|
||||
# [][website]
|
||||
|
||||
> A simple and extensible shell script for managing your todo.txt file.
|
||||
|
||||
[](https://travis-ci.org/todotxt/todo.txt-cli)
|
||||
[](https://github.com/todotxt/todo.txt-cli/issues)
|
||||
[](https://github.com/todotxt/todo.txt-cli/network)
|
||||
[](https://github.com/todotxt/todo.txt-cli/stargazers)
|
||||
[](https://raw.githubusercontent.com/todotxt/todo.txt-cli/master/LICENSE)
|
||||
[](https://gitter.im/todotxt/todo.txt-cli)
|
||||
|
||||
|
||||
|
||||
*Read our [contributing guide](CONTRIBUTING.md) if you're looking to contribute (issues/PRs/etc).*
|
||||
|
||||
|
||||
## Installation
|
||||
|
||||
### Download
|
||||
Download the latest stable [release][release] for use on your desktop or server.
|
||||
|
||||
### OS X / macOS
|
||||
|
||||
```shell
|
||||
brew install todo-txt
|
||||
```
|
||||
|
||||
### Linux
|
||||
|
||||
#### From command line
|
||||
|
||||
```shell
|
||||
make
|
||||
make install
|
||||
make test
|
||||
```
|
||||
|
||||
*NOTE:* Makefile defaults to several default paths for installed files. Adjust to your system:
|
||||
|
||||
- `INSTALL_DIR`: PATH for executables (default /usr/local/bin)
|
||||
- `CONFIG_DIR`: PATH for todo.txt config
|
||||
- `BASH_COMPLETION`: PATH for autocompletion scripts (default to /etc/bash_completion.d)
|
||||
|
||||
```shell
|
||||
make install CONFIG_DIR=/etc INSTALL_DIR=/usr/bin BASH_COMPLETION_DIR=/usr/share/bash-completion/completions
|
||||
```
|
||||
|
||||
#### Arch Linux (AUR)
|
||||
|
||||
https://aur.archlinux.org/packages/todotxt-git/
|
||||
|
||||
|
||||
## Usage
|
||||
```shell
|
||||
todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
```
|
||||
|
||||
For example, to add a todo item, you can do:
|
||||
|
||||
```shell
|
||||
todo.sh add "THING I NEED TO DO +project @context"
|
||||
```
|
||||
|
||||
Read about all the possible commands in the [USAGE][USAGE] file.
|
||||
|
||||
|
||||
## Release History
|
||||
|
||||
See [CHANGELOG.md][CHANGELOG]
|
||||
|
||||
|
||||
## Support
|
||||
|
||||
- [Stack Overflow](https://stackoverflow.com/questions/tagged/todotxt)
|
||||
- [Gitter chat](https://gitter.im/todotxt/todo.txt-cli)
|
||||
- [Twitter](https://twitter.com/todotxt)
|
||||
|
||||
|
||||
## Code of Conduct
|
||||
|
||||
[Contributor Code of Conduct][CODE_OF_CONDUCT]. By participating in this project you agree to abide by its terms.
|
||||
|
||||
## Contributing
|
||||
|
||||
We welcome all contributations. First read our [Contributor Code of Conduct][CODE_OF_CONDUCT] and then get started [contributing][CONTRIBUTING].
|
||||
|
||||
## License
|
||||
|
||||
GNU General Public License v3.0 © [todo.txt org][github]
|
||||
|
||||
|
||||
|
||||
[release]: https://github.com/todotxt/todo.txt-cli/releases
|
||||
[website]: http://todotxt.org
|
||||
[github]: https://github.com/todotxt
|
||||
[USAGE]: ./USAGE.md
|
||||
[CHANGELOG]: ./CHANGELOG.md
|
||||
[CODE_OF_CONDUCT]: ./CODE_OF_CONDUCT.md
|
||||
[CONTRIBUTING]: ./CONTRIBUTING.md
|
||||
27
README.textile
Normal file
27
README.textile
Normal file
@@ -0,0 +1,27 @@
|
||||
h1. TODO.TXT Command Line Interface
|
||||
|
||||
A simple and extensible shell script for managing your todo.txt file.
|
||||
|
||||
h2. "Downloads":http://github.com/ginatrapani/todo.txt-cli/downloads
|
||||
|
||||
"Download the latest stable release":http://github.com/ginatrapani/todo.txt-cli/downloads for use on your desktop or server.
|
||||
|
||||
h2. "Documentation":http://wiki.github.com/ginatrapani/todo.txt-cli
|
||||
|
||||
* "User Documentation":http://wiki.github.com/ginatrapani/todo.txt-cli/user-documentation - Find out "how to install and use Todo.txt CLI":http://wiki.github.com/ginatrapani/todo.txt-cli/user-documentation, and get tips and tricks.
|
||||
|
||||
* "Developer Documentation":http://wiki.github.com/ginatrapani/todo.txt-cli/developer-documentation - "Contribute to Todo.txt CLI":http://wiki.github.com/ginatrapani/todo.txt-cli/developer-documentation and build your own custom add-ons.
|
||||
|
||||
h2. "Mailing List":http://groups.yahoo.com/group/todotxt/
|
||||
|
||||
Get support from users and developers on the "mailing list":http://groups.yahoo.com/group/todotxt/.
|
||||
|
||||
h2. Quick Links
|
||||
|
||||
* Original anemic release by "Gina Trapani":http://ginatrapani.org on 5/11/2006.
|
||||
* Raised to great heights by "brainy and dedicated volunteers":http://github.com/ginatrapani/todo.txt-cli/network.
|
||||
* Licensed under the "GPL":http://www.gnu.org/copyleft/gpl.html
|
||||
* "Add-on Directory":https://github.com/ginatrapani/todo.txt-cli/wiki/Todo.sh-Add-on-Directory
|
||||
https://github.com/ginatrapani/todo.txt-cli/wiki/Creating-and-Installing-Add-ons
|
||||
* "Changelog":http://wiki.github.com/ginatrapani/todo.txt-cli/todosh-changelog
|
||||
* "Known Bugs":http://github.com/ginatrapani/todo.txt-cli/issues
|
||||
266
USAGE.md
266
USAGE.md
@@ -1,266 +0,0 @@
|
||||
# [todo.txt-cli](http://todotxt.org) Usage
|
||||
|
||||
```shell
|
||||
todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
```
|
||||
|
||||
## Actions
|
||||
|
||||
### `add`
|
||||
Adds THING I NEED TO DO to your todo.txt file on its own line.
|
||||
|
||||
Project and context notation optional.
|
||||
|
||||
Quotes optional.
|
||||
|
||||
```shell
|
||||
todo.sh add "THING I NEED TO DO +project @context"
|
||||
todo.sh a "THING I NEED TO DO +project @context"
|
||||
```
|
||||
|
||||
### `addm`
|
||||
Adds FIRST THING I NEED TO DO to your todo.txt on its own line and adds SECOND THING I NEED TO DO to you todo.txt on its own line.
|
||||
|
||||
Project and context notation optional.
|
||||
|
||||
```shell
|
||||
todo.sh addm "FIRST THING I NEED TO DO +project1 @context
|
||||
SECOND THING I NEED TO DO +project2 @context"
|
||||
```
|
||||
|
||||
### `addto`
|
||||
Adds a line of text to any file located in the todo.txt directory.
|
||||
|
||||
For example, `addto inbox.txt "decide about vacation"`
|
||||
|
||||
```shell
|
||||
todo.sh addto DEST "TEXT TO ADD"
|
||||
```
|
||||
|
||||
### `append`
|
||||
Adds TEXT TO APPEND to the end of the task on line ITEM#.
|
||||
|
||||
Quotes optional.
|
||||
|
||||
```shell
|
||||
todo.sh append ITEM# "TEXT TO APPEND"
|
||||
todo.sh app ITEM# "TEXT TO APPEND"
|
||||
```
|
||||
|
||||
### `archive`
|
||||
Moves all done tasks from todo.txt to done.txt and removes blank lines.
|
||||
|
||||
```shell
|
||||
todo.sh archive
|
||||
```
|
||||
|
||||
### `command`
|
||||
Runs the remaining arguments using only todo.sh builtins.
|
||||
|
||||
Will not call any `.todo.actions.d` scripts.
|
||||
|
||||
```shell
|
||||
todo.sh command [ACTIONS]
|
||||
```
|
||||
|
||||
### `deduplicate`
|
||||
Removes duplicate lines from todo.txt.
|
||||
|
||||
```shell
|
||||
todo.sh deduplicate
|
||||
```
|
||||
|
||||
### `del`
|
||||
Deletes the task on line ITEM# in todo.txt. If TERM specified, deletes only TERM from the task.
|
||||
|
||||
```shell
|
||||
todo.sh del ITEM# [TERM]
|
||||
todo.sh rm ITEM# [TERM]
|
||||
```
|
||||
|
||||
### `depri`
|
||||
Deprioritizes (removes the priority) from the task(s) on line ITEM# in todo.txt.
|
||||
|
||||
```shell
|
||||
todo.sh depri ITEM#[, ITEM#, ITEM#, ...]
|
||||
todo.sh dp ITEM#[, ITEM#, ITEM#, ...]
|
||||
```
|
||||
|
||||
### `do`
|
||||
Marks task(s) on line ITEM# as done in todo.txt.
|
||||
|
||||
```shell
|
||||
todo.sh do ITEM#[, ITEM#, ITEM#, ...]
|
||||
```
|
||||
|
||||
### `help`
|
||||
Display help about usage, options, built-in and add-on actions, or just the usage help for the passed ACTION(s).
|
||||
|
||||
```shell
|
||||
todo.sh help [ACTION...]
|
||||
```
|
||||
|
||||
### `list`
|
||||
Displays all tasks that contain TERM(s) sorted by priority with line numbers. Each task must match all TERM(s) (logical AND); to display tasks that contain any TERM (logical OR), use `"TERM1\|TERM2\|..."` (with quotes), or `TERM1\\|TERM2` (unquoted). Hides all tasks that contain TERM(s) preceded by a minus sign (i.e. `-TERM`).
|
||||
|
||||
If no TERM specified, lists entire todo.txt.
|
||||
|
||||
```shell
|
||||
todo.sh list [TERM...]
|
||||
todo.sh ls [TERM...]
|
||||
```
|
||||
|
||||
### `listall`
|
||||
Displays all the lines in todo.txt AND done.txt that contain TERM(s) sorted by priority with line numbers. Hides all tasks that contain TERM(s) preceded by a minus sign (i.e. `-TERM`).
|
||||
|
||||
If no TERM specified, lists entire todo.txt AND done.txt concatenated and sorted.
|
||||
|
||||
```shell
|
||||
todo.sh listall [TERM...]
|
||||
todo.sh lsa [TERM...]
|
||||
```
|
||||
|
||||
### `listaddons`
|
||||
Lists all added and overridden actions in the actions directory.
|
||||
|
||||
```shell
|
||||
todo.sh listaddons
|
||||
```
|
||||
|
||||
### `listcon`
|
||||
Lists all the task contexts that start with the @ sign in todo.txt.
|
||||
|
||||
If TERM specified, considers only tasks that contain TERM(s).
|
||||
|
||||
```shell
|
||||
todo.sh listcon [TERM...]
|
||||
todo.sh lsc [TERM...]
|
||||
```
|
||||
|
||||
### `listfile`
|
||||
Displays all the lines in SRC file located in the todo.txt directory, sorted by priority with line numbers. If TERM specified, lists all lines that contain TERM(s) in SRC file. Hides all tasks that contain TERM(s) preceded by a minus sign (i.e. `-TERM`).
|
||||
|
||||
Without any arguments, the names of all text files in the todo.txt directory are listed.
|
||||
|
||||
```shell
|
||||
todo.sh listfile [SRC [TERM...]]
|
||||
todo.sh lf [SRC [TERM...]]
|
||||
```
|
||||
|
||||
### `listpri`
|
||||
Displays all tasks prioritized PRIORITIES. PRIORITIES can be a single one (A) or a range (A-C). If no PRIORITIES specified, lists all prioritized tasks. If TERM specified, lists only prioritized tasks that contain TERM(s). Hides all tasks that contain TERM(s) preceded by a minus sign (i.e. `-TERM`).
|
||||
|
||||
```shell
|
||||
todo.sh listpri [PRIORITIES] [TERM...]
|
||||
todo.sh lsp [PRIORITIES] [TERM...]
|
||||
```
|
||||
|
||||
### `listproj`
|
||||
Lists all the projects (terms that start with a `+` sign) in todo.txt. If TERM specified, considers only tasks that contain TERM(s).
|
||||
|
||||
```shell
|
||||
todo.sh listproj [TERM...]
|
||||
todo.sh lsprj [TERM...]
|
||||
```
|
||||
|
||||
### `move`
|
||||
Moves a line from source text file (SRC) to destination text file (DEST). Both source and destination file must be located in the directory defined in the configuration directory. When SRC is not defined it's by default todo.txt.
|
||||
|
||||
```shell
|
||||
todo.sh move ITEM# DEST [SRC]
|
||||
todo.sh mv ITEM# DEST [SRC]
|
||||
```
|
||||
|
||||
### `prepend`
|
||||
Adds TEXT TO PREPEND to the beginning of the task on line ITEM#. Quotes optional.
|
||||
|
||||
```shell
|
||||
todo.sh prepend ITEM# "TEXT TO PREPEND"
|
||||
todo.sh prep ITEM# "TEXT TO PREPEND"
|
||||
```
|
||||
|
||||
### `pri`
|
||||
Adds PRIORITY to task on line ITEM#. If the task is already prioritized, replaces current priority with new PRIORITY. PRIORITY must be a letter between A and Z.
|
||||
|
||||
```shell
|
||||
todo.sh pri ITEM# PRIORITY
|
||||
todo.sh p ITEM# PRIORITY
|
||||
```
|
||||
|
||||
### `replace`
|
||||
Replaces task on line ITEM# with UPDATED TODO.
|
||||
|
||||
```shell
|
||||
todo.sh replace ITEM# "UPDATED TODO"
|
||||
```
|
||||
|
||||
### `report`
|
||||
Adds the number of open tasks and done tasks to report.txt.
|
||||
|
||||
```shell
|
||||
todo.sh report
|
||||
```
|
||||
|
||||
### `shorthelp`
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
|
||||
```shell
|
||||
todo.sh shorthelp
|
||||
```
|
||||
|
||||
|
||||
## Options
|
||||
|
||||
### `-@`
|
||||
Hide context names in list output. Use twice to show context names (default).
|
||||
|
||||
### `-+`
|
||||
Hide project names in list output. Use twice to show project names (default).
|
||||
|
||||
### `-c`
|
||||
Color mode
|
||||
|
||||
### `-d CONFIG_FILE`
|
||||
Use a configuration file other than the default `~/.todo/config`
|
||||
|
||||
### `-f`
|
||||
Forces actions without confirmation or interactive input.
|
||||
|
||||
### `-h`
|
||||
Display a short help message; same as action "shorthelp"
|
||||
|
||||
### `-p`
|
||||
Plain mode turns off colors
|
||||
|
||||
### `-P`
|
||||
Hide priority labels in list output. Use twice to show priority labels (default).
|
||||
|
||||
### `-a`
|
||||
Don't auto-archive tasks automatically on completion
|
||||
|
||||
### `-A`
|
||||
Auto-archive tasks automatically on completion
|
||||
|
||||
### `-n`
|
||||
Don't preserve line numbers; automatically remove blank lines on task deletion.
|
||||
|
||||
### `-N`
|
||||
Preserve line numbers
|
||||
|
||||
### `-t`
|
||||
Prepend the current date to a task automatically when it's added.
|
||||
|
||||
### `-T`
|
||||
Do not prepend the current date to a task automatically when it's added.
|
||||
|
||||
### `-v`
|
||||
Verbose mode turns on confirmation messages
|
||||
|
||||
### `-vv`
|
||||
Extra verbose mode prints some debugging information and additional help text
|
||||
|
||||
### `-V`
|
||||
Displays version, license and credits
|
||||
|
||||
### `-x`
|
||||
Disables `TODOTXT_FINAL_FILTER`
|
||||
@@ -1,36 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
make_action()
|
||||
{
|
||||
unset TODO_ACTIONS_DIR
|
||||
[ -d .todo.actions.d ] || mkdir .todo.actions.d
|
||||
cat > ".todo.actions.d/$1" <<EOF
|
||||
#!/bin/bash
|
||||
[ "\$1" = "usage" ] && {
|
||||
echo " $1 ITEM#[, ITEM#, ...] [TERM...]"
|
||||
echo " This custom action does $1."
|
||||
echo ""
|
||||
exit
|
||||
}
|
||||
echo "custom action $1"
|
||||
EOF
|
||||
chmod +x ".todo.actions.d/$1"
|
||||
}
|
||||
|
||||
make_action_in_folder()
|
||||
{
|
||||
unset TODO_ACTIONS_DIR
|
||||
[ -d .todo.actions.d ] || mkdir .todo.actions.d
|
||||
mkdir .todo.actions.d/$1
|
||||
cat > ".todo.actions.d/$1/$1" <<EOF
|
||||
#!/bin/bash
|
||||
[ "\$1" = "usage" ] && {
|
||||
echo " $1 ITEM#[, ITEM#, ...] [TERM...]"
|
||||
echo " This custom action does $1."
|
||||
echo ""
|
||||
exit
|
||||
}
|
||||
echo "custom action $1 in folder $1"
|
||||
EOF
|
||||
chmod +x ".todo.actions.d/$1/$1"
|
||||
}
|
||||
@@ -8,10 +8,6 @@ to find it somewhere else.
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
|
||||
# Override default global config file
|
||||
export TODOTXT_GLOBAL_CFG_FILE=global.cfg
|
||||
|
||||
# Remove the pre-created todo.cfg to test behavior in its absence
|
||||
rm -f todo.cfg
|
||||
echo "Fatal Error: Cannot read configuration file $HOME/.todo/config" > expect
|
||||
@@ -59,14 +55,6 @@ test_expect_success 'config file (default location 3)' '
|
||||
rm -f .todo.cfg
|
||||
'
|
||||
|
||||
rm -f used_config
|
||||
test_expect_success 'config file (global config file)' '
|
||||
cp test.cfg "$TODOTXT_GLOBAL_CFG_FILE"
|
||||
todo.sh > output;
|
||||
test_cmp expect output && test -f used_config &&
|
||||
rm -f "$TODOTXT_GLOBAL_CFG_FILE"
|
||||
'
|
||||
|
||||
rm -f used_config
|
||||
test_expect_success 'config file (command line)' '
|
||||
todo.sh -d test.cfg > output;
|
||||
|
||||
@@ -9,15 +9,8 @@ On failure, it will print each offending line number and line.
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
backtick_check()
|
||||
{
|
||||
sed -n -e 's/\(^\|[ \t]\)#.*//' -e '/`/{' -e '=;p' -e '}' "$@"
|
||||
}
|
||||
|
||||
test_todo_session 'no old-style backtick command substitution' <<EOF
|
||||
>>> backtick_check bin/todo.sh
|
||||
|
||||
>>> backtick_check ../../todo.cfg
|
||||
>>> sed -n -e 's/\(^\|[ \t]\)#.*//' -e '/\`/{' -e '=;p' -e '}' "$(which todo.sh)"
|
||||
EOF
|
||||
|
||||
test_done
|
||||
|
||||
@@ -37,22 +37,6 @@ TODO: 2 of 2 tasks shown
|
||||
TODO: 2 deleted.
|
||||
EOF
|
||||
|
||||
test_todo_session 'cmd line first day with lowercase priority' <<EOF
|
||||
>>> todo.sh -pt add '(b) notice the daisies'
|
||||
2 (B) 2009-02-13 notice the daisies
|
||||
TODO: 2 added.
|
||||
|
||||
>>> todo.sh -p list
|
||||
2 (B) 2009-02-13 notice the daisies
|
||||
1 2009-02-13 notice the daisies
|
||||
--
|
||||
TODO: 2 of 2 tasks shown
|
||||
|
||||
>>> todo.sh -npf del 2
|
||||
2 (B) 2009-02-13 notice the daisies
|
||||
TODO: 2 deleted.
|
||||
EOF
|
||||
|
||||
test_tick
|
||||
|
||||
test_todo_session 'cmd line second day' <<EOF
|
||||
|
||||
@@ -1,33 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
test_description='test the priority on add feature'
|
||||
. ./test-lib.sh
|
||||
|
||||
## Normal use case
|
||||
echo "export TODOTXT_PRIORITY_ON_ADD=A" >> todo.cfg
|
||||
|
||||
test_todo_session 'config file priority' <<EOF
|
||||
>>> todo.sh add take out the trash
|
||||
1 (A) take out the trash
|
||||
TODO: 1 added.
|
||||
|
||||
>>> todo.sh -p list
|
||||
1 (A) take out the trash
|
||||
--
|
||||
TODO: 1 of 1 tasks shown
|
||||
EOF
|
||||
|
||||
## Wrong value in config var
|
||||
echo "export TODOTXT_PRIORITY_ON_ADD=1" >> todo.cfg
|
||||
|
||||
test_todo_session 'config file wrong priority' <<EOF
|
||||
>>> todo.sh add fail to take out the trash
|
||||
=== 1
|
||||
TODOTXT_PRIORITY_ON_ADD should be a capital letter from A to Z (it is now "1").
|
||||
|
||||
>>> todo.sh -p list
|
||||
=== 1
|
||||
TODOTXT_PRIORITY_ON_ADD should be a capital letter from A to Z (it is now "1").
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -164,12 +164,4 @@ TODO: Replaced task with:
|
||||
1 (A) 2010-07-04 this also has a new date
|
||||
EOF
|
||||
|
||||
echo '2009-02-13 this is just a new one' > todo.txt
|
||||
test_todo_session 'replace with prepended priority and date replaces existing date' <<EOF
|
||||
>>> todo.sh replace 1 '(B) 2010-07-04 this also has a new date'
|
||||
1 2009-02-13 this is just a new one
|
||||
TODO: Replaced task with:
|
||||
1 (B) 2010-07-04 this also has a new date
|
||||
EOF
|
||||
|
||||
test_done
|
||||
|
||||
@@ -55,16 +55,6 @@ test_todo_session 'listcon e-mail address test' <<EOF
|
||||
@con02
|
||||
EOF
|
||||
|
||||
cat > todo.txt <<EOF
|
||||
(B) smell the uppercase Roses +roses @outside +shared
|
||||
(C) notice the sunflowers +sunflowers @garden +shared +landscape
|
||||
stop
|
||||
EOF
|
||||
test_todo_session 'listcon with project' <<EOF
|
||||
>>> todo.sh listcon +landscape
|
||||
@garden
|
||||
EOF
|
||||
|
||||
cat > todo.txt <<EOF
|
||||
@con01 -- Some context 1 task
|
||||
EOF
|
||||
|
||||
@@ -114,9 +114,4 @@ test_todo_session 'listproj from combined open + done tasks' <<'EOF'
|
||||
+prj01
|
||||
EOF
|
||||
|
||||
test_todo_session 'listproj with GREP_OPTIONS disruption' <<'EOF'
|
||||
>>> GREP_OPTIONS=-n todo.sh listproj
|
||||
+prj01
|
||||
EOF
|
||||
|
||||
test_done
|
||||
|
||||
@@ -1,91 +0,0 @@
|
||||
#!/bin/bash
|
||||
#
|
||||
|
||||
test_description='highlighting projects and contexts
|
||||
|
||||
This test checks the highlighting (with colors) of projects and contexts.
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
# Prioritized tasks with projects and contexts
|
||||
cat > todo.txt <<EOF
|
||||
(A) prioritized @con01 context
|
||||
(B) prioritized +prj02 project
|
||||
(C) prioritized context at EOL @con03
|
||||
(D) prioritized project at EOL +prj04
|
||||
+prj05 non-prioritized project at BOL
|
||||
@con06 non-prioritized context at BOL
|
||||
multiple @con_ @texts and +pro_ +jects
|
||||
non-contexts: seti@home @ @* @(foo)
|
||||
non-projects: lost+found + +! +(bar)
|
||||
EOF
|
||||
|
||||
# config file specifying COLOR_PROJECT and COLOR_CONTEXT
|
||||
#
|
||||
TEST_TODO_LABEL_COLORS=todo-colors.cfg
|
||||
cat todo.cfg > "$TEST_TODO_LABEL_COLORS"
|
||||
|
||||
echo "export COLOR_CONTEXT='\\\\033[1m'" >>"$TEST_TODO_LABEL_COLORS"
|
||||
echo "export COLOR_PROJECT='\\\\033[2m'" >>"$TEST_TODO_LABEL_COLORS"
|
||||
|
||||
test_todo_session 'highlighting for contexts and projects' <<'EOF'
|
||||
>>> todo.sh -d "$TEST_TODO_LABEL_COLORS" ls
|
||||
[1;33m1 (A) prioritized [1m@con01[0m[1;33m context[0m
|
||||
[0;32m2 (B) prioritized [2m+prj02[0m[0;32m project[0m
|
||||
[1;34m3 (C) prioritized context at EOL [1m@con03[0m[1;34m[0m
|
||||
[1;37m4 (D) prioritized project at EOL [2m+prj04[0m[1;37m[0m
|
||||
5 [2m+prj05[0m non-prioritized project at BOL
|
||||
6 [1m@con06[0m non-prioritized context at BOL
|
||||
7 multiple [1m@con_[0m [1m@texts[0m and [2m+pro_[0m [2m+jects[0m
|
||||
8 non-contexts: seti@home @ @* @(foo)
|
||||
9 non-projects: lost+found + +! +(bar)
|
||||
--
|
||||
TODO: 9 of 9 tasks shown
|
||||
EOF
|
||||
|
||||
test_todo_session 'suppressing highlighting for contexts and projects' <<'EOF'
|
||||
>>> todo.sh -p -d "$TEST_TODO_LABEL_COLORS" ls
|
||||
1 (A) prioritized @con01 context
|
||||
2 (B) prioritized +prj02 project
|
||||
3 (C) prioritized context at EOL @con03
|
||||
4 (D) prioritized project at EOL +prj04
|
||||
5 +prj05 non-prioritized project at BOL
|
||||
6 @con06 non-prioritized context at BOL
|
||||
7 multiple @con_ @texts and +pro_ +jects
|
||||
8 non-contexts: seti@home @ @* @(foo)
|
||||
9 non-projects: lost+found + +! +(bar)
|
||||
--
|
||||
TODO: 9 of 9 tasks shown
|
||||
EOF
|
||||
|
||||
test_todo_session 'suppressing display of contexts' <<'EOF'
|
||||
>>> todo.sh -@ -d "$TEST_TODO_LABEL_COLORS" ls
|
||||
[1;33m1 (A) prioritized context[0m
|
||||
[0;32m2 (B) prioritized [2m+prj02[0m[0;32m project[0m
|
||||
[1;34m3 (C) prioritized context at EOL[0m
|
||||
[1;37m4 (D) prioritized project at EOL [2m+prj04[0m[1;37m[0m
|
||||
5 [2m+prj05[0m non-prioritized project at BOL
|
||||
6 non-prioritized context at BOL
|
||||
7 multiple and [2m+pro_[0m [2m+jects[0m
|
||||
8 non-contexts: seti@home @
|
||||
9 non-projects: lost+found + +! +(bar)
|
||||
--
|
||||
TODO: 9 of 9 tasks shown
|
||||
EOF
|
||||
|
||||
test_todo_session 'suppressing display of projects' <<'EOF'
|
||||
>>> todo.sh -+ -d "$TEST_TODO_LABEL_COLORS" ls
|
||||
[1;33m1 (A) prioritized [1m@con01[0m[1;33m context[0m
|
||||
[0;32m2 (B) prioritized project[0m
|
||||
[1;34m3 (C) prioritized context at EOL [1m@con03[0m[1;34m[0m
|
||||
[1;37m4 (D) prioritized project at EOL[0m
|
||||
5 non-prioritized project at BOL
|
||||
6 [1m@con06[0m non-prioritized context at BOL
|
||||
7 multiple [1m@con_[0m [1m@texts[0m and
|
||||
8 non-contexts: seti@home @ @* @(foo)
|
||||
9 non-projects: lost+found +
|
||||
--
|
||||
TODO: 9 of 9 tasks shown
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -1,44 +0,0 @@
|
||||
#!/bin/bash
|
||||
#
|
||||
|
||||
test_description='help functionality
|
||||
|
||||
This test covers the help output.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
|
||||
# Note: To avoid having to adapt the test whenever the help documentation
|
||||
# slightly changes, only check for the section headers.
|
||||
test_todo_session 'help output' <<EOF
|
||||
>>> todo.sh help | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Options:
|
||||
Built-in Actions:
|
||||
EOF
|
||||
|
||||
test_todo_session 'verbose help output' <<EOF
|
||||
>>> todo.sh -v help | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Options:
|
||||
Built-in Actions:
|
||||
EOF
|
||||
|
||||
test_todo_session 'very verbose help output' <<EOF
|
||||
>>> todo.sh -vv help | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Options:
|
||||
Environment variables:
|
||||
Built-in Actions:
|
||||
EOF
|
||||
|
||||
make_action "foo"
|
||||
test_todo_session 'help output with custom action' <<EOF
|
||||
>>> todo.sh -v help | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Options:
|
||||
Built-in Actions:
|
||||
Add-on Actions:
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -1,66 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
test_description='built-in actions help functionality
|
||||
|
||||
This test checks listing the usage help of a built-in action.
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
test_todo_session 'nonexisting action help' <<'EOF'
|
||||
>>> todo.sh help doesnotexist
|
||||
TODO: No action "doesnotexist" exists.
|
||||
=== 1
|
||||
|
||||
>>> todo.sh help hel
|
||||
TODO: No action "hel" exists.
|
||||
=== 1
|
||||
|
||||
>>> todo.sh help h
|
||||
TODO: No action "h" exists.
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
test_todo_session 'single action help' <<'EOF'
|
||||
>>> todo.sh help shorthelp
|
||||
shorthelp
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'multiple actions help' <<'EOF'
|
||||
>>> todo.sh help shorthelp append
|
||||
shorthelp
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
\
|
||||
append ITEM# "TEXT TO APPEND"
|
||||
app ITEM# "TEXT TO APPEND"
|
||||
Adds TEXT TO APPEND to the end of the task on line ITEM#.
|
||||
Quotes optional.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'short and long form of action help' <<'EOF'
|
||||
>>> todo.sh help append
|
||||
append ITEM# "TEXT TO APPEND"
|
||||
app ITEM# "TEXT TO APPEND"
|
||||
Adds TEXT TO APPEND to the end of the task on line ITEM#.
|
||||
Quotes optional.
|
||||
\
|
||||
|
||||
>>> todo.sh help app
|
||||
app ITEM# "TEXT TO APPEND"
|
||||
Adds TEXT TO APPEND to the end of the task on line ITEM#.
|
||||
Quotes optional.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'mixed existing and nonexisting action help' <<'EOF'
|
||||
>>> todo.sh help shorthelp doesnotexist list
|
||||
shorthelp
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
\
|
||||
TODO: No action "doesnotexist" exists.
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -1,82 +0,0 @@
|
||||
#!/bin/bash
|
||||
#
|
||||
|
||||
test_description='shorthelp functionality
|
||||
|
||||
This test covers the output of the -h option and the shorthelp action.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
|
||||
# Note: To avoid having to adapt the test whenever the actions change, only
|
||||
# check for the section headers.
|
||||
test_todo_session '-h output' <<EOF
|
||||
>>> todo.sh -h | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
See "help" for more details.
|
||||
EOF
|
||||
|
||||
test_todo_session 'shorthelp output' <<EOF
|
||||
>>> todo.sh shorthelp | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
See "help" for more details.
|
||||
EOF
|
||||
|
||||
make_action "foo"
|
||||
test_todo_session 'shorthelp output with custom action' <<EOF
|
||||
>>> todo.sh -v shorthelp | sed '/^ [A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
Add-on Actions:
|
||||
See "help" for more details.
|
||||
EOF
|
||||
|
||||
|
||||
# Verify that custom configuration is actually processed (when the -d option
|
||||
# precedes the -h option) by specifying a different actions directory and moving
|
||||
# our custom action there. The help output should mention the "Add-On Actions".
|
||||
set -o pipefail # So that the sed filter doesn't swallow todo.sh's exit code.
|
||||
mv todo.cfg custom.cfg
|
||||
mv .todo.actions.d custom.actions
|
||||
echo 'export TODO_ACTIONS_DIR=$HOME/custom.actions' >> custom.cfg
|
||||
|
||||
# Avoid the use of global config file, if it exists
|
||||
export TODOTXT_GLOBAL_CFG_FILE=global.cfg
|
||||
|
||||
test_todo_session '-h and fatal error without config' <<EOF
|
||||
>>> todo.sh -h | sed '/^ \\{0,2\\}[A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
See "help" for more details.
|
||||
Fatal Error: Cannot read configuration file $HOME/.todo/config
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
# Config option comes too late; "Add-on Actions" is *not* mentioned here.
|
||||
test_todo_session '-h and fatal error with trailing custom config' <<EOF
|
||||
>>> todo.sh -h -d custom.cfg | sed '/^ \\{0,2\\}[A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
See "help" for more details.
|
||||
Fatal Error: Cannot read configuration file $HOME/.todo/config
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
# Config option processed; "Add-on Actions" is mentioned here.
|
||||
test_todo_session '-h output with preceding custom config' <<EOF
|
||||
>>> todo.sh -d custom.cfg -h | sed '/^ \\{0,2\\}[A-Z]/!d'
|
||||
Usage: todo.sh [-fhpantvV] [-d todo_config] action [task_number] [task_description]
|
||||
Actions:
|
||||
Actions can be added and overridden using scripts in the actions
|
||||
Add-on Actions:
|
||||
See "help" for more details.
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -1,49 +0,0 @@
|
||||
#!/bin/bash
|
||||
#
|
||||
|
||||
test_description='todo.sh configuration with a sole todo.txt data file.
|
||||
|
||||
This test covers turning off done.txt and report.txt, and
|
||||
checks that no such empty files are created.
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
cat > test.cfg << EOF
|
||||
export TODO_DIR=.
|
||||
export TODO_FILE="\$TODO_DIR/todo.txt"
|
||||
export DONE_FILE=/dev/null
|
||||
export REPORT_FILE=/dev/null
|
||||
export TMP_FILE="\$TODO_DIR/todo.tmp"
|
||||
touch used_config
|
||||
EOF
|
||||
|
||||
test_todo_session 'invoke todo.sh' <<EOF
|
||||
>>> todo.sh -d test.cfg add notice the daisies
|
||||
1 notice the daisies
|
||||
TODO: 1 added.
|
||||
EOF
|
||||
|
||||
test_expect_success 'the todo file has been created' '[ -e todo.txt ]'
|
||||
test_expect_success 'no done file has been created' '[ ! -e done.txt ]'
|
||||
test_expect_success 'no report file has been created' '[ ! -e report.txt ]'
|
||||
|
||||
test_todo_session 'perform archive' <<EOF
|
||||
>>> todo.sh -A -d test.cfg do 1
|
||||
1 x 2009-02-13 notice the daisies
|
||||
TODO: 1 marked as done.
|
||||
x 2009-02-13 notice the daisies
|
||||
TODO: ./todo.txt archived.
|
||||
EOF
|
||||
|
||||
test_expect_success 'no done file has been created by the archiving' '[ ! -e done.txt ]'
|
||||
|
||||
test_todo_session 'perform report' <<EOF
|
||||
>>> todo.sh -d test.cfg report
|
||||
TODO: ./todo.txt archived.
|
||||
2009-02-13T04:40:00 0 0
|
||||
TODO: Report file updated.
|
||||
EOF
|
||||
|
||||
test_expect_success 'no report file has been created by the reporting' '[ ! -e report.txt ]'
|
||||
|
||||
test_done
|
||||
@@ -7,7 +7,7 @@ This test checks basic todo_completion of actions and options
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
readonly ACTIONS='add a addto addm append app archive command del rm depri dp do help list ls listaddons listall lsa listcon lsc listfile lf listpri lsp listproj lsprj move mv prepend prep pri p replace report shorthelp'
|
||||
readonly ACTIONS='add a addto addm append app archive command del rm depri dp do help list ls listall lsa listcon lsc listfile lf listpri lsp listproj lsprj move mv prepend prep pri p replace report shorthelp'
|
||||
readonly OPTIONS='-@ -@@ -+ -++ -d -f -h -p -P -PP -a -n -t -v -vv -V -x'
|
||||
|
||||
test_todo_completion 'all arguments' 'todo.sh ' "$ACTIONS $OPTIONS"
|
||||
|
||||
@@ -14,7 +14,6 @@ notice the sunflowers +sunflowers @outside @garden +shared +landscape
|
||||
(C) 2012-02-28 @outside mow the lawn
|
||||
x 2012-02-21 +herbs @oriental buy spices
|
||||
x 2012-02-28 2012-02-21 +slack @home watch tv
|
||||
2012-02-28 +herbs buy cinnamon @grocer
|
||||
EOF
|
||||
test_todo_completion 'simple task' 'todo.sh list 1' '"1 # simple task"'
|
||||
test_todo_completion 'remove projects and contents from task' 'todo.sh list 2' '"2 # notice the sunflowers"'
|
||||
@@ -22,6 +21,5 @@ test_todo_completion 'keep priority' 'todo.sh list 3' '"3 # (B) smell the flower
|
||||
test_todo_completion 'keep priority and remove timestamp' 'todo.sh list 4' '"4 # (C) mow the lawn"'
|
||||
test_todo_completion 'keep done marker and remove done date' 'todo.sh list 5' '"5 # x buy spices"'
|
||||
test_todo_completion 'keep done marker and remove timestamp and done date' 'todo.sh list 6' '"6 # x watch tv"'
|
||||
test_todo_completion 'remove add date' 'todo.sh list 7' '"7 # buy cinnamon"'
|
||||
|
||||
test_done
|
||||
|
||||
@@ -7,86 +7,20 @@ This test checks todo_completion of custom actions in .todo.actions.d
|
||||
'
|
||||
. ./test-lib.sh
|
||||
|
||||
readonly ACTIONS='add a addto addm append app archive command del rm depri dp do help list ls listaddons listall lsa listcon lsc listfile lf listpri lsp listproj lsprj move mv prepend prep pri p replace report shorthelp'
|
||||
readonly ACTIONS='add a addto addm append app archive command del rm depri dp do help list ls listall lsa listcon lsc listfile lf listpri lsp listproj lsprj move mv prepend prep pri p replace report shorthelp'
|
||||
readonly OPTIONS='-@ -@@ -+ -++ -d -f -h -p -P -PP -a -n -t -v -vv -V -x'
|
||||
|
||||
readonly ADDONS='bar baz foobar'
|
||||
|
||||
readonly CONTAINED='xeno zoolander'
|
||||
makeCustomActions()
|
||||
{
|
||||
set -e
|
||||
mkdir "${1:?}"
|
||||
for addon in $ADDONS
|
||||
do
|
||||
addonFile="${1}/$addon"
|
||||
> "$addonFile"
|
||||
chmod +x "$addonFile"
|
||||
done
|
||||
|
||||
# Also create a subdirectory, to test that it is skipped.
|
||||
mkdir "${1}/subdir"
|
||||
|
||||
# Also create a non-executable file, to test that it is skipped.
|
||||
datafile="${1:?}/datafile"
|
||||
> "$datafile"
|
||||
chmod -x "$datafile"
|
||||
[ -x "$datafile" ] && rm "$datafile" # Some file systems may always make files executable; then, skip this check.
|
||||
|
||||
# Add an executable file in a folder with the same name as the file,
|
||||
# in order to ensure completion
|
||||
for contained in $CONTAINED
|
||||
do
|
||||
mkdir "${1}/$contained"
|
||||
> "${1}/$contained/$contained"
|
||||
chmod u+x "${1}/$contained/$contained"
|
||||
done
|
||||
|
||||
set +e
|
||||
}
|
||||
removeCustomActions()
|
||||
{
|
||||
set -e
|
||||
rmdir "${1}/subdir"
|
||||
|
||||
for contained in $CONTAINED
|
||||
do
|
||||
rm "${1}/$contained/$contained"
|
||||
rmdir "${1}/$contained"
|
||||
done
|
||||
|
||||
rm "${1:?}/"*
|
||||
rmdir "$1"
|
||||
set +e
|
||||
}
|
||||
|
||||
#
|
||||
# Test resolution of the default TODO_ACTIONS_DIR.
|
||||
#
|
||||
makeCustomActions "$HOME/.todo.actions.d"
|
||||
test_todo_completion 'all arguments' 'todo.sh ' "$ACTIONS $ADDONS $CONTAINED $OPTIONS"
|
||||
test_todo_completion 'all arguments after option' 'todo.sh -a ' "$ACTIONS $ADDONS $CONTAINED $OPTIONS"
|
||||
mkdir "$HOME/.todo.actions.d"
|
||||
for addon in $ADDONS
|
||||
do
|
||||
> "$HOME/.todo.actions.d/$addon"
|
||||
chmod +x "$HOME/.todo.actions.d/$addon"
|
||||
done
|
||||
test_todo_completion 'all arguments' 'todo.sh ' "$ACTIONS $ADDONS $OPTIONS"
|
||||
test_todo_completion 'all arguments after option' 'todo.sh -a ' "$ACTIONS $ADDONS $OPTIONS"
|
||||
test_todo_completion 'all arguments beginning with b' 'todo.sh b' 'bar baz'
|
||||
test_todo_completion 'all arguments beginning with f after options' 'todo.sh -a -v f' 'foobar'
|
||||
test_todo_completion 'nothing after addon action' 'todo.sh foobar ' ''
|
||||
removeCustomActions "$HOME/.todo.actions.d"
|
||||
|
||||
#
|
||||
# Test resolution of an alternative TODO_ACTIONS_DIR.
|
||||
#
|
||||
mkdir "$HOME/.todo"
|
||||
makeCustomActions "$HOME/.todo/actions"
|
||||
test_todo_completion 'all arguments with actions from .todo/actions/' 'todo.sh ' "$ACTIONS $ADDONS $CONTAINED $OPTIONS"
|
||||
removeCustomActions "$HOME/.todo/actions"
|
||||
|
||||
#
|
||||
# Test resolution of a configured TODO_ACTIONS_DIR.
|
||||
#
|
||||
makeCustomActions "$HOME/addons"
|
||||
cat >> todo.cfg <<'EOF'
|
||||
export TODO_ACTIONS_DIR="$HOME/addons"
|
||||
EOF
|
||||
test_todo_completion 'all arguments with actions from addons/' 'todo.sh ' "$ACTIONS $ADDONS $CONTAINED $OPTIONS"
|
||||
removeCustomActions "$HOME/addons"
|
||||
|
||||
test_done
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
#!/bin/bash
|
||||
#
|
||||
|
||||
test_description='Bash help completion functionality
|
||||
|
||||
This test checks todo_completion of actions for usage help.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
make_action "zany"
|
||||
make_action "aardvark"
|
||||
|
||||
readonly ACTIONS='add a addto addm append app archive command del rm depri dp do help list ls listaddons listall lsa listcon lsc listfile lf listpri lsp listproj lsprj move mv prepend prep pri p replace report shorthelp'
|
||||
readonly ADDONS='aardvark zany'
|
||||
|
||||
test_todo_completion 'all actions after help' 'todo.sh help ' "$ACTIONS $ADDONS"
|
||||
test_todo_completion 'all actions after command help' 'todo.sh command help ' "$ACTIONS $ADDONS"
|
||||
test_todo_completion 'actions beginning with a' 'todo.sh help a' 'add a addto addm append app archive aardvark'
|
||||
|
||||
test_done
|
||||
@@ -4,9 +4,19 @@ test_description='custom actions functionality
|
||||
|
||||
This test covers the contract between todo.sh and custom actions.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
|
||||
unset TODO_ACTIONS_DIR
|
||||
mkdir .todo.actions.d
|
||||
make_action()
|
||||
{
|
||||
cat > ".todo.actions.d/$1" <<- EOF
|
||||
#!/bin/bash
|
||||
echo "custom action $1"
|
||||
EOF
|
||||
chmod +x ".todo.actions.d/$1"
|
||||
}
|
||||
|
||||
make_action "foo"
|
||||
test_todo_session 'executable action' <<EOF
|
||||
>>> todo.sh foo
|
||||
|
||||
@@ -1,84 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
test_description='listaddons functionality
|
||||
|
||||
This test checks listing of custom actions.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
|
||||
test_todo_session 'no custom actions' <<EOF
|
||||
>>> todo.sh listaddons
|
||||
EOF
|
||||
|
||||
make_action "foo"
|
||||
test_todo_session 'one custom action' <<EOF
|
||||
>>> todo.sh listaddons
|
||||
foo
|
||||
EOF
|
||||
|
||||
make_action "bar"
|
||||
make_action "ls"
|
||||
make_action "quux"
|
||||
test_todo_session 'multiple custom actions' <<EOF
|
||||
>>> todo.sh listaddons
|
||||
bar
|
||||
foo
|
||||
ls
|
||||
quux
|
||||
EOF
|
||||
|
||||
chmod -x .todo.actions.d/foo
|
||||
# On Cygwin, clearing the executable flag may have no effect, as the Windows ACL
|
||||
# may still grant execution rights. In this case, we skip the test.
|
||||
if [ -x .todo.actions.d/foo ]; then
|
||||
SKIP_TESTS="${SKIP_TESTS}${SKIP_TESTS+ }t8010.4"
|
||||
fi
|
||||
test_todo_session 'nonexecutable action' <<EOF
|
||||
>>> todo.sh listaddons
|
||||
bar
|
||||
ls
|
||||
quux
|
||||
EOF
|
||||
|
||||
make_action_in_folder "chuck"
|
||||
# Add a bit of cruft in the action folders in order to ensure that we only
|
||||
# care about the executables with the same name as the folder in which they
|
||||
# reside.
|
||||
touch .todo.actions.d/chuck/mc_hammer # can't touch this
|
||||
chmod u+x .todo.actions.d/chuck/mc_hammer # better run, better run run
|
||||
touch .todo.actions.d/chuck/README
|
||||
|
||||
make_action_in_folder "norris"
|
||||
|
||||
test_todo_session 'custom actions in subfolders' <<EOF
|
||||
>>> test -f .todo.actions.d/chuck/README
|
||||
=== 0
|
||||
|
||||
>>> test -x .todo.actions.d/chuck/mc_hammer
|
||||
=== 0
|
||||
|
||||
>>> todo.sh listaddons
|
||||
bar
|
||||
chuck
|
||||
ls
|
||||
norris
|
||||
quux
|
||||
EOF
|
||||
|
||||
# nthorne: shamelessly stolen from above..
|
||||
chmod -x .todo.actions.d/norris/norris
|
||||
# On Cygwin, clearing the executable flag may have no effect, as the Windows ACL
|
||||
# may still grant execution rights. In this case, we skip the test.
|
||||
if [ -x .todo.actions.d/norris/norris ]; then
|
||||
SKIP_TESTS="${SKIP_TESTS}${SKIP_TESTS+ }t8010.8"
|
||||
fi
|
||||
test_todo_session 'nonexecutable action in subfolder' <<EOF
|
||||
>>> todo.sh listaddons
|
||||
bar
|
||||
chuck
|
||||
ls
|
||||
quux
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -1,76 +0,0 @@
|
||||
#!/bin/bash
|
||||
|
||||
test_description='custom actions help functionality
|
||||
|
||||
This test checks listing the usage help of a custom action.
|
||||
'
|
||||
. ./actions-test-lib.sh
|
||||
. ./test-lib.sh
|
||||
|
||||
test_todo_session 'custom action help with no custom action directory' <<'EOF'
|
||||
>>> todo.sh help foo
|
||||
TODO: No action "foo" exists.
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
make_action "foo"
|
||||
make_action "bar"
|
||||
make_action "ls"
|
||||
make_action "quux"
|
||||
|
||||
test_todo_session 'custom action help' <<'EOF'
|
||||
>>> todo.sh help foo
|
||||
foo ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does foo.
|
||||
\
|
||||
|
||||
>>> todo.sh help bar
|
||||
bar ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does bar.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'multiple custom actions help' <<'EOF'
|
||||
>>> todo.sh help foo bar
|
||||
foo ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does foo.
|
||||
\
|
||||
bar ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does bar.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'nonexisting action help' <<'EOF'
|
||||
>>> todo.sh help doesnotexist
|
||||
TODO: No action "doesnotexist" exists.
|
||||
=== 1
|
||||
|
||||
>>> todo.sh help foo doesnotexist bar
|
||||
foo ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does foo.
|
||||
\
|
||||
TODO: No action "doesnotexist" exists.
|
||||
=== 1
|
||||
EOF
|
||||
|
||||
test_todo_session 'mixed built-in and custom actions help' <<'EOF'
|
||||
>>> todo.sh help foo shorthelp bar
|
||||
foo ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does foo.
|
||||
\
|
||||
shorthelp
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
\
|
||||
bar ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does bar.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_todo_session 'custom override of built-in action help' <<'EOF'
|
||||
>>> todo.sh help ls
|
||||
ls ITEM#[, ITEM#, ...] [TERM...]
|
||||
This custom action does ls.
|
||||
\
|
||||
EOF
|
||||
|
||||
test_done
|
||||
@@ -264,7 +264,25 @@ test_expect_success () {
|
||||
test_expect_output () {
|
||||
test "$#" = 2 ||
|
||||
error "bug in the test script: not 2 parameters to test-expect-output"
|
||||
test_expect_code_and_output 0 "$@"
|
||||
if ! test_skip "$@"
|
||||
then
|
||||
say >&3 "expecting success and output: $2"
|
||||
test_run_ "$2"
|
||||
if [ "$?" = 0 -a "$eval_ret" = 0 ]
|
||||
then
|
||||
cmp_output=$(test_cmp expect output)
|
||||
if [ "$?" = 0 ]
|
||||
then
|
||||
test_ok_ "$1"
|
||||
else
|
||||
test_failure_ "$@" "
|
||||
$cmp_output"
|
||||
fi
|
||||
else
|
||||
test_failure_ "$@"
|
||||
fi
|
||||
fi
|
||||
echo >&3 ""
|
||||
}
|
||||
|
||||
test_expect_code_and_output () {
|
||||
@@ -272,11 +290,7 @@ test_expect_code_and_output () {
|
||||
error "bug in the test script: not 3 parameters to test-expect-code-and-output"
|
||||
if ! test_skip "$@"
|
||||
then
|
||||
if [ "$1" = 0 ]; then
|
||||
say >&3 "expecting success and output: $3"
|
||||
else
|
||||
say >&3 "expecting exit code $1 and output: $3"
|
||||
fi
|
||||
say >&3 "expecting exit code $1 and output: $3"
|
||||
test_run_ "$3"
|
||||
if [ "$?" = 0 -a "$eval_ret" = "$1" ]
|
||||
then
|
||||
@@ -552,16 +566,14 @@ test_tick () {
|
||||
}
|
||||
|
||||
# Generate and run a series of tests based on a transcript.
|
||||
# Usage: test_todo_session "description" <<'EOF'
|
||||
# Usage: test_todo_session "description" <<EOF
|
||||
# >>> command
|
||||
# output1
|
||||
# output2
|
||||
#
|
||||
# >>> command
|
||||
# === exit status
|
||||
# output3 with empty line (must be escaped here)
|
||||
# \
|
||||
# output5
|
||||
# output3
|
||||
# output4
|
||||
# EOF
|
||||
test_todo_session () {
|
||||
test "$#" = 1 ||
|
||||
@@ -570,7 +582,7 @@ test_todo_session () {
|
||||
cmd=""
|
||||
status=0
|
||||
> expect
|
||||
while IFS= read -r line
|
||||
while read -r line
|
||||
do
|
||||
case $line in
|
||||
">>> "*)
|
||||
@@ -594,9 +606,6 @@ test_todo_session () {
|
||||
> expect
|
||||
fi
|
||||
;;
|
||||
\\)
|
||||
echo "" >> expect
|
||||
;;
|
||||
*)
|
||||
echo "$line" >> expect
|
||||
;;
|
||||
|
||||
13
todo.cfg
13
todo.cfg
@@ -1,8 +1,8 @@
|
||||
# === EDIT FILE LOCATIONS BELOW ===
|
||||
|
||||
# Your todo.txt directory (this should be an absolute path)
|
||||
# Your todo.txt directory
|
||||
#export TODO_DIR="/Users/gina/Documents/todo"
|
||||
export TODO_DIR=$(dirname "$0")
|
||||
export TODO_DIR=`dirname "$0"`
|
||||
|
||||
# Your todo/done/report.txt locations
|
||||
export TODO_FILE="$TODO_DIR/todo.txt"
|
||||
@@ -62,15 +62,6 @@ export REPORT_FILE="$TODO_DIR/report.txt"
|
||||
#
|
||||
# export COLOR_DONE=$LIGHT_GREY
|
||||
|
||||
# There is highlighting for projects and contexts.
|
||||
#
|
||||
# export COLOR_PROJECT=$RED
|
||||
# export COLOR_CONTEXT=$RED
|
||||
|
||||
# ... and for date extensions (due:yyyy-mm-dd, t:yyyy-mm-dd and again:X)
|
||||
#
|
||||
# export COLOR_DATEEXT=$LIGHT_BLUE
|
||||
|
||||
# === BEHAVIOR ===
|
||||
|
||||
## customize list output
|
||||
|
||||
449
todo.sh
449
todo.sh
@@ -1,4 +1,4 @@
|
||||
#!/usr/bin/env bash
|
||||
#! /bin/bash
|
||||
|
||||
# === HEAVY LIFTING ===
|
||||
shopt -s extglob extquote
|
||||
@@ -11,10 +11,12 @@ version() {
|
||||
cat <<-EndVersion
|
||||
TODO.TXT Command Line Interface v$VERSION
|
||||
|
||||
Homepage: http://todotxt.org
|
||||
Code repository: https://github.com/todotxt/todo.txt-cli/
|
||||
Contributors: https://github.com/todotxt/todo.txt-cli/graphs/contributors
|
||||
License: https://github.com/todotxt/todo.txt-cli/blob/master/LICENSE
|
||||
First release: 5/11/2006
|
||||
Original conception by: Gina Trapani (http://ginatrapani.org)
|
||||
Contributors: http://github.com/ginatrapani/todo.txt-cli/network
|
||||
License: GPL, http://www.gnu.org/copyleft/gpl.html
|
||||
More information and mailing list at http://todotxt.com
|
||||
Code repository: http://github.com/ginatrapani/todo.txt-cli/tree/master
|
||||
EndVersion
|
||||
exit 1
|
||||
}
|
||||
@@ -51,12 +53,11 @@ shorthelp()
|
||||
deduplicate
|
||||
del|rm ITEM# [TERM]
|
||||
depri|dp ITEM#[, ITEM#, ITEM#, ...]
|
||||
done|do ITEM#[, ITEM#, ITEM#, ...]
|
||||
help [ACTION...]
|
||||
do ITEM#[, ITEM#, ITEM#, ...]
|
||||
help
|
||||
list|ls [TERM...]
|
||||
listall|lsa [TERM...]
|
||||
listaddons
|
||||
listcon|lsc [TERM...]
|
||||
listcon|lsc
|
||||
listfile|lf [SRC [TERM...]]
|
||||
listpri|lsp [PRIORITIES] [TERM...]
|
||||
listproj|lsprj [TERM...]
|
||||
@@ -79,6 +80,7 @@ shorthelp()
|
||||
|
||||
See "help" for more details.
|
||||
EndHelpFooter
|
||||
exit 0
|
||||
}
|
||||
|
||||
help()
|
||||
@@ -134,7 +136,7 @@ help()
|
||||
|
||||
EndOptionsHelp
|
||||
|
||||
[ "$TODOTXT_VERBOSE" -gt 1 ] && cat <<-'EndVerboseHelp'
|
||||
[ $TODOTXT_VERBOSE -gt 1 ] && cat <<-'EndVerboseHelp'
|
||||
Environment variables:
|
||||
TODOTXT_AUTO_ARCHIVE is same as option -a (0)/-A (1)
|
||||
TODOTXT_CFG_FILE=CONFIG_FILE is same as option -d CONFIG_FILE
|
||||
@@ -142,7 +144,6 @@ help()
|
||||
TODOTXT_PRESERVE_LINE_NUMBERS is same as option -n (0)/-N (1)
|
||||
TODOTXT_PLAIN is same as option -p (1)/-c (0)
|
||||
TODOTXT_DATE_ON_ADD is same as option -t (1)/-T (0)
|
||||
TODOTXT_PRIORITY_ON_ADD=pri default priority A-Z
|
||||
TODOTXT_VERBOSE=1 is same as option -v
|
||||
TODOTXT_DISABLE_FILTER=1 is same as option -x
|
||||
TODOTXT_DEFAULT_ACTION="" run this when called with no arguments
|
||||
@@ -152,12 +153,6 @@ help()
|
||||
|
||||
|
||||
EndVerboseHelp
|
||||
actionsHelp
|
||||
addonHelp
|
||||
}
|
||||
|
||||
actionsHelp()
|
||||
{
|
||||
cat <<-EndActionsHelp
|
||||
Built-in Actions:
|
||||
add "THING I NEED TO DO +project @context"
|
||||
@@ -201,13 +196,11 @@ actionsHelp()
|
||||
Deprioritizes (removes the priority) from the task(s)
|
||||
on line ITEM# in todo.txt.
|
||||
|
||||
done ITEM#[, ITEM#, ITEM#, ...]
|
||||
do ITEM#[, ITEM#, ITEM#, ...]
|
||||
Marks task(s) on line ITEM# as done in todo.txt.
|
||||
|
||||
help [ACTION...]
|
||||
Display help about usage, options, built-in and add-on actions,
|
||||
or just the usage help for the passed ACTION(s).
|
||||
help
|
||||
Display this help message.
|
||||
|
||||
list [TERM...]
|
||||
ls [TERM...]
|
||||
@@ -226,23 +219,19 @@ actionsHelp()
|
||||
TERM specified, lists entire todo.txt AND done.txt
|
||||
concatenated and sorted.
|
||||
|
||||
listaddons
|
||||
Lists all added and overridden actions in the actions directory.
|
||||
|
||||
listcon [TERM...]
|
||||
lsc [TERM...]
|
||||
listcon
|
||||
lsc
|
||||
Lists all the task contexts that start with the @ sign in todo.txt.
|
||||
If TERM specified, considers only tasks that contain TERM(s).
|
||||
|
||||
listfile [SRC [TERM...]]
|
||||
lf [SRC [TERM...]]
|
||||
Displays all the lines in SRC file located in the todo.txt directory,
|
||||
sorted by priority with line numbers. If TERM specified, lists
|
||||
all lines that contain TERM(s) in SRC file. Hides all tasks that
|
||||
contain TERM(s) preceded by a minus sign (i.e. -TERM).
|
||||
contain TERM(s) preceded by a minus sign (i.e. -TERM).
|
||||
Without any arguments, the names of all text files in the todo.txt
|
||||
directory are listed.
|
||||
|
||||
|
||||
listpri [PRIORITIES] [TERM...]
|
||||
lsp [PRIORITIES] [TERM...]
|
||||
Displays all tasks prioritized PRIORITIES.
|
||||
@@ -250,13 +239,12 @@ actionsHelp()
|
||||
If no PRIORITIES specified, lists all prioritized tasks.
|
||||
If TERM specified, lists only prioritized tasks that contain TERM(s).
|
||||
Hides all tasks that contain TERM(s) preceded by a minus sign
|
||||
(i.e. -TERM).
|
||||
(i.e. -TERM).
|
||||
|
||||
listproj [TERM...]
|
||||
lsprj [TERM...]
|
||||
listproj
|
||||
lsprj
|
||||
Lists all the projects (terms that start with a + sign) in
|
||||
todo.txt.
|
||||
If TERM specified, considers only tasks that contain TERM(s).
|
||||
|
||||
move ITEM# DEST [SRC]
|
||||
mv ITEM# DEST [SRC]
|
||||
@@ -286,6 +274,9 @@ actionsHelp()
|
||||
List the one-line usage of all built-in and add-on actions.
|
||||
|
||||
EndActionsHelp
|
||||
|
||||
addonHelp
|
||||
exit 1
|
||||
}
|
||||
|
||||
addonHelp()
|
||||
@@ -294,7 +285,7 @@ addonHelp()
|
||||
didPrintAddonActionsHeader=
|
||||
for action in "$TODO_ACTIONS_DIR"/*
|
||||
do
|
||||
if [ -f "$action" ] && [ -x "$action" ]; then
|
||||
if [ -f "$action" -a -x "$action" ]; then
|
||||
if [ ! "$didPrintAddonActionsHeader" ]; then
|
||||
cat <<-EndAddonActionsHeader
|
||||
Add-on Actions:
|
||||
@@ -302,50 +293,11 @@ addonHelp()
|
||||
didPrintAddonActionsHeader=1
|
||||
fi
|
||||
"$action" usage
|
||||
elif [ -d "$action" ] && [ -x "$action"/"$(basename "$action")" ]; then
|
||||
if [ ! "$didPrintAddonActionsHeader" ]; then
|
||||
cat <<-EndAddonActionsHeader
|
||||
Add-on Actions:
|
||||
EndAddonActionsHeader
|
||||
didPrintAddonActionsHeader=1
|
||||
fi
|
||||
"$action"/"$(basename "$action")" usage
|
||||
fi
|
||||
done
|
||||
fi
|
||||
}
|
||||
|
||||
actionUsage()
|
||||
{
|
||||
for actionName
|
||||
do
|
||||
action="${TODO_ACTIONS_DIR}/${actionName}"
|
||||
if [ -f "$action" ] && [ -x "$action" ]; then
|
||||
"$action" usage
|
||||
elif [ -d "$action" ] && [ -x "$action"/"$(basename "$action")" ]; then
|
||||
"$action"/"$(basename "$action")" usage
|
||||
else
|
||||
builtinActionUsage=$(actionsHelp | sed -n -e "/^ ${actionName//\//\\/} /,/^\$/p" -e "/^ ${actionName//\//\\/}$/,/^\$/p")
|
||||
if [ "$builtinActionUsage" ]; then
|
||||
echo "$builtinActionUsage"
|
||||
echo
|
||||
else
|
||||
die "TODO: No action \"${actionName}\" exists."
|
||||
fi
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
||||
dieWithHelp()
|
||||
{
|
||||
case "$1" in
|
||||
help) help;;
|
||||
shorthelp) shorthelp;;
|
||||
esac
|
||||
shift
|
||||
|
||||
die "$@"
|
||||
}
|
||||
die()
|
||||
{
|
||||
echo "$*"
|
||||
@@ -378,9 +330,8 @@ getPrefix()
|
||||
# Parameters: $1: todo file; empty means $TODO_FILE.
|
||||
# Returns: Uppercase FILE prefix to be used in place of "TODO:" where
|
||||
# a different todo file can be specified.
|
||||
local base
|
||||
base=$(basename "${1:-$TODO_FILE}")
|
||||
echo "${base%%.[^.]*}" | tr '[:lower:]' '[:upper:]'
|
||||
local base=$(basename "${1:-$TODO_FILE}")
|
||||
echo "${base%%.[^.]*}" | tr 'a-z' 'A-Z'
|
||||
}
|
||||
|
||||
getTodo()
|
||||
@@ -405,8 +356,8 @@ getNewtodo()
|
||||
# Postcondition: $newtodo contains task text.
|
||||
|
||||
local item=$1
|
||||
[ -z "$item" ] && die "Programming error: $item should exist."
|
||||
[ "${item//[0-9]/}" ] && die "Programming error: $item should be numeric."
|
||||
[ -z "$item" ] && die 'Programming error: $item should exist.'
|
||||
[ "${item//[0-9]/}" ] && die 'Programming error: $item should be numeric.'
|
||||
|
||||
newtodo=$(sed "$item!d" "${2:-$TODO_FILE}")
|
||||
[ -z "$newtodo" ] && die "$(getPrefix "$2"): No updated task $item."
|
||||
@@ -430,28 +381,27 @@ replaceOrPrepend()
|
||||
|
||||
if [[ -z "$1" && $TODOTXT_FORCE = 0 ]]; then
|
||||
echo -n "$querytext"
|
||||
read -r -i "$todo" -e input
|
||||
read input
|
||||
else
|
||||
input=$*
|
||||
fi
|
||||
cleaninput "for sed"
|
||||
|
||||
# Retrieve existing priority and prepended date
|
||||
local -r priAndDateExpr='^\((.) \)\{0,1\}\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} \)\{0,1\}'
|
||||
priority=$(sed -e "$item!d" -e "${item}s/${priAndDateExpr}.*/\\1/" "$TODO_FILE")
|
||||
prepdate=$(sed -e "$item!d" -e "${item}s/${priAndDateExpr}.*/\\2/" "$TODO_FILE")
|
||||
priority=$(sed -e "$item!d" -e $item's/^\((.) \)\{0,1\}\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} \)\{0,1\}.*/\1/' "$TODO_FILE")
|
||||
prepdate=$(sed -e "$item!d" -e $item's/^\((.) \)\{0,1\}\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} \)\{0,1\}.*/\2/' "$TODO_FILE")
|
||||
|
||||
if [ "$prepdate" ] && [ "$action" = "replace" ] && [ "$(echo "$input"|sed -e "s/${priAndDateExpr}.*/\\1\\2/")" ]; then
|
||||
# If the replaced text starts with a [priority +] date, it will replace
|
||||
# the existing date, too.
|
||||
if [ "$prepdate" -a "$action" = "replace" ] && [ "$(echo "$input"|sed -e 's/^\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\}\)\{0,1\}.*/\1/')" ]; then
|
||||
# If the replaced text starts with a date, it will replace the existing
|
||||
# date, too.
|
||||
prepdate=
|
||||
fi
|
||||
|
||||
# Temporarily remove any existing priority and prepended date, perform the
|
||||
# change (replace/prepend) and re-insert the existing priority and prepended
|
||||
# date again.
|
||||
cleaninput "for sed"
|
||||
sed -i.bak -e "$item s/^${priority}${prepdate}//" -e "$item s|^.*|${priority}${prepdate}${input}${backref}|" "$TODO_FILE"
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
getNewtodo "$item"
|
||||
case "$action" in
|
||||
replace)
|
||||
@@ -466,47 +416,30 @@ replaceOrPrepend()
|
||||
fi
|
||||
}
|
||||
|
||||
uppercasePriority()
|
||||
{
|
||||
# Precondition: $input contains task text for which to uppercase priority.
|
||||
# Postcondition: Modifies $input.
|
||||
lower=( {a..z} )
|
||||
upper=( {A..Z} )
|
||||
for ((i=0; i<26; i++))
|
||||
do
|
||||
upperPriority="${upperPriority};s/^[(]${lower[i]}[)]/(${upper[i]})/"
|
||||
done
|
||||
input=$(echo "$input" | sed "$upperPriority")
|
||||
}
|
||||
|
||||
#Preserving environment variables so they don't get clobbered by the config file
|
||||
OVR_TODOTXT_AUTO_ARCHIVE="$TODOTXT_AUTO_ARCHIVE"
|
||||
OVR_TODOTXT_FORCE="$TODOTXT_FORCE"
|
||||
OVR_TODOTXT_PRESERVE_LINE_NUMBERS="$TODOTXT_PRESERVE_LINE_NUMBERS"
|
||||
OVR_TODOTXT_PLAIN="$TODOTXT_PLAIN"
|
||||
OVR_TODOTXT_DATE_ON_ADD="$TODOTXT_DATE_ON_ADD"
|
||||
OVR_TODOTXT_PRIORITY_ON_ADD="$TODOTXT_PRIORITY_ON_ADD"
|
||||
OVR_TODOTXT_DISABLE_FILTER="$TODOTXT_DISABLE_FILTER"
|
||||
OVR_TODOTXT_VERBOSE="$TODOTXT_VERBOSE"
|
||||
OVR_TODOTXT_DEFAULT_ACTION="$TODOTXT_DEFAULT_ACTION"
|
||||
OVR_TODOTXT_SORT_COMMAND="$TODOTXT_SORT_COMMAND"
|
||||
OVR_TODOTXT_FINAL_FILTER="$TODOTXT_FINAL_FILTER"
|
||||
|
||||
# Prevent GREP_OPTIONS from malforming grep's output
|
||||
export GREP_OPTIONS=""
|
||||
|
||||
# == PROCESS OPTIONS ==
|
||||
while getopts ":fhpcnNaAtTvVx+@Pd:" Option
|
||||
do
|
||||
case $Option in
|
||||
'@')
|
||||
'@' )
|
||||
## HIDE_CONTEXT_NAMES starts at zero (false); increment it to one
|
||||
## (true) the first time this flag is seen. Each time the flag
|
||||
## is seen after that, increment it again so that an even
|
||||
## number shows context names and an odd number hides context
|
||||
## names.
|
||||
: $(( HIDE_CONTEXT_NAMES++ ))
|
||||
if [ $(( HIDE_CONTEXT_NAMES % 2 )) -eq 0 ]
|
||||
if [ $(( $HIDE_CONTEXT_NAMES % 2 )) -eq 0 ]
|
||||
then
|
||||
## Zero or even value -- show context names
|
||||
unset HIDE_CONTEXTS_SUBSTITUTION
|
||||
@@ -515,14 +448,14 @@ do
|
||||
export HIDE_CONTEXTS_SUBSTITUTION='[[:space:]]@[[:graph:]]\{1,\}'
|
||||
fi
|
||||
;;
|
||||
'+')
|
||||
'+' )
|
||||
## HIDE_PROJECT_NAMES starts at zero (false); increment it to one
|
||||
## (true) the first time this flag is seen. Each time the flag
|
||||
## is seen after that, increment it again so that an even
|
||||
## number shows project names and an odd number hides project
|
||||
## names.
|
||||
: $(( HIDE_PROJECT_NAMES++ ))
|
||||
if [ $(( HIDE_PROJECT_NAMES % 2 )) -eq 0 ]
|
||||
if [ $(( $HIDE_PROJECT_NAMES % 2 )) -eq 0 ]
|
||||
then
|
||||
## Zero or even value -- show project names
|
||||
unset HIDE_PROJECTS_SUBSTITUTION
|
||||
@@ -531,45 +464,44 @@ do
|
||||
export HIDE_PROJECTS_SUBSTITUTION='[[:space:]][+][[:graph:]]\{1,\}'
|
||||
fi
|
||||
;;
|
||||
a)
|
||||
a )
|
||||
OVR_TODOTXT_AUTO_ARCHIVE=0
|
||||
;;
|
||||
A)
|
||||
A )
|
||||
OVR_TODOTXT_AUTO_ARCHIVE=1
|
||||
;;
|
||||
c)
|
||||
c )
|
||||
OVR_TODOTXT_PLAIN=0
|
||||
;;
|
||||
d)
|
||||
d )
|
||||
TODOTXT_CFG_FILE=$OPTARG
|
||||
;;
|
||||
f)
|
||||
f )
|
||||
OVR_TODOTXT_FORCE=1
|
||||
;;
|
||||
h)
|
||||
h )
|
||||
# Short-circuit option parsing and forward to the action.
|
||||
# Cannot just invoke shorthelp() because we need the configuration
|
||||
# processed to locate the add-on actions directory.
|
||||
set -- '-h' 'shorthelp'
|
||||
OPTIND=2
|
||||
;;
|
||||
n)
|
||||
n )
|
||||
OVR_TODOTXT_PRESERVE_LINE_NUMBERS=0
|
||||
;;
|
||||
N)
|
||||
N )
|
||||
OVR_TODOTXT_PRESERVE_LINE_NUMBERS=1
|
||||
;;
|
||||
p)
|
||||
p )
|
||||
OVR_TODOTXT_PLAIN=1
|
||||
;;
|
||||
P)
|
||||
P )
|
||||
## HIDE_PRIORITY_LABELS starts at zero (false); increment it to one
|
||||
## (true) the first time this flag is seen. Each time the flag
|
||||
## is seen after that, increment it again so that an even
|
||||
## number shows priority labels and an odd number hides priority
|
||||
## labels.
|
||||
: $(( HIDE_PRIORITY_LABELS++ ))
|
||||
if [ $(( HIDE_PRIORITY_LABELS % 2 )) -eq 0 ]
|
||||
if [ $(( $HIDE_PRIORITY_LABELS % 2 )) -eq 0 ]
|
||||
then
|
||||
## Zero or even value -- show priority labels
|
||||
unset HIDE_PRIORITY_SUBSTITUTION
|
||||
@@ -578,27 +510,24 @@ do
|
||||
export HIDE_PRIORITY_SUBSTITUTION="([A-Z])[[:space:]]"
|
||||
fi
|
||||
;;
|
||||
t)
|
||||
t )
|
||||
OVR_TODOTXT_DATE_ON_ADD=1
|
||||
;;
|
||||
T)
|
||||
T )
|
||||
OVR_TODOTXT_DATE_ON_ADD=0
|
||||
;;
|
||||
v)
|
||||
v )
|
||||
: $(( TODOTXT_VERBOSE++ ))
|
||||
;;
|
||||
V)
|
||||
V )
|
||||
version
|
||||
;;
|
||||
x)
|
||||
x )
|
||||
OVR_TODOTXT_DISABLE_FILTER=1
|
||||
;;
|
||||
*)
|
||||
usage
|
||||
;;
|
||||
esac
|
||||
done
|
||||
shift $((OPTIND - 1))
|
||||
shift $(($OPTIND - 1))
|
||||
|
||||
# defaults if not yet defined
|
||||
TODOTXT_VERBOSE=${TODOTXT_VERBOSE:-1}
|
||||
@@ -608,15 +537,13 @@ TODOTXT_FORCE=${TODOTXT_FORCE:-0}
|
||||
TODOTXT_PRESERVE_LINE_NUMBERS=${TODOTXT_PRESERVE_LINE_NUMBERS:-1}
|
||||
TODOTXT_AUTO_ARCHIVE=${TODOTXT_AUTO_ARCHIVE:-1}
|
||||
TODOTXT_DATE_ON_ADD=${TODOTXT_DATE_ON_ADD:-0}
|
||||
TODOTXT_PRIORITY_ON_ADD=${TODOTXT_PRIORITY_ON_ADD:-}
|
||||
TODOTXT_DEFAULT_ACTION=${TODOTXT_DEFAULT_ACTION:-}
|
||||
TODOTXT_SORT_COMMAND=${TODOTXT_SORT_COMMAND:-env LC_COLLATE=C sort -f -k2}
|
||||
TODOTXT_DISABLE_FILTER=${TODOTXT_DISABLE_FILTER:-}
|
||||
TODOTXT_FINAL_FILTER=${TODOTXT_FINAL_FILTER:-cat}
|
||||
TODOTXT_GLOBAL_CFG_FILE=${TODOTXT_GLOBAL_CFG_FILE:-/etc/todo/config}
|
||||
|
||||
# Export all TODOTXT_* variables
|
||||
export "${!TODOTXT_@}"
|
||||
export ${!TODOTXT_@}
|
||||
|
||||
# Default color map
|
||||
export NONE=''
|
||||
@@ -644,11 +571,6 @@ export PRI_B=$GREEN # color for B priority
|
||||
export PRI_C=$LIGHT_BLUE # color for C priority
|
||||
export PRI_X=$WHITE # color unless explicitly defined
|
||||
|
||||
# Default project, context and dateext colors.
|
||||
export COLOR_PROJECT=$NONE
|
||||
export COLOR_CONTEXT=$NONE
|
||||
export COLOR_DATEEXT=$NONE
|
||||
|
||||
# Default highlight colors.
|
||||
export COLOR_DONE=$LIGHT_GREY # color for done (but not yet archived) tasks
|
||||
|
||||
@@ -676,15 +598,6 @@ export SENTENCE_DELIMITERS=',.:;'
|
||||
fi
|
||||
}
|
||||
|
||||
[ -e "$TODOTXT_CFG_FILE" ] || {
|
||||
CFG_FILE_ALT="${XDG_CONFIG_HOME:-$HOME/.config}/todo/config"
|
||||
|
||||
if [ -e "$CFG_FILE_ALT" ]
|
||||
then
|
||||
TODOTXT_CFG_FILE="$CFG_FILE_ALT"
|
||||
fi
|
||||
}
|
||||
|
||||
[ -e "$TODOTXT_CFG_FILE" ] || {
|
||||
CFG_FILE_ALT=$(dirname "$0")"/todo.cfg"
|
||||
|
||||
@@ -694,17 +607,8 @@ export SENTENCE_DELIMITERS=',.:;'
|
||||
fi
|
||||
}
|
||||
|
||||
[ -e "$TODOTXT_CFG_FILE" ] || {
|
||||
CFG_FILE_ALT="$TODOTXT_GLOBAL_CFG_FILE"
|
||||
|
||||
if [ -e "$CFG_FILE_ALT" ]
|
||||
then
|
||||
TODOTXT_CFG_FILE="$CFG_FILE_ALT"
|
||||
fi
|
||||
}
|
||||
|
||||
|
||||
if [ -z "$TODO_ACTIONS_DIR" ] || [ ! -d "$TODO_ACTIONS_DIR" ]
|
||||
if [ -z "$TODO_ACTIONS_DIR" -o ! -d "$TODO_ACTIONS_DIR" ]
|
||||
then
|
||||
TODO_ACTIONS_DIR="$HOME/.todo/actions"
|
||||
export TODO_ACTIONS_DIR
|
||||
@@ -719,17 +623,8 @@ fi
|
||||
fi
|
||||
}
|
||||
|
||||
[ -d "$TODO_ACTIONS_DIR" ] || {
|
||||
TODO_ACTIONS_DIR_ALT="${XDG_CONFIG_HOME:-$HOME/.config}/todo/actions"
|
||||
|
||||
if [ -d "$TODO_ACTIONS_DIR_ALT" ]
|
||||
then
|
||||
TODO_ACTIONS_DIR="$TODO_ACTIONS_DIR_ALT"
|
||||
fi
|
||||
}
|
||||
|
||||
# === SANITY CHECKS (thanks Karl!) ===
|
||||
[ -r "$TODOTXT_CFG_FILE" ] || dieWithHelp "$1" "Fatal Error: Cannot read configuration file $TODOTXT_CFG_FILE"
|
||||
[ -r "$TODOTXT_CFG_FILE" ] || die "Fatal Error: Cannot read configuration file $TODOTXT_CFG_FILE"
|
||||
|
||||
. "$TODOTXT_CFG_FILE"
|
||||
|
||||
@@ -749,9 +644,6 @@ fi
|
||||
if [ -n "$OVR_TODOTXT_DATE_ON_ADD" ] ; then
|
||||
TODOTXT_DATE_ON_ADD="$OVR_TODOTXT_DATE_ON_ADD"
|
||||
fi
|
||||
if [ -n "$OVR_TODOTXT_PRIORITY_ON_ADD" ] ; then
|
||||
TODOTXT_PRIORITY_ON_ADD="$OVR_TODOTXT_PRIORITY_ON_ADD"
|
||||
fi
|
||||
if [ -n "$OVR_TODOTXT_DISABLE_FILTER" ] ; then
|
||||
TODOTXT_DISABLE_FILTER="$OVR_TODOTXT_DISABLE_FILTER"
|
||||
fi
|
||||
@@ -771,47 +663,33 @@ fi
|
||||
ACTION=${1:-$TODOTXT_DEFAULT_ACTION}
|
||||
|
||||
[ -z "$ACTION" ] && usage
|
||||
[ -d "$TODO_DIR" ] || mkdir -p "$TODO_DIR" 2> /dev/null || dieWithHelp "$1" "Fatal Error: $TODO_DIR is not a directory"
|
||||
( cd "$TODO_DIR" ) || dieWithHelp "$1" "Fatal Error: Unable to cd to $TODO_DIR"
|
||||
[ -z "$TODOTXT_PRIORITY_ON_ADD" ] \
|
||||
|| echo "$TODOTXT_PRIORITY_ON_ADD" | grep -q "^[A-Z]$" \
|
||||
|| die "TODOTXT_PRIORITY_ON_ADD should be a capital letter from A to Z (it is now \"$TODOTXT_PRIORITY_ON_ADD\")."
|
||||
[ -d "$TODO_DIR" ] || die "Fatal Error: $TODO_DIR is not a directory"
|
||||
( cd "$TODO_DIR" ) || die "Fatal Error: Unable to cd to $TODO_DIR"
|
||||
|
||||
[ -f "$TODO_FILE" ] || [ -c "$TODO_FILE" ] || > "$TODO_FILE"
|
||||
[ -f "$DONE_FILE" ] || [ -c "$DONE_FILE" ] || > "$DONE_FILE"
|
||||
[ -f "$REPORT_FILE" ] || [ -c "$REPORT_FILE" ] || > "$REPORT_FILE"
|
||||
[ -f "$TODO_FILE" ] || cp /dev/null "$TODO_FILE"
|
||||
[ -f "$DONE_FILE" ] || cp /dev/null "$DONE_FILE"
|
||||
[ -f "$REPORT_FILE" ] || cp /dev/null "$REPORT_FILE"
|
||||
|
||||
if [ $TODOTXT_PLAIN = 1 ]; then
|
||||
for clr in ${!PRI_@}; do
|
||||
export "$clr"=$NONE
|
||||
export $clr=$NONE
|
||||
done
|
||||
PRI_X=$NONE
|
||||
DEFAULT=$NONE
|
||||
COLOR_DONE=$NONE
|
||||
COLOR_PROJECT=$NONE
|
||||
COLOR_CONTEXT=$NONE
|
||||
fi
|
||||
|
||||
[[ "$HIDE_PROJECTS_SUBSTITUTION" ]] && COLOR_PROJECT="$NONE"
|
||||
[[ "$HIDE_CONTEXTS_SUBSTITUTION" ]] && COLOR_CONTEXT="$NONE"
|
||||
|
||||
_addto() {
|
||||
file="$1"
|
||||
input="$2"
|
||||
cleaninput
|
||||
uppercasePriority
|
||||
|
||||
if [[ "$TODOTXT_DATE_ON_ADD" -eq 1 ]]; then
|
||||
if [[ $TODOTXT_DATE_ON_ADD = 1 ]]; then
|
||||
now=$(date '+%Y-%m-%d')
|
||||
input=$(echo "$input" | sed -e 's/^\(([A-Z]) \)\{0,1\}/\1'"$now /")
|
||||
fi
|
||||
if [[ -n "$TODOTXT_PRIORITY_ON_ADD" ]]; then
|
||||
if ! echo "$input" | grep -q '^([A-Z])'; then
|
||||
input=$(echo -n "($TODOTXT_PRIORITY_ON_ADD) " ; echo "$input")
|
||||
fi
|
||||
fi
|
||||
echo "$input" >> "$file"
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
TASKNUM=$(sed -n '$ =' "$file")
|
||||
echo "$TASKNUM $input"
|
||||
echo "$(getPrefix "$file"): $TASKNUM added."
|
||||
@@ -879,7 +757,7 @@ _list() {
|
||||
|
||||
_format "$src" '' "$@"
|
||||
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
echo "--"
|
||||
echo "$(getPrefix "$src"): ${NUMTASKS:-0} of ${TOTALTASKS:-0} tasks shown"
|
||||
fi
|
||||
@@ -939,7 +817,7 @@ _format()
|
||||
s/^ /00/;
|
||||
s/^ /0/;
|
||||
''' \
|
||||
| eval "${TODOTXT_SORT_COMMAND}" \
|
||||
| eval ${TODOTXT_SORT_COMMAND} \
|
||||
| awk '''
|
||||
function highlight(colorVar, color) {
|
||||
color = ENVIRON[colorVar]
|
||||
@@ -947,43 +825,15 @@ _format()
|
||||
return color
|
||||
}
|
||||
{
|
||||
clr = ""
|
||||
if (match($0, /^[0-9]+ x /)) {
|
||||
clr = highlight("COLOR_DONE")
|
||||
print highlight("COLOR_DONE") $0 highlight("DEFAULT")
|
||||
} else if (match($0, /^[0-9]+ \([A-Z]\) /)) {
|
||||
clr = highlight("PRI_" substr($0, RSTART + RLENGTH - 3, 1))
|
||||
clr = (clr ? clr : highlight("PRI_X"))
|
||||
if (ENVIRON["HIDE_PRIORITY_SUBSTITUTION"] != "") {
|
||||
$0 = substr($0, 1, RLENGTH - 4) substr($0, RSTART + RLENGTH)
|
||||
}
|
||||
}
|
||||
end_clr = (clr ? highlight("DEFAULT") : "")
|
||||
|
||||
prj_beg = highlight("COLOR_PROJECT")
|
||||
prj_end = (prj_beg ? (highlight("DEFAULT") clr) : "")
|
||||
|
||||
ctx_beg = highlight("COLOR_CONTEXT")
|
||||
ctx_end = (ctx_beg ? (highlight("DEFAULT") clr) : "")
|
||||
|
||||
dtx_beg = highlight("COLOR_DATEEXT")
|
||||
dtx_end = (dtx_beg ? (highlight("DEFAULT") clr) : "")
|
||||
|
||||
gsub(/[ \t][ \t]*/, "\n&\n")
|
||||
len = split($0, words, /\n/)
|
||||
|
||||
printf "%s", clr
|
||||
for (i = 1; i <= len; ++i) {
|
||||
if (words[i] ~ /^[+].*[A-Za-z0-9_]$/) {
|
||||
printf "%s", prj_beg words[i] prj_end
|
||||
} else if (words[i] ~ /^[@].*[A-Za-z0-9_]$/) {
|
||||
printf "%s", ctx_beg words[i] ctx_end
|
||||
} else if (words[i] ~ /^(due|t|again):/) {
|
||||
printf "%s", dtx_beg words[i] dtx_end
|
||||
} else {
|
||||
printf "%s", words[i]
|
||||
}
|
||||
}
|
||||
printf "%s\n", end_clr
|
||||
print \
|
||||
(clr ? clr : highlight("PRI_X")) \
|
||||
(ENVIRON["HIDE_PRIORITY_SUBSTITUTION"] == "" ? $0 : substr($0, 1, RLENGTH - 4) substr($0, RSTART + RLENGTH)) \
|
||||
highlight("DEFAULT")
|
||||
} else { print }
|
||||
}
|
||||
''' \
|
||||
| sed '''
|
||||
@@ -995,29 +845,19 @@ _format()
|
||||
)
|
||||
[ "$filtered_items" ] && echo "$filtered_items"
|
||||
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
NUMTASKS=$( echo -n "$filtered_items" | sed -n '$ =' )
|
||||
TOTALTASKS=$( echo -n "$items" | sed -n '$ =' )
|
||||
fi
|
||||
if [ "$TODOTXT_VERBOSE" -gt 1 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 1 ]; then
|
||||
echo "TODO DEBUG: Filter Command was: ${filter_command:-cat}"
|
||||
fi
|
||||
}
|
||||
|
||||
listWordsWithSigil()
|
||||
{
|
||||
sigil=$1
|
||||
shift
|
||||
|
||||
FILE=$TODO_FILE
|
||||
[ "$TODOTXT_SOURCEVAR" ] && eval "FILE=$TODOTXT_SOURCEVAR"
|
||||
eval "$(filtercommand 'cat "${FILE[@]}"' '' "$@")" | grep -o "[^ ]*${sigil}[^ ]\\+" | grep "^$sigil" | sort -u
|
||||
}
|
||||
|
||||
export -f cleaninput getPrefix getTodo getNewtodo shellquote filtercommand _list listWordsWithSigil getPadding _format die
|
||||
export -f cleaninput getPrefix getTodo getNewtodo shellquote filtercommand _list getPadding _format die
|
||||
|
||||
# == HANDLE ACTION ==
|
||||
action=$( printf "%s\n" "$ACTION" | tr '[:upper:]' '[:lower:]' )
|
||||
action=$( printf "%s\n" "$ACTION" | tr 'A-Z' 'a-z' )
|
||||
|
||||
## If the first argument is "command", run the rest of the arguments
|
||||
## using todo.sh builtins.
|
||||
@@ -1028,12 +868,8 @@ then
|
||||
## Get rid of "command" from arguments list
|
||||
shift
|
||||
## Reset action to new first argument
|
||||
action=$( printf "%s\n" "$1" | tr '[:upper:]' '[:lower:]' )
|
||||
elif [ -d "$TODO_ACTIONS_DIR/$action" ] && [ -x "$TODO_ACTIONS_DIR/$action/$action" ]
|
||||
then
|
||||
"$TODO_ACTIONS_DIR/$action/$action" "$@"
|
||||
exit $?
|
||||
elif [ -d "$TODO_ACTIONS_DIR" ] && [ -x "$TODO_ACTIONS_DIR/$action" ]
|
||||
action=$( printf "%s\n" "$1" | tr 'A-Z' 'a-z' )
|
||||
elif [ -d "$TODO_ACTIONS_DIR" -a -x "$TODO_ACTIONS_DIR/$action" ]
|
||||
then
|
||||
"$TODO_ACTIONS_DIR/$action" "$@"
|
||||
exit $?
|
||||
@@ -1044,7 +880,7 @@ case $action in
|
||||
"add" | "a")
|
||||
if [[ -z "$2" && $TODOTXT_FORCE = 0 ]]; then
|
||||
echo -n "Add: "
|
||||
read -e -r input
|
||||
read input
|
||||
else
|
||||
[ -z "$2" ] && die "usage: $TODO_SH add \"TODO ITEM\""
|
||||
shift
|
||||
@@ -1056,14 +892,14 @@ case $action in
|
||||
"addm")
|
||||
if [[ -z "$2" && $TODOTXT_FORCE = 0 ]]; then
|
||||
echo -n "Add: "
|
||||
read -e -r input
|
||||
read input
|
||||
else
|
||||
[ -z "$2" ] && die "usage: $TODO_SH addm \"TODO ITEM\""
|
||||
shift
|
||||
input=$*
|
||||
fi
|
||||
|
||||
# Set Internal Field Seperator as newline so we can
|
||||
# Set Internal Field Seperator as newline so we can
|
||||
# loop across multiple lines
|
||||
SAVEIFS=$IFS
|
||||
IFS=$'\n'
|
||||
@@ -1097,7 +933,7 @@ case $action in
|
||||
|
||||
if [[ -z "$1" && $TODOTXT_FORCE = 0 ]]; then
|
||||
echo -n "Append: "
|
||||
read -e -r input
|
||||
read input
|
||||
else
|
||||
input=$*
|
||||
fi
|
||||
@@ -1107,8 +943,8 @@ case $action in
|
||||
esac
|
||||
cleaninput "for sed"
|
||||
|
||||
if sed -i.bak "${item} s|^.*|&${appendspace}${input}|" "$TODO_FILE"; then
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if sed -i.bak $item" s|^.*|&${appendspace}${input}|" "$TODO_FILE"; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
getNewtodo "$item"
|
||||
echo "$item $newtodo"
|
||||
fi
|
||||
@@ -1120,10 +956,10 @@ case $action in
|
||||
"archive" )
|
||||
# defragment blank lines
|
||||
sed -i.bak -e '/./!d' "$TODO_FILE"
|
||||
[ "$TODOTXT_VERBOSE" -gt 0 ] && grep "^x " "$TODO_FILE"
|
||||
[ $TODOTXT_VERBOSE -gt 0 ] && grep "^x " "$TODO_FILE"
|
||||
grep "^x " "$TODO_FILE" >> "$DONE_FILE"
|
||||
sed -i.bak '/^x /d' "$TODO_FILE"
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
echo "TODO: $TODO_FILE archived."
|
||||
fi
|
||||
;;
|
||||
@@ -1137,19 +973,19 @@ case $action in
|
||||
if [ -z "$3" ]; then
|
||||
if [ $TODOTXT_FORCE = 0 ]; then
|
||||
echo "Delete '$todo'? (y/n)"
|
||||
read -e -r ANSWER
|
||||
read ANSWER
|
||||
else
|
||||
ANSWER="y"
|
||||
fi
|
||||
if [ "$ANSWER" = "y" ]; then
|
||||
if [ $TODOTXT_PRESERVE_LINE_NUMBERS = 0 ]; then
|
||||
# delete line (changes line numbers)
|
||||
sed -i.bak -e "${item}s/^.*//" -e '/./!d' "$TODO_FILE"
|
||||
sed -i.bak -e $item"s/^.*//" -e '/./!d' "$TODO_FILE"
|
||||
else
|
||||
# leave blank line behind (preserves line numbers)
|
||||
sed -i.bak -e "${item}s/^.*//" "$TODO_FILE"
|
||||
sed -i.bak -e $item"s/^.*//" "$TODO_FILE"
|
||||
fi
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
echo "$item $todo"
|
||||
echo "TODO: $item deleted."
|
||||
fi
|
||||
@@ -1158,18 +994,18 @@ case $action in
|
||||
fi
|
||||
else
|
||||
sed -i.bak \
|
||||
-e "${item}s/^\((.) \)\{0,1\} *$3 */\1/g" \
|
||||
-e "${item}s/ *$3 *\$//g" \
|
||||
-e "${item}s/ *$3 */ /g" \
|
||||
-e "${item}s/ *$3 */ /g" \
|
||||
-e "${item}s/$3//g" \
|
||||
-e $item"s/^\((.) \)\{0,1\} *$3 */\1/g" \
|
||||
-e $item"s/ *$3 *\$//g" \
|
||||
-e $item"s/ *$3 */ /g" \
|
||||
-e $item"s/ *$3 */ /g" \
|
||||
-e $item"s/$3//g" \
|
||||
"$TODO_FILE"
|
||||
getNewtodo "$item"
|
||||
if [ "$todo" = "$newtodo" ]; then
|
||||
[ "$TODOTXT_VERBOSE" -gt 0 ] && echo "$item $todo"
|
||||
[ $TODOTXT_VERBOSE -gt 0 ] && echo "$item $todo"
|
||||
die "TODO: '$3' not found; no removal done."
|
||||
fi
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
echo "$item $todo"
|
||||
echo "TODO: Removed '$3' from task."
|
||||
echo "$item $newtodo"
|
||||
@@ -1188,8 +1024,8 @@ case $action in
|
||||
getTodo "$item"
|
||||
|
||||
if [[ "$todo" = \(?\)\ * ]]; then
|
||||
sed -i.bak -e "${item}s/^(.) //" "$TODO_FILE"
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
sed -i.bak -e $item"s/^(.) //" "$TODO_FILE"
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
getNewtodo "$item"
|
||||
echo "$item $newtodo"
|
||||
echo "TODO: $item deprioritized."
|
||||
@@ -1200,7 +1036,7 @@ case $action in
|
||||
done
|
||||
;;
|
||||
|
||||
"do" | "done" )
|
||||
"do" )
|
||||
errmsg="usage: $TODO_SH do ITEM#[, ITEM#, ITEM#, ...]"
|
||||
# shift so we get arguments to the do request
|
||||
shift;
|
||||
@@ -1215,9 +1051,9 @@ case $action in
|
||||
if [ "${todo:0:2}" != "x " ]; then
|
||||
now=$(date '+%Y-%m-%d')
|
||||
# remove priority once item is done
|
||||
sed -i.bak "${item}s/^(.) //" "$TODO_FILE"
|
||||
sed -i.bak "${item}s|^|x $now |" "$TODO_FILE"
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
sed -i.bak $item"s/^(.) //" "$TODO_FILE"
|
||||
sed -i.bak $item"s|^|x $now |" "$TODO_FILE"
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
getNewtodo "$item"
|
||||
echo "$item $newtodo"
|
||||
echo "TODO: $item marked as done."
|
||||
@@ -1235,19 +1071,13 @@ case $action in
|
||||
;;
|
||||
|
||||
"help" )
|
||||
shift ## Was help; new $1 is first help topic / action name
|
||||
if [ $# -gt 0 ]; then
|
||||
# Don't use PAGER here; we don't expect much usage output from one / few actions.
|
||||
actionUsage "$@"
|
||||
else
|
||||
if [ -t 1 ] ; then # STDOUT is a TTY
|
||||
if which "${PAGER:-less}" >/dev/null 2>&1; then
|
||||
# we have a working PAGER (or less as a default)
|
||||
help | "${PAGER:-less}" && exit 0
|
||||
fi
|
||||
if [ -t 1 ] ; then # STDOUT is a TTY
|
||||
if which "${PAGER:-less}" >/dev/null 2>&1; then
|
||||
# we have a working PAGER (or less as a default)
|
||||
help | "${PAGER:-less}" && exit 0
|
||||
fi
|
||||
help # just in case something failed above, we go ahead and just spew to STDOUT
|
||||
fi
|
||||
help # just in case something failed above, we go ahead and just spew to STDOUT
|
||||
;;
|
||||
|
||||
"shorthelp" )
|
||||
@@ -1271,10 +1101,10 @@ case $action in
|
||||
TOTAL=$( sed -n '$ =' "$TODO_FILE" )
|
||||
PADDING=${#TOTAL}
|
||||
|
||||
post_filter_command="${post_filter_command:-}${post_filter_command:+ | }awk -v TOTAL=$TOTAL -v PADDING=$PADDING '{ \$1 = sprintf(\"%\" PADDING \"d\", (\$1 > TOTAL ? 0 : \$1)); print }' "
|
||||
post_filter_command="awk -v TOTAL=$TOTAL -v PADDING=$PADDING '{ \$1 = sprintf(\"%\" PADDING \"d\", (\$1 > TOTAL ? 0 : \$1)); print }' "
|
||||
cat "$TODO_FILE" "$DONE_FILE" | TODOTXT_VERBOSE=0 _format '' "$PADDING" "$@"
|
||||
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
TDONE=$( sed -n '$ =' "$DONE_FILE" )
|
||||
TASKNUM=$(TODOTXT_PLAIN=1 TODOTXT_VERBOSE=0 _format "$TODO_FILE" 1 "$@" | sed -n '$ =')
|
||||
DONENUM=$(TODOTXT_PLAIN=1 TODOTXT_VERBOSE=0 _format "$DONE_FILE" 1 "$@" | sed -n '$ =')
|
||||
@@ -1288,8 +1118,8 @@ case $action in
|
||||
"listfile" | "lf" )
|
||||
shift ## Was listfile, next $1 is file name
|
||||
if [ $# -eq 0 ]; then
|
||||
[ "$TODOTXT_VERBOSE" -gt 0 ] && echo "Files in the todo.txt directory:"
|
||||
cd "$TODO_DIR" && ls -1 -- *.txt
|
||||
[ $TODOTXT_VERBOSE -gt 0 ] && echo "Files in the todo.txt directory:"
|
||||
cd "$TODO_DIR" && ls -1 *.txt
|
||||
else
|
||||
FILE="$1"
|
||||
shift ## Was filename; next $1 is first search term
|
||||
@@ -1299,20 +1129,23 @@ case $action in
|
||||
;;
|
||||
|
||||
"listcon" | "lsc" )
|
||||
shift
|
||||
listWordsWithSigil '@' "$@"
|
||||
FILE=$TODO_FILE
|
||||
[ "$TODOTXT_SOURCEVAR" ] && eval "FILE=$TODOTXT_SOURCEVAR"
|
||||
grep -ho '[^ ]*@[^ ]\+' "${FILE[@]}" | grep '^@' | sort -u
|
||||
;;
|
||||
|
||||
"listproj" | "lsprj" )
|
||||
FILE=$TODO_FILE
|
||||
[ "$TODOTXT_SOURCEVAR" ] && eval "FILE=$TODOTXT_SOURCEVAR"
|
||||
shift
|
||||
listWordsWithSigil '+' "$@"
|
||||
eval "$(filtercommand 'cat "${FILE[@]}"' '' "$@")" | grep -o '[^ ]*+[^ ]\+' | grep '^+' | sort -u
|
||||
;;
|
||||
|
||||
"listpri" | "lsp" )
|
||||
shift ## was "listpri", new $1 is priority to list or first TERM
|
||||
|
||||
pri=$(printf "%s\n" "$1" | tr '[:lower:]' '[:upper:]' | grep -e '^[A-Z]$' -e '^[A-Z]-[A-Z]$') && shift || pri="A-Z"
|
||||
post_filter_command="${post_filter_command:-}${post_filter_command:+ | }grep '^ *[0-9]\+ ([${pri}]) '"
|
||||
pri=$(printf "%s\n" "$1" | tr 'a-z' 'A-Z' | grep -e '^[A-Z]$' -e '^[A-Z]-[A-Z]$') && shift || pri="A-Z"
|
||||
post_filter_command="grep '^ *[0-9]\+ ([${pri}]) '"
|
||||
_list "$TODO_FILE" "$@"
|
||||
;;
|
||||
|
||||
@@ -1333,21 +1166,21 @@ case $action in
|
||||
[ -z "$todo" ] && die "$item: No such item in $src."
|
||||
if [ $TODOTXT_FORCE = 0 ]; then
|
||||
echo "Move '$todo' from $src to $dest? (y/n)"
|
||||
read -e -r ANSWER
|
||||
read ANSWER
|
||||
else
|
||||
ANSWER="y"
|
||||
fi
|
||||
if [ "$ANSWER" = "y" ]; then
|
||||
if [ $TODOTXT_PRESERVE_LINE_NUMBERS = 0 ]; then
|
||||
# delete line (changes line numbers)
|
||||
sed -i.bak -e "${item}s/^.*//" -e '/./!d' "$src"
|
||||
sed -i.bak -e $item"s/^.*//" -e '/./!d' "$src"
|
||||
else
|
||||
# leave blank line behind (preserves line numbers)
|
||||
sed -i.bak -e "${item}s/^.*//" "$src"
|
||||
sed -i.bak -e $item"s/^.*//" "$src"
|
||||
fi
|
||||
echo "$todo" >> "$dest"
|
||||
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
echo "$item $todo"
|
||||
echo "TODO: $item moved from '$src' to '$dest'."
|
||||
fi
|
||||
@@ -1363,7 +1196,7 @@ case $action in
|
||||
|
||||
"pri" | "p" )
|
||||
item=$2
|
||||
newpri=$( printf "%s\n" "$3" | tr '[:lower:]' '[:upper:]' )
|
||||
newpri=$( printf "%s\n" "$3" | tr 'a-z' 'A-Z' )
|
||||
|
||||
errmsg="usage: $TODO_SH pri ITEM# PRIORITY
|
||||
note: PRIORITY must be anywhere from A to Z."
|
||||
@@ -1378,9 +1211,9 @@ note: PRIORITY must be anywhere from A to Z."
|
||||
fi
|
||||
|
||||
if [ "$oldpri" != "$newpri" ]; then
|
||||
sed -i.bak -e "${item}s/^(.) //" -e "${item}s/^/($newpri) /" "$TODO_FILE"
|
||||
sed -i.bak -e $item"s/^(.) //" -e $item"s/^/($newpri) /" "$TODO_FILE"
|
||||
fi
|
||||
if [ "$TODOTXT_VERBOSE" -gt 0 ]; then
|
||||
if [ $TODOTXT_VERBOSE -gt 0 ]; then
|
||||
getNewtodo "$item"
|
||||
echo "$item $newtodo"
|
||||
if [ "$oldpri" != "$newpri" ]; then
|
||||
@@ -1414,12 +1247,12 @@ note: PRIORITY must be anywhere from A to Z."
|
||||
LASTDATA=${LASTREPORT#* } # Strip timestamp.
|
||||
if [ "$LASTDATA" = "$NEWDATA" ]; then
|
||||
echo "$LASTREPORT"
|
||||
[ "$TODOTXT_VERBOSE" -gt 0 ] && echo "TODO: Report file is up-to-date."
|
||||
[ $TODOTXT_VERBOSE -gt 0 ] && echo "TODO: Report file is up-to-date."
|
||||
else
|
||||
NEWREPORT="$(date +%Y-%m-%dT%T) ${NEWDATA}"
|
||||
echo "${NEWREPORT}" >> "$REPORT_FILE"
|
||||
echo "${NEWREPORT}"
|
||||
[ "$TODOTXT_VERBOSE" -gt 0 ] && echo "TODO: Report file updated."
|
||||
[ $TODOTXT_VERBOSE -gt 0 ] && echo "TODO: Report file updated."
|
||||
fi
|
||||
;;
|
||||
|
||||
@@ -1467,20 +1300,6 @@ note: PRIORITY must be anywhere from A to Z."
|
||||
fi
|
||||
;;
|
||||
|
||||
"listaddons" )
|
||||
if [ -d "$TODO_ACTIONS_DIR" ]; then
|
||||
cd "$TODO_ACTIONS_DIR" || exit $?
|
||||
for action in *
|
||||
do
|
||||
if [ -f "$action" ] && [ -x "$action" ]; then
|
||||
echo "$action"
|
||||
elif [ -d "$action" ] && [ -x "$action/$action" ]; then
|
||||
echo "$action"
|
||||
fi
|
||||
done
|
||||
fi
|
||||
;;
|
||||
|
||||
* )
|
||||
usage;;
|
||||
esac
|
||||
|
||||
40
todo_completion
Executable file → Normal file
40
todo_completion
Executable file → Normal file
@@ -11,41 +11,42 @@ _todo()
|
||||
local -r OPTS="-@ -@@ -+ -++ -d -f -h -p -P -PP -a -n -t -v -vv -V -x"
|
||||
local -r COMMANDS="\
|
||||
add a addto addm append app archive command del \
|
||||
rm depri dp do help list ls listaddons listall lsa listcon \
|
||||
rm depri dp do help list ls listall lsa listcon \
|
||||
lsc listfile lf listpri lsp listproj lsprj move \
|
||||
mv prepend prep pri p replace report shorthelp"
|
||||
local -r MOVE_COMMAND_PATTERN='^(move|mv)$'
|
||||
|
||||
# Add custom commands from add-ons, if installed.
|
||||
# TODO: Filter for executable flag of files found in $TODO_ACTIONS_DIR.
|
||||
local allCommands="$COMMANDS $('ls' "${TODO_ACTIONS_DIR:-$HOME/.todo.actions.d}/" 2>/dev/null)"
|
||||
|
||||
local _todo_sh=${_todo_sh:-todo.sh}
|
||||
local completions
|
||||
if [ $COMP_CWORD -eq 1 ]; then
|
||||
completions="$COMMANDS $(eval TODOTXT_VERBOSE=0 $_todo_sh command listaddons 2>/dev/null) $OPTS"
|
||||
completions="$allCommands $OPTS"
|
||||
elif [[ $COMP_CWORD -gt 2 && ( \
|
||||
"${COMP_WORDS[COMP_CWORD-2]}" =~ $MOVE_COMMAND_PATTERN || \
|
||||
"${COMP_WORDS[COMP_CWORD-3]}" =~ $MOVE_COMMAND_PATTERN ) ]]; then
|
||||
"${COMP_WORDS[COMP_CWORD-2]}" =~ ^(move|mv)$ || \
|
||||
"${COMP_WORDS[COMP_CWORD-3]}" =~ ^(move|mv)$ ) ]]; then
|
||||
# "move ITEM# DEST [SRC]" has file arguments on positions 2 and 3.
|
||||
completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listfile 2>/dev/null)
|
||||
completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listfile)
|
||||
else
|
||||
case "$prev" in
|
||||
command)
|
||||
completions=$COMMANDS;;
|
||||
help)
|
||||
completions="$COMMANDS $(eval TODOTXT_VERBOSE=0 $_todo_sh command listaddons 2>/dev/null)";;
|
||||
addto|listfile|lf)
|
||||
completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listfile 2>/dev/null);;
|
||||
-*) completions="$COMMANDS $(eval TODOTXT_VERBOSE=0 $_todo_sh command listaddons 2>/dev/null) $OPTS";;
|
||||
completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listfile);;
|
||||
-*) completions="$allCommands $OPTS";;
|
||||
*) case "$cur" in
|
||||
+*) completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listproj 2>/dev/null)
|
||||
+*) completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listproj)
|
||||
COMPREPLY=( $( compgen -W "$completions" -- $cur ))
|
||||
[ ${#COMPREPLY[@]} -gt 0 ] && return 0
|
||||
# Fall back to projects extracted from done tasks.
|
||||
completions=$(eval 'TODOTXT_VERBOSE=0 TODOTXT_SOURCEVAR=\$DONE_FILE' $_todo_sh command listproj 2>/dev/null)
|
||||
completions=$(eval 'TODOTXT_VERBOSE=0 TODOTXT_SOURCEVAR=\$DONE_FILE' $_todo_sh command listproj)
|
||||
;;
|
||||
@*) completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listcon 2>/dev/null)
|
||||
@*) completions=$(eval TODOTXT_VERBOSE=0 $_todo_sh command listcon)
|
||||
COMPREPLY=( $( compgen -W "$completions" -- $cur ))
|
||||
[ ${#COMPREPLY[@]} -gt 0 ] && return 0
|
||||
# Fall back to contexts extracted from done tasks.
|
||||
completions=$(eval 'TODOTXT_VERBOSE=0 TODOTXT_SOURCEVAR=\$DONE_FILE' $_todo_sh command listcon 2>/dev/null)
|
||||
completions=$(eval 'TODOTXT_VERBOSE=0 TODOTXT_SOURCEVAR=\$DONE_FILE' $_todo_sh command listcon)
|
||||
;;
|
||||
*) if [[ "$cur" =~ ^[0-9]+$ ]]; then
|
||||
# Remove the (padded) task number; we prepend the
|
||||
@@ -60,9 +61,9 @@ _todo()
|
||||
# Finally, limit the output to a single line just as
|
||||
# a safety check of the ls action output.
|
||||
local todo=$( \
|
||||
eval TODOTXT_VERBOSE=0 $_todo_sh '-@ -+ -p -x command ls "^ *${cur} "' 2>/dev/null | \
|
||||
sed -e 's/^ *[0-9]\{1,\} //' -e 's/^\((.) \)\{0,1\}[0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} /\1/' \
|
||||
-e 's/^\([xX] \)\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} \)\{1,2\}/\1/' \
|
||||
eval TODOTXT_VERBOSE=0 $_todo_sh '-@ -+ -p -x command ls "^ *${cur} "' | \
|
||||
sed -e 's/^ *[0-9]\+ //' -e 's/\((.) \)[0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} /\1/' \
|
||||
-e 's/\([xX] \)\([0-9]\{2,4\}-[0-9]\{2\}-[0-9]\{2\} \)\{1,2\}/\1/' \
|
||||
-e 's/[[:space:]]*$//' \
|
||||
-e '1q' \
|
||||
)
|
||||
@@ -88,9 +89,6 @@ complete -F _todo todo.sh
|
||||
# If you define an alias (e.g. "t") to todo.sh, you need to explicitly enable
|
||||
# completion for it, too:
|
||||
#complete -F _todo t
|
||||
# It is recommended to put this line next to your alias definition in your
|
||||
# ~/.bashrc (or wherever else you're defining your alias). If you simply
|
||||
# uncomment it here, you will need to redo this on every todo.txt update!
|
||||
|
||||
# If you have renamed the todo.sh executable, or if it is not accessible through
|
||||
# PATH, you need to add and use a wrapper completion function, like this:
|
||||
@@ -103,7 +101,7 @@ complete -F _todo todo.sh
|
||||
|
||||
# If you use aliases to use different configuration(s), you need to add and use
|
||||
# a wrapper completion function for each configuration if you want to complete
|
||||
# from the actual configured task locations:
|
||||
# fron the actual configured task locations:
|
||||
#alias todo2='todo.sh -d "$HOME/todo2.cfg"'
|
||||
#_todo2()
|
||||
#{
|
||||
|
||||
Reference in New Issue
Block a user