my_help 0.8.6 → 1.1a

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 871927da25328b86ac258c721aa91c4001caefcb8a0e07a170af5ac241561d07
-  data.tar.gz: 1a7639867760309d36cd71a0696dd2bde8ab2d9d78b912984abc88dd72458dc5
+  metadata.gz: db524474830d2c9c8a27e43e6b5360717ee4356ffe55ba70858f1396080561b5
+  data.tar.gz: 3de6dbe0c5b10a7df472dd727a44fceadeae966b2e6b120e5271485a4282f434
 SHA512:
-  metadata.gz: 7a598090a7eaa81d6c355168a6a2e41d5ac816119a2c50813047dd37c169418af1198fac09fb1c739cb7d69066980eb5a7bd0766cd4a64d6982b5cb42712b68d
-  data.tar.gz: 972696bf11ff387fb23f5e954d0b24cf6c1d66b8776f92a0a222dc18103835f2b3108021f73715526ae5f1e468e595b221e6e0126ceea4498824e9a5ffa8cd3b
+  metadata.gz: da47e72884abef31b214e2bde22c787ceed6671d0efdd4c04ee55caf8de49a4184f98e5103add39bbf99ce21fab9426d5fd85da6db74d1f6c6d75521eac9990f
+  data.tar.gz: 6c0ceca9d19715ba61eb1e27cb1b40d132f44792054dead3e6203fe0d0297504f044e4bafc8f49d4826420feafaeb2481048ba6e7013bd974fd0b558c70c6618

data/'../test'/.my_help/.my_help_conf.yml

@@ -0,0 +1,2 @@
+---
+:editor: emacs

data/'../test'/.my_help/emacs.org

@@ -0,0 +1,50 @@
+#+STARTUP: indent nolineimages
+* head
+- Emacs key bind
+- 
+special key command
+-   c-f, While pressing the control key, press 'f'
+-   M-f, After pressing Esc key, press 'f'
+-   c-g, Operation interruption 
+-   c-x u, Undo operation(Undo)
+* license
+-      cc by Natsuko Kawabata, 2017
+
+* move cursor
+- c-f, move Forward,		  Move to forward or right
+- c-b, move Backward,   	  Move to back or left
+- c-a, go Ahead of line, 	  Move to the beginning of the line
+- c-e, go End of line,   	  Move to the end of the line
+- c-n, move Next line,      Move to next line
+- c-p, move Previous line,  Move to previous line
+* move page
+- c-v, move Vertical,          Move to next page
+- M-v, move reversive Vertical,Move to previous page
+- c-l, centerise Line,         Move to center on current line
+- M-<, move Top of file,    	 Move to the top of the file
+- M->, move Bottom of file,    Move to the end of the file
+* file operation file
+- c-x c-f, Find file, Find file
+- c-x c-s, Save file, Save file
+- c-x c-w, Write file NAME, Write a file with another name
+* edit operation
+- c-d, Delete char, Delete a letter
+- c-k, Kill line,   Delete a line，cut
+- c-y, Yank,        Paste
+- c-w, Kill region, Delete an area ，cut
+- 領域選択は，先頭 or 最後尾で c-space した後，最後尾 or 先頭へカーソル移動
+- c-s, forward incremental Search WORD, 前へ WORD を検索
+- c-r, Reverse incremental search WORD, 後へ WORD を検索
+- M-x query-replace WORD1 <ret> WORD2：対話的置換(y or n で可否選択)
+* window operation
+- c-x 2, 2 windows, Split into two windows 二つに分割
+- c-x 1, 1 windows, Integrate in a window
+- c-x 3, 3rd window sep, Split vertically
+- c-x o, Other windows, Move to the next window
+* buffer operation
+- すでに open して Emacs にバッファーされた file
+- c-x b, show Buffer,   Buffer list
+- c-x c-b, next Buffer, Move to next buffer
+* quit operation
+- c-x c-c, Quit Emacs, Save file and quit
+- c-z, suspend Emacs,  Pause，restart with fg

data/.gitignore

@@ -1,10 +1,18 @@
 /tmp
 .DS_Store
 /.bundle/
+/.yardoc
 /_yardoc/
 /coverage/
+/doc/
+/docs/
 /pkg/
+/spec/reports/
+/vendor/
+/tmp/
+/.tags
 *~
 \#*
+.\#*
 
 .ruby-version

data/.my_help/example2.org

@@ -0,0 +1,9 @@
+#+STARTUP: indent nolineimages overview
+* head
+- help_title example
+* license
+-      cc by Shigeto R. Nishitani, 2016-22
+* a_item : item_short_description
+- content_a
+* b_item
+- content_b

data/.rspec

@@ -1,4 +1,3 @@
---require spec_helper
 --format documentation
 --color
-
+--require spec_helper

data/.rspec_status

@@ -0,0 +1,13 @@
+example_id                  | status | run_time        |
+--------------------------- | ------ | --------------- |
+./spec/cli_spec.rb[1:1:1]   | passed | 0.31228 seconds |
+./spec/cli_spec.rb[1:2:1]   | passed | 0.31058 seconds |
+./spec/cli_spec.rb[1:3:1]   | passed | 0.31153 seconds |
+./spec/cli_spec.rb[1:4:1]   | passed | 0.2152 seconds  |
+./spec/cli_spec.rb[1:4:2]   | passed | 0.21003 seconds |
+./spec/cli_spec.rb[1:5:1]   | passed | 0.31109 seconds |
+./spec/cli_spec.rb[1:6:1]   | passed | 0.31433 seconds |
+./spec/cli_spec.rb[1:7:1]   | passed | 0.21002 seconds |
+./spec/cli_spec.rb[1:7:2]   | passed | 0.21031 seconds |
+./spec/cli_spec.rb[1:7:3]   | passed | 0.21089 seconds |
+./spec/my_help_spec.rb[1:1] | passed | 0.00078 seconds |

data/.yardoc/checksums

@@ -1,5 +1,5 @@
 lib/my_help.rb ced6dd68eb7342dc65e8c8506359cb9a18f37fde
-lib/my_help/org2yml.rb 4be5461e87290a6c8fa4ef802df8b64e8c63ca9a
-lib/my_help/version.rb 0c71ad78597c647364908e595140b5fb9af9e6a3
-lib/my_help/my_help_controll.rb fba5c56e7e7c716d4d34b6851a808e959ecdb773
+lib/my_help/org2yml.rb 0246f80ac2e821e5778aff8395dabbd6fbedc1d6
+lib/my_help/version.rb 8107e9718a720a9369e085771ab7c04ecb5bb8dc
+lib/my_help/my_help_controll.rb ccf627da5074e19887d379130df76b0b3db845a2
 lib/my_help/tomo_help_controll.rb da39a3ee5e6b4b0d3255bfef95601890afd80709

data/Gemfile

@@ -1,6 +1,11 @@
-source 'https://rubygems.org'
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in my_help.gemspec
 gemspec
-gem 'ffi', '~> 1.9'
-gem 'aruba', '~> 0.14.12'
-gem 'command_line', '~> 1.1.0'
-gem 'color_echo'
+
+gem "rake", "~> 13.0"
+
+gem "rspec", "~> 3.0"
+gem 'aruba', '~> 2.1.0'

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    my_help (0.8.5)
+    my_help (1.0c)
       colorize
       command_line
       thor
@@ -9,102 +9,75 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (6.0.3.3)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
-    aruba (0.14.14)
-      childprocess (>= 0.6.3, < 4.0.0)
-      contracts (~> 0.9)
-      cucumber (>= 1.3.19)
-      ffi (~> 1.9)
-      rspec-expectations (>= 2.99)
-      thor (>= 0.19, < 2.0)
+    aruba (2.1.0)
+      bundler (>= 1.17, < 3.0)
+      childprocess (>= 2.0, < 5.0)
+      contracts (>= 0.16.0, < 0.18.0)
+      cucumber (>= 4.0, < 9.0)
+      rspec-expectations (~> 3.4)
+      thor (~> 1.0)
     builder (3.2.4)
-    childprocess (3.0.0)
-    color_echo (3.1.1)
+    childprocess (4.1.0)
     colorize (0.8.1)
-    command_line (1.1.0)
-    concurrent-ruby (1.1.7)
-    contracts (0.16.0)
-    cucumber (5.1.2)
+    command_line (2.0.1)
+    contracts (0.16.1)
+    cucumber (8.0.0)
       builder (~> 3.2, >= 3.2.4)
-      cucumber-core (~> 8.0, >= 8.0.1)
-      cucumber-create-meta (~> 2.0, >= 2.0.2)
-      cucumber-cucumber-expressions (~> 10.3, >= 10.3.0)
-      cucumber-gherkin (~> 15.0, >= 15.0.2)
-      cucumber-html-formatter (~> 9.0, >= 9.0.0)
-      cucumber-messages (~> 13.1, >= 13.1.0)
-      cucumber-wire (~> 4.0, >= 4.0.1)
-      diff-lcs (~> 1.4, >= 1.4.4)
-      multi_test (~> 0.1, >= 0.1.2)
-      sys-uname (~> 1.2, >= 1.2.1)
-    cucumber-core (8.0.1)
-      cucumber-gherkin (~> 15.0, >= 15.0.2)
-      cucumber-messages (~> 13.0, >= 13.0.1)
-      cucumber-tag-expressions (~> 2.0, >= 2.0.4)
-    cucumber-create-meta (2.0.2)
-      cucumber-messages (~> 13.0, >= 13.0.1)
-      sys-uname (~> 1.2, >= 1.2.1)
-    cucumber-cucumber-expressions (10.3.0)
-    cucumber-gherkin (15.0.2)
-      cucumber-messages (~> 13.0, >= 13.0.1)
-    cucumber-html-formatter (9.0.0)
-      cucumber-messages (~> 13.0, >= 13.0.1)
-    cucumber-messages (13.1.0)
-      protobuf-cucumber (~> 3.10, >= 3.10.8)
-    cucumber-tag-expressions (2.0.4)
-    cucumber-wire (4.0.1)
-      cucumber-core (~> 8.0, >= 8.0.1)
-      cucumber-cucumber-expressions (~> 10.3, >= 10.3.0)
-      cucumber-messages (~> 13.0, >= 13.0.1)
-    diff-lcs (1.4.4)
-    ffi (1.13.1)
-    i18n (1.8.5)
-      concurrent-ruby (~> 1.0)
-    middleware (0.1.0)
-    minitest (5.14.2)
-    multi_test (0.1.2)
-    protobuf-cucumber (3.10.8)
-      activesupport (>= 3.2)
-      middleware
-      thor
-      thread_safe
-    rake (13.0.1)
-    rspec (3.9.0)
-      rspec-core (~> 3.9.0)
-      rspec-expectations (~> 3.9.0)
-      rspec-mocks (~> 3.9.0)
-    rspec-core (3.9.2)
-      rspec-support (~> 3.9.3)
-    rspec-expectations (3.9.2)
+      cucumber-ci-environment (~> 9.0, >= 9.0.4)
+      cucumber-core (~> 11.0, >= 11.0.0)
+      cucumber-cucumber-expressions (~> 15.1, >= 15.1.1)
+      cucumber-gherkin (~> 23.0, >= 23.0.1)
+      cucumber-html-formatter (~> 19.1, >= 19.1.0)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+      diff-lcs (~> 1.5, >= 1.5.0)
+      mime-types (~> 3.4, >= 3.4.1)
+      multi_test (~> 1.1, >= 1.1.0)
+      sys-uname (~> 1.2, >= 1.2.2)
+    cucumber-ci-environment (9.1.0)
+    cucumber-core (11.0.0)
+      cucumber-gherkin (~> 23.0, >= 23.0.1)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+      cucumber-tag-expressions (~> 4.1, >= 4.1.0)
+    cucumber-cucumber-expressions (15.2.0)
+    cucumber-gherkin (23.0.1)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+    cucumber-html-formatter (19.2.0)
+      cucumber-messages (~> 18.0, >= 18.0.0)
+    cucumber-messages (18.0.0)
+    cucumber-tag-expressions (4.1.0)
+    diff-lcs (1.5.0)
+    ffi (1.15.5)
+    mime-types (3.4.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2022.0105)
+    multi_test (1.1.0)
+    rake (13.0.6)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.0)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-mocks (3.9.1)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.9.0)
-    rspec-support (3.9.3)
-    sys-uname (1.2.1)
-      ffi (>= 1.0.0)
-    thor (1.0.1)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
-    zeitwerk (2.4.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.0)
+    sys-uname (1.2.2)
+      ffi (~> 1.1)
+    thor (1.2.1)
 
 PLATFORMS
-  ruby
+  arm64-darwin-20
+  x86_64-linux
 
 DEPENDENCIES
-  aruba (~> 0.14.12)
-  color_echo
-  command_line (~> 1.1.0)
-  ffi (~> 1.9)
+  aruba (~> 2.1.0)
   my_help!
-  rake
-  rspec
+  rake (~> 13.0)
+  rspec (~> 3.0)
 
 BUNDLED WITH
-   2.1.4
+   2.3.23

data/README.org

@@ -1,4 +1,4 @@
-#+TITLE:  my_help README
+# my_help
 #+AUTHOR:  Shigeto R. Nishitani
 #+EMAIL:     (concat "nishitani@kwansei.ac.jp")
 #+LANGUAGE:  jp
@@ -21,8 +21,10 @@ CUI(CLA)ヘルプのUsage出力を真似て，user独自のhelpを作成・提
   :END:
 
 CUIやshell, 何かのプログラミング言語などを習得しようとする初心者は，
-commandや文法を覚えるのに苦労します．少しのkey(とっかかり)があると
-思い出すんですが，うろ覚えでは間違えて路頭に迷います．問題点は， 
+commandや文法を覚えるのに苦労します．
+少しのkey(とっかかり)があると思い出すんですが，
+うろ覚えでは間違えて路頭に迷います．
+問題点は， 
 + manは基本的に英語 
 + manualでは重たい 
 + いつもおなじことをwebで検索して 
@@ -35,7 +37,7 @@ commandや文法を覚えるのに苦労します．少しのkey(とっかかり
   :CUSTOM_ID: 特徴
   :END:
 
-これらをCLA環境として提供しようというのが，このgemの目的です．
+これらをCLAとして提供しようというのが，このgemの目的です．
 仕様としては， 
 - userが自分にあったmanを作成 
 - 雛形を提供 
@@ -48,6 +50,7 @@ key(記憶のとっかかり)を提供することが目的です．
 RPGでレベル上げとかアイテムを貯めるようにして，
 プログラミングでスキルを発展させてください．
 
+VSCodeやGithub Copilotではcodeの候補を挙げてくれますが，
 物覚えの悪い作者は，人の名前をitem分けして，こそっと使っています．
 
 * 使用法
@@ -56,7 +59,7 @@ RPGでレベル上げとかアイテムを貯めるようにして，
   :END:
 ** インストール
 
-: $ gem install my_help
+: > gem install my_help
 です．
 
 ** 簡単な使用法
@@ -65,8 +68,8 @@ RPGでレベル上げとかアイテムを貯めるようにして，
    :END:
 
 まずは，
-#+begin_example
-my_help                                                                          1559ms
+#+begin_src bash
+> my_help
 Commands:
   my_help delete HELP             # delete HELP
   my_help edit HELP               # edit HELP
@@ -76,17 +79,18 @@ Commands:
   my_help set_editor EDITOR_NAME  # set editor to EDITOR_NAME
   my_help setup                   # set up the test database
   my_help version                 # show version
-#+end_example
+#+end_src
 としてください．このlistにNAMEやITEMを加えて行くとわかると思います．
 
-: my_help list
-: my_help list emacs
-: my_help list emacs -f
-: my_help list emacs file
+#+begin_src bash
+> my_help list
+> my_help list emacs
+> my_help list emacs -f
+> my_help list emacs file
+#+end_src
 として動かしてみてください．
 
-
-#+BEGIN_EXAMPLE
+#+begin_src bash
 - emacsのキーバインド
 - 
 特殊キー操作
@@ -107,49 +111,33 @@ Commands:
      , query_replace  : query_replace
    -r, ruby-mode      : ruby-mode
    -d, dired          : ファイラとして使う
-#+END_EXAMPLE
+#+end_src
+
+** my_helpがやっていること
+my_helpの個々のヘルプファイルは'~/.my_help'に置かれています．
+ヘルプファイルのフォーマットはEmacsのorg-modeです．
+これをEditorで叩いて編集したり，
+そこから情報を取り出したりしています．
+単にファイル操作を集約しているだけなのですが，
+これが面倒で．．．
+
 
 ** 独自のhelpを作る方法
 独自のhelpを作る方法です．まずは，
 
-: my_help new new_help
+: $ my_help new new_help
 
 で，new_helpというtemplateが用意されます．
-: my_help edit new_help
-で編集してください． emacs org形式で，格納されています．
+: $ my_help edit new_help
+で編集してください． Emacs org形式で，格納されています．
 
-: my_help delete new_help
+: $ my_help delete new_help
 
 すると消されます．
 ** editorの変更
-: my_help set_editor vim
+: $ my_help set_editor vim
 でeditorを変更できます．codeとかは確認していますが，
 それ以外で動いたり，動かなかったりを報告してください．
 
-* test
-
-以下は，開発者メモです．
-testは[[/Users/bob/github/ruby_docs/testing_frameworks/test_unit/README.org]]
-にあるのに従って書いています．
-
-「Rubyベストプラクティス」にあるmustを使ったextension
-を組み込んで，DSLにしている．
-[[https://github.com/practicingruby/rbp/blob/master/testing/test_unit_extensions.rb]]
-
-* rspec <2020-09-30 水>
-shuheiがrspecを組み込んでくれていたはずだが，うまく動いていないみたい．
-: gem install ffi -v "1.12.1"
-でerrorが出る．
-
-#+begin_example
-brew reinstall libffi
-set -gx PKG_CONFIG_PATH "/usr/local/opt/libffi/lib/pkgconfig"
-set -gx CPPFLAGS "-I/usr/local/opt/libffi/include"
-set -gx LDFLAGS "-L/usr/local/opt/libffi/lib"
-gem install ffi
-#+end_example
-で解消．
-: bundle update
-: bundle exec rspec
-で試したが，相対パスでなく絶対パス的な設定がされているようでダメ．
-
+OS Xで'emacs'とした時にGUI版が立ち上がって嫌だという場合は，
+'emacs -nw'として下さい．

data/Rakefile

@@ -1,21 +1,32 @@
-require "bundler/gem_tasks"
-require "rake/testtask"
-require 'yard'
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
+  t.options = '-v'
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/*_test.rb']
 end
 
-task :default => :test
-
-desc "make documents by yard"
+desc 'make documents by yard'
 task :yard do
-  YARD::Rake::YardocTask.new {|t|
-#    t.files=['**/*.md']
-#    t.options=['-t','mathjax']
-#    t.options=['--exclude','lib.rb','--files','**/*.org']
-  }
+  # api_output_dir = 'doc'
+  YARD::Rake::YardocTask.new do |t|
+    # t.options << '-o#{api_output_dir}' # output dir = doc_api
+    # t.files=['**/*.md']
+    t.options += ['--title', 'my_help']
+    # t.options=['--exclude','lib.rb','--files','**/*.org']
+    # see [[https://github.com/lsegal/yard/issues/66]] for the other options
+  end
+end
+
+require 'rubocop/rake_task'
+
+RuboCop::RakeTask.new
 
+#task default: %i[test rubocop]
+task :default do
+  system "rake -T"
 end