rbnotes 0.4.8 → 0.4.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de852db7e0679690dc371c256eb8f65a5f8022772b04ed6024c4f4b55c5cebae
-  data.tar.gz: 27764e6f940f29be341745d50db658ef419af0e576b674533398910694f294f7
+  metadata.gz: 55b7ddb12d306be2cb815400d4e729deff8badfbde55ede0f9edba78c380eb44
+  data.tar.gz: ae0720108810db518693959f3a8faf20c7ca985d6aaf3c39bac94327d45f25db
 SHA512:
-  metadata.gz: de49f9046ad826a346cabd37bab304e1d0ab08dfda4e6f5ca6ce7b216cc717ed39645baf092aa993e8287bd65761a605d1f2d1c158e465bc75efbac68ceeb785
-  data.tar.gz: 9c28c82c7b486695a5e5fe5875fda39e69bc1673e85434368fba4a2a1a71c0cff1918e60c88ecfd43bf22546bbb79d121319044b1fb068da5445dbc78b239639
+  metadata.gz: 8fc47bdc0c93bc964714c89d791655f1d385de0dfbf6af5202ec18c17f1be951efb02fcd4d9b0ac9b298cbb163e8a9e836a5c4d752bf9bad5299cc0d38983463
+  data.tar.gz: d2a3db96531609429775b9caf32308691afc6023ffaf2d8aae39df3d763e99b497a3efe763e821033ab725240e925ddd23a5385dac15d0a3bd5f3cb9f7c23ac1

data/.github/workflows/main.yml

@@ -0,0 +1,18 @@
+name: Build
+
+on: [push,pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: 3.0.0
+    - name: Run the default task
+      run: |
+        gem install bundler -v 2.2.3
+        bundle install
+        bundle exec rake

data/.gitignore

@@ -35,7 +35,6 @@ build-iPhoneSimulator/
 ## Documentation cache and generated files:
 /.yardoc/
 /_yardoc/
-/doc/
 /rdoc/
 
 ## Environment normalization:

data/CHANGELOG.md

@@ -5,7 +5,52 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
-Nothing to record here.
+
+## [0.4.13] - 2021-03-30
+### Changed
+- Use GitHub/Actions instead of Travis-CI.
+- Add `--week` option to `pick` command. (#88)
+
+### Fixed
+- Fix issue #98: remove redundant args
+  (Rbnotes::Utils.read_multiple_timestamps). (#98)
+- Update `textrepo`. -> 0.5.8 (#97)
+
+## [0.4.12] - 2020-12-18
+### Changed
+- Make clear the spec of `list` command args. (#94)
+- Add a feature to use a template file for `add` command. (#87)
+- Add new keywords for `list` command. (#90)
+  - `this_month` and `last_month`
+- Add a new option, `verbose` for `list` command. (#76)
+
+### Fixed
+- Fix issue #80: suppress unnecessary error message.
+
+## [0.4.11] - 2020-12-07
+### Added
+- Add a new command `statistics`. (#73)
+  - limited features
+- Add a completion file for `zsh`.
+  - a new file `etc/zsh/_rbnotes`
+
+### Changed
+- Add a new option for `import` to use `mtime`. (#82)
+- Add a feature to show multiple notes at once. (#79)
+
+### Fixed
+- Fix issue #77: no error with a non-existing config file.
+
+## [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

data/Gemfile

@@ -6,4 +6,4 @@ gemspec
 gem "rake", "~> 13.0"
 gem "minitest", "~> 5.0"
 
-gem 'textrepo', "~> 0.5.4"
+gem 'textrepo', "~> 0.5.8"

data/Gemfile.lock

@@ -1,16 +1,16 @@
 PATH
   remote: .
   specs:
-    rbnotes (0.4.8)
-      textrepo (~> 0.5.4)
+    rbnotes (0.4.13)
+      textrepo (~> 0.5.8)
       unicode-display_width (~> 1.7)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    minitest (5.14.2)
-    rake (13.0.1)
-    textrepo (0.5.7)
+    minitest (5.14.4)
+    rake (13.0.3)
+    textrepo (0.5.8)
     unicode-display_width (1.7.0)
 
 PLATFORMS
@@ -20,7 +20,7 @@ DEPENDENCIES
   minitest (~> 5.0)
   rake (~> 13.0)
   rbnotes!
-  textrepo (~> 0.5.4)
+  textrepo (~> 0.5.8)
 
 BUNDLED WITH
-   2.1.4
+   2.2.3

data/README.md

@@ -1,6 +1,6 @@
 # Rbnotes
 
-[![Build Status](https://travis-ci.org/mnbi/rbnotes.svg?branch=main)](https://travis-ci.org/mnbi/rbnotes)
+[![Build Status](https://github.com/mnbi/rbnotes/workflows/Build/badge.svg)](https://github.com/mnbi/rbnotes/actions?query=workflow%3A"Build")
 
 Rbnotes is a simple utility to write a note in the single repository.
 

data/Rakefile

@@ -25,6 +25,6 @@ require "rdoc/task"
 
 RDoc::Task.new do |rdoc|
   rdoc.generator = "ri"
-  rdoc.rdoc_dir = "doc"
+  rdoc.rdoc_dir = "rdoc"
   rdoc.rdoc_files.include("lib/**/*.rb")
 end

data/conf/config.yml

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

data/conf/config_deve.yml

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

data/conf/config_deve_fzf_no_opts.yml

@@ -0,0 +1,8 @@
+---
+:run_mode: :development
+:repository_type: :file_system
+:repository_name: "notes"
+:repository_base: "tmp"
+:pager: "bat -l md"
+:picker: "fzf"
+:editor: "/usr/local/bin/emacsclient"

data/conf/config_deve_no_picker.yml

@@ -0,0 +1,7 @@
+---
+:run_mode: :development
+:repository_type: :file_system
+:repository_name: "notes"
+:repository_base: "tmp"
+:pager: "bat -l md"
+:editor: "/usr/local/bin/emacsclient"

data/conf/config_deve_peco.yml

@@ -0,0 +1,8 @@
+---
+:run_mode: :development
+:repository_type: :file_system
+:repository_name: "notes"
+:repository_base: "tmp"
+:pager: "bat -l md"
+:picker: "peco"
+:editor: "/usr/local/bin/emacsclient"

data/etc/zsh/_rbnotes

@@ -0,0 +1,93 @@
+#compdef rbnotes
+
+local __rbnotes_cmd __rbnotes_debug
+
+__rbnotes_process() {
+}
+
+function _rbnotes() {
+    local context curcontext=$curcontext stat line
+    typeset -A opt_args
+    local ret=1
+
+    _arguments \
+	-C \
+	'(- *)'{-v,--version}'[print version]' \
+	'(- *)'{-h,--help}'[show help]' \
+	'(- *)'{-c,--conf}'[config file]: :->conffile' \
+	'1: :__rbnotes_commands' \
+	'*:: :->args'
+
+    case $state in
+	(conffile)
+	    _files -g "*.yml" && ret=0
+	    ;;
+	(args)
+	    case $words[1] in
+		(add)
+		    _arguments \
+			-C \
+			'(-t --timestamp)'{-t,--timestamp}'[set timestamp]' \
+			'(-)*:: :->null_state' \
+			&& ret=0
+		    ;;
+		(export)
+		    _directories && ret=0
+		    ;;
+		(help)
+		    _arguments \
+			-C \
+			'1: :__rbnotes_commands' \
+			&& ret=0
+		    ;;
+		(import)
+		    _files -g '*.md' && ret=0
+		    ;;
+		(list|pick)
+		    _arguments \
+			-C \
+			'1: :__rbnotes_list_keywords' \
+			&& ret=0
+		    ;;
+		(update)
+		    _arguments \
+			-C \
+			'(-k --keep)'{-k,--keep}'[keep timestamp]' \
+			'(-)*:: :->nul_state' \
+			&& ret=0
+		    ;;
+	    esac
+	    ;;
+    esac
+
+    return ret
+}
+
+__rbnotes_commands() {
+    local -a _cmds
+    _cmds=( $(rbnotes commands -d) )
+    _describe -t commands Commands _cmds
+}
+
+__rbnotes_list_keywords() {
+    local -a _kw _this_month _this_year
+    _this_month=$(date "+%Y%m")
+    _last_month=$(date -v-1m "+%Y%m")
+    _this_year=$(date "+%Y")
+    _kw=(
+	{to,today}':Today'
+	{ye,yesterday}':Yesterday'
+	{tw,this_week}':This week'
+	{lw,last_week}':Last week'
+	"${_this_month}:This month"
+	"${_last_month}:Last month"
+	"${_this_year}:This year"
+	)
+    _describe -t keywords Keywords _kw
+}
+
+_rbnotes "$@"
+
+# Local Variables:
+# mode: shell-script
+# End:

data/exe/rbnotes

@@ -48,14 +48,24 @@ app = App.new
 begin
   app.parse_global_options(ARGV)
   app.run(ARGV)
-rescue Errno::EPIPE => e
+rescue Errno::EPIPE => _
   # 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 NoArgumentError => _
+  # Fix issue #80: Typically, this error raises when a command tries
+  # to read the standard input for its arguments and gets nil.  It
+  # means user wants to cancel to execute.  So, just ignore the error
+  # and exit.
+  exit 0
 rescue MissingArgumentError, MissingTimestampError,
        NoEditorError, ProgramAbortError,
        Textrepo::InvalidTimestampStringError,
+       InvalidTimestampPatternError,
+       InvalidTimestampPatternAsDateError,
+       NoConfFileError,
+       NoTemplateFileError,
        ArgumentError,
        Errno::EACCES => e
   puts e.message

data/lib/rbnotes.rb

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

data/lib/rbnotes/commands.rb

@@ -58,13 +58,15 @@ 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} import [-m|--use-mtime] FILE
   #{Rbnotes::NAME} list [STAMP_PATTERN|KEYWORD]
   #{Rbnotes::NAME} search PATTERN [STAMP_PATTERN]
-  #{Rbnotes::NAME} show [TIMESTAMP]
-  #{Rbnotes::NAME} update [TIMESTAMP]
+  #{Rbnotes::NAME} show [TIMESTAMP...]
+  #{Rbnotes::NAME} statistics ([-y]|[-m])
+  #{Rbnotes::NAME} update [-k] [TIMESTAMP]
 
 Further help for each command:
   #{Rbnotes::NAME} help commands

data/lib/rbnotes/commands/add.rb

@@ -42,6 +42,9 @@ module Rbnotes::Commands
           raise ArgumentError, "missing timestamp: %s" % args.unshift(arg) if stamp_str.nil?
           stamp_str = complement_timestamp_pattern(stamp_str)
           @opts[:timestamp] = Textrepo::Timestamp.parse_s(stamp_str)
+        when "-f", "--template-file"
+          template_path = args.shift
+          @opts[:template] = template_path
         else
           args.unshift(arg)
           break
@@ -54,7 +57,8 @@ module Rbnotes::Commands
       editor = Rbnotes.utils.find_program(candidates)
       raise Rbnotes::NoEditorError, candidates if editor.nil?
 
-      tmpfile = Rbnotes.utils.run_with_tmpfile(editor, stamp.to_s)
+      template = read_template(conf)
+      tmpfile = Rbnotes.utils.run_with_tmpfile(editor, stamp.to_s, template)
 
       unless FileTest.exist?(tmpfile)
         puts "Cancel adding, since nothing to store"
@@ -127,5 +131,26 @@ HELP
       end
       stamp_str
     end
+
+    def read_template(conf)
+      template = nil
+      template_path = @opts[:template] || conf[:template]
+
+      if template_path
+        raise Rbnotes::NoTemplateFileError, template_path unless FileTest.exist?(template_path)
+        template = File.readlines(template_path, chomp: true)
+      else
+        template_path = default_template_file(conf)
+        template = File.readlines(template_path, chomp: true) if FileTest.exist?(template_path)
+      end
+
+      template
+    end
+
+    def default_template_file(conf)
+      dir = File.join(conf[:config_home], "templates")
+      File.expand_path("default.md", dir)
+    end
+
   end
 end

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