na 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d4f45d14fddff26b88853edcac42f9d8250de1848f5d639138d757a0ce5bfe1
-  data.tar.gz: 73057d29cf56b1a3069973f5ea1ab4c06c4fcf76778997df12e51a56baf6ca0f
+  metadata.gz: 4841ea0f17ec2751c09ae7277fa773dd0730a9055eaae68389f4651b606f5fc6
+  data.tar.gz: 3d056faf540401934754cac051bd29f75c8c851607731d5f16bd937baa8e0968
 SHA512:
-  metadata.gz: 1cfcd9dcf3543954f558ac25438bf84384f7c41fdde3f20ec7b6ce8970f971841e940d84b5eb003c5aa26dd17b77fde85901c10b9c30cb179a39a7ea1e26ac07
-  data.tar.gz: 824e2b356c805301fefd096bc851979e307268bb3ddc4f581c74cf03a4b8cf17de688e329a039c8754f646af99e6944f217d4cdd2e02a676fe7763ed08e93a26
+  metadata.gz: 612464ec3687922763b9469a65f32b6773dfdc1a98f965f8c3b2f16ba3709c7972fe4771f6c68e5bff3506d329e9e39c4fe1f3bb2257aa2b09dbe06f0389cb85
+  data.tar.gz: 4e770547abaa252ef7f5b4a691476b1f6c48eb8d9d6304bbf408c12d741ea606d70f7d5331dc8943f445a25622127358fbd96fd03c12bfbaec0384ba4e841943

data/CHANGELOG.md

@@ -5,4 +5,3 @@
 #### IMPROVED
 
 - Backwards compatibility with the Bash version of NA
-

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    na (1.0.0)
+    na (1.0.1)
       gli (~> 2.21.0)
       tty-reader (~> 0.9, >= 0.9.0)
       tty-which (~> 0.5, >= 0.5.0)
@@ -20,7 +20,10 @@ GEM
       wisper (~> 2.0)
     tty-screen (0.8.1)
     tty-which (0.5.0)
+    webrick (1.7.0)
     wisper (2.0.1)
+    yard (0.9.28)
+      webrick (~> 1.7.0)
 
 PLATFORMS
   arm64-darwin-20
@@ -30,6 +33,7 @@ DEPENDENCIES
   na!
   rake (~> 0.9.2)
   rdoc (~> 4.3)
+  yard (~> 0.9, >= 0.9.26)
 
 BUNDLED WITH
    2.2.29

data/LICENSE.txt

@@ -0,0 +1,19 @@
+MIT License Copyright (c) 2022 Brett Terpstra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
+OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,217 @@
+# na
+
+[![Gem](https://img.shields.io/gem/v/doing.svg)](https://rubygems.org/gems/na)
+[![Travis](https://app.travis-ci.com/ttscoff/doing.svg?branch=master)](https://travis-ci.org/makenew/na_gem)
+[![GitHub license](https://img.shields.io/github/license/ttscoff/doing.svg)](./LICENSE.txt)
+
+**A command line tool for adding and listing per-project todos.**
+
+_If you're one of the rare people like me who find this useful, feel free to
+[buy me some coffee][donate]._
+
+<!--README-->
+
+The current version of `na` is <!--VER-->1.0.0<!--END VER-->.
+
+`na` is a command line tool designed to make it easy to see what your next actions are for any project, right from the command line. It works with TaskPaper-formatted files (but any plain text format will do), looking for `@na` tags (or whatever you specify) in todo files in your current folder. 
+
+Used with Taskpaper files, it can add new todo items quickly from the command line, automatically tagging them as next actions.
+
+It can also auto-display next actions when you enter a project directory, automatically locating any todo files and listing their next actions when you `cd` to the project (optionally recursive). See the [Prompt Hooks](#prompt-hooks) section for details.
+
+### Features
+
+You can list next actions in files in the current directory by typing `na`. By default, `na` looks for `*.taskpaper` files and extracts items tagged `@na` and not `@done`. All of these can be changed in the configuration.
+
+#### Easy matching
+
+`na` features intelligent project matching. Every time it locates a todo file, it adds the project to the database. Once a project is recorded, you can list its actions by using any portion of the parent directories or file names. If your project is in `~/Sites/dev/markedapp`, you could quickly list its next actions by typing `na dev mark`. It will always look for the shortest match.
+
+#### Recursion
+
+`na` can also recurse subdirectories to find all todo files in child folders as well. Use the `-d X` to search X levels deep from the current directory. `na -r` with no arguments will recurse from your current location, looking for todo files 3 directories deep.
+
+#### Adding todos
+
+You can also quickly add todo items from the command line with the `add` subcommand. The script will look for a file in the current directory with a `.taskpaper` extension (configurable). 
+
+If found, it will try to locate an `Inbox:` project, or create one if it doesn't exist. Any arguments after `add` will be combined to create a new task in TaskPaper format. They will automatically be assigned as next actions (tagged `@na`) and will show up when `na` lists the tasks for the project.
+
+### Installation
+
+Just run `gem install na`. If you run into errors, use `sudo gem install na`.
+
+### Usage
+
+```
+GLOBAL OPTIONS
+    -a, --[no-]add          - Add a next action (deprecated, for backwards compatibility)
+    -d, --depth=DEPTH       - Recurse to depth (default: 1)
+    --ext=FILE_EXTENSION    - File extension to consider a todo file (default: taskpaper)
+    --help                  - Show this message
+    -n, --[no-]note         - Prompt for additional notes (deprecated, for backwards compatibility)
+    --na_tag=TAG            - Tag to consider a next action (default: na)
+    -p, --priority=PRIORITY - Set a priority 0-5 (deprecated, for backwards compatibility) (default: none)
+    -r, --[no-]recurse      - Recurse 3 directories deep (deprecated, for backwards compatability)
+    --version               - Display the program version
+
+
+
+COMMANDS
+    add        - Add a new next action
+    find       - Find actions matching a search pattern
+    help       - Shows a list of commands or help for one command
+    initconfig - Initialize the config file using current global options
+    next, show - Show next actions
+    tagged     - Find actions matching a tag
+```
+
+#### Commands
+
+##### add
+
+Example: `na add This feature @idea I have`
+
+```
+NAME
+    add - Add a new next action
+
+SYNOPSIS
+
+    na [global options] add [command options] TASK
+
+
+COMMAND OPTIONS
+    -f, --file=PATH    - Specify the file to which the task should be added (default: none)
+    -n, --[no-]note    - Prompt for additional notes
+    -p, --priority=arg - Add a priority level 1-5 (default: 0)
+    -t, --tag=TAG      - Use a tag other than the default next action tag (default: none)
+```
+
+##### find
+
+Example: `na find cool feature idea`
+
+```
+NAME
+    find - Find actions matching a search pattern
+
+SYNOPSIS
+
+    na [global options] find [command options] PATTERN
+
+
+
+DESCRIPTION
+    Search tokens are separated by spaces. Actions matching any token in the pattern will be shown (partial matches allowed). Add a +
+    before a token to make it required, e.g. `na find +feature +maybe`
+
+
+
+COMMAND OPTIONS
+    -d, --depth=DEPTH - Recurse to depth (default: 1)
+    -x, --[no-]exact  - Match pattern exactly
+```
+
+##### next, show
+
+Examples: 
+
+- `na show` (list all next actions in the current directory)
+- `na show -d 3` (list all next actions in the current directory and look for additional files 3 levels deep from there)
+- `na show marked2` (show next actions from another directory you've previously used na on)
+
+```
+NAME
+    next - Show next actions
+
+SYNOPSIS
+
+    na [global options] next [command options] OPTIONAL_QUERY
+
+
+COMMAND OPTIONS
+    -d, --depth=DEPTH - Recurse to depth (default: none)
+    -t, --tag=arg     - Alternate tag to search for (default: na)
+```
+
+##### tagged
+
+Example: `na tagged feature +maybe`
+
+```
+NAME
+    tagged - Find actions matching a tag
+
+SYNOPSIS
+
+    na [global options] tagged [command options] TAG [VALUE]
+
+
+
+DESCRIPTION
+    Finds actions with tags matching the arguments. An action is shown if it contains any of the tags listed. Add a + before a tag to
+    make it required, e.g. `na tagged feature +maybe`
+
+
+
+COMMAND OPTIONS
+    -d, --depth=DEPTH - Recurse to depth (default: 1)
+```
+
+### Configuration
+
+Global options such as todo extension and default next action tag can be stored permanently by using the `na initconfig` command. Run na with the global options you'd like to set, and add `initconfig` at the end of the command. A file will be written to `~/.na.rc`. You can edit this manually, or just update it using the `initconfig --force` command to overwrite it with new settings.
+
+Example: `na --ext md --na_tag next initconfig --force`
+
+### Prompt Hooks
+
+You can add a prompt command to your shell to have na automatically list your next actions when you `cd` into a directory. Add the appropriate command to your login file for your shell:
+
+_(You can add `-r` to any of these calls to na to automatically recurse 3 directories deep)_
+
+Bash (in ~/.bash_profile):
+
+```bash
+last_command_was_cd() {
+	[[ $(history 1|sed -e "s/^[ ]*[0-9]*[ ]*//") =~ ^((cd|z|j|jump|g|f|pushd|popd|exit)([ ]|$)) ]] && na
+}
+if [[ -z "$PROMPT_COMMAND" ]]; then
+	PROMPT_COMMAND="eval 'last_command_was_cd'"
+else
+	echo $PROMPT_COMMAND | grep -v -q "last_command_was_cd" && PROMPT_COMMAND="$PROMPT_COMMAND;"'eval "last_command_was_cd"'
+fi
+```
+
+Fish (in ~/.config/fish/conf.d/*.fish):
+
+```fish
+function __should_na --on-variable PWD
+	# function __should_na --on-event fish_prompt
+	test -s (basename $PWD)".taskpaper" && na
+end
+```
+
+Zsh (in ~/.zshrc):
+
+```zsh
+chpwd() { na }
+```
+
+
+### Misc
+
+If you have [gum][] installed, na will use it for command line input when adding tasks and notes.
+
+[gum]: https://github.com/charmbracelet/gum
+[donate]: http://brettterpstra.com/donate/
+[github]: https://github.com/ttscoff/na_gem/
+
+<!--END README-->
+
+PayPal link: [paypal.me/ttscoff](https://paypal.me/ttscoff)
+
+## Changelog
+
+See [CHANGELOG.md](https://github.com/ttscoff/na_gem/blob/master/CHANGELOG.md)

data/Rakefile

@@ -5,7 +5,7 @@ require 'rdoc/task'
 require 'yard'
 
 YARD::Rake::YardocTask.new do |t|
- t.files = ['lib/doing/*.rb']
+ t.files = ['lib/na/*.rb']
  t.options = ['--markup-provider=redcarpet', '--markup=markdown', '--no-private', '-p', 'yard_templates']
  # t.stats_options = ['--list-undoc']
 end
@@ -28,4 +28,50 @@ Rake::TestTask.new do |t|
   t.test_files = FileList['test/*_test.rb']
 end
 
-task :default => :test
+desc 'Development version check'
+task :ver do
+  gver = `git ver`
+  cver = IO.read(File.join(File.dirname(__FILE__), 'CHANGELOG.md')).match(/^#+ (\d+\.\d+\.\d+(\w+)?)/)[1]
+  res = `grep VERSION lib/na/version.rb`
+  version = res.match(/VERSION *= *['"](\d+\.\d+\.\d+(\w+)?)/)[1]
+  puts "git tag: #{gver}"
+  puts "version.rb: #{version}"
+  puts "changelog: #{cver}"
+end
+
+desc 'Changelog version check'
+task :cver do
+  puts IO.read(File.join(File.dirname(__FILE__), 'CHANGELOG.md')).match(/^#+ (\d+\.\d+\.\d+(\w+)?)/)[1]
+end
+
+desc 'Bump incremental version number'
+task :bump, :type do |_, args|
+  args.with_defaults(type: 'inc')
+  version_file = 'lib/na/version.rb'
+  content = IO.read(version_file)
+  content.sub!(/VERSION = '(?<major>\d+)\.(?<minor>\d+)\.(?<inc>\d+)(?<pre>\S+)?'/) do
+    m = Regexp.last_match
+    major = m['major'].to_i
+    minor = m['minor'].to_i
+    inc = m['inc'].to_i
+    pre = m['pre']
+
+    case args[:type]
+    when /^maj/
+      major += 1
+      minor = 0
+      inc = 0
+    when /^min/
+      minor += 1
+      inc = 0
+    else
+      inc += 1
+    end
+
+    $stdout.puts "At version #{major}.#{minor}.#{inc}#{pre}"
+    "VERSION = '#{major}.#{minor}.#{inc}#{pre}'"
+  end
+  File.open(version_file, 'w+') { |f| f.puts content }
+end
+
+task default: %i[test clobber package]

data/bin/na

@@ -48,6 +48,7 @@ class App
   flag %i[d depth], type: :integer, must_match: /^\d+$/
 
   desc 'Show next actions'
+  arg_name 'OPTIONAL_QUERY'
   command %i[next show] do |c|
     c.desc 'Recurse to depth'
     c.arg_name 'DEPTH'
@@ -57,7 +58,7 @@ class App
     c.default_value 'na'
     c.flag %i[t tag]
 
-    c.action do |global_options, options, _|
+    c.action do |global_options, options, args|
       if global_options[:add]
         cmd = ['add']
         cmd.push('--note') if global_options[:note]
@@ -67,6 +68,18 @@ class App
         exit run(cmd)
       end
 
+
+      if args.count.positive?
+        tokens = []
+        args.each do |arg|
+          m = arg.match(/^(?<req>\+)?(?<tok>.*?)$/)
+          tokens.push({
+                        token: m['tok'],
+                        required: !m['req'].nil?
+                      })
+        end
+      end
+
       depth = if global_options[:recurse] && options[:depth].nil? && global_options[:depth] == 1
                 3
               else
@@ -74,9 +87,11 @@ class App
               end
       tag = options[:tag] == global_options[:na_tag] ? nil : options[:tag]
       actions = NA.parse_actions(depth: depth,
+                                 query: tokens,
                                  extension: global_options[:ext],
                                  na_tag: global_options[:na_tag],
                                  tag: tag)
+
       NA.output_actions(actions, depth, global_options[:ext])
     end
   end
@@ -163,6 +178,7 @@ class App
         end
       end
 
+      save_working_dir(File.expand_path(target))
       NA.add_action(target, action, note)
     end
   end

data/html/created.rid

@@ -1,9 +1,9 @@
-Tue, 27 Sep 2022 10:51:50 -0500
+Tue, 27 Sep 2022 12:40:56 -0500
 README.rdoc	Tue, 27 Sep 2022 10:44:08 -0500
-lib/na.rb	Tue, 27 Sep 2022 05:21:27 -0500
+lib/na.rb	Tue, 27 Sep 2022 11:36:48 -0500
 lib/na/action.rb	Tue, 27 Sep 2022 09:38:32 -0500
 lib/na/colors.rb	Tue, 27 Sep 2022 03:25:39 -0500
-lib/na/next_action.rb	Tue, 27 Sep 2022 10:13:13 -0500
+lib/na/next_action.rb	Tue, 27 Sep 2022 12:05:46 -0500
 lib/na/string.rb	Tue, 27 Sep 2022 09:37:41 -0500
-lib/na/version.rb	Tue, 27 Sep 2022 07:26:43 -0500
-bin/na	Tue, 27 Sep 2022 10:42:39 -0500
+lib/na/version.rb	Tue, 27 Sep 2022 11:33:15 -0500
+bin/na	Tue, 27 Sep 2022 12:06:13 -0500

data/html/js/search_index.js

@@ -1 +1 @@
-var search_data = {"index":{"searchIndex":["app","na","action","color","na","string","add_action()","attributes()","choose_from()","coloring()","coloring?()","create_todo()","find_files()","highlight_tags()","indent_level()","inspect()","last_color_code()","matches()","matches_all()","matches_any()","new()","normalize_color()","output_actions()","parse_actions()","pretty()","rgb()","select_file()","support?()","template()","to_s()","uncolor()","validate_color()","readme"],"longSearchIndex":["app","na","na::action","na::color","na","string","na::add_action()","na::color#attributes()","na::choose_from()","na::color::coloring()","na::color::coloring?()","na::create_todo()","na::find_files()","string#highlight_tags()","string#indent_level()","na::action#inspect()","string#last_color_code()","string#matches()","string#matches_all()","string#matches_any()","na::action::new()","string#normalize_color()","na::output_actions()","na::parse_actions()","na::action#pretty()","na::color#rgb()","na::select_file()","na::color#support?()","na::color::template()","na::action#to_s()","na::color#uncolor()","string#validate_color()",""],"info":[["App","","App.html","",""],["NA","","NA.html","","<p>Cribbed from &lt;github.com/flori/term-ansicolor&gt;\n<p>Next Action methods\n"],["NA::Action","","NA/Action.html","",""],["NA::Color","","NA/Color.html","","<p>Terminal output color functions.\n"],["Na","","Na.html","",""],["String","","String.html","","<p>Template coloring\n"],["add_action","NA","NA.html#method-c-add_action","(file, action, note = nil)",""],["attributes","NA::Color","NA/Color.html#method-i-attributes","()","<p>Returns an array of all NA::Color attributes as symbols.\n"],["choose_from","NA","NA.html#method-c-choose_from","(options, prompt: 'Make a selection: ', multiple: false, sorted: true, fzf_args: [])","<p>Generate a menu of options and allow user selection\n<p>@return     [String] The selected option\n<p>@param    …\n"],["coloring","NA::Color","NA/Color.html#method-c-coloring","()","<p>Enables colored output\n<p>@example Turn color on or off based on TTY\n\n<pre class=\"ruby\"><span class=\"ruby-constant\">NA</span><span class=\"ruby-operator\">::</span><span class=\"ruby-constant\">Color</span>.<span class=\"ruby-identifier\">coloring</span> = <span class=\"ruby-constant\">STDOUT</span>.<span class=\"ruby-identifier\">isatty</span>\n</pre>\n"],["coloring?","NA::Color","NA/Color.html#method-c-coloring-3F","()","<p>Returns true if the coloring function of this module is switched on, false otherwise.\n"],["create_todo","NA","NA.html#method-c-create_todo","(target, basename)",""],["find_files","NA","NA.html#method-c-find_files","(depth: 1, extension: 'taskpaper')",""],["highlight_tags","String","String.html#method-i-highlight_tags","(color: '{m}', value: '{y}', parens: '{m}', last_color: '{g}')","<p>Colorize @tags with ANSI escapes\n<p>@param      color  [String] color (see #Color)\n<p>@return     [String] string …\n"],["indent_level","String","String.html#method-i-indent_level","()",""],["inspect","NA::Action","NA/Action.html#method-i-inspect","()",""],["last_color_code","String","String.html#method-i-last_color_code","()","<p>Get the calculated ANSI color at the end of the string\n<p>@return     ANSI escape sequence to match color …\n"],["matches","String","String.html#method-i-matches","(any: [], all: [])",""],["matches_all","String","String.html#method-i-matches_all","(regexes)",""],["matches_any","String","String.html#method-i-matches_any","(regexes)",""],["new","NA::Action","NA/Action.html#method-c-new","(file, project, parent, action)",""],["normalize_color","String","String.html#method-i-normalize_color","()","<p>Normalize a color name, removing underscores, replacing “bright” with “bold”, and …\n"],["output_actions","NA","NA.html#method-c-output_actions","(actions, depth, extension)",""],["parse_actions","NA","NA.html#method-c-parse_actions","(depth: 1, extension: 'taskpaper', na_tag: 'na', tag: nil, search: nil)",""],["pretty","NA::Action","NA/Action.html#method-i-pretty","(extension: 'taskpaper', template: {})",""],["rgb","NA::Color","NA/Color.html#method-i-rgb","(hex)","<p>Generate escape codes for hex colors\n<p>@param      hex   [String] The hexadecimal color code\n<p>@return     …\n"],["select_file","NA","NA.html#method-c-select_file","(files)",""],["support?","NA::Color","NA/Color.html#method-i-support-3F","(feature)","<p>Returns true if NA::Color supports the <code>feature</code>.\n<p>The feature :clear, that is mixing the clear color attribute …\n"],["template","NA::Color","NA/Color.html#method-c-template","(input)","<p>Convert a template string to a colored string. Colors are specified with single letters inside curly …\n"],["to_s","NA::Action","NA/Action.html#method-i-to_s","()",""],["uncolor","NA::Color","NA/Color.html#method-i-uncolor","(string = nil)","<p>Returns an uncolored version of the string, that is all ANSI-sequences are stripped from the string. …\n"],["validate_color","String","String.html#method-i-validate_color","()","<p>Extract the longest valid %color name from a string.\n<p>Allows %colors to bleed into other text and still …\n"],["README","","README_rdoc.html","","<p>na\n<p>A command line tool for adding and listing project todos in TaskPaper format.\n<p>na - Add and list next …\n"]]}}
+var search_data = {"index":{"searchIndex":["app","na","action","color","na","string","add_action()","attributes()","choose_from()","coloring()","coloring?()","create_todo()","find_files()","highlight_tags()","indent_level()","inspect()","last_color_code()","match_working_dir()","matches()","matches_all()","matches_any()","new()","normalize_color()","output_actions()","parse_actions()","pretty()","rgb()","save_working_dir()","select_file()","support?()","template()","to_s()","uncolor()","validate_color()","weed_cache_file()","readme"],"longSearchIndex":["app","na","na::action","na::color","na","string","na::add_action()","na::color#attributes()","na::choose_from()","na::color::coloring()","na::color::coloring?()","na::create_todo()","na::find_files()","string#highlight_tags()","string#indent_level()","na::action#inspect()","string#last_color_code()","na::match_working_dir()","string#matches()","string#matches_all()","string#matches_any()","na::action::new()","string#normalize_color()","na::output_actions()","na::parse_actions()","na::action#pretty()","na::color#rgb()","na::save_working_dir()","na::select_file()","na::color#support?()","na::color::template()","na::action#to_s()","na::color#uncolor()","string#validate_color()","na::weed_cache_file()",""],"info":[["App","","App.html","",""],["NA","","NA.html","","<p>Cribbed from &lt;github.com/flori/term-ansicolor&gt;\n<p>Next Action methods\n"],["NA::Action","","NA/Action.html","",""],["NA::Color","","NA/Color.html","","<p>Terminal output color functions.\n"],["Na","","Na.html","",""],["String","","String.html","","<p>Template coloring\n"],["add_action","NA","NA.html#method-c-add_action","(file, action, note = nil)",""],["attributes","NA::Color","NA/Color.html#method-i-attributes","()","<p>Returns an array of all NA::Color attributes as symbols.\n"],["choose_from","NA","NA.html#method-c-choose_from","(options, prompt: 'Make a selection: ', multiple: false, sorted: true, fzf_args: [])","<p>Generate a menu of options and allow user selection\n<p>@return     [String] The selected option\n<p>@param    …\n"],["coloring","NA::Color","NA/Color.html#method-c-coloring","()","<p>Enables colored output\n<p>@example Turn color on or off based on TTY\n\n<pre class=\"ruby\"><span class=\"ruby-constant\">NA</span><span class=\"ruby-operator\">::</span><span class=\"ruby-constant\">Color</span>.<span class=\"ruby-identifier\">coloring</span> = <span class=\"ruby-constant\">STDOUT</span>.<span class=\"ruby-identifier\">isatty</span>\n</pre>\n"],["coloring?","NA::Color","NA/Color.html#method-c-coloring-3F","()","<p>Returns true if the coloring function of this module is switched on, false otherwise.\n"],["create_todo","NA","NA.html#method-c-create_todo","(target, basename)",""],["find_files","NA","NA.html#method-c-find_files","(depth: 1, extension: 'taskpaper')",""],["highlight_tags","String","String.html#method-i-highlight_tags","(color: '{m}', value: '{y}', parens: '{m}', last_color: '{g}')","<p>Colorize @tags with ANSI escapes\n<p>@param      color  [String] color (see #Color)\n<p>@return     [String] string …\n"],["indent_level","String","String.html#method-i-indent_level","()",""],["inspect","NA::Action","NA/Action.html#method-i-inspect","()",""],["last_color_code","String","String.html#method-i-last_color_code","()","<p>Get the calculated ANSI color at the end of the string\n<p>@return     ANSI escape sequence to match color …\n"],["match_working_dir","NA","NA.html#method-c-match_working_dir","(search)",""],["matches","String","String.html#method-i-matches","(any: [], all: [])",""],["matches_all","String","String.html#method-i-matches_all","(regexes)",""],["matches_any","String","String.html#method-i-matches_any","(regexes)",""],["new","NA::Action","NA/Action.html#method-c-new","(file, project, parent, action)",""],["normalize_color","String","String.html#method-i-normalize_color","()","<p>Normalize a color name, removing underscores, replacing “bright” with “bold”, and …\n"],["output_actions","NA","NA.html#method-c-output_actions","(actions, depth, extension)",""],["parse_actions","NA","NA.html#method-c-parse_actions","(depth: 1, extension: 'taskpaper', na_tag: 'na', query: nil, tag: nil, search: nil)",""],["pretty","NA::Action","NA/Action.html#method-i-pretty","(extension: 'taskpaper', template: {})",""],["rgb","NA::Color","NA/Color.html#method-i-rgb","(hex)","<p>Generate escape codes for hex colors\n<p>@param      hex   [String] The hexadecimal color code\n<p>@return     …\n"],["save_working_dir","NA","NA.html#method-c-save_working_dir","(todo_file)",""],["select_file","NA","NA.html#method-c-select_file","(files)",""],["support?","NA::Color","NA/Color.html#method-i-support-3F","(feature)","<p>Returns true if NA::Color supports the <code>feature</code>.\n<p>The feature :clear, that is mixing the clear color attribute …\n"],["template","NA::Color","NA/Color.html#method-c-template","(input)","<p>Convert a template string to a colored string. Colors are specified with single letters inside curly …\n"],["to_s","NA::Action","NA/Action.html#method-i-to_s","()",""],["uncolor","NA::Color","NA/Color.html#method-i-uncolor","(string = nil)","<p>Returns an uncolored version of the string, that is all ANSI-sequences are stripped from the string. …\n"],["validate_color","String","String.html#method-i-validate_color","()","<p>Extract the longest valid %color name from a string.\n<p>Allows %colors to bleed into other text and still …\n"],["weed_cache_file","NA","NA.html#method-c-weed_cache_file","()",""],["README","","README_rdoc.html","","<p>na\n<p>A command line tool for adding and listing project todos in TaskPaper format.\n<p>na - Add and list next …\n"]]}}

data/html/table_of_contents.html

@@ -126,6 +126,11 @@
     —
     <span class="container">NA</span>
 
+  <li class="method">
+    <a href="NA.html#method-c-match_working_dir">::match_working_dir</a>
+    &mdash;
+    <span class="container">NA</span>
+
   <li class="method">
     <a href="NA/Action.html#method-c-new">::new</a>
     &mdash;
@@ -141,6 +146,11 @@
     &mdash;
     <span class="container">NA</span>
 
+  <li class="method">
+    <a href="NA.html#method-c-save_working_dir">::save_working_dir</a>
+    &mdash;
+    <span class="container">NA</span>
+
   <li class="method">
     <a href="NA.html#method-c-select_file">::select_file</a>
     &mdash;
@@ -151,6 +161,11 @@
     &mdash;
     <span class="container">NA::Color</span>
 
+  <li class="method">
+    <a href="NA.html#method-c-weed_cache_file">::weed_cache_file</a>
+    &mdash;
+    <span class="container">NA</span>
+
   <li class="method">
     <a href="NA/Color.html#method-i-attributes">#attributes</a>
     &mdash;

data/lib/na/next_action.rb

@@ -83,7 +83,7 @@ module NA
       puts actions.map { |action| action.pretty(template: { output: template }) }
     end
 
-    def parse_actions(depth: 1, extension: 'taskpaper', na_tag: 'na', tag: nil, search: nil)
+    def parse_actions(depth: 1, extension: 'taskpaper', na_tag: 'na', query: nil, tag: nil, search: nil)
       actions = []
       required = []
       optional = []
@@ -112,8 +112,14 @@ module NA
 
       na_tag = "@#{na_tag.sub(/^@/, '')}"
 
-      files = find_files(depth: depth, extension: extension)
+      if query.nil?
+        files = find_files(depth: depth, extension: extension)
+      else
+        files = match_working_dir(query)
+      end
+
       files.each do |file|
+        save_working_dir(File.expand_path(file))
         content = IO.read(file)
         indent_level = 0
         parent = []
@@ -177,5 +183,52 @@ module NA
 
       res
     end
+
+    def match_working_dir(search)
+      optional = []
+      required = []
+
+      search&.each do |t|
+        new_rx = t[:token].to_s
+
+        optional.push(new_rx)
+        required.push(new_rx) if t[:required]
+      end
+
+      db_dir = File.expand_path('~/.local/share/na')
+      db_file = 'tdlist.txt'
+      file = File.join(db_dir, db_file)
+      if File.exist?(file)
+        dirs = IO.read(file).split("\n")
+        dirs.delete_if { |d| !d.matches(any: optional, all: required) }
+        dirs.sort.uniq
+      else
+        puts NA::Color.template('{r}No na database found{x}')
+        Process.exit 1
+      end
+    end
+
+    def save_working_dir(todo_file)
+      db_dir = File.expand_path('~/.local/share/na')
+      FileUtils.mkdir_p(db_dir) unless File.directory?(db_dir)
+      db_file = 'tdlist.txt'
+      file = File.join(db_dir, db_file)
+      content = File.exist?(file) ? IO.read(file) : ''
+      dirs = content.split(/\n/)
+      dirs.push(File.expand_path(todo_file))
+      dirs.sort!.uniq!
+      File.open(file, 'w') { |f| f.puts dirs.join("\n") }
+    end
+
+    def weed_cache_file
+      db_dir = File.expand_path('~/.local/share/na')
+      db_file = 'tdlist.txt'
+      file = File.join(db_dir, db_file)
+      if File.exist?(file)
+        dirs = IO.read(file).split("\n")
+        dirs.delete_if { |f| !File.exist?(f) }
+        File.open(file, 'w') { |f| f.puts dirs.join("\n") }
+      end
+    end
   end
 end

data/lib/na/version.rb

@@ -1,3 +1,3 @@
 module Na
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

data/lib/na.rb

@@ -2,6 +2,7 @@ require 'na/version.rb'
 
 # Add requires for other files you add to your project here, so
 # you just need to require this one file in your bin file
+require 'fileutils'
 require 'shellwords'
 require 'tty-reader'
 require 'tty-which'

data/na.gemspec

@@ -20,6 +20,7 @@ spec = Gem::Specification.new do |s|
   s.add_development_dependency('rake','~> 0.9.2')
   s.add_development_dependency('rdoc', '~> 4.3')
   s.add_development_dependency('minitest', '~> 5.14')
+  s.add_development_dependency('yard', '~> 0.9', '>= 0.9.26')
   s.add_runtime_dependency('gli','~> 2.21.0')
   s.add_runtime_dependency('tty-reader', '~> 0.9', '>= 0.9.0')
   s.add_runtime_dependency('tty-which', '~> 0.5', '>= 0.5.0')

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: na
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Brett Terpstra
@@ -52,6 +52,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5.14'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.26
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.26
 - !ruby/object:Gem::Dependency
   name: gli
   requirement: !ruby/object:Gem::Requirement
@@ -118,6 +138,8 @@ files:
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
+- LICENSE.txt
+- README.md
 - README.rdoc
 - Rakefile
 - bin/na