rbnotes 0.4.5 → 0.4.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 840d2acc4c93d5b03d833b6a518c9740518e025aeb3bb2b6751864d5cf9e9d1c
-  data.tar.gz: 759f8bdc29d64e32c73d7e02540603c3bdf84b6bdf3ac91b7a76bf8e3cf2005d
+  metadata.gz: 7e6de4675ffb2b409f72f240e4509a6d254793d977a8dd68cc54cf6d0c839e3d
+  data.tar.gz: 364d4deb47d049af7145024cfb3151639ea9cf0504963c1b72e5a15e465a84a6
 SHA512:
-  metadata.gz: b47f361e68f7e5275b981848035621fd31342a994d6bd5d90002f91417f4806ba364714b4ea86728f993e43e74868bf08508701531361c4e785830cc772a5b2e
-  data.tar.gz: '09cea0ff486e4e2a8521d732296e64a520c7d076088dd63c05cc4a9c219a2be28e65e50234859bab0d2772a92fb466b1ffc580525fb3565e8d68f7f7f81f8eec'
+  metadata.gz: bf90b255e23257a921f7a9254d4df5233f97394e73368f27f6a4a8e96989fa3aa76ab55fca69b201ecd9a15264d5d07cf974ee9b745854ca80d3c962accbe37a
+  data.tar.gz: c9fca12a0a6a71562a968775b09e3ebf7bda202ce7251666ab7b727236c47f8b5981d7ee703b94bfc22fae038cc161f76b10ed413ca28bcac3a9d9e0417f7f83

data/CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 ## [Unreleased]
 Nothing to record here.
 
+## [0.4.10] - 2020-11-20
+### Added
+- Add a new command `commands` to show all command names. (#71)
+
+### Fixed
+- Fix issue #69: crashes with invalid timestamp pattern.
+
+## [0.4.9] - 2020-11-17
+### Added
+- Add a new option `--week` to the `list` command. (#67)
+
+## [0.4.8] - 2020-11-16
+### Fixed
+- Fix issue #65: messy output of the `search` command.
+
+## [0.4.7] - 2020-11-15
+### Changed
+- Beautify output of the `search` command. (#63)
+
+### Fixed
+- Fix issue #61: `list` command fails in pipeline.
+
+## [0.4.6] - 2020-11-13
+### Added
+- Add a new command `pick` to select a note with picker program. (#59)
+
 ## [0.4.5] - 2020-11-12
 ### Changed
 - Add a feature to accept multiple args for `list`. (#57)
@@ -24,7 +50,7 @@ Nothing to record here.
 - Add individual help for each command. (#42)
 
 ### Fixed
-- Fix `add` fails without modification (#48)
+- Fix issue #48: `add` fails without modification.
 
 ## [0.4.2] - 2020-11-05
 ### Changed

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rbnotes (0.4.5)
+    rbnotes (0.4.10)
       textrepo (~> 0.5.4)
       unicode-display_width (~> 1.7)
 
@@ -10,7 +10,7 @@ GEM
   specs:
     minitest (5.14.2)
     rake (13.0.1)
-    textrepo (0.5.6)
+    textrepo (0.5.7)
     unicode-display_width (1.7.0)
 
 PLATFORMS

data/conf/config.yml

@@ -4,4 +4,5 @@
 :repository_name: "notes"
 :repository_base: "~"
 :pager: "bat -l md"
+:picker: "fzf"
 :editor: "/usr/local/bin/emacsclient"

data/conf/config_deve.yml

@@ -4,4 +4,5 @@
 :repository_name: "notes"
 :repository_base: "tmp"
 :pager: "bat -l md"
+:picker: "fzf"
 :editor: "/usr/local/bin/emacsclient"

data/exe/rbnotes

@@ -48,9 +48,15 @@ app = App.new
 begin
   app.parse_global_options(ARGV)
   app.run(ARGV)
+rescue Errno::EPIPE => e
+  # Fix issue #61: When the pipeline which rbnotes connects is
+  # discarded by the other program, the execption was raised.  It does
+  # not end abnormally for rbnotes.  So, just ignores the exception.
+  exit 0
 rescue MissingArgumentError, MissingTimestampError,
        NoEditorError, ProgramAbortError,
        Textrepo::InvalidTimestampStringError,
+       InvalidTimestampPatternError,
        ArgumentError,
        Errno::EACCES => e
   puts e.message

data/lib/rbnotes.rb

@@ -8,4 +8,10 @@ module Rbnotes
   require_relative "rbnotes/conf"
   require_relative "rbnotes/utils"
   require_relative "rbnotes/commands"
+
+  class << self
+    def utils
+      Utils.instance
+    end
+  end
 end

data/lib/rbnotes/commands.rb

@@ -58,13 +58,14 @@ Syntax:
 
 Example usage:
   #{Rbnotes::NAME} add [-t STAMP_PATTERN]
+  #{Rbnotes::NAME} commands [-d]
   #{Rbnotes::NAME} delete [TIMESTAMP]
   #{Rbnotes::NAME} export [TIMESTAMP [FILENAME]]
   #{Rbnotes::NAME} import FILE
   #{Rbnotes::NAME} list [STAMP_PATTERN|KEYWORD]
   #{Rbnotes::NAME} search PATTERN [STAMP_PATTERN]
   #{Rbnotes::NAME} show [TIMESTAMP]
-  #{Rbnotes::NAME} update [TIMESTAMP]
+  #{Rbnotes::NAME} update [-k] [TIMESTAMP]
 
 Further help for each command:
   #{Rbnotes::NAME} help commands

data/lib/rbnotes/commands/add.rb

@@ -27,7 +27,6 @@ module Rbnotes::Commands
   # If none of the above editor is available, the command fails.
 
   class Add < Command
-    include ::Rbnotes::Utils
 
     def description             # :nodoc:
       "Add a new note"
@@ -52,10 +51,10 @@ module Rbnotes::Commands
       stamp = @opts[:timestamp] || Textrepo::Timestamp.new(Time.now)
 
       candidates = [conf[:editor], ENV["EDITOR"], "nano", "vi"].compact
-      editor = find_program(candidates)
+      editor = Rbnotes.utils.find_program(candidates)
       raise Rbnotes::NoEditorError, candidates if editor.nil?
 
-      tmpfile = run_with_tmpfile(editor, stamp.to_s)
+      tmpfile = Rbnotes.utils.run_with_tmpfile(editor, stamp.to_s)
 
       unless FileTest.exist?(tmpfile)
         puts "Cancel adding, since nothing to store"

data/lib/rbnotes/commands/commands.rb

@@ -0,0 +1,121 @@
+module Rbnotes::Commands
+  ##
+  # Prints all command names into a single line.  When `-d` (or
+  # `--deve-commands`) was specified, development commands (such
+  # `conf`) would be also printed in addition to general commands.
+
+  class Commands < Command
+
+    def description             # :nodoc:
+      "Print all command names into a single line"
+    end
+
+    def execute(args, conf)
+      @opts = {}
+      while args.size > 0
+        arg = args.shift
+        case arg.to_s
+        when ""                 # no options
+          break
+        when "-d", "--deve-commands"
+          @opts[:print_deve_commands] = true
+        else                    # invalid options or args
+          args.unshift(arg)
+          raise ArgumentError, "invalid option or argument: %s" % args.join(" ")
+        end
+      end
+
+      puts commands(@opts[:print_deve_commands]).join(" ")
+    end
+
+    def help
+      puts <<HELP
+usage:
+    #{Rbnotes::NAME} [-d|--deve-commands]
+
+Print all command names into a single line.  If "-d" option (or
+"--deve-commands") is specified, commands for development purpose are
+also printed.
+
+HELP
+      print_commands
+    end
+
+    # :stopdoc:
+    private
+
+    ##
+    # Enumerates all command names.
+    #
+    # :call-seq:
+    #     commands(builtins = false) -> [Array of Strings]
+
+    def commands(include_builtins = false)
+      names = external_commands.map { |cmd| cmd.to_s.downcase }
+      names += builtin_commands.map { |cmd| cmd.to_s.downcase } if include_builtins
+      names
+    end
+
+    def external_commands
+      Dir.glob("*.rb", :base => __dir__) { |rb|
+        require_relative rb
+      }
+      Rbnotes::Commands.constants.difference([:Builtins, :Command]).sort
+    end
+
+    def builtin_commands
+      Rbnotes::Commands::Builtins.constants.sort
+    end
+
+    def print_commands
+      Dir.glob("*.rb", :base => __dir__) { |rb|
+        require_relative rb
+      }
+      puts "#{Rbnotes::NAME.capitalize} Commands:"
+      print_commands_desc(external_commands)
+      puts
+      puts "for development purpose"
+      print_builtins_desc(builtin_commands)
+    end
+
+    def print_commands_desc(commands)
+      print_desc(Rbnotes::Commands, commands)
+    end
+
+    def print_builtins_desc(builtins)
+      print_desc(Rbnotes::Commands::Builtins, builtins)
+    end
+
+    class CmdNames
+      attr_reader :symbol, :name, :size
+      def initialize(cmd)
+        @symbol = cmd
+        @name = cmd.to_s.downcase
+        @size = name.size
+      end
+    end
+
+    def print_desc(mod, commands)
+      cmds = commands.map { |cmd| CmdNames.new(cmd) }
+      name_part_size = cmds.map(&:size).max + 2
+      cmds.map { |cmd|
+        puts "#{spaces(4)}#{name_part(cmd.name, name_part_size)} #{desc_part(cmd.symbol, mod)}"
+      }
+    end
+
+    def name_part(name, size)
+      "#{name}#{spaces(size)}"[0, size]
+    end
+
+    def desc_part(symbol, mod)
+      mod.const_get(symbol, false).new.description
+    end
+
+    def spaces(size)
+      Array.new(size, " ").join
+    end
+
+    # :startdoc:
+
+  end
+end

data/lib/rbnotes/commands/delete.rb

@@ -13,7 +13,7 @@ module Rbnotes::Commands
     end
 
     def execute(args, conf)
-      stamp = Rbnotes::Utils.read_timestamp(args)
+      stamp = Rbnotes.utils.read_timestamp(args)
 
       repo = Textrepo.init(conf)
       begin

data/lib/rbnotes/commands/export.rb

@@ -21,7 +21,7 @@ module Rbnotes::Commands
     #     execute([a String as timestring], Rbnotes::Conf or Hash) -> nil
 
     def execute(args, conf)
-      stamp = Rbnotes::Utils.read_timestamp(args)
+      stamp = Rbnotes.utils.read_timestamp(args)
 
       repo = Textrepo.init(conf)
       begin

data/lib/rbnotes/commands/help.rb

@@ -7,7 +7,7 @@ module Rbnotes::Commands
   class Help < Command
 
     def description             # :nodoc:
-      "Provide help on each command"
+      "Print help of each command"
     end
 
     ##
@@ -20,8 +20,6 @@ module Rbnotes::Commands
       case cmd_name
       when nil
         self.help
-      when "commands"
-        print_commands
       else
         Commands.load(cmd_name).help
       end
@@ -59,40 +57,5 @@ Further information:
 HELP
     end
 
-    # :stopdoc:
-    private
-
-    def print_commands
-      Dir.glob("*.rb", :base => __dir__) { |rb|
-        next if rb == "help.rb"
-        require_relative rb
-      }
-      commands = Commands.constants.difference([:Builtins, :Command])
-      builtins = Commands::Builtins.constants
-
-      puts "#{Rbnotes::NAME.capitalize} Commands:"
-      print_commands_desc(commands.sort)
-      puts
-      puts "for development purpose"
-      print_builtins_desc(builtins.sort)
-    end
-
-    def print_commands_desc(commands)
-      print_desc(Commands, commands)
-    end
-
-    def print_builtins_desc(builtins)
-      print_desc(Commands::Builtins, builtins)
-    end
-
-    def print_desc(mod, commands)
-      commands.map { |cmd|
-        name = "#{cmd.to_s.downcase}        "[0, 8]
-        desc = mod.const_get(cmd, false).new.description
-        puts "    #{name} #{desc}"
-      }
-    end
-
-    # :startdoc:
   end
 end

data/lib/rbnotes/commands/list.rb

@@ -1,7 +1,3 @@
-require "date"
-require "unicode/display_width"
-require "io/console/size"
-
 module Rbnotes::Commands
 
   ##
@@ -55,22 +51,45 @@ module Rbnotes::Commands
     #     execute(Array, Rbnotes::Conf or Hash) -> nil
 
     def execute(args, conf)
-      patterns = args.size > 0 ? convert_keyword(args) : [nil]
+      @opts = {}
+      while args.size > 0
+        arg = args.shift
+        case arg
+        when "-w", "--week"
+          @opts[:enum_week] = true
+        else
+          args.unshift(arg)
+          break
+        end
+      end
+
+      patterns = nil
+      if @opts[:enum_week]
+        arg = args.shift || Textrepo::Timestamp.now[0, 8]
+        case arg.size
+        when "yyyymodd".size, "yyyymoddhhmiss".size, "yyyymoddhhmiss_sfx".size
+          stamp_str = "#{arg}000000"[0, 14]
+          timestamp = Textrepo::Timestamp.parse_s(stamp_str)
+          patterns = Rbnotes.utils.timestamp_patterns_in_week(timestamp)
+        else
+          raise InvalidTimestampPatternError,
+                "cannot convert to a date [%s]" % args.unshift(arg)
+        end
+      else
+        patterns = Rbnotes.utils.expand_keyword_in_args(args)
+      end
 
       @repo = Textrepo.init(conf)
       # newer stamp shoud be above
-      stamps = patterns.map { |pat|
-        @repo.entries(pat)
-      }.flatten.sort{|a, b| b <=> a}.uniq
-      stamps.each { |timestamp|
-        puts make_headline(timestamp)
+      Rbnotes.utils.find_notes(patterns, @repo).each { |timestamp|
+        puts Rbnotes.utils.make_headline(timestamp, @repo.read(timestamp))
       }
     end
 
     def help                    # :nodoc:
       puts <<HELP
 usage:
-    #{Rbnotes::NAME} list [STAMP_PATTERN|KEYWORD]
+    #{Rbnotes::NAME} list [-w|--week][STAMP_PATTERN|KEYWORD]
 
 Show a list of notes.  When no arguments, make a list with all notes
 in the repository.  When specified STAMP_PATTERN, only those match the
@@ -92,100 +111,18 @@ KEYWORD:
     - "this_week"  (or "tw")
     - "last_week"  (or "lw")
 
-HELP
-    end
-
-    # :stopdoc:
-
-    private
-    TIMESTAMP_STR_MAX_WIDTH = "yyyymoddhhmiss_sfx".size
-
-    ##
-    # Makes a headline with the timestamp and subject of the notes, it
-    # looks like as follows:
-    #
-    #   |<------------------ console column size ------------------->|
-    #   +-- timestamp ---+  +-  subject (the 1st line of each note) -+
-    #   |                |  |                                        |
-    #   20101010001000_123: I love Macintosh.                        [EOL]
-    #   20100909090909_999: This is very very long long loooong subje[EOL]
-    #                     ++
-    #                      ^--- delimiter (2 characters)
-    #
-    # The subject part will truncate when it is long.
-
-    def make_headline(timestamp)
-      _, column = IO.console_size
-      delimiter = ": "
-      subject_width = column - TIMESTAMP_STR_MAX_WIDTH - delimiter.size - 1
+An option "--week" is also acceptable.  It specifies to enumerate all
+days of a week.  Typically, the option is used with a STAMP_PATTERN
+which specifies a date, such "20201117", then it enumerates all days
+of the week which contains "17th November 2020".
 
-      subject = remove_heading_markup(@repo.read(timestamp)[0])
+A STAMP_PATTERN other than (a) and (b) causes an error if it was used
+with "--week" option.
 
-      ts_part = "#{timestamp.to_s}    "[0..(TIMESTAMP_STR_MAX_WIDTH - 1)] 
-      sj_part = truncate_str(subject, subject_width)
-
-      ts_part + delimiter + sj_part
-    end
-
-    def truncate_str(str, size)
-      count = 0
-      result = ""
-      str.each_char { |c|
-        count += Unicode::DisplayWidth.of(c)
-        break if count > size
-        result << c
-      }
-      result
-    end
-
-    def remove_heading_markup(str)
-      str.sub(/^#+ +/, '')
-    end
-
-    def convert_keyword(args)
-      patterns = []
-      while args.size > 0
-        arg = args.shift
-        case arg.to_s
-        when "today", "to"
-          patterns << Textrepo::Timestamp.new(Time.now).to_s[0..7]
-        when "yesterday", "ye"
-          t = Time.now
-          patterns << Date.new(t.year, t.mon, t.day).prev_day.strftime("%Y%m%d")
-        when "this_week", "tw"
-          patterns.concat(dates_in_this_week)
-        when "last_week", "lw"
-          patterns.concat(dates_in_last_week)
-        else
-          patterns << arg
-        end
-      end
-      patterns.sort!.uniq
-    end
-
-    # week day for Monday start calendar
-    def wday(time)
-      (time.wday - 1) % 7
-    end
-
-    def dates_in_this_week
-      to = Time.now
-      start = Date.new(to.year, to.mon, to.day).prev_day(wday(to))
-      dates_in_week(start)
-    end
-
-    def dates_in_last_week
-      to = Time.now
-      start_of_this_week = Date.new(to.year, to.mon, to.day).prev_day(wday(to))
-      dates_in_week(start_of_this_week.prev_day(7))
-    end
-
-    def dates_in_week(start_date)
-      dates = [start_date]
-      1.upto(6) { |i| dates << start_date.next_day(i) }
-      dates.map { |d| d.strftime("%Y%m%d") }
+When no STAMP_PATTERN was specified with "--week" option, the output
+would be as same as the KEYWORD, "this_week" was specified.
+HELP
     end
 
-    # :startdoc:
   end
 end

data/lib/rbnotes/commands/pick.rb

@@ -0,0 +1,47 @@
+module Rbnotes::Commands
+
+  ##
+  # Picks a timestamp with a picker program, like `fzf`.
+
+  class Pick < Command
+
+    def description             # :nodoc:
+      "Pick a timestamp with a picker program"
+    end
+
+    def execute(args, conf)
+      patterns = Rbnotes.utils.expand_keyword_in_args(args)
+      @repo = Textrepo.init(conf)
+
+      list = []
+      Rbnotes.utils.find_notes(patterns, @repo).each { |timestamp|
+        list << Rbnotes.utils.make_headline(timestamp, @repo.read(timestamp))
+      }
+
+      picker = conf[:picker]
+      unless picker.nil?
+        require 'open3'
+        result = Open3.pipeline_rw(picker) { |stdin, stdout, _|
+          stdin.puts list
+          stdin.close
+          stdout.read
+        }
+        puts result
+      else
+        puts list
+      end
+    end
+
+    def help                    # :nodoc:
+      puts <<HELP
+usage:
+    #{Rbnotes::NAME} pick
+
+Pick a timestamp with a picker program, like `fzf`.  This command
+refers the configuration setting of ":picker".  If no picker program
+is specified, it will behave as same as "list" command.
+
+HELP
+    end
+  end
+end

data/lib/rbnotes/commands/search.rb

@@ -39,11 +39,8 @@ module Rbnotes::Commands
         result = repo.search(pattern, timestamp_pattern)
       rescue Textrepo::InvalidSearchResultError => e
         puts e.message
-      else
-        result.each { |stamp, num, match|
-          puts "#{stamp}:#{num}:#{match}"
-        }
       end
+      print_search_result(result.map{ |e| SearchEntry.new(*e) })
     end
 
     def help                    # :nodoc:
@@ -63,5 +60,51 @@ STAMP_PATTERN must be:
     (e) date part only: "1030"
 HELP
     end
+
+    private
+
+    # Each entry of search result is:
+    #
+    #   [<timestamp>, <line_number>, <matched_text>]
+    #
+    # The sort must be done in;
+    #
+    #   - descending order for <timestamp>,
+    #   - ascending ordier for <line_number>.
+    #
+
+    SearchEntry = Struct.new(:timestamp, :line_number, :matched_text) {
+      def timestamp_size
+        timestamp.to_s.size
+      end
+
+      def line_number_digits_size
+        line_number.to_s.size
+      end
+    }
+
+    def print_search_result(entries)
+      maxcol_stamp = entries.map(&:timestamp_size).max
+      maxcol_num = entries.map(&:line_number_digits_size).max
+
+      sort(entries).each { |e|
+        stamp_display = "%- *s" % [maxcol_stamp, e.timestamp]
+        num_display = "%*d" % [maxcol_num, e.line_number]
+
+        puts "#{stamp_display}: #{num_display}: #{e.matched_text}"
+      }
+    end
+
+    def sort(search_result)
+      search_result.sort { |a, b|
+        stamp_comparison = (b.timestamp <=> a.timestamp)
+        if stamp_comparison == 0
+          a.line_number <=> b.line_number
+        else
+          stamp_comparison
+        end
+      }
+    end
+
   end
 end

data/lib/rbnotes/commands/show.rb

@@ -19,7 +19,7 @@ module Rbnotes::Commands
     end
 
     def execute(args, conf)
-      stamp = Rbnotes::Utils.read_timestamp(args)
+      stamp = Rbnotes.utils.read_timestamp(args)
 
       repo = Textrepo.init(conf)
       content = repo.read(stamp)

data/lib/rbnotes/commands/update.rb

@@ -18,7 +18,6 @@ module Rbnotes::Commands
   # none of editors is available, the execution fails.
 
   class Update < Command
-    include ::Rbnotes::Utils
 
     def description             # :nodoc:
       "Update the content of a note"
@@ -44,8 +43,8 @@ module Rbnotes::Commands
         end
       end
 
-      target_stamp = Rbnotes::Utils.read_timestamp(args)
-      editor = find_editor(conf[:editor])
+      target_stamp = Rbnotes.utils.read_timestamp(args)
+      editor = Rbnotes.utils.find_editor(conf[:editor])
       repo = Textrepo.init(conf)
 
       text = nil
@@ -55,7 +54,7 @@ module Rbnotes::Commands
         raise Rbnotes::MissingTimestampError, target_stamp
       end
 
-      tmpfile = run_with_tmpfile(editor, target_stamp.to_s, text)
+      tmpfile = Rbnotes.utils.run_with_tmpfile(editor, target_stamp.to_s, text)
       text = File.readlines(tmpfile, :chomp => true)
 
       unless text.empty?
@@ -83,7 +82,7 @@ module Rbnotes::Commands
     def help                    # :nodoc:
       puts <<HELP
 usage:
-    #{Rbnotes::NAME} update [TIMESTAMP]
+    #{Rbnotes::NAME} update [-k|--keep] [TIMESTAMP]
 
 Updates the content of the note associated with given timestamp.
 

data/lib/rbnotes/error.rb

@@ -7,10 +7,12 @@ module Rbnotes
   # :stopdoc:
 
   module ErrMsg
-    MISSING_ARGUMENT  = "missing argument: %s"
-    MISSING_TIMESTAMP = "missing timestamp: %s"
+    MISSING_ARGUMENT  = "Missing argument: %s"
+    MISSING_TIMESTAMP = "Missing timestamp: %s"
     NO_EDITOR         = "No editor is available: %s"
     PROGRAM_ABORT     = "External program was aborted: %s"
+    UNKNOWN_KEYWORD   = "Unknown keyword: %s"
+    INVALID_TIMESTAMP_PATTERN = "Invalid timestamp pattern: %s"
   end
 
   # :startdoc:
@@ -53,4 +55,24 @@ module Rbnotes
       super(ErrMsg::PROGRAM_ABORT % cmdline.join(" "))
     end
   end
+
+  ##
+  # An eeror raised when an unknown keyword was specified as a
+  # timestamp string pattern.
+
+  class UnknownKeywordError < Error
+    def initialize(keyword)
+      super(ErrMsg::UNKNOWN_KEYWORD % keyword)
+    end
+  end
+
+  ##
+  # An error raised when an invalid timestamp pattern was specified.
+
+  class InvalidTimestampPatternError < Error
+    def initialize(pattern)
+      super(ErrMsg::INVALID_TIMESTAMP_PATTERN % pattern)
+    end
+  end
+
 end

data/lib/rbnotes/utils.rb

@@ -1,12 +1,18 @@
+require "singleton"
 require "pathname"
 require "tmpdir"
+require "date"
+require "io/console/size"
+
+require "unicode/display_width"
 
 module Rbnotes
   ##
   # Defines several utility methods those are intended to be used in
   # Rbnotes classes.
   #
-  module Utils
+  class Utils
+    include Singleton
 
     ##
     # Finds a external editor program which is specified with the
@@ -26,7 +32,6 @@ module Rbnotes
     def find_editor(preferred_editor)
       find_program([preferred_editor, ENV["EDITOR"], "nano", "vi"].compact)
     end
-    module_function :find_editor
 
     ##
     # Finds a executable program in given names.  When the executable
@@ -60,7 +65,6 @@ module Rbnotes
       }
       nil
     end
-    module_function :find_program
 
     ##
     # Executes the program with passing the given filename as argument.
@@ -84,7 +88,6 @@ module Rbnotes
       raise ProgramAbortError, [prog, tmpfile] unless rc
       tmpfile
     end
-    module_function :run_with_tmpfile
 
     ##
     # Generates a Textrepo::Timestamp object from a String which comes
@@ -98,7 +101,6 @@ module Rbnotes
       str = args.shift || read_arg($stdin)
       Textrepo::Timestamp.parse_s(str)
     end
-    module_function :read_timestamp
 
     ##
     # Reads an argument from the IO object.  Typically, it is intended
@@ -119,7 +121,122 @@ module Rbnotes
         nil
       end
     end
-    module_function :read_arg
+
+    ##
+    # Parses the given arguments and expand keywords if found.  Each
+    # of the arguments is assumed to represent a timestamp pattern (or
+    # a keyword to be expand into several timestamp pattern).  Returns
+    # an Array of timestamp partterns (each pattern is a String
+    # object).
+    #
+    # A timestamp pattern looks like:
+    #
+    #   (a) full qualified timestamp (with suffix): "20201030160200"
+    #   (b) year and date part: "20201030"
+    #   (c) year and month part: "202010"
+    #   (d) year part only: "2020"
+    #   (e) date part only: "1030"
+    #
+    # KEYWORD:
+    #
+    #   - "today"      (or "to")
+    #   - "yeasterday" (or "ye")
+    #   - "this_week"  (or "tw")
+    #   - "last_week"  (or "lw")
+    #
+    # :call-seq:
+    #   expand_keyword_in_args(Array of Strings) -> Array of Strings
+
+    def expand_keyword_in_args(args)
+      return [nil] if args.empty?
+
+      patterns = []
+      while args.size > 0
+        arg = args.shift
+        if ["today", "to", "yesterday", "ye",
+            "this_week", "tw", "last_week", "lw"].include?(arg)
+          patterns.concat(Rbnotes.utils.expand_keyword(arg))
+        else
+          patterns << arg
+        end
+      end
+      patterns.sort.uniq
+    end
+
+    ##
+    # Expands a keyword to timestamp strings.
+    #
+    # :call-seq:
+    #     expand_keyword(keyword as String) -> Array of timestamp Strings
+
+    def expand_keyword(keyword)
+      patterns = []
+      case keyword
+      when "today", "to"
+        patterns << timestamp_pattern(date_of_today)
+      when "yesterday", "ye"
+        patterns << timestamp_pattern(date_of_yesterday)
+      when "this_week", "tw"
+        patterns.concat(dates_in_this_week.map { |d| timestamp_pattern(d) })
+      when "last_week", "lw"
+        patterns.concat(dates_in_last_week.map { |d| timestamp_pattern(d) })
+      else
+        raise UnknownKeywordError, keyword
+      end
+      patterns
+    end
+
+    ##
+    # Makes a headline with the timestamp and subject of the notes, it
+    # looks like as follows:
+    #
+    #   |<------------------ console column size ------------------->|
+    #   +-- timestamp ---+  +-  subject (the 1st line of each note) -+
+    #   |                |  |                                        |
+    #   20101010001000_123: I love Macintosh.                        [EOL]
+    #   20100909090909_999: This is very very long long loooong subje[EOL]
+    #                     ++
+    #                      ^--- delimiter (2 characters)
+    #
+    # The subject part will truncate when it is long.
+
+    def make_headline(timestamp, text)
+      _, column = IO.console_size
+      delimiter = ": "
+      timestamp_width = timestamp.to_s.size
+      subject_width = column - timestamp_width - delimiter.size - 1
+
+      subject = remove_heading_markup(text[0])
+
+      ts_part = "#{timestamp.to_s}    "[0..(timestamp_width - 1)]
+      sj_part = truncate_str(subject, subject_width)
+
+      ts_part + delimiter + sj_part
+    end
+
+    ##
+    # Finds all notes those timestamps match to given patterns in the
+    # given repository.  Returns an Array contains Timestamp objects.
+    #
+    # :call-seq:
+    #     find_notes(Array of timestamp patterns, Textrepo::Repository)
+
+    def find_notes(timestamp_patterns, repo)
+      timestamp_patterns.map { |pat|
+        repo.entries(pat)
+      }.flatten.sort{ |a, b| b <=> a }.uniq
+    end
+
+    ##
+    # Enumerates all timestamp patterns in a week which contains a
+    # given timestamp as a day of the week.
+    #
+    # :call-seq:
+    #     timestamp_patterns_in_week(timestamp) -> [Array of Strings]
+
+    def timestamp_patterns_in_week(timestamp)
+      dates_in_week(start_date_in_the_week(timestamp.time)).map { |date| timestamp_pattern(date) }
+    end
 
     # :stopdoc:
 
@@ -132,11 +249,74 @@ module Rbnotes
       }
       found.compact[0]
     end
-    module_function :search_in_path
 
     def add_extension(basename)
       "#{basename}.md"
     end
-    module_function :add_extension
+
+    def timestamp_pattern(date)
+      date.strftime("%Y%m%d")
+    end
+
+    def date_of_today
+      date(Time.now)
+    end
+
+    def date_of_yesterday
+      date(Time.now).prev_day
+    end
+
+    def date(time)
+      Date.new(time.year, time.mon, time.day)
+    end
+
+    def dates_in_this_week
+      dates_in_week(start_date_in_this_week)
+    end
+
+    def dates_in_last_week
+      dates_in_week(start_date_in_last_week)
+    end
+
+    def start_date_in_this_week
+      start_date_in_the_week(Time.now)
+    end
+
+    def start_date_in_last_week
+      start_date_in_this_week.prev_day(7)
+    end
+
+    def start_date_in_the_week(time)
+      parts = [:year, :mon, :day].map { |sym| time.send(sym) }
+      Date.new(*parts).prev_day(wday(time))
+    end
+
+    def wday(time)
+      (time.wday - 1) % 7
+    end
+
+    def dates_in_week(start_date)
+      dates = [start_date]
+      1.upto(6) { |i| dates << start_date.next_day(i) }
+      dates
+    end
+
+    def truncate_str(str, size)
+      count = 0
+      result = ""
+      str.each_char { |c|
+        count += Unicode::DisplayWidth.of(c)
+        break if count > size
+        result << c
+      }
+      result
+    end
+
+    def remove_heading_markup(str)
+      str.sub(/^#+ +/, '')
+    end
+
+    # :startdoc:
+
   end
 end

data/lib/rbnotes/version.rb

@@ -1,4 +1,4 @@
 module Rbnotes
-  VERSION = "0.4.5"
-  RELEASE = "2020-11-12"
+  VERSION = "0.4.10"
+  RELEASE = "2020-11-20"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rbnotes
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.10
 platform: ruby
 authors:
 - mnbi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-12 00:00:00.000000000 Z
+date: 2020-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: textrepo
@@ -63,11 +63,13 @@ files:
 - lib/rbnotes.rb
 - lib/rbnotes/commands.rb
 - lib/rbnotes/commands/add.rb
+- lib/rbnotes/commands/commands.rb
 - lib/rbnotes/commands/delete.rb
 - lib/rbnotes/commands/export.rb
 - lib/rbnotes/commands/help.rb
 - lib/rbnotes/commands/import.rb
 - lib/rbnotes/commands/list.rb
+- lib/rbnotes/commands/pick.rb
 - lib/rbnotes/commands/search.rb
 - lib/rbnotes/commands/show.rb
 - lib/rbnotes/commands/update.rb