nvim 1.4.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ee36b4c5053b9d05ab3a47d66b5b248aeacc3ffd340b282db719200c298a3fe1
-  data.tar.gz: aa714f06cd14114dfc406afbec1e38ce452ff3cdb935c0f2dfeecba6762c1ec3
+  metadata.gz: b2f33b262cf70f6226c1af40d6b6173c56f5d808e7e4ba6629caa342f3131944
+  data.tar.gz: b78833e0442c2ba8e6a74786576bb4dcfecf5ecebf005bd45dd1c9b4a49732f5
 SHA512:
-  metadata.gz: 7867c1fc7051d1776058d412e71c56f4127d06176fa3b9f0ce744ab2171e738626eb47916dc186551799be637d7eca565a48ed24b19014400818c805548be7d9
-  data.tar.gz: 8913f88061341f6282c05f041e8ac734bb664a775a711e00e1080af97d674a3b38e8988265fdb7d1ab38393615b48b08abd690cf1c8fbd6fa3d703f6d97c876a
+  metadata.gz: 49a0ba665e6d93a4f629b1b0375c29237d90cbb2510bb99d4ff3e4533f7e5cab68c76ee841cc7b25a5117411f5fb5e2ab24d3763f9cf4fa9617b9bef4d693cab
+  data.tar.gz: 1dafb13f71a994566f383577de178766fa6e0dc05a36075dc2af53c77cf3c5a0c8b21ac8dc08835fcbe89824441b857a193cfa8a503537f8ad642775276b8f6b

data/INFO.yaml

@@ -3,7 +3,7 @@
 #
 
 nvim:
-  version: 1.4.0
+  version: 1.5.1
   license: BSD-2-Clause+
   authors:
     - Bertram Scharpf

data/LICENSE

@@ -36,8 +36,8 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ## Use of the German Language
 
 Beim Gebrauch deutscher Sprache sind Weiterentwicklungen und
--verbreitungen nur gestattet unter Einhaltung folgender
-zusätzlicher Bedingungen:
+-verbreitungen nur gestattet unter Einhaltung sowie abermaligen
+Einforderns folgender zusätzlicher Bedingungen:
 
   * Keine Verwendung von sogenannter „geschlechtergerechter Sprache“,
     also Anfügen von weiblichen Endungen mit Binnen-I, Sternchen,

data/README.md

@@ -15,7 +15,7 @@ sudo gem uninstall neovim || true
 sudo gem install nvim
 ```
 
-You may prefer to also install the dependencies. Yet, this is not
+You may prefer to also install the dependencies.  Yet, this is not
 neccessary, as they are small and Ruby-Nvim includes a copy of them.
 
 ```shell
@@ -91,7 +91,7 @@ set number
 :1,6ruby |
 ```
 
-The last value, if it is not `nil`,  will be added through `#inspect` as
+The last value, if it is not `nil`, will be added through `#inspect` as
 a comment.
 
 ```
@@ -132,7 +132,44 @@ This results in:
 :
 ```
 
-The anonymous variable `_` hold this last result.
+To inhibit the output of the last value, add a minus (`-`) to the
+`:ruby|` call.
+
+```
+pp Regexp.constants
+~
+~
+:.ruby |-
+```
+
+In this case, you may even omit the pipe (`|`) character.
+
+
+#### Last return value
+
+The anonymous variable `_` will hold the result
+of the last evaluation.
+
+```
+ 1 7*11*13
+~
+~
+:%ruby |
+```
+
+Then this will work:
+
+```
+ 1 7*11*13
+ 2 #=> 1001
+ 3 _ - 1
+~
+~
+:3ruby |
+```
+
+
+#### Standard output
 
 Output will be added to the buffer, too.
 
@@ -142,9 +179,63 @@ Output will be added to the buffer, too.
  3 puts "o"
 ~
 ~
+:1,3ruby |
+```
+
+Error output will be displayed on the command line,
+highlighted by `ErrorMsg`.
+
+```
+ 1 $stderr.puts "Oh, no!"
+~
+~
+:%ruby |
+```
+
+This even applies to subprocesses. They won't mess up
+the RPC communication.
+
+```
+ 1 system *%w(ls -l)
+ 2 system *%w(ls nonexistent)
+~
+~
 :%ruby |
 ```
 
+Yet, you should avoid to use `fork` and `exec`, except when
+you're absolutely sure what you're doing.
+
+
+### List all API functions
+
+To show a list of the API functions call something like this:
+
+```
+pp $vim.functions.sort
+pp $vim.obj_classes.map { |c| [ c.type, ($vim.obj_functions c).sort] }.to_h
+~
+~
+:%ruby |-
+```
+
+Deprecated functions and old functions not starting with `nvim_` will be
+hidden. The full list of API functions can be obtained by a call to
+`get_api_info`.
+
+```
+pp $vim.get_api_info
+~
+~
+:.ruby |-
+```
+
+See the script `examples/dump_api` for a more elaborated and colorized
+output.
+
+
+### Calculator
+
 Further, a simple number/cash summing tool is included.
 
 ```
@@ -253,7 +344,7 @@ or ask the running Neovim for its server name.
 echo v:servername
 ```
 
-Then connect to it. This requires the [Intar](https://github.com/BertramScharpf/ruby-intar) gem.
+Then connect to it.  This requires the [Intar](https://github.com/BertramScharpf/ruby-intar) gem.
 
 ```
 $ intar -r neovim/remote
@@ -276,7 +367,7 @@ Put text into an X selection or a TMux register.
 ```vim
 let g:ruby_require = "neovim/tools/copy"
 '<,'>ruby xsel $lines
-'<,'>ruby xsel! $ines
+'<,'>ruby xsel! $lines
 '<,'>ruby tmuxbuf $lines
 ```
 

data/examples/demo.rb

@@ -0,0 +1,35 @@
+#
+#  demo.rb  --  Demo plugin
+#
+
+
+Neovim.plugin do |dsl|
+
+  dsl.command :SetLine, nargs: 1 do |client,(str)|
+    client.set_current_line str
+  end
+
+  dsl.command :Fail, nargs: 0 do |client|
+    raise "ouch!"
+  end
+
+  dsl.function :Sum, nargs: 2, sync: true do |client,x,y|
+    x + y
+  end
+
+  dsl.function :Fail do |client|
+    raise "ouch!"
+  end
+
+  dsl.function :Other, nargs: 2, range: true, eval: "strftime('%s')" do |client,(x,y),range,evaled|
+    r = "<<<#{x}---#{y}===#{range}---#{evaled}>>>"
+    client.buf_set_lines 0, 0, 0, false, [r.inspect]
+    r
+  end
+
+  dsl.autocmd :BufEnter, pattern: "*.rb" do |client|
+    client.command "echom 'Hello, Ruby!'"
+  end
+
+end
+

data/examples/demo_attach

@@ -0,0 +1,38 @@
+#!/usr/bin/env ruby
+
+#
+#  demo_attach  --  Start a Neovim session and attach to it
+#
+
+require "neovim/remote"
+
+
+module Neovim
+
+  SOCKET = "/tmp/nvim-#$$.sock"
+
+  system *%W(tmux split-window -dv nvim --listen #{SOCKET})
+
+  Remote.start_client ConnectionUnix, SOCKET, timeout: 1 do |c|
+    c.command "e /etc/passwd"
+    c.command "/home"
+    b = c.get_current_buf
+    puts b.inspect
+    puts
+    sleep 1
+    puts b[1]
+    w = c.get_current_win
+    puts w.index
+    puts b[w.line]
+    c.command "bw"
+    sleep 1
+    e = c.evaluate "3*9"
+    puts e.inspect
+    sleep 1
+    c.command "q"
+  rescue Remote::Disconnected
+    puts "done."
+  end
+
+end
+

data/examples/demo_intar

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+#
+#  demo_intar  --  Start a Neovim session, attach to it and control it from an interactive Ruby
+#
+
+require "neovim/remote"
+require "intar"
+
+
+module Neovim
+
+  SOCKET = "/tmp/nvim-#$$.sock"
+
+  system *%W(tmux split-window -dv nvim --listen #{SOCKET})
+
+  Remote.start_client ConnectionUnix, SOCKET, timeout: 1 do |c|
+    c.command "set cuc cul"
+    c.set_option buftype: "nofile"
+    c.set_option :nu
+    b = c.get_current_buf
+    w = c.get_current_win
+    b[] = ["A".."Z", "a".."z", "0".."9"].map { |r| r.to_a }.flatten.map { |x| x*4 }
+    c.message "Hello from interactive Ruby!"
+    Intar.open do |i|
+      i.set_var :c, c
+      i.set_var :b, b
+      i.set_var :w, w
+      puts <<~'EOT'
+        # Example calls:
+          c.set_option_value "nu", false, {}
+          w.set_option :nu, :rnu
+          puts w.index
+          puts b[w.line]
+          b[w.line] += ["----"]
+          b.map! w.line do |x| x << "!" end
+          c.call_function "setreg", ["a", "hello\nbye", "l"]
+      EOT
+      i.run
+    end
+    c.command "qa!"
+  rescue Remote::Disconnected
+    puts "done."
+  end
+
+end
+

data/examples/demo_remote.rb

@@ -0,0 +1,36 @@
+#!/usr/bin/env ruby
+
+#
+#  demo_remote.rb  --  Demo for plain handlers
+#
+
+require "neovim"
+
+
+if $stdin.tty? then
+  puts <<~EOT
+    " How to run this from inside Neovim:
+    let chan = jobstart(['ruby','#$0'], { 'rpc': v:true })
+    call rpcrequest(chan, 'rb_add', 7)
+    call rpcrequest(chan, 'rb_raise')
+    call jobstop(chan)
+  EOT
+  exit 1
+end
+
+
+counter = 0
+
+Neovim.start_remote do |dsl|
+
+  dsl.register_handler "rb_add" do |client,n|
+    counter += n
+    client.command "echo 'Counter value now is: '..#{counter}..'.'"
+  end
+
+  dsl.register_handler "rb_raise" do |client|
+    raise "Ouch!"
+  end
+
+end
+

data/examples/demo_remote_inside_block.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+#
+#  examples/demo_remote_inside_block.rb  --  Demo for plain handlers
+#
+
+require "neovim"
+
+
+if $stdin.tty? then
+  puts <<~EOT
+    " How to run this from inside Neovim:
+    let chan = jobstart(['ruby','#$0', 'counter.log', 100], { 'rpc': v:true })
+    echo rpcrequest(chan, 'rb_add', 7)
+    echo jobstop(chan)
+  EOT
+  exit 1
+end
+
+
+logname, counter = *$*
+logname ||= "counter.log"
+counter = counter.to_i
+
+File.open logname, "w" do |log|
+
+  log.puts "I was called with: #{$*.inspect}"
+  log.flush
+
+  Neovim.start_remote do |dsl|
+
+    dsl.register_handler "rb_add" do |client,n|
+      counter += n
+      client.command "echo 'Counter value now is: '..#{counter}..'.'"
+      log.puts "Counter: #{counter}"
+      log.flush
+      nil
+    end
+
+  end
+
+ensure
+  log.puts "Bye from counter at #{counter}."
+  log.flush
+
+end
+

data/examples/demo_sub

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+
+#
+#  demo_sub  --  Descend to a Neovim session with some text
+#
+
+require "neovim/host"
+
+
+data = <<~EOT
+  Name:     John Doe
+  Mail:     jdoe@example.com
+  Password: verysecret
+EOT
+
+Neovim::Remote.run_sub do |dsl|
+  dsl.setup do |client|
+    d = data.split "\n"
+    client.put d, "l", false, false
+    client.command "autocmd BufUnload <buffer=%d> call rpcrequest(%d,'rb_yield_data',getline(1,'$'))" %
+                            [ client.get_current_buf.number, client.channel_id]
+  end
+  dsl.register_handler "rb_yield_data" do |client,l|
+    data = l.join "\n"
+  end
+end
+
+puts $?.inspect
+puts "data =", data
+

data/examples/dump_api

@@ -0,0 +1,99 @@
+#!/usr/bin/env ruby
+
+#
+#  dump_api  --  Dump NeoVim's API
+#
+
+usage = <<~EOT
+  #$0    | nvim - +'set ft=yaml' '+$'    # dump as YAML
+  #$0 -a | nvim - +'set ft=yaml' '+$'    # dump by "--api-info" option
+  #$0 -j | nvim - +'set ft=json' '+$'    # dump as JSON
+
+  Or just source it from Neovim:
+
+    :let g:ruby_api_info="yaml"
+    :rubyfile #$0
+
+EOT
+
+
+if $vim then  # We're getting called from inside a Neovim.
+
+  a = $vim.get_api_info
+  t = ($vim.get_var "ruby_api_info") rescue "yaml"
+  a = case t
+  when "yaml" then require "yaml" ; a.to_yaml
+  when "json" then require "json" ; JSON.pretty_generate a
+  end
+  a = a.split $/
+  $vim.command "vnew"
+  $vim.set_options ft: t, buftype: "nofile"
+  $vim.put a, "l", false, false
+
+
+else
+
+  $:.unshift "../lib"
+  require "neovim/remote"
+
+
+  include Neovim
+
+
+  class DumpApi
+
+    def get json: nil, alt: nil
+      if json then
+        as_json
+      else
+        if alt then
+          alternative_yaml
+        else
+          as_yaml
+        end
+      end
+    end
+
+    private
+
+    def api_info
+      Remote.open ConnectionChild, "-u", "NONE", "-n" do |s|
+        ch, ai = s.request :nvim_get_api_info
+        ai
+      end
+    end
+
+    def as_json
+      require "json"
+      JSON.pretty_generate api_info
+    end
+
+    def as_yaml
+      require "yaml"
+      api_info.to_yaml
+    end
+
+    def alternative_yaml
+      require "neovim/foreign/mplight"
+      require "yaml"
+      t = MPLight::Types.new
+      t.extend MPLight::Unpacker
+      IO.popen %w(nvim --api-info) do |r|
+        t.init_input r
+        return t.get.to_yaml
+      end
+    end
+
+  end
+
+
+  if $*.delete '-h' then
+    puts usage
+    exit
+  end
+
+  output = DumpApi.new.get json: ($*.delete '-j'), alt: ($*.delete '-a')
+  puts output
+
+end
+

data/examples/passwords

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+#
+#  examples/passwords  --  Manage a file containing your passwords
+#
+
+# (C) 2025 Bertram Scharpf <software@bertram-scharpf.de>
+
+require "neovim/host"
+
+
+class Passwords
+
+  PW_FILE = File.expand_path "~/.config/mypasswords.asc"
+  RECIPIENT = "jdoe@example.com"
+
+  def initialize debug: false
+    @debug = debug
+  end
+
+  def run
+    contents = get_contents.split $/
+    Neovim::Remote.run_sub do |pw_dsl|
+      pw_dsl.setup do |client|
+        client.set_option shadafile: "NONE"
+        client.set_option filetype: "dosini"
+        client.put contents, "l", true, false
+        client.command "1"
+        client.get_current_line.empty? and client.del_current_line
+        {
+          "Save" => "rb_save",
+          "Totp" => "rb_totp",
+        }.each { |cmd,fn|
+          client.command "command -buffer -nargs=0 %s call rpcrequest(%d,'%s')" % [ cmd, client.channel_id, fn]
+        }
+      end
+      pw_dsl.register_handler "rb_save" do |client|
+        File.rename PW_FILE, "#{PW_FILE}.bak" rescue nil
+        IO.popen %W(gpg -a -r #{RECIPIENT} --encrypt -o #{PW_FILE}), "w" do |gpg|
+          gpg.puts client.get_current_buf[1..]
+        end
+        File.chmod 0600, PW_FILE
+      end
+      pw_dsl.register_handler "rb_totp" do |client|
+        require "potp"
+        require "neovim/tools/copy"
+        p = client.call_function "expand", [ "<cword>"]
+        key = (POTP::TOTP.new p).now if p.notempty? and p.length % 4 == 0
+        client.echo [ [ key]], true, {}
+        xsel key
+      rescue
+        client.err_writeln "No OTP under cursor?"
+      rescue ScriptError
+        client.err_writeln $!.message
+      end
+    end
+  end
+
+  def get_contents
+    r = IO.popen %W(gpg -d #{PW_FILE}), "r" do |gpg| gpg.read end
+    r.notempty? or <<~EOT
+      # Move the cursor to the OTP keyword and give the command `:Totp`.
+      # The TOTP key will be displayed and further copied to the clipboard.
+
+      [account "dummy"]
+      name     = John Doe
+      password = very$ecret
+      optauth  = GYS5L3N3E4AAYNMN562LW76TMWHQBJ4A
+
+      # As soon as you have set the `RECIPIENT` constant in the executable,
+      # you may save this file calling the command `:Save`.
+    EOT
+  end
+
+  new.run
+
+end
+

data/lib/neovim/client.rb

@@ -25,7 +25,7 @@ module Neovim
     def initialize comm, channel_id
       @comm, @channel_id = comm, channel_id
       @functions = {}
-      @objfuncs  = Hash.new do |h,k| h[k] = {} end
+      @objfuncs  = {}
     end
 
     def inspect
@@ -36,10 +36,16 @@ module Neovim
       list.each { |fn|
         next if fn[ "deprecated_since"] && self.class.strict
         n = fn[ "name"]
-        next unless n =~ /\Anvim_/
-        @functions[ $'.to_sym] = n
-        t, = prefixes.find { |t,p| n =~ p }
-        @objfuncs[ t][ $'.to_sym] = n if t
+        if (b = n.starts_with? "nvim_") then
+          @functions[ n[ b...].to_sym] = n
+        end
+        prefixes.each { |t,p|
+          if (b = n.starts_with? p) then
+            @objfuncs[ t] ||= {}
+            @objfuncs[ t][ n[ b...].to_sym] = n
+            break
+          end
+        }
       }
     end
 
@@ -58,7 +64,6 @@ module Neovim
     end
 
 
-
     def method_missing sym, *args
       call_api sym, *args
     rescue UnknownApiFunction
@@ -78,17 +83,24 @@ module Neovim
       s
     end
 
+    def functions
+      @functions.keys
+    end
+
 
     def has_obj_function? obj, name
       @objfuncs[ obj.type][ name.to_sym].to_bool
     end
 
+    def obj_classes
+      RemoteObject.subclasses.select { |c| @objfuncs[ c.type] rescue nil }
+    end
+
     def obj_functions obj
       @objfuncs[ obj.type].keys
     end
 
 
-
     def message str
       call_api :out_write, str
       str.end_with? $/ or call_api :out_write, $/
@@ -100,6 +112,7 @@ module Neovim
 
     def command arg ; call_api :command, arg ; end
 
+    # Be aware that #eval was a private instance method from module Kernel.
     def evaluate expr ; call_api :eval, expr ; end
 
   end

data/lib/neovim/connection.rb

@@ -40,7 +40,7 @@ module Neovim
       prefixes = {}
       api_info[ "types"].each do |type,info|
         type = type.to_sym
-        prefixes[ type] = /\A#{info[ "prefix"]}/
+        prefixes[ type] = info[ "prefix"]
         register_type type, info[ "id"]
       end
       @client.add_functions api_info[ "functions"], prefixes
@@ -69,10 +69,19 @@ module Neovim
 
   class ConnectionTcp < Connection
     class <<self
-      def open_files host, port
+      def open_files host, port, timeout: nil
+        due = Time.now + timeout if timeout
         require "socket"
-        TCPSocket.open host, port do |socket|
-          yield (new socket, socket)
+        begin
+          TCPSocket.open host, port do |socket|
+            due = nil
+            yield (new socket, socket)
+          end
+        rescue Errno::ECONNREFUSED
+          if due then
+            sleep 0.1
+            retry
+          end
         end
       end
     end
@@ -80,10 +89,19 @@ module Neovim
 
   class ConnectionUnix < Connection
     class <<self
-      def open_files path
+      def open_files path, timeout: nil
+        due = Time.now + timeout if timeout
         require "socket"
-        UNIXSocket.open path do |socket|
-          yield (new socket, socket)
+        begin
+          UNIXSocket.open path do |socket|
+            due = nil
+            yield (new socket, socket)
+          end
+        rescue Errno::ENOENT
+          if due then
+            sleep 0.1
+            retry
+          end
         end
       end
     end

data/lib/neovim/foreign/supplement.rb

@@ -38,6 +38,10 @@ rescue LoadError
         self
       end
     end
+    def starts_with? oth ; o = oth.to_str ; o.length          if start_with? o ; end
+    def ends_with?   oth ; o = oth.to_str ; length - o.length if end_with?   o ; end
+    alias starts_with starts_with?
+    alias ends_with   ends_with?
   end
 end
 

data/lib/neovim/handler.rb

@@ -142,6 +142,10 @@ module Neovim
 
     TYPE = :remote
 
+    def setup &block
+      add_setup_block &block
+    end
+
     def register_handler name, &block
       add_handler nil, name, &block
     end

data/lib/neovim/host.rb

@@ -8,6 +8,32 @@ require "neovim/handler"
 
 module Neovim
 
+  class Remote
+
+    class <<self
+
+      def run_remote *args, **kwargs, &block
+        plugins = { remote: (DslRemote.open &block), }
+        start plugins, *args, **kwargs do |i|
+          i.start
+          i.run
+        end
+      rescue Remote::Disconnected
+      end
+
+      def run_sub socket: nil, timeout: nil, &block
+        socket ||= "/tmp/nvim-sub-#$$.sock"
+        f = fork { exec *%w(nvim --listen), socket }
+        Remote.run_remote ConnectionUnix, socket, timeout: timeout||1, &block
+      ensure
+        Process.waitpid f
+      end
+
+    end
+
+  end
+
+
   class Provider < Remote
 
     class <<self
@@ -21,6 +47,7 @@ module Neovim
       def run plugins
         $stdin.tty? and raise "This program expects to be called by Neovim. It can't run interactively."
         start plugins do |h|
+          log :info, "Starting event loop."
           h.run
           nil
         rescue Remote::Disconnected
@@ -28,8 +55,13 @@ module Neovim
           nil
         rescue SignalException
           n = $!.signm.notempty? || $!.class.to_s
-          log :fatal, "Signal was caught: #{n}"
-          (n =~ /\A(?:SIG)?TERM\z/) ? 0 : 1
+          if n =~ /\A(?:SIG)?TERM\z/ then
+            log :info, "Exiting after terminate signal."
+            nil
+          else
+            log :fatal, "Signal was caught: #{n}"
+            1
+          end
         rescue Exception
           log_exception :fatal
           2
@@ -47,7 +79,6 @@ module Neovim
       @plugins[ :base] = DslPlain.open do |dsl|
         dsl.plain "poll" do
           start
-          @plugins.each_value { |p| p.setup @conn.client }
           "ok"
         end
         dsl.plain "specs", nargs: 1 do |source|

data/lib/neovim/info.rb

@@ -1,10 +1,10 @@
 require "neovim/meta.rb"
 Neovim::INFO = Neovim::Meta.new "nvim",
-  version: "1.4.0",
+  version: "1.5.1",
   license: "BSD-2-Clause+",
   authors: ["Bertram Scharpf"],
   email: "software@bertram-scharpf.de",
   summary: "Yet another Ruby client for Neovim",
   description: "A simple Ruby client for Neovim.\nClean code, minimal dependecies, no frills, no wokeness.",
   homepage: "https://github.com/BertramScharpf/ruby-nvim",
-  commit: "3318cce"
+  commit: "3508371"

data/lib/neovim/logging.rb

@@ -234,8 +234,8 @@ module Neovim
         **kwargs
     end
 
-    def log_exception level
-      Logging.put level, "Exception: #$!",
+    def log_exception level = nil
+      Logging.put level||:error, "Exception: #$!",
         sender: self, caller: (caller 1, 1).first,
         exception: $!.class
       $@.each { |b|

data/lib/neovim/remote.rb

@@ -120,20 +120,20 @@ module Neovim
         end
       end
 
-      def start plugins, *args
+      def start plugins, *args, **kwargs
         open_logfile do
-          log :info, "Starting", args: $*
-          open_conn *args do |conn|
+          log :debug1, "Starting", args: $*
+          open_conn *args, **kwargs do |conn|
             i = new plugins, conn
             yield i
           end
         ensure
-          log :info, "Leaving"
+          log :debug1, "Leaving"
         end
       end
 
-      def start_client *args
-        start nil, *args do |i|
+      def start_client *args, **kwargs
+        start nil, *args, **kwargs do |i|
           yield i.start
         end
       end
@@ -154,7 +154,7 @@ module Neovim
         l.map! { |p| p.type }
         l.uniq!
         name = l.join "-"
-        log :info, "Client Name", name: name
+        log :debug1, "Client Name", name: name
         "ruby-#{name}-host"
       else
         "ruby-client"
@@ -175,6 +175,7 @@ module Neovim
 
     def start
       @conn.start self
+      @plugins.each_value { |p| p.setup @conn.client }
       @conn.client
     end
 
@@ -209,7 +210,7 @@ module Neovim
             if @conn.client or not h.needs_client? then
               p.call
             else
-              log :info, "Deferred handler for", name: message.method_name
+              log :debug1, "Deferred handler for", name: message.method_name
               @deferred ||= []
               @deferred.push p
             end
@@ -265,7 +266,7 @@ module Neovim
       @plugins.each_value do |plugin|
         h = plugin.get_handler name
         if h then
-          log :info, "Found handler", name: name
+          log :debug1, "Found handler", name: name
           return h
         end
       end

data/lib/neovim/remote_object.rb

@@ -131,7 +131,7 @@ module Neovim
     # Functions as described in ":h ruby"
 
     def name   ; call_obj :get_name   ; end
-    def number ; call_obj :get_number ; end
+    def number ; index                ; end
 
     def count  ; call_obj :line_count ; end
     alias length count

data/lib/neovim/ruby_provider.rb

@@ -19,20 +19,19 @@ end
 # The VIM module as documented in ":h ruby".
 module Vim
 
-  class Buffer < ::Neovim::Buffer
-    class <<self
-      def current ; $vim.get_current_buf ; end
-      def count   ; $vim.list_bufs.size  ; end
-      def [] i    ; $vim.list_bufs[ i]   ; end
-    end
+  Buffer = ::Neovim::Buffer
+  class <<Buffer
+    def current ; $vim.get_current_buf ; end
+    def count   ; $vim.list_bufs.size  ; end
+    def [] i    ; $vim.list_bufs[ i]   ; end
   end
 
-  class Window < ::Neovim::Window
-    class <<self
-      def current ; $vim.get_current_win                    ; end
-      def count   ; $vim.get_current_tabpage.list_wins.size ; end
-      def [] i    ; $vim.get_current_tabpage.list_wins[ i]  ; end
-    end
+  Window = ::Neovim::Window
+  class <<Window
+    def current ; $vim.get_current_win                    ; end
+    def count   ; $vim.get_current_tabpage.list_wins.size ; end
+    def [] i    ; $vim.get_current_tabpage.list_wins[ i]  ; end
+    self
   end
 
   class <<self
@@ -163,13 +162,14 @@ module Neovim
     # This is called by the +:ruby+ command.
     dsl.rpc :ruby_execute do |client,code,fst,lst|
       code.rstrip!
-      if !code.notempty? or code == "|" then  # Workaround because Neovim doesn't allow empty code (the ultimate Quine)
+      if code =~ /\A\|?(-)?\z/ then  # | is a workaround because Neovim doesn't allow empty code (the ultimate Quine).
+        no_out = $1
         set_global_client client do
           client.command "#{lst}"
           code = (get_lines client, fst..lst).join $/
           WriteBuf.redirect client do
             r = script_binding.eval code, "ruby_run"
-            unless r.nil? then
+            unless no_out or r.nil? then
               script_binding.local_variable_set :_, r
               puts "#=> #{r.inspect}"
             end

data/lib/neovim/tools/calculator.rb

@@ -16,11 +16,16 @@ module Neovim
       case r
       when BigDecimal then
         r = r.to_s "F"
-        r.sub! /(?:(\.)([0-9]+))?\z/ do
-          (@sep||$1) + ($2.to_s.ljust @decs, "0")
+        if @decs.nonzero? then
+          r.sub! /(\.)(\d+)\z/ do (@sep||$1) + ($2.to_s.ljust @decs, "0") end
+        else
+          r.slice! /\.0+\z/
         end
       when Integer    then
         r = r.to_s
+        if @decs.nonzero? then
+          r << (@sep||".") << "0"*@decs
+        end
       end
       r
     end
@@ -31,11 +36,13 @@ module Neovim
 
     def decs= d ; @decs = Integer d ; end
 
-    def dot!   ; @sep = "." ; end
+    def dot!   ; @sep =  "." ; end
     def dot?   ; @sep == "." ; end
-    def comma! ; @sep = "," ; end
+    def comma! ; @sep =  "," ; end
     def comma? ; @sep == "," ; end
-    def auto!  ; @sep = nil ; end
+    def colon! ; @sep =  ":" ; end
+    def colon? ; @sep == ":" ; end
+    def auto!  ; @sep =  nil ; end
 
     def add line
       line = line.chomp
@@ -43,9 +50,11 @@ module Neovim
       if $& =~ /!(\w+)/ then
         case $1
           when "c", "comma", "k", "komma" then comma!
+          when "l", "colon"               then colon!
           when "d", "dot", "p", "point"   then dot!
           when "a", "auto"                then auto!
-          when /\A\d+\z/                  then @decs = $1.to_i
+          when /\A\d+\z/                  then @decs = $&.to_i
+          when "all", "full", "places"    then @decs = nil
         end
       end
       line.slice! /^.*:/

data/lib/neovim.rb

@@ -19,11 +19,7 @@ module Neovim
   class <<self
 
     def start_remote &block
-      Job.run mk_plugins &block
-    end
-
-    def mk_plugins &block
-      { remote: (DslRemote.open &block) }
+      Job.run remote: (DslRemote.open &block)
     end
 
   end

data/nvim.gemspec

@@ -0,0 +1,31 @@
+#
+#  nvim.gemspec  --  Gem specification
+#
+
+system *%w(rake infofile)
+
+$:.unshift "./lib"
+require "neovim/info"
+
+
+Gem::Specification.new do |spec|
+  Neovim::INFO.mk_gemspec spec
+  spec.required_ruby_version = Gem::Requirement.new ">= 3.1.0"
+
+  spec.files         = Dir[ "lib/**/*.rb"] + Dir[ "bin/*"]
+
+  spec.require_paths = %w(lib)
+  spec.bindir        = "bin"
+  spec.executables   = %w(neovim-ruby-host)
+
+  spec.extra_rdoc_files =  %w(INFO.yaml LICENSE README.md)
+  spec.extra_rdoc_files += %w(Rakefile nvim.gemspec)
+  spec.extra_rdoc_files += Dir[ "examples/*"]
+
+  if false then
+    spec.add_dependency "supplement", "~> 2.18"
+    spec.add_dependency "mplight",    "~> 1.0"
+  end
+
+end
+

metadata

@@ -1,28 +1,46 @@
 --- !ruby/object:Gem::Specification
 name: nvim
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.1
 platform: ruby
 authors:
 - Bertram Scharpf
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-23 00:00:00.000000000 Z
+date: 2025-01-14 00:00:00.000000000 Z
 dependencies: []
-description:
 email: software@bertram-scharpf.de
 executables:
 - neovim-ruby-host
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- INFO.yaml
+- LICENSE
+- README.md
+- Rakefile
+- nvim.gemspec
+- examples/demo.rb
+- examples/demo_attach
+- examples/demo_intar
+- examples/demo_remote.rb
+- examples/demo_remote_inside_block.rb
+- examples/demo_sub
+- examples/dump_api
+- examples/passwords
 files:
 - INFO.yaml
 - LICENSE
 - README.md
 - Rakefile
-- TODO
 - bin/neovim-ruby-host
+- examples/demo.rb
+- examples/demo_attach
+- examples/demo_intar
+- examples/demo_remote.rb
+- examples/demo_remote_inside_block.rb
+- examples/demo_sub
+- examples/dump_api
+- examples/passwords
 - lib/neovim.rb
 - lib/neovim/client.rb
 - lib/neovim/connection.rb
@@ -43,11 +61,11 @@ files:
 - lib/neovim/tools/calculator.rb
 - lib/neovim/tools/copy.rb
 - lib/neovim/vimscript_provider.rb
+- nvim.gemspec
 homepage: https://github.com/BertramScharpf/ruby-nvim
 licenses:
 - BSD-2-Clause+
 metadata: {}
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -55,15 +73,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: Yet another Ruby client for Neovim
 test_files: []

data/TODO

@@ -1,2 +0,0 @@
-- system "ls" stürzt ab
-- Logdatei ins Standardverzeichnis