rbnotes 0.4.4 → 0.4.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a04bd4d45d7c2f4227f355672baa860602ae3b9e481e7a384daf4283f4ad6754
-  data.tar.gz: bc707b20ea91ab655f6e355026164c01844c82ea3869c18fd5ca1040c968934d
+  metadata.gz: 4e4e20e7274cc9e4f9d013340447f7fb06a7dcf45d8536d71e6c6f456a29d310
+  data.tar.gz: e41d785998768d9b4655575ae5303240de437243b6349ecd4ce147a5a051359b
 SHA512:
-  metadata.gz: d93df0df9e002a8bae26b7d9e1e89acf19d84551635d58f3ec747c78f3764ac004a784977a3d9940783a8b4661b2caafd2b55502644bca4bb69947d91593bd79
-  data.tar.gz: 913c240b04215cb5502146f4d1edcd5c1ddc273de31baace3f0d8dff600dcf759e5983aee5cce72fb5079dc26e1a22b43c0aad46e1cc766c4127697090fb0037
+  metadata.gz: 5b2f313ceab8c9a18205189235d72f13c48b7724ba8b15e2651bfb79e1af62e55e1fc1d855eaa0b6eadb3b715e3fd85bd70fe692bbf18d706191a81532a27b0d
+  data.tar.gz: 430276b6461f3502e8f74463451c67a4ddfe40fe7abd5a676abbb6f0ac24980890de6f6ac22f5a7dd64827283c7b101323d4c21b6b210e8c99a577823244885f

data/CHANGELOG.md

@@ -7,8 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 ## [Unreleased]
 Nothing to record here.
 
+## [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)
+
+### Fixed
+- Fix issue #54: Notes list does not sort correctly.
+
 ## [0.4.4] - 2020-11-09
-###
+### Changed
 - Add a feature to use a keyword as an argument for `list`. (#47)
 
 ## [0.4.3] - 2020-11-08
@@ -17,17 +43,17 @@ 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
-### Added
+### Changed
 - Add a feature to keep the timestamp in `update` command. (#44)
 
 ### Fixed
 - Fix issue #45: hanging up of `add` command.
 
 ## [0.4.1] - 2020-11-04
-### Added
+### Changed
 - Add a feature to accept a timestamp in `add` command. (#34)
 
 ## [0.4.0] - 2020-11-03
@@ -36,20 +62,21 @@ Nothing to record here.
 
 ## [0.3.1] - 2020-10-30
 ### Added
-- Add feature to specify configuration file in the command line. (#21)
+- Add a feature to specify configuration file in the command
+  line. (#21)
 
 ## [0.3.0] - 2020-10-29
-### Added
+### Changed
 - Add feature to read argument from the standard input. (#27)
 
 ## [0.2.2] - 2020-10-27
-### Added
-- Add feature to accept a timestamp pattern in `list` command. (#22)
+### Changed
+- Add a feature to accept a timestamp pattern in `list` command. (#22)
 
 ## [0.2.1] - 2020-10-25
 ### Added
-- Add feature to load the configuration from an external file.
-- Add description about the configuration file in README.md
+- Add a feature to load the configuration from an external file.
+  - Add a description about the configuration file in README.md.
 
 ## [0.2.0] - 2020-10-23
 ### Added
@@ -59,15 +86,15 @@ Nothing to record here.
 - Add a new task into `Rakefile` to generate RI docs.
   - The intention of the task is to verify RI docs.
 
-### Fixed
+### Changed
 - Refactor some tests.
 
 ## [0.1.3] - 2020-10-15
-### Fixed
+### Changed
 - Add help text for the `conf` command.
 
 ## [0.1.2] - 2020-10-15
-### Fixed
+### Changed
 - Adapt the API change in `textrepo` (0.4.0).
 
 ## [0.1.0] - 2020-10-12

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rbnotes (0.4.4)
+    rbnotes (0.4.9)
       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.4)
+    textrepo (0.5.7)
     unicode-display_width (1.7.0)
 
 PLATFORMS

data/README.md

@@ -164,10 +164,10 @@ don't have to set `:searcher_options` for them.
 
 | searcher | default options in `textrepo`                      |
 |:---------|:---------------------------------------------------|
-| `grep`   | `["-i", "-n", "-R", "-E"]`                         |
-| `egrep`  | `["-i", "-n", "-R"]`                               |
-| `ggrep`  | `["-i", "-n", "-R", "-E"]`                         |
-| `gegrep` | `["-i", "-n", "-R"]`                               |
+| `grep`   | `["-i", "-n", "-H", "-R", "-E"]`                   |
+| `egrep`  | `["-i", "-n", "-H", "-R"]`                         |
+| `ggrep`  | `["-i", "-n", "-H", "-R", "-E"]`                   |
+| `gegrep` | `["-i", "-n", "-H", "-R"]`                         |
 | `rg`     | `["-S", "-n", "--no-heading", "--color", "never"]` |
 
 Those searcher names are used in macOS (with Homebrew).  Any other OS

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,6 +48,11 @@ 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,

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/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/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/list.rb

@@ -1,7 +1,3 @@
-require "date"
-require "unicode/display_width"
-require "io/console/size"
-
 module Rbnotes::Commands
 
   ##
@@ -15,11 +11,23 @@ module Rbnotes::Commands
     end
 
     ##
-    # Shows a list of notes in the repository.  The only argument is
-    # optional.  If it passed, it must be an timestamp pattern.  A
-    # timestamp is an instance of Textrepo::Timestamp class.  A
-    # timestamp pattern is a string which would match several
-    # Timestamp objects.
+    # Shows a list of notes in the repository.  Arguments are
+    # optional.  If several args are passed, each of them must be a
+    # timestamp pattern or a keyword.
+    #
+    # Any order of timestamp patterns and keywords mixture is
+    # acceptable.  The redundant patterns are just ignored.
+    #
+    # A timestamp pattern is a string which would match several
+    # Timestamp objects.  A timestamp is an instance of
+    # Textrepo::Timestamp class.
+    #
+    # A keyword must be one of them:
+    #
+    # - "today"      (or "to")
+    # - "yeasterday" (or "ye")
+    # - "this_week"  (or "tw")
+    # - "last_week"  (or "lw")
     #
     # Here is several examples of timestamp patterns.
     #
@@ -43,37 +51,45 @@ module Rbnotes::Commands
     #     execute(Array, Rbnotes::Conf or Hash) -> nil
 
     def execute(args, conf)
-      arg = args.shift
-      patterns = []
-
-      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)
+      @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 << arg
+        patterns = Rbnotes.utils.expand_keyword_in_args(args)
       end
 
       @repo = Textrepo.init(conf)
-      stamps = patterns.map { |pat|
-        @repo.entries(pat).sort{|a, b| b <=> a}
-      }.flatten
       # newer stamp shoud be above
-      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
@@ -95,79 +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
-
-    # 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?

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.4"
-  RELEASE = "2020-11-09"
+  VERSION = "0.4.9"
+  RELEASE = "2020-11-17"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rbnotes
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 0.4.9
 platform: ruby
 authors:
 - mnbi
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-09 00:00:00.000000000 Z
+date: 2020-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: textrepo
@@ -68,6 +68,7 @@ files:
 - 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