na 1.2.84 → 1.2.86

data/lib/na/theme.rb

@@ -1,10 +1,16 @@
 # frozen_string_literal: true
 
 module NA
+  # Provides theme and color template helpers for todo CLI output.
+  #
+  # @example Get theme help text
+  #   NA::Theme.template_help
   module Theme
     class << self
       # Returns a help string describing available color placeholders for themes.
       # @return [String] Help text for theme placeholders
+      # @example
+      #   NA::Theme.template_help
       def template_help
         <<~EOHELP
           Use {X} placeholders to apply colors. Available colors are:
@@ -28,52 +34,63 @@ module NA
       # Writes the help text and theme YAML to the theme file.
       # @param template [Hash] Additional theme settings to merge
       # @return [Hash] The merged theme configuration
+      # @example
+      #   NA::Theme.load_theme(template: { action: '{r}' })
       def load_theme(template: {})
-        NA::Benchmark.measure('Theme.load_theme') do
-          # Default colorization, can be overridden with full or partial template variable
-          default_template = {
-            parent: '{c}',
-            bracket: '{dc}',
-            parent_divider: '{xw}/',
-            action: '{bg}',
-            project: '{xbk}',
-            tags: '{m}',
-            value_parens: '{m}',
-            values: '{c}',
-            search_highlight: '{y}',
-            note: '{dw}',
-            dirname: '{xdw}',
-            filename: '{xb}{#eccc87}',
-            prompt: '{m}',
-            success: '{bg}',
-            error: '{b}{#b61d2a}',
-            warning: '{by}',
-            debug: '{dw}',
-            templates: {
-              output: '%filename%parents| %action',
-              default: '%parent%action',
-              single_file: '%parent%action',
-              multi_file: '%filename%parent%action',
-              no_file: '%parent%action'
-            }
-          }
+        if defined?(NA::Benchmark) && NA::Benchmark
+          NA::Benchmark.measure('Theme.load_theme') do
+            load_theme_internal(template: template)
+          end
+        else
+          load_theme_internal(template: template)
+        end
+      end
 
-          # Load custom theme
-          theme_file = NA.database_path(file: 'theme.yaml')
-          theme = if File.exist?(theme_file)
-                    YAML.load(File.read(theme_file)) || {}
-                  else
-                    {}
-                  end
-          theme = default_template.deep_merge(theme)
+      def load_theme_internal(template: {})
+        # Default colorization, can be overridden with full or partial template variable
+        default_template = {
+          parent: '{c}',
+          bracket: '{dc}',
+          parent_divider: '{xw}/',
+          action: '{bg}',
+          project: '{xbk}',
+          tags: '{m}',
+          value_parens: '{m}',
+          values: '{c}',
+          search_highlight: '{y}',
+          note: '{dw}',
+          dirname: '{xdw}',
+          filename: '{xb}{#eccc87}',
+          line: '{dw}',
+          prompt: '{m}',
+          success: '{bg}',
+          error: '{b}{#b61d2a}',
+          warning: '{by}',
+          debug: '{dw}',
+          templates: {
+            output: '%filename%line%parents| %action',
+            default: '%parents %line %action',
+            single_file: '%parents %line %action',
+            multi_file: '%filename%line%parents %action',
+            no_file: '%parents %line %action'
+          }
+        }
 
-          File.open(theme_file, 'w') do |f|
-            f.puts template_help.comment
-            f.puts YAML.dump(theme)
-          end
+        # Load custom theme
+        theme_file = NA.database_path(file: 'theme.yaml')
+        theme = if File.exist?(theme_file)
+                  YAML.load(File.read(theme_file)) || {}
+                else
+                  {}
+                end
+        theme = default_template.deep_merge(theme)
 
-          theme.merge(template)
+        File.open(theme_file, 'w') do |f|
+          f.puts template_help.comment
+          f.puts YAML.dump(theme)
         end
+
+        theme.merge(template)
       end
     end
   end

data/lib/na/todo.rb

@@ -1,6 +1,10 @@
 # frozen_string_literal: true
 
 module NA
+  # Represents a parsed todo file, including actions, projects, and file management.
+  #
+  # @example Parse a todo file
+  #   todo = NA::Todo.new(file_path: 'todo.txt')
   class Todo
     attr_accessor :actions, :projects, :files
 
@@ -8,6 +12,8 @@ module NA
     #
     # @param options [Hash] Options for parsing todo files
     # @return [void]
+    # @example
+    #   todo = NA::Todo.new(file_path: 'todo.txt')
     def initialize(options = {})
       @files, @actions, @projects = parse(options)
     end
@@ -26,6 +32,8 @@ module NA
     # @option options [Boolean] :require_na Require @na tag
     # @option options [String] :file_path file path to parse
     # @return [Array] files, actions, projects
+    # @example
+    #   files, actions, projects = todo.parse(file_path: 'todo.txt')
     def parse(options)
       NA::Benchmark.measure('Todo.parse') do
         defaults = {

data/lib/na/version.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+##
+# Main module for the na gem, providing version information.
 module Na
-  VERSION = '1.2.84'
+  ##
+  # Current version of the na gem.
+  VERSION = '1.2.86'
 end

data/lib/na.rb

@@ -1,6 +1,16 @@
 # frozen_string_literal: true
 
-require 'na/benchmark'
+require 'na/benchmark' if ENV['NA_BENCHMARK']
+# Define a dummy Benchmark if not available for tests
+unless defined?(NA::Benchmark)
+  module NA
+    module Benchmark
+      def self.measure(_label)
+        yield
+      end
+    end
+  end
+end
 require 'na/version'
 require 'na/pager'
 require 'time'

data/src/_README.md

@@ -9,7 +9,7 @@
 _If you're one of the rare people like me who find this useful, feel free to
 [buy me some coffee][donate]._
 
-The current version of `na` is <!--VER-->1.2.83<!--END VER-->.
+The current version of `na` is <!--VER-->1.2.85<!--END VER-->.
 
 `na` ("next action") 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.
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: na
 version: !ruby/object:Gem::Version
-  version: 1.2.84
+  version: 1.2.86
 platform: ruby
 authors:
 - Brett Terpstra
@@ -245,6 +245,7 @@ extra_rdoc_files:
 - README.md
 - na.rdoc
 files:
+- ".cursor/commands/priority35m36m335m32m.md"
 - ".rubocop.yml"
 - ".rubocop_todo.yml"
 - ".travis.yml"