tabry 0.2.6 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7733876522770c3037de86e663ddadd59cf1a86b2ddb1bc993934789e5b8d34a
-  data.tar.gz: 383673dc7f2ba427e70808fc08484829db28cd5b2c263b21ed1a4971ee2427be
+  metadata.gz: fb391cd439ebe097e13df65ff4a99f2911abd2d53b9c81e8283b8d5af94282b9
+  data.tar.gz: ed3bc83d0f19fa9efee82a7cc6ec5cbd37fd34f602cb9915b78fbeeb0e0ddea9
 SHA512:
-  metadata.gz: e3f75ff33d1b2d3c9e959debc066a672687b906a64a7b414ed57091878cb4ede0ae815d18c563ea619be7ca148bc51c2a571d9cb4075ff4a10ca0c05e64a97cd
-  data.tar.gz: 29d82a30fe87411c11c97287bd6af5f1fd279bf2f1a1e44890273c7844d6dd5e0f35916bf4756f2c9fbfbc84f9e6a206862f8d73addbae14cce90666b2b16f89
+  metadata.gz: ee6f71b46c334b5c2a50ed46c9d6a2930d9b39d3d9dac42ed158ba5b1f94a3b850d485794169e1794f72d54333813b1f10b6d816a557c36d8830ec126524ff74
+  data.tar.gz: fa871318216d9258fc5a9dcbe62ee9b7a9e52922cde2986a6d493025b721753b0b452b8f58ac5157925bfebcddee009289904c676a53ed6d00e2d6b6f4addf98

data/bin/tabry-generate-bash-complete

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require_relative "../lib/tabry/cli/all_in_one"
 require_relative "../lib/tabry/shells/bash"
@@ -23,9 +24,7 @@ Tabry::CLI::AllInOne.run do
     puts Tabry::Shells::Bash.generate(
       args.command_name,
       args.tabry_json_path,
-      uniq_fn_id: flags.uniq_fn_id,
+      uniq_fn_id: flags.uniq_fn_id
     )
   end
 end
-
-

data/bin/tabry-generate-fish-complete

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require_relative "../lib/tabry/cli/all_in_one"
 require_relative "../lib/tabry/shells/fish"
@@ -23,9 +24,7 @@ Tabry::CLI::AllInOne.run do
     puts Tabry::Shells::Fish.generate(
       args.command_name,
       args.tabry_json_path,
-      uniq_fn_id: flags.uniq_fn_id,
+      uniq_fn_id: flags.uniq_fn_id
     )
   end
 end
-
-

data/lib/tabry/cli/all_in_one.rb

@@ -45,6 +45,11 @@ module Tabry
 
       def self.define_completion_methods(cli_class, config, cmd_name: nil)
         cli_class.module_eval do
+          define_method :completion__json do
+            require "json"
+            # Result is flattened/includes squashed (ConfigList#to_a I think calls flatten), so remove the includes
+            puts config.as_json.except(:arg_includes, :option_includes).to_json
+          end
 
           define_method :completion__bash do
             require_relative "../shells/bash"
@@ -88,18 +93,16 @@ module Tabry
 
         # If we recognize command is going to be a completion command, fast track and
         # run completion now
-        if run_completion
-          if ARGV.first == "completion"
-            fish_mode = ENV.fetch("TABRY_FISH_MODE", false)
-            if fish_mode
-              require_relative "../shells/fish/wrapper"
-              Tabry::Fish::Wrapper.run(ARGV[1], ARGV[2], config: config)
-            else
-              require_relative "../shells/bash/wrapper"
-              Tabry::Bash::Wrapper.run(ARGV[1], ARGV[2], config: config)
-            end
-            exit
+        if run_completion && (ARGV.first == "completion")
+          fish_mode = ENV.fetch("TABRY_FISH_MODE", false)
+          if fish_mode
+            require_relative "../shells/fish/wrapper"
+            Tabry::Fish::Wrapper.run(ARGV[1], ARGV[2], config: config)
+          else
+            require_relative "../shells/bash/wrapper"
+            Tabry::Bash::Wrapper.run(ARGV[1], ARGV[2], config: config)
           end
+          exit
         end
 
         # If we recognize there is a "completion" subcommand, add completion
@@ -111,8 +114,8 @@ module Tabry
         Tabry::CLI::Builder.new(config, cli)
       end
 
-      def self.run(**kwargs, &blk)
-        build(**kwargs, &blk).run(ARGV)
+      def self.run(...)
+        build(...).run(ARGV)
       end
     end
   end

data/lib/tabry/cli/arg_proxy.rb

@@ -44,7 +44,7 @@ module Tabry
       end
 
       def <=>(*args)
-        @args.<=>(*args)
+        @args.send(:<=>, *args)
       end
 
       def method_missing(met)

data/lib/tabry/cli/builder.rb

@@ -3,6 +3,7 @@
 require_relative "../runner"
 require_relative "../util"
 require_relative "internals"
+require_relative "base"
 
 # Responsible for building the CLI object, making a Runner to parse the
 # arguments, and running the proper action method of the CLI object.
@@ -56,6 +57,7 @@ module Tabry
 
       def instantiate_cli(klass, internals)
         return klass unless klass.is_a?(Class)
+        raise "CLI class must inherit from Tabry::CLI::Base" unless klass < Tabry::CLI::Base
 
         state = internals.state
         klass.new(state.flags, state.args, internals.result.named_args, internals)

data/lib/tabry/cli/util.rb

@@ -20,7 +20,7 @@ module Tabry
             Shellwords.escape(arg)
           end
         end
-        cmdline = cmdline % args
+        cmdline %= args
         cmdline = "{ #{cmdline} ;} 2>&1" if merge_stderr
 
         warn cmdline if echo || echo_only

data/lib/tabry/config_builder/top_level_builder.rb

@@ -23,6 +23,7 @@ module Tabry
       def completion
         sub :completion do
           desc "Get tab completion shell config"
+          sub :json, "Get flattened tabry JSON config for command (experimental)"
           sub :bash, "Get tab completion for bash or zsh"
           sub :fish, "Get tab completion for fish"
           arg :cmd_line, "(for internal usage, when used instead of subcommand) full command line for getting completion options"

data/lib/tabry/config_loader.rb

@@ -19,7 +19,7 @@ module Tabry
     end
 
     def load
-      return load_from_file(name) if name =~ /\.json$/i || name =~ /\.ya?ml$/i
+      return load_from_file(name) if name =~ /json$/i || name =~ /\.ya?ml$/i
 
       load_paths.each do |path|
         EXTENSIONS.each do |extension|
@@ -48,7 +48,7 @@ module Tabry
     end
 
     def load_from_file(filename)
-      if filename =~ /\.json$/
+      if filename =~ /json$/
         require "json"
         Tabry::Models::Config.new(raw: JSON.parse(File.read(filename)))
       elsif filename =~ /\.ya?ml$/

data/lib/tabry/models/config_list.rb

@@ -24,6 +24,11 @@ module Tabry
         flatten
       end
 
+      def as_json
+        val = to_a.map { ConfigObject.as_json(_1) }
+        val.empty? ? nil : val
+      end
+
       def flatten
         @flatten ||= unflattened.map(&:flatten).flatten
       end

data/lib/tabry/models/config_object.rb

@@ -73,6 +73,23 @@ module Tabry
         assert_of_class(key, val, [TrueClass, FalseClass])
         val
       end
+
+      def as_json
+        self.class::FIELDS.to_h do |k, _|
+          raw_val = send(k)
+          [k, ConfigObject.as_json(raw_val)]
+        end.compact
+      end
+
+      def self.as_json(val)
+        if [ConfigObject, ConfigList, ConfigStringHash].any? { val.is_a?(_1) }
+          val.as_json
+        elsif val.is_a?(Array)
+          val.map { as_json(_1) }
+        else
+          val
+        end
+      end
     end
   end
 end

data/lib/tabry/models/config_string_hash.rb

@@ -39,6 +39,11 @@ module Tabry
       def keys
         to_h.keys
       end
+
+      def as_json
+        val = to_h.transform_values { ConfigObject.as_json(_1) }
+        val.empty? ? nil : val
+      end
     end
   end
 end

data/lib/tabry/models/include_arg.rb

@@ -11,7 +11,9 @@ module Tabry
       end
 
       def flatten
-        _root.arg_includes[include_name].args.flatten
+        inc = _root.arg_includes[include_name]
+        raise "no include found for #{include_name}" unless inc
+        inc.args.flatten
       end
     end
   end

data/lib/tabry/models/subs_list.rb

@@ -33,7 +33,6 @@ module Tabry
           end
           .compact
       end
-
     end
   end
 end

data/lib/tabry/options_finder.rb

@@ -28,11 +28,45 @@ module Tabry
         current_flag: result.state.current_flag
       }.to_json
 
-      send(:"options_#{state.mode}", token || "")
+      send(
+        { subcommand: :options_subcommand, flagarg: :options_flagarg }[state.mode],
+        token || ""
+      )
     ensure
       ENV["TABRY_AUTOCOMPLETE_STATE"] = before_env
     end
 
+    # Descriptions of what is expected; particularly, argument names and descriptions
+    # returns an array, each can be one of three things:
+    #   symbol :flag or :subcommand
+    #   array [name, description]
+    #   array [:flagarg, flag_description]
+    def summary_descriptions
+      send({
+        subcommand: :summary_descriptions_subcommand,
+        flagarg: :summary_descriptions_flagarg
+      }[state.mode])
+    end
+
+    def summary_descriptions_flagarg
+      result.current_flags_for_flagargs.map do |flag|
+        [:flagarg, flag.description]
+      end.compact
+    end
+
+    def summary_descriptions_subcommand
+      descriptions = []
+      if result.expected_arg
+        descriptions << [
+          result.expected_arg.title || result.expected_arg.name,
+          result.expected_arg.description
+        ]
+      end
+      descriptions << :subcommand if options_subcommand_subs("").any?
+      descriptions << :flag if options_subcommand_flags("").any?
+      descriptions
+    end
+
     private
 
     def state
@@ -59,8 +93,8 @@ module Tabry
     end
 
     def options_flagarg(token)
-      result.sub_stack.map do |sub|
-        sub.flags[state.current_flag]&.options&.options(token, params)
+      result.current_flags_for_flagargs.map do |flag|
+        flag.options&.options(token, params)
       end.compact.flatten.uniq
     end
 
@@ -84,13 +118,7 @@ module Tabry
     end
 
     def options_subcommand_args(token)
-      arg = if current_sub.args.n_passed_in_varargs(state.args.length) > 0
-              current_sub.args.varargs_arg
-            else
-              current_sub.args[state.args.length]
-            end
-
-      arg&.options&.options(token, params) || []
+      result.expected_arg&.options&.options(token, params) || []
     end
   end
 end

data/lib/tabry/replty/builder.rb

@@ -35,7 +35,7 @@ module Tabry
       rescue Errno::ENOENT # rubocop:disable Lint/SuppressedException
       end
 
-      def save_history(file, max_size = 10000)
+      def save_history(file, max_size = 10_000)
         return unless file
 
         history = Readline::HISTORY.each

data/lib/tabry/result.rb

@@ -24,7 +24,8 @@ module Tabry
     def invalid_usage_reason
       waiting_on_flag_arg? ||
         wrong_number_of_args? ||
-        missing_required_flags?
+        missing_required_flags? ||
+        nil
     end
 
     def waiting_on_flag_arg?
@@ -81,7 +82,7 @@ module Tabry
           return "missing required flag #{flag.name}"
         end
       end
-      nil
+      false
     end
 
     def usage(cmd_name = nil)
@@ -110,5 +111,20 @@ module Tabry
         end
       end
     end
+
+    def current_flags_for_flagargs
+      sub_stack.map do |sub|
+        flag = sub.flags[state.current_flag]
+        flag if flag&.arg
+      end.compact
+    end
+
+    def expected_arg
+      if current_sub.args.n_passed_in_varargs(state.args.length) > 0
+        current_sub.args.varargs_arg
+      else
+        current_sub.args[state.args.length]
+      end
+    end
   end
 end

data/lib/tabry/runner.rb

@@ -16,11 +16,16 @@ module Tabry
                   config
                 else
                   ConfigLoader.load(name: config)
+
                 end
     end
 
     def options(args, last = nil, params = {})
-      Tabry::OptionsFinder.options(parse(args), last, params)
+      options_finder(args, params).options(last)
+    end
+
+    def options_finder(args, params = {})
+      Tabry::OptionsFinder.new(parse(args), params)
     end
 
     def parse(args)

data/lib/tabry/shells/bash.rb

@@ -45,8 +45,8 @@ module Tabry
         File.expand_path("#{__dir__}/../../../")
       end
 
-      def self.esc(s)
-        Shellwords.escape(s)
+      def self.esc(str)
+        Shellwords.escape(str)
       end
 
       def self.generate_internal(cmd_name:, import_path:, tabry_bash_executable:, tabry_bash_arg:, uniq_fn_id: nil)

data/lib/tabry/shells/fish/wrapper.rb

@@ -14,7 +14,7 @@ module Tabry
 
       def self.run(cmd_line, comp_point, config: nil)
         cmd_name, args, last_arg = Tabry::ShellTokenizer.split_with_comppoint(cmd_line, comp_point)
-        opts = Tabry::Runner.new(config: config || cmd_name).options(args, last_arg, {descriptions: true})
+        opts = Tabry::Runner.new(config: config || cmd_name).options(args, last_arg, { descriptions: true })
 
         if Tabry::Util.debug?
           $stderr.puts
@@ -38,12 +38,10 @@ module Tabry
       def self.format_description(description)
         if description.nil?
           ""
+        elsif description.length > DESCRIPTION_MAX_LENGTH
+          "#{description[0..(DESCRIPTION_MAX_LENGTH - 3)]}..."
         else
-          if description.length > DESCRIPTION_MAX_LENGTH
-            "#{description[0..(DESCRIPTION_MAX_LENGTH - 3)]}..."
-          else
-            description
-          end
+          description
         end
       end
     end

data/lib/tabry/shells/fish.rb

@@ -33,7 +33,7 @@ module Tabry
           cmd_name: cmd_name,
           import_path: "",
           tabry_fish_executable: File.expand_path($0),
-          tabry_fish_arg: "completion",
+          tabry_fish_arg: "completion"
         )
       end
 
@@ -41,8 +41,8 @@ module Tabry
         File.expand_path("#{__dir__}/../../../")
       end
 
-      def self.esc(s)
-        Shellwords.escape(s)
+      def self.esc(str)
+        Shellwords.escape(str)
       end
 
       def self.add_uniq_id(str, pattern, uniq_id)
@@ -65,7 +65,7 @@ module Tabry
 
         script.gsub! "# TABRY_IMPORT_PATH_REPLACE (DO NOT REMOVE)", "set TABRY_IMPORTS_PATH #{esc import_path}"
         script.gsub! "# TABRY_EXECUTABLE_REPLACE (DO NOT REMOVE)", "set TABRY_EXECUTABLE #{esc tabry_fish_executable}"
-        if !tabry_fish_arg.nil?
+        unless tabry_fish_arg.nil?
           script.gsub! "# TABRY_ARG_REPLACE (DO NOT REMOVE)", "set TABRY_ARG #{esc tabry_fish_arg}"
         end
 

data/lib/tabry/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Tabry
-  VERSION = "0.2.6"
+  VERSION = "0.3.0"
 end

data/spec/fixtures/vehicles.tabry

@@ -8,7 +8,7 @@ desc "Build and control vehicles"
 flag verbose,v "Give more details in output"
 
 sub build {
-  varargs vehicle-types @vehicle-type-arg
+  varargs vehicle-types @vehicle-type
 }
 
 sub list-vehicles

data/spec/fixtures/vehicles.yaml

@@ -12,7 +12,7 @@ main:
         - name: vehicle-types
           options:
             - type: include
-              value: vehicle-type-arg
+              value: vehicle-type
           varargs: true
     - name: list-vehicles
     - name: move

data/spec/tabry/cli/all_in_one_spec.rb

@@ -76,6 +76,13 @@ describe Tabry::CLI::AllInOne do
       cli.run(["completion", "bash"])
     end
 
+    it "creates a #completion__json method which generates tabry JSON" do
+      expect_any_instance_of(Kernel).to receive(:puts) do |_, json|
+        expect(JSON.parse(json)).to eq(JSON.parse(cli.runner.config.as_json.to_json))
+      end
+      cli.run(["completion", "json"])
+    end
+
     it "creates a #completion method which generates options" do
       expect(Tabry::Bash::Wrapper).to receive(:run).with("cmd line", "6", config: instance_of(Tabry::Models::Config))
       cli.run(["completion", "cmd line", "6"])

data/spec/tabry/config_builder_spec.rb

@@ -31,7 +31,7 @@ describe Tabry::ConfigBuilder do
     end
   end
 
-  it "defines a 'completion' shortcut with 'completion' and 'completion__bash' subs" do
+  it "defines a 'completion' shortcut with 'completion' and completion__bash, __fish, __json subs" do
     config = described_class.build do
       completion
     end
@@ -52,6 +52,10 @@ describe Tabry::ConfigBuilder do
             }
           ],
           "subs" => [
+            {
+              "description" => "Get flattened tabry JSON config for command (experimental)",
+              "name" => "json"
+            },
             {
               "description" => "Get tab completion for bash or zsh",
               "name" => "bash"

data/spec/tabry/machine_spec.rb

@@ -22,7 +22,7 @@ describe Tabry::Machine do
       pending unless expectation
       result = described_class.run(config, tokens)
       expectation.each do |key, val|
-        key = 'subcommand_stack' if key == 'subs'
+        key = "subcommand_stack" if key == "subs"
         res = result.send(key.to_sym)
         res = res.to_s if res.is_a?(Symbol)
         expect(res).to eq(val)

data/spec/tabry/models/config_spec.rb

@@ -33,6 +33,12 @@ describe Tabry::Models::Config do
     }
   end
 
+  describe "#as_json" do
+    it "returns the config as a hash" do
+      expect(subject.as_json).to eq(config_hash)
+    end
+  end
+
   describe "#dig_sub_array" do
     it "returns the array of subcommands leading up to the specified subcommand" do
       res = subject.dig_sub_array(%w[sub1 sub1.1])

data/spec/tabry/models/dir_option_spec.rb

@@ -8,7 +8,7 @@ describe Tabry::Models::DirOption do
     described_class.new(root: double, raw: { "type" => "dir" })
   end
 
-  # Handled by tabru=bash/tabry-bash.sh/shell, we just return a symbol to
+  # Handled by tabry-bash/tabry-bash.sh/shell, we just return a symbol to
   # communicate to tabry-bash
   it "returns a array with a symbol" do
     expect(subject.options("whatever", {})).to eq([:directory])

data/spec/tabry/models/file_option_spec.rb

@@ -8,7 +8,7 @@ describe Tabry::Models::FileOption do
     described_class.new(root: double, raw: { "type" => "file" })
   end
 
-  # Handled by tabru=bash/tabry-bash.sh/shell, we just return a symbol to
+  # Handled by tabry-bash/tabry-bash.sh/shell, we just return a symbol to
   # communicate to tabry-bash
   it "returns a array with a symbol" do
     expect(subject.options("whatever", {})).to eq([:file])

data/spec/tabry/models/shell_option_spec.rb

@@ -14,6 +14,6 @@ describe Tabry::Models::ShellOption do
     expect(subject.options("", {})).to match_array(%w[a a1 b])
     expect(subject.options("a", {})).to match_array(%w[a a1])
     expect(subject.options("a1", {})).to match_array(%w[a1])
-    expect(subject.options("a1 ", {})).to match_array(%w[])
+    expect(subject.options("a1 ", {})).to be_empty
   end
 end

data/spec/tabry/options_finder_spec.rb

@@ -4,6 +4,7 @@ require_relative "../../lib/tabry/config_loader"
 require_relative "../../lib/tabry/options_finder"
 require_relative "../../lib/tabry/result"
 require_relative "../../lib/tabry/state"
+require_relative "../../lib/tabry/util"
 
 describe Tabry::OptionsFinder do
   let(:config_fixture) { "#{__dir__}/../fixtures/vehicles.yaml" }
@@ -23,6 +24,10 @@ describe Tabry::OptionsFinder do
       %w[car bike],
       subs: %w[move go]
     ],
+    "lists options for varargs" => [
+      %w[car bike],
+      subs: %w[build],
+    ],
     "lists both possible args and subs if a subcommand can take either" => [
       %w[x y z subsub],
       subs: %w[sub-with-sub-or-arg]

data/spec/tabry/replty/builder_spec.rb

@@ -1,6 +1,8 @@
-require_relative '../../../lib/tabry/replty/builder'
-require_relative '../../../lib/tabry/replty/base'
-require_relative '../../../lib/tabry/config_builder'
+# frozen_string_literal: true
+
+require_relative "../../../lib/tabry/replty/builder"
+require_relative "../../../lib/tabry/replty/base"
+require_relative "../../../lib/tabry/config_builder"
 
 module Tabry
   module Specs
@@ -21,8 +23,8 @@ module Tabry
 end
 
 describe Tabry::Replty::Builder do
-  it 'calls the repl method for the subcommand' do
-    conf = Tabry::ConfigBuilder.build do |c|
+  it "calls the repl method for the subcommand" do
+    conf = Tabry::ConfigBuilder.build do |_c|
       sub :foo
       sub :bar do
         arg :waz

data/spec/tabry/runner_spec.rb

@@ -28,7 +28,9 @@ describe Tabry::Runner do
     it "runs OptionsFinder" do
       res = instance_double(Tabry::Result)
       expect(subject).to receive(:parse).with(%w[foo bar]).and_return res
-      expect(Tabry::OptionsFinder).to receive(:options).with(res, "waz", {}).and_return %w[a b c]
+      opts_finder = instance_double(Tabry::OptionsFinder)
+      expect(Tabry::OptionsFinder).to receive(:new).with(res, {}).and_return opts_finder
+      expect(opts_finder).to receive(:options).with("waz").and_return %w[a b c]
       expect(subject.options(%w[foo bar], "waz")).to eq(%w[a b c])
     end
   end

data/spec/tabry/shells/bash_spec.rb

@@ -5,6 +5,7 @@ require_relative "../../../lib/tabry/shells/bash"
 describe Tabry::Shells::Bash do
   describe ".generate_self" do
     before { @backup, $0 = $0, "/bla/waz/abc" }
+
     after { $0 = @backup }
 
     it "tells bash to use the currently running command plus 'completion' to get completion options" do
@@ -19,7 +20,7 @@ describe Tabry::Shells::Bash do
     end
 
     it "defaults cmd_name to the basename of the currently running command" do
-      result = described_class.generate_self(cmd_name: 'wombat')
+      result = described_class.generate_self(cmd_name: "wombat")
       expect(result).to match(
         %r{^ *TABRY_IMPORTS_PATH='' _tabry_WOMBAT_completions_internal /bla/waz/abc completion$}
       )
@@ -27,8 +28,8 @@ describe Tabry::Shells::Bash do
     end
   end
 
-  describe '.generate' do
-    it 'tells bash to use tabry-bash with a import path to get completion options' do
+  describe ".generate" do
+    it "tells bash to use tabry-bash with a import path to get completion options" do
       result = described_class.generate("my-cmd", "/path/to/mycmd.tabry")
       expect(result).to include("TABRY_IMPORTS_PATH=/path/to/mycmd.tabry _tabry_MY_CMD_completions_internal /")
       expect(result).to include("complete -F _tabry_MY_CMD_completions my-cmd\n")

data/tabry.gemspec

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative './lib/tabry/version'
+require_relative "lib/tabry/version"
 
 Gem::Specification.new do |s|
   s.name        = "tabry"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tabry
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.3.0
 platform: ruby
 authors:
 - Evan Battaglia
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-11-30 00:00:00.000000000 Z
+date: 2024-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry-byebug
@@ -265,7 +265,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: Tab completion and CLIs extraordinaire