shelldon 0.0.7 → 0.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4c9b127c3231b3a6616c774fe92a69847b25bb10
-  data.tar.gz: d9a68228b4bcfe2ac70c55123c3b08ce99ca4a41
+  metadata.gz: 0c0b0a7f5f6649588679a69a1173b3fbb8908cc7
+  data.tar.gz: b71f5389f97fd747ed80973fbf14993ffc88cc4d
 SHA512:
-  metadata.gz: 3b2f291dd74ff9ab4e29f2626a3331f93a72da07629f0f3eb6026466b188eff6e4b92af70c3371f41bc0eddc03fd6bc6787768ef8b45270389d95551f51828e3
-  data.tar.gz: 413aa23e7e03186a0d6684c3a74b38226f6d8f7ee05a46dcab1297638122446667efb1ec3c38db8864afefb0bf9e55f638cfb1a3acd1b2be3ed17d71e02e519d
+  metadata.gz: 23f12ce391adccd268f03d11fbcf48496956b9f4428f95cf31591e3456c111edd9c72f3330c724f48e1c253e0c5a4a09b29a45295453797524ae4d821ae119b4
+  data.tar.gz: c22ce281321e342ae0345a051eadd38cb2d0563f3e1bcc240321ec3de3262bbf95bd411bef116f6931586cbb619ab9997bda8f7c8e219c42b0b7092313987e63

data/.rbenv-gemsets

@@ -0,0 +1 @@
+-global

data/README.md

@@ -1,4 +1,6 @@
-# Shelldon
+# <img src="http://www.wesleyboynton.com/wp-content/uploads/2016/04/shelldon.png" width="100"> Shelldon
+
+[![Gem Version](https://badge.fury.io/rb/shelldon.svg)](https://badge.fury.io/rb/shelldon)
 
 Shelldon is an expressive DSL for building interactive terminal applications, or REPLs (Read-Evaluate-Print-Loops).
 
@@ -16,116 +18,89 @@ Or just `gem install shelldon` -- You know the drill.
 
 ## Usage
 
-Here's a simple Shelldon app, available in `test_shell/simple_shell.rb`
+Shelldon is made to be dead-simple to use. Here's a breakdown of the usage!
 
-```ruby
-require 'shelldon'
-require 'pp'
+Start defining a shell like this:
 
-Shelldon.shell do
-  opts do
-    opt '--myopt', '-m', :boolean
-  end
+``` ruby
+Shelldon.shell :example do
+end
+Shelldon.run(:example)
 
-  config do
-    # Set the config file, which can hold values one level higher than their default
-    # The order of precedence for params is: Set in-session > set by command-line flag > set by config file > default
-    config_file '.my-config-file'
+```
 
-    param :myparam do # Create a config option (a 'param')
-      type :boolean   # Make it a boolean
-      default false   # Make its default value false
-      opt 'myopt'     # Override it with the value of command-line opt '--myopt' if present
-    end
-  end
+### Commands
 
-  # Define a command that sets a config option
-  command :set do
-    # Set up some help information for the command
-    help 'Set a configuration option for the remainder of the session.'
-    examples ['set myparam']
-    usage 'set [config_option]'
-
-    # Define the command's action - this has access to some helpers, like 'config'
-    #   You can also give the block access to the remaining (unusued) tokens of the command
-    #   "Unused" meaning tokens that weren't used up to call the command in the first place
-    action do |args|
-      tokens                   = args.split(' ')
-      config[tokens[0].to_sym] = tokens[1]
-    end
+Define a command with a `command` block:
+
+``` ruby
+Shelldon.shell :example do
+  command :test do
+    aliased 'test_command'
+    help "Run a test command to show some text. Optionally, add an arg."
+    usage "test"
+    examples ['test', 'test blah']
+    action { |arg = ''| puts "This is a test! #{arg}" }
   end
+end
+Shelldon.run(:example)
 
+```
 
-  # Here's a simplification of grabbing args for use in an action
-  command :arg do
-    help 'Show your args off!'
-    action { |args| puts args }
-  end
+### Sub-Commands
 
-  # This command will show the active config if called witout args, or
-  #   show the value of a specific option if called with an argument
-  command :config do
-    help 'Show the configuration of the current session.'
-    usage 'config'
-    action do |args|
-      if args.empty?
-        pp config.to_a
-      else
-        param = config.find(args.to_sym)
-        puts "#{param.name}: #{param.val}"
-      end
-    end
+You can nest commands into other commands with the `subcommand` block. This is great for organizing functionality. You can retain the functionality of your higher-level commands, or if you want a higher-level command to act as a placeholder you can just tell Shelldon so!
 
-    # This is a subcommand - it will automatically take precedence
-    #   if you call a command beginning with "config save"
-    subcommand :save do
-      help 'Save your current configuration'
-      usage 'config save'
-      action { config.save }
+For instance, you could run the command `test foobar` like this:
+``` ruby
+  command :test do
+    placeholder
+
+    subcommand :foobar do
+      help "Print out 'Foobar!'"
+      action {puts "Foobar!"}
     end
   end
+```
 
+### Default Command ("No Such Command Found")
+You can use the `command_missing` block to define behaviour when a command isn't explicitly registered. This can be anything from writing "No Such Command" to doing a similarity-search to passing the command to some other resource.
 
-  # This will show all that nice help information we've been defining.
-  #   This produces a two-dimensional array, so you could make it into a table with some
-  #   table-printing gem if you wanted.
-  command :help do
-    action { |args| pp command_list.help(args) }
-    help 'Show help. Optionally specify specific command for more information.'
-    usage 'help [cmd]'
-    examples ['help', 'help quit']
-  end
-
-  # Define a default command - This is what happens when a command doesn't match up
-  command_missing do
-    action { |cmd| puts "No such command \"#{cmd}\"" }
-  end
+``` ruby
+command_missing do
+  action { |cmd| puts "No such command \"#{cmd}\"" }
+end
+```
 
-  # LASTLY, define some basic shell properties. The shell will run at the end of this block.
-  shell do
-    # You can make your prompt a string or a block
-    prompt 'shelldon> '          # This is okay
-    prompt { "shelldon#{4+2}>" } # This is okay too
+### Configuration
+What good is a shell without config? The `config` block will allow you to set up parameters, validate and adjust input, set a configuration yml file, and interact with command-line opts.
 
-    # This is the "home" directory of your shell, used for config files, history files, etc.
-    home '~/.shelldon-test'
+Here's an example that implements the bash 'set -o vi/emacs' functionality in the shell
 
-    # Enable in-session history (enabled by default)
-    history true
+``` ruby
 
-    # Enable history logging and reloading between sessions
-    history_file '.shelldon-history'
+config do
+  config_file '.shelldon_config'
 
-    # Error handling - You can 'accept' an error or 'reject' it.
-    #   The only difference is an accepted error won't kill the shell.
-    #   You can also pass a block to run when that specific command is caught.
-    errors do
-      reject StandardError
-      accept(Interrupt) { puts '^C' }
+  param :'-o' do
+    type :string
+    default 'emacs'
+    # adjust runs before validate, and can 'fix' your input. In this case, allow 'vim' for 'vi'
+    adjust { |s| s.to_s.downcase.strip.gsub('vim', 'vi') }
+    # validate looks for a 'true' result, but in this case we're also using it to take action
+    validate do |s|
+      return false unless s == 'emacs' || s == 'vi'
+      if s == 'emacs'
+        Readline.emacs_editing_mode; true
+      else
+        Readline.vi_editing_mode; true
+      end
     end
   end
 end
 ```
+
+
 ## Contributing
 Bug reports and pull requests are welcome on GitHub at https://github.com/wwboynton/shelldon.
 

data/lib/command/command.rb

@@ -1,3 +1,5 @@
+require 'timeout'
+
 module Shelldon
   class Command
     attr_reader :name, :aliases, :subcommands, :parent, :autocomplete, :times_out

data/lib/command/command_list.rb

@@ -56,7 +56,10 @@ module Shelldon
       else
         cmd = find(str).first
         if cmd.show && !is_default?(cmd)
-          [compile_help(cmd), cmd.sub_to_a]
+          subcommands = cmd.sub_to_a
+          res = [compile_help(cmd).values]
+          res << subcommands unless subcommands.empty?
+          res
         else
           fail Shelldon::NoSuchCommandError
         end

data/lib/config/config.rb

@@ -17,7 +17,7 @@ module Shelldon
     end
 
     def setup
-      load_config_file
+      load_config_file if @config_file_manager
     end
 
     def toggle(key)
@@ -73,7 +73,8 @@ module Shelldon
       hash.each do |k, v|
         key = k.to_sym
         if @config.key?(key)
-          set(key, v) unless @config[key].override || Shelldon.opts.key?(@config[key].opt)
+          set(key, v) unless @config[key].override ||
+              (Shelldon.opts &&Shelldon.opts.key?(@config[key].opt))
         else
           fail(Shelldon::NoSuchParamError)
         end

data/lib/config/config_factory.rb

@@ -9,8 +9,9 @@ module Shelldon
     end
 
     def initialize(shell, &block)
-      @shell = shell
-      @config = Shelldon::Config.new(@shell)
+      @shell        = shell
+      @shell.config ||= Shelldon::Config.new(@shell)
+      @config       = @shell.config
       instance_eval(&block)
       @shell.config = @config
     end

data/lib/config/param.rb

@@ -15,7 +15,8 @@ module Shelldon
     def val
       return @val if @val
       return @override if @override
-      @val = Shelldon.opts.key?(@opt) ? Shelldon.opts[@opt] : @default
+      return @default unless Shelldon.opts
+      @val = Shelldon.opts.has_key?(@opt) ? Shelldon.opts[@opt] : @default
     end
 
     def val=(value)

data/lib/dsl.rb

@@ -12,7 +12,11 @@ module Shelldon
   end
 
   def self.shell(name = (:default), &block)
-    ShellFactory.new(name.to_sym, &block)
+    if shell_factory_index.has_key?(name)
+      shell_factory_index[name].load(&block)
+    else
+      ShellFactory.new(name.to_sym, &block)
+    end
   end
 
   def self.opts=(opts_arr)
@@ -35,4 +39,24 @@ module Shelldon
     sym = sym.to_sym unless sym
     ShellIndex.instance.key?(sym)
   end
+
+  def self.module(name, &block)
+    ModuleFactory.new(name.to_sym, &block)
+  end
+
+  def self.module_index
+    Shelldon::ModuleIndex.instance
+  end
+
+  def self.modules
+    module_index
+  end
+
+  def self.shell_factory_index
+    Shelldon::ShellFactoryIndex.instance
+  end
+
+  def self.run(shell_name = (:default))
+    shell_factory_index[shell_name].run
+  end
 end

data/lib/exceptions/exceptions.rb

@@ -1,5 +1,8 @@
 module Shelldon
   class Error < StandardError
+    def initialize(msg = nil)
+      @msg = msg
+    end
   end
 
   class ConfirmationError < Error
@@ -54,6 +57,22 @@ module Shelldon
     define_method(:message) { 'Cannot add non-shells to the shell index' }
   end
 
+  class NotAShellFactoryError < Error
+    define_method(:message) { 'Cannot add non-shell-factories to the shell factory index' }
+  end
+
+  class NotAModuleError < Error
+    define_method(:message) { 'Cannot add non-modules to the module index' }
+  end
+
+  class NoSuchModuleError < Error
+    define_method(:message) { "No such module #{@msg} found." }
+  end
+
+  class DuplicateIndexError < Error
+    define_method(:message) { 'There is already an object with that name in the index' }
+  end
+
   class TimeoutError < Error
     define_method(:message) { 'Operation timed out.' }
   end

data/lib/index.rb

@@ -0,0 +1,40 @@
+module Shelldon
+  class Index
+    include Singleton
+
+    def self.method_missing(meth_name, *args, &block)
+      if block_given?
+        instance.send(meth_name, *args, &block)
+      else
+        instance.send(meth_name, *args)
+      end
+    end
+
+    def initialize
+      @index = {}
+    end
+
+    def [](key)
+      @index[key.to_sym]
+    end
+
+    def []=(key, val)
+      @index[key.to_sym] = val
+    end
+
+    def has_key?(key)
+      @index.key?(key)
+    end
+
+    def <<(obj)
+      @first = obj.name if @index.empty?
+      fail Shelldon::DuplicateIndexError if @index.key?(obj.name)
+      @index[obj.name] = obj
+    end
+
+    def first?(sym)
+      sym = sym.to_sym unless sym.is_a?(Symbol)
+      sym == @first
+    end
+  end
+end

data/lib/module/module.rb

@@ -0,0 +1,43 @@
+module Shelldon
+  class Module
+    attr_reader :name
+    def initialize(name)
+      @name            = name.to_sym
+      @commands        = []
+      @configs         = []
+      @shell_blocks    = []
+      @command_missing = []
+    end
+
+    def add_command(name, lambda)
+      @commands << [name, lambda]
+    end
+
+    def add_config(lambda)
+      @configs << lambda
+    end
+
+    def add_shell_block(lambda)
+      @shell_blocks << lambda
+    end
+
+    def add_command_missing(lambda)
+      @command_missing[0] = lambda
+    end
+
+    def install(shell_name)
+      @commands.each do |(name, lambda)|
+        Shelldon.shell(shell_name) { command(name, &lambda.to_proc) }
+      end
+      @configs.each do |lambda|
+        Shelldon.shell(shell_name) { config(&lambda.to_proc) }
+      end
+      @shell_blocks.each do |lambda|
+        Shelldon.shell(shell_name) { shell(&lambda.to_proc) }
+      end
+      @command_missing.each do |lambda|
+        Shelldon.shell(shell_name) { command_missing(&lambda.to_proc) }
+      end
+    end
+  end
+end

data/lib/module/module_factory.rb

@@ -0,0 +1,33 @@
+module Shelldon
+  class ModuleFactory
+    def initialize(name, &block)
+      @name = name
+      register Shelldon::Module.new(name) unless Shelldon.modules.has_key?(name)
+      instance_exec(@name, &block.to_proc)
+    end
+
+    def this_module
+      Shelldon.modules[@name]
+    end
+
+    def command(name, &block)
+      this_module.add_command(name, block)
+    end
+
+    def config(&block)
+      this_module.add_config(block)
+    end
+
+    def shell(&block)
+      this_module.add_shell_block(block)
+    end
+
+    def command_missing(&block)
+      this_module.add_command_missing(block)
+    end
+
+    def register(mod)
+      Shelldon.modules << mod
+    end
+  end
+end

data/lib/module/module_index.rb

@@ -0,0 +1,16 @@
+# This allows subshelling - You can define multiple shells in one program and nest them.
+# This is the opposite approach to shell-as-singleton, which makes access easy but prevents multiple shells.
+# This is why all of the factories pass the shell parent into their respective products.
+
+module Shelldon
+  class ModuleIndex < Index
+    def <<(mod)
+      if mod.is_a?(Shelldon::Module)
+        fail Shelldon::DuplicateIndexError if @index.key?(mod.name)
+        @index[mod.name] = mod
+      else
+        fail Shelldon::NotAModuleError
+      end
+    end
+  end
+end

data/lib/shell/shell.rb

@@ -77,7 +77,7 @@ module Shelldon
     end
 
     def run
-      @history_helper.load
+      @history_helper.load if @history_helper
       run_opt_conditions
       handle_piped_input
       instance_eval(&@startup) if @startup
@@ -85,12 +85,12 @@ module Shelldon
         run_repl
       rescue *@accept_errors.keys => e
         print_error(e)
-        @logger.warn(e)
+        log_warn(e)
         on_error(e, @accept_errors[e.class], :accept)
         retry
       rescue *@reject_errors.keys => e
         print_error(e)
-        @logger.fatal(e)
+        log_fatal(e)
         on_error(e, @reject_errors[e.class], :reject)
       rescue StandardError => e
         print_error(e)
@@ -104,6 +104,14 @@ module Shelldon
       end
     end
 
+    def log_warn(e)
+      @logger.warn(e) if @logger
+    end
+
+    def log_fatal(e)
+      @logger.fatal(e) if @logger
+    end
+
     def on_error(e, proc, type = nil)
       run_accept_error(e) if type == :accept
       run_reject_error(e) if type == :reject

data/lib/shell/shell_factory.rb

@@ -1,14 +1,21 @@
 module Shelldon
   class ShellFactory
+    attr_reader :name
+
     def initialize(name, &block)
       @name = name
+      Shelldon.shell_factory_index << self
       setup_vars
       register(Shell.new(name)) unless Shelldon[name]
+      load(&block)
+    end
+
+    def load(&block)
       instance_eval(&block)
-      make_it_rain
     end
 
     def setup_vars
+      @modules         = []
       @new_opts        = []
       @new_configs     = []
       @new_on_opts     = []
@@ -16,9 +23,16 @@ module Shelldon
       @new_script_dirs = []
     end
 
+    def run
+      make_it_rain
+      Shelldon[@name].run
+    end
+
     def make_it_rain
+      install_modules
       make_opts
       make_configs
+      this_shell.config.setup
       make_on_opts
       make_commands
       make_scripts
@@ -62,6 +76,22 @@ module Shelldon
 
     alias_method :scripts, :script
 
+    def modules(mods)
+      mods     = [mods] unless mods.is_a?(Array)
+      @modules += mods.map(&:to_sym)
+    end
+
+    def install_modules
+      @modules.each do |mod_name|
+        if Shelldon.modules.has_key?(mod_name)
+          Shelldon.modules[mod_name].install(@name)
+        else
+          raise Shelldon::NoSuchModuleError mod_name
+        end
+
+      end
+    end
+
     def config(&block)
       @new_configs << block
     end

data/lib/shell/shell_factory_index.rb

@@ -0,0 +1,16 @@
+# This allows subshelling - You can define multiple shells in one program and nest them.
+# This is the opposite approach to shell-as-singleton, which makes access easy but prevents multiple shells.
+# This is why all of the factories pass the shell parent into their respective products.
+
+module Shelldon
+  class ShellFactoryIndex < Index
+    def <<(shell_factory)
+      if shell_factory.is_a?(Shelldon::ShellFactory)
+        fail Shelldon::DuplicateIndexError if @index.key?(shell_factory.name)
+        @index[shell_factory.name] = shell_factory
+      else
+        fail Shelldon::NotAShellFactoryError
+      end
+    end
+  end
+end

data/lib/shell/shell_index.rb

@@ -3,41 +3,15 @@
 # This is why all of the factories pass the shell parent into their respective products.
 
 module Shelldon
-  class ShellIndex
-    include Singleton
-
-    def self.method_missing(meth_name, *args, &block)
-      if block_given?
-        instance.send(meth_name, *args, &block)
-      else
-        instance.send(meth_name, *args)
-      end
-    end
-
-    def initialize
-      @shell_index = {}
-    end
-
-    def [](key)
-      @shell_index[key.to_sym]
-    end
-
-    def has_key?(key)
-      @shell_index.key?(key)
-    end
-
+  class ShellIndex < Index
     def <<(shell)
       if shell.is_a?(Shelldon::Shell)
-        @first = shell.name if @shell_index.empty?
-        @shell_index[shell.name] = shell
+        fail Shelldon::DuplicateIndexError if @index.key?(shell.name)
+        @first = shell.name if @index.empty?
+        @index[shell.name] = shell
       else
         fail Shelldon::NotAShellError
       end
     end
-
-    def first?(sym)
-      sym = sym.to_sym unless sym.is_a?(Symbol)
-      sym == @first
-    end
   end
 end

data/lib/shelldon.rb

@@ -4,9 +4,14 @@ require 'readline'
 require 'getopt/long'
 require 'yaml'
 require 'fuzzy_match'
+require 'index'
 require 'shell/shell_index'
+require 'shell/shell_factory_index'
 require 'dsl'
 require 'shell/shell'
+require 'module/module'
+require 'module/module_factory'
+require 'module/module_index'
 require 'config/config'
 require 'config/param'
 require 'config/param/string_param'

data/lib/shelldon/version.rb

@@ -1,3 +1,3 @@
 module Shelldon
-  VERSION = '0.0.7'
+  VERSION = '0.0.8'
 end

data/test_shell/dependency_test/dependency_test.rb

@@ -6,8 +6,9 @@ Shelldon.shell :test do
     action { |cmd| puts "No such command \"#{cmd}\"" }
   end
 
+  modules [:test_module]
+
   shell do
-    prompt 'shelldon> '
     home '~/.shelldon-test'
     history true
     history_file '.shelldon-history'

data/test_shell/dependency_test/dt_config.rb

@@ -1,4 +1,3 @@
-
 Shelldon.shell :test do
   config do
     config_file '.shelldon_config'
@@ -22,10 +21,5 @@ Shelldon.shell :test do
         end
       end
     end
-
-    param :value do
-      type :string
-      default 'This is the default value!'
-    end
   end
 end

data/test_shell/dependency_test/dt_runner.rb

@@ -1,11 +1,30 @@
 # This is a split-up version of the test_shell.rb
 # It exists so you can screw around with when the different parts are required and ensure that
-#   the order doesn't matter.
+#   the order doesn't matter and multiple blocks of the same type all load in correctly.
 
 require 'shelldon'
 require_relative 'dependency_test'
 require_relative 'dt_commands'
 require_relative 'dt_opts'
 require_relative 'dt_config'
+require_relative 'test_module'
 
-Shelldon[:test].run
+Shelldon.shell :test do
+  command :superderp do
+    action { puts 'beh' }
+    help 'test'
+  end
+
+  config do
+    param :value do
+      type :string
+      default 'This is the default value!'
+    end
+  end
+
+  shell do
+    prompt 'shelldon> '
+  end
+end
+
+Shelldon.run(:test)

data/test_shell/dependency_test/test_module.rb

@@ -0,0 +1,16 @@
+Shelldon.module :test_module do
+  command :harpdarp do
+    action { puts 'HARPDARP' }
+  end
+
+  config do
+    param :harpdarp do
+      type :string
+      default 'sweg'
+    end
+  end
+
+  shell do
+    prompt 'prompt!> '
+  end
+end

data/test_shell/simple_shell.rb

@@ -103,4 +103,4 @@ Shelldon.shell :test do
   end
 end
 
-Shelldon[:test].run
+Shelldon.run(:test)

data/test_shell/simplest_shell.rb

@@ -0,0 +1,12 @@
+require 'shelldon'
+
+Shelldon.shell :example do
+  command :test do
+    help "Run a test command to show some text. Optionally, add an arg."
+    usage "test"
+    examples ['test', 'test blah']
+    action { |arg = ''| puts "This is a test! #{arg}" }
+  end
+end
+
+Shelldon.run(:example)

data/test_shell/test_shell.rb

@@ -122,4 +122,4 @@ Shelldon.shell :test do
   end
 end
 
-Shelldon[:test].run
+Shelldon.run(:test)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shelldon
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors:
 - Wesley Boynton
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-03-27 00:00:00.000000000 Z
+date: 2016-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: getopt
@@ -91,6 +91,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rbenv-gemsets"
 - ".rubocop.yml"
 - Gemfile
 - LICENSE.txt
@@ -120,10 +121,15 @@ files:
 - lib/file_management/yaml_manager.rb
 - lib/helpers/confirmation.rb
 - lib/helpers/timer.rb
+- lib/index.rb
+- lib/module/module.rb
+- lib/module/module_factory.rb
+- lib/module/module_index.rb
 - lib/opts/opt_factory.rb
 - lib/opts/opts.rb
 - lib/shell/shell.rb
 - lib/shell/shell_factory.rb
+- lib/shell/shell_factory_index.rb
 - lib/shell/shell_index.rb
 - lib/shelldon.rb
 - lib/shelldon/version.rb
@@ -137,8 +143,10 @@ files:
 - test_shell/dependency_test/dt_config.rb
 - test_shell/dependency_test/dt_opts.rb
 - test_shell/dependency_test/dt_runner.rb
+- test_shell/dependency_test/test_module.rb
 - test_shell/run.sh
 - test_shell/simple_shell.rb
+- test_shell/simplest_shell.rb
 - test_shell/test_shell.rb
 - test_shell/useful_commands.rb
 homepage: https://github.com/wwboynton/shelldon
@@ -162,7 +170,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.5
+rubygems_version: 2.4.5.1
 signing_key: 
 specification_version: 4
 summary: An expressive DSL for building interactive command-line apps