command_kit 0.1.0.pre1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa6096447b8ddf59149147d020c3fe6f5fcf6de1c167f749692fc1b50dec1b8a
-  data.tar.gz: c4c0a58596e92563f9f69a7fd151a7b7dd9121c8083ca104a21dd3ce53ef2fc5
+  metadata.gz: 5dc00be598fd9cee093dbfaf32a03118897179587d4dc17c97fdde2b020d3ac7
+  data.tar.gz: 88e498fa844b4db50dc194f6ec474d7c85bbea1619bf1340e6d2abfc4c13c0b3
 SHA512:
-  metadata.gz: a777422cddc17a986940b7cd902ac43c01765b6ef98efe717307f545a29dfe975579bb8eacdce9647cd2ccbd0f210b7a8b0ab3ffac026d8341f2c9669ef56a18
-  data.tar.gz: 7b768f74911ac136b24f755534d31844febb92b5b034e672b4b93c3a45083b4731d9658830b6f700bc8b70106b772f253291ed15fcd36f5f709351808910c93b
+  metadata.gz: 5fd2683d7d3fb3f4c1258019d209b9f8ca348b0fc71c21c9f292b6799502dcfbc39d8f5ff8e50d54b822aaf229eedd85c3e151bea0f9c92d13dc08bb5b6d947e
+  data.tar.gz: 4276756c0495b2583303c9db090cd0e1221681d7eb357b34d4078a7e59167695f3250552c58ff0be24ee27535fb49ab2ce15d8e0711ee44cebbb93a52f6dfac0

data/.github/workflows/ruby.yml

@@ -3,6 +3,7 @@ name: CI
 on: [ push, pull_request ]
 
 jobs:
+  # run tests
   tests:
     runs-on: ubuntu-latest
     strategy:
@@ -27,3 +28,17 @@ jobs:
         run: bundle install --jobs 4 --retry 3
       - name: Run tests
         run: bundle exec rake test
+
+  # rubocop linting
+  rubocop:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+      - name: Run rubocop
+        run: bundle exec rubocop --parallel

data/.rubocop.yml

@@ -0,0 +1,138 @@
+AllCops:
+  NewCops: enable
+  SuggestExtensions: false
+  TargetRubyVersion: 2.7
+
+#
+# our rules
+#
+
+Layout/FirstArrayElementIndentation: { EnforcedStyle: consistent }
+Layout/LineLength: { Enabled: false }
+Layout/SpaceAroundEqualsInParameterDefault: { EnforcedStyle: no_space }
+Lint/ConstantDefinitionInBlock: { Exclude: ['spec/**/*'] }
+Metrics: { Enabled: false }
+Style/SymbolArray: { EnforcedStyle: brackets }
+Style/IfInsideElse: { Enabled: false } # Offense count: 1
+Style/PercentLiteralDelimiters:
+  Enabled: true
+  PreferredDelimiters:
+    default: '{}'
+    '%i': '[]'
+    '%I': '[]'
+    '%w': '[]'
+    '%W': '[]'
+
+#
+# rules that are in flux
+#
+
+# consider enabling these and autocorrecting?
+# Layout/SpaceAfterComma
+# Layout/SpaceAroundKeyword
+# Layout/SpaceBeforeComma
+# Layout/SpaceInsideHashLiteralBraces
+# Layout/SpaceInsideParens
+# Layout/TrailingWhitespace
+# Lint/UnreachableLoop
+# Lint/UnusedBlockArgument
+# Style/ClassCheck
+# Style/Documentation
+# Style/ExpandPathArguments
+# Style/GlobalStdStream
+# Style/HashSyntax
+# Style/KeywordParametersOrder
+# Style/MethodCallWithoutArgsParentheses
+# Style/MutableConstant
+# Style/QuotedSymbols: { EnforcedStyle: double_quotes }
+# Style/RedundantReturn
+# Style/SafeNavigation
+# Style/SpecialGlobalVars
+# Style/StringLiterals: { EnforcedStyle: double_quotes }
+# Style/WordArray
+
+# these have been fixed
+# Gemspec/DuplicatedAssignment: { Enabled: false } # Offense count: 1
+# Layout/ElseAlignment: { Enabled: false } # Offense count: 1
+# Layout/EndAlignment: { Enabled: false } # Offense count: 1
+# Lint/DuplicateMethods: { Enabled: false } # Offense count: 1
+# Lint/UselessAssignment: { Enabled: false } # Offense count: 1
+# Style/Encoding: { Enabled: false } # Offense count: 2
+# Style/RedundantBegin: { Enabled: false } # Offense count: 2
+# Style/RedundantInterpolation: { Enabled: false } # Offense count: 1
+# Style/TrailingCommaInArrayLiteral: { Enabled: false } # Offense count: 1
+
+#
+# This list was generated with:
+# bundle exec rubocop --auto-gen-config --exclude-limit 1
+#
+
+# > 10 violations
+Layout/AssignmentIndentation: { Enabled: false } # Offense count: 11
+Layout/EmptyLinesAroundClassBody: { Enabled: false } # Offense count: 76
+Layout/HashAlignment: { Enabled: false } # Offense count: 28
+Layout/SpaceAfterComma: { Enabled: false } # Offense count: 141
+Layout/SpaceInsideHashLiteralBraces: { Enabled: false } # Offense count: 57
+Layout/TrailingWhitespace: { Enabled: false } # Offense count: 50
+Naming/RescuedExceptionsVariableName: { Enabled: false } # Offense count: 11
+Style/BlockDelimiters: { Enabled: false } # Offense count: 17
+Style/ClassCheck: { Enabled: false } # Offense count: 10
+Style/ClassEqualityComparison: { Enabled: false } # Offense count: 16
+Style/FrozenStringLiteralComment: { Enabled: false } # Offense count: 77
+Style/GlobalStdStream: { Enabled: false } # Offense count: 13
+Style/GuardClause: { Enabled: false } # Offense count: 10
+Style/IfUnlessModifier: { Enabled: false } # Offense count: 13
+Style/MethodCallWithoutArgsParentheses: { Enabled: false } # Offense count: 10
+Style/SpecialGlobalVars: { Enabled: false } # Offense count: 28
+Style/StringLiterals: { Enabled: false } # Offense count: 774
+
+# < 10 violations
+Layout/EmptyLinesAroundModuleBody: { Enabled: false } # Offense count: 5
+Layout/ExtraSpacing: { Enabled: false } # Offense count: 6
+Layout/FirstHashElementIndentation: { Enabled: false } # Offense count: 4
+Layout/ParameterAlignment: { Enabled: false } # Offense count: 9
+Layout/SpaceAroundKeyword: { Enabled: false } # Offense count: 7
+Layout/SpaceBeforeComma: { Enabled: false } # Offense count: 4
+Layout/SpaceInsideParens: { Enabled: false } # Offense count: 4
+Lint/EmptyClass: { Enabled: false } # Offense count: 3
+Lint/SuppressedException: { Enabled: false } # Offense count: 4
+Lint/UnusedMethodArgument: { Enabled: false } # Offense count: 5
+Style/AccessorGrouping: { Enabled: false } # Offense count: 7
+Style/Documentation: { Enabled: false } # Offense count: 3
+Style/ExpandPathArguments: { Enabled: false } # Offense count: 8
+Style/HashSyntax: { Exclude: ['Rakefile'] } # Offense count: 3
+Style/KeywordParametersOrder: { Enabled: false } # Offense count: 8
+Style/Lambda: { Enabled: false } # Offense count: 3
+Style/MutableConstant: { Enabled: false } # Offense count: 4
+Style/RaiseArgs: { Enabled: false } # Offense count: 4
+Style/RedundantReturn: { Enabled: false } # Offense count: 7
+Style/SafeNavigation: { Enabled: false } # Offense count: 5
+Style/StringConcatenation: { Enabled: false } # Offense count: 8
+Style/WordArray: { Enabled: false } # Offense count: 4
+
+# 1 or 2 violations
+Layout/ArgumentAlignment: { Enabled: false } # Offense count: 1
+Layout/BlockAlignment: { Enabled: false } # Offense count: 1
+Layout/IndentationWidth: { Enabled: false } # Offense count: 2
+Layout/SpaceAroundOperators: { Enabled: false } # Offense count: 1
+Layout/SpaceBeforeBlockBraces: { Enabled: false } # Offense count: 1
+Lint/MissingSuper: { Enabled: false } # Offense count: 2
+Lint/RescueException: { Enabled: false } # Offense count: 1
+Lint/UnreachableLoop: { Enabled: false } # Offense count: 1
+Lint/UnusedBlockArgument: { Enabled: false } # Offense count: 1
+Naming/MethodParameterName: { Enabled: false } # Offense count: 1
+Style/EmptyMethod: { Enabled: false } # Offense count: 2
+Style/HashConversion: { Enabled: false } # Offense count: 1
+Style/MultilineMemoization: { Enabled: false } # Offense count: 1
+Style/NumericPredicate: { Enabled: false } # Offense count: 1
+Style/OptionalArguments: { Enabled: false } # Offense count: 1
+Style/ParenthesesAroundCondition: { Enabled: false } # Offense count: 1
+Style/PreferredHashMethods: { Enabled: false } # Offense count: 1
+Style/QuotedSymbols: { Enabled: false } # Offense count: 1
+Style/RedundantException: { Enabled: false } # Offense count: 1
+Style/RedundantRegexpEscape: { Enabled: false } # Offense count: 1
+Style/RegexpLiteral: { Enabled: false } # Offense count: 1
+Style/RescueStandardError: { Enabled: false } # Offense count: 1
+Style/SoleNestedConditional: { Enabled: false } # Offense count: 1
+Style/TrailingCommaInHashLiteral: { Enabled: false } # Offense count: 2
+Style/PercentLiteralDelimiters: { Enabled: false } # Offense count: 2

data/ChangeLog.md

@@ -1,13 +1,41 @@
-### 0.1.0 / 2021-05-XX
+### 0.2.0 / 2021-08-31
+
+* Added {CommandKit::Colors::ANSI#on_black}.
+* Added {CommandKit::Colors::ANSI#on_red}.
+* Added {CommandKit::Colors::ANSI#on_green}.
+* Added {CommandKit::Colors::ANSI#on_yellow}.
+* Added {CommandKit::Colors::ANSI#on_blue}.
+* Added {CommandKit::Colors::ANSI#on_magenta}.
+* Added {CommandKit::Colors::ANSI#on_cyan}.
+* Added {CommandKit::Colors::ANSI#on_white}.
+* Added {CommandKit::Man}.
+* Added {CommandKit::OS#bsd?}.
+* Added {CommandKit::OS#freebsd?}.
+* Added {CommandKit::OS#netbsd?}.
+* Added {CommandKit::OS#openbsd?}.
+* Added {CommandKit::OS#os}.
+* Added {CommandKit::OS#unix?}.
+* Added {CommandKit::OS::Linux}.
+* Added {CommandKit::OpenApp}.
+* Added {CommandKit::PackageManager}.
+* Added {CommandKit::Pager#pipe_to_pager}.
+* Added {CommandKit::Sudo}.
+* Added {CommandKit::Terminal#tty?}.
+* Refactor {CommandKit::Inflector.camelize} and
+  {CommandKit::Inflector.underscore} to use StringScanner.
+* Allow {CommandKit::OS#initialize} to accept an `os:` keyword to override the
+  detected OS.
+
+### 0.1.0 / 2021-07-16
 
 * Initial release:
   * {CommandKit::Arguments}
   * {CommandKit::Colors}
+  * {CommandKit::Command}
   * {CommandKit::CommandName}
   * {CommandKit::Commands}
     * {CommandKit::Commands::AutoLoad}
     * {CommandKit::Commands::AutoRequire}
-  * {CommandKit::Console}
   * {CommandKit::Description}
   * {CommandKit::Env}
     * {CommandKit::Env::Home}
@@ -16,14 +44,18 @@
   * {CommandKit::ExceptionHandler}
   * {CommandKit::Help}
     * {CommandKit::Help::Man}
+  * {CommandKit::Interactive}
   * {CommandKit::Main}
   * {CommandKit::Options}
     * {CommandKit::Options::Quiet}
     * {CommandKit::Options::Verbose}
+  * {CommandKit::OS}
   * {CommandKit::Pager}
   * {CommandKit::Printing}
+    * {CommandKit::Printing::Indent}
   * {CommandKit::ProgramName}
   * {CommandKit::Stdio}
+  * {CommandKit::Terminal}
   * {CommandKit::Usage}
   * {CommandKit::XDG}
 

data/Gemfile

@@ -6,9 +6,12 @@ group :development do
   gem 'rake'
   gem 'rubygems-tasks', '~> 0.2'
 
+  gem 'rubocop', '~> 1.18'
+
   gem 'rspec', '~> 3.0'
   gem 'simplecov', '~> 0.20', require: false
 
   gem 'kramdown'
   gem 'yard', '~> 0.9'
+  gem 'yard-spellcheck', require: false
 end

data/README.md

@@ -1,57 +1,39 @@
 # command_kit
 
-* [Homepage](https://github.com/postmodern/command_kit#readme)
-* [Issues](https://github.com/postmodern/command_kit/issues)
+[![Build Status](https://github.com/postmodern/command_kit.rb/workflows/CI/badge.svg?branch=main)](https://github.com/postmodern/command_kit.rb/actions)
+
+* [Homepage](https://github.com/postmodern/command_kit.rb#readme)
+* [Forum](https://github.com/postmodern/command_kit.rb/discussions) |
+  [Issues](https://github.com/postmodern/command_kit.rb/issues)
 * [Documentation](http://rubydoc.info/gems/command_kit/frames)
-* [Email](mailto:postmodern.mod3 at gmail.com)
 
 ## Description
 
-A Ruby toolkit for building clean, correct, and robust CLI commands as Ruby
-classes.
+A Ruby toolkit for building clean, correct, and robust CLI commands as
+plain-old Ruby classes.
 
 ## Features
 
-* Supports defining commands as Classes.
-* Supports defining options and arguments as attributes.
-* Supports subcommands (explicit or lazy-loaded) and command aliases.
-* Correctly handles Ctrl^C and SIGINT interrupts (aka exit 130).
-* Correctly handles broken pipes (aka `mycmd | head`).
-* Uses [OptionParser][optparse] for option parsing.
-* Provides ANSI coloring support.
-* Supports optionally displaying a man-page instead of `--help`
-  (see {CommandKit::Help::Man}).
-* Supports XDG directories (`~/.config/`, `~/.local/share/`, `~/.cache/`).
-* Easy to test:
-  * `MyCmd.main(arg1, arg2, options: {foo: foo}) # => 0`
-
-### Modules
-
-* {CommandKit::Arguments}
-* {CommandKit::Colors}
-* {CommandKit::CommandName}
-* {CommandKit::Commands}
-  * {CommandKit::Commands::AutoLoad}
-  * {CommandKit::Commands::AutoRequire}
-* {CommandKit::Console}
-* {CommandKit::Description}
-* {CommandKit::Env}
-  * {CommandKit::Env::Home}
-  * {CommandKit::Env::Path}
-* {CommandKit::Examples}
-* {CommandKit::ExceptionHandler}
-* {CommandKit::Help}
-  * {CommandKit::Help::Man}
-* {CommandKit::Main}
-* {CommandKit::Options}
-  * {CommandKit::Options::Quiet}
-  * {CommandKit::Options::Verbose}
-* {CommandKit::Pager}
-* {CommandKit::Printing}
-* {CommandKit::ProgramName}
-* {CommandKit::Stdio}
-* {CommandKit::Usage}
-* {CommandKit::XDG}
+* **Simple** - Commands are plain-old ruby classes, with options and
+  arguments declared as attributes. All features are ruby modules that can be
+  included into command classes.
+* **Correct** - CommandKit behaves like a standard UNIX command.
+  * Safely handles Ctrl^C / SIGINT interrupts and [exits with 130](https://tldp.org/LDP/abs/html/exitcodes.html).
+  * Safely handles broken pipes (aka `mycmd | head`).
+  * Respects common environment variables (ex: `TERM=dumb`).
+  * Uses [OptionParser][optparse] for POSIX option parsing.
+  * Disables ANSI color when output is redirected to a file.
+* **Complete** - Provides many additional CLI features.
+  * OS detection.
+  * Terminal size detection.
+  * ANSI coloring support.
+  * Interactive input.
+  * Subcommands (explicit or lazy-loaded) and command aliases.
+  * Displaying man pages for `--help`/`help`.
+  * Using the pager (aka `less`).
+  * [XDG directories](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) (aka `~/.config/`, `~/.local/share/`, `~/.cache/`).
+* **Testable** - Since commands are plain-old ruby classes, it's easy to
+  initialize them and call `#main` or `#run`.
 
 ## Anti-Features
 
@@ -59,209 +41,148 @@ classes.
 * Does not implement it's own option parser.
 * Not named after a comic-book Superhero.
 
-## Examples
-
-### Command
-
-#### lib/foo/cli/my_cmd.rb
-
-    require 'command_kit'
-
-    module Foo
-      module CLI
-        class MyCmd < CommandKit::Command
-    
-          usage '[OPTIONS] [-o OUTPUT] FILE'
-    
-          option :count, short: '-c',
-                         value: {
-                           type: Integer,
-                           default: 1
-                         },
-                         desc: "Number of times"
-    
-          option :output, short: '-o',
-                          value: {
-                            type: String,
-                            usage: 'FILE'
-                          },
-                          desc: "Optional output file"
-    
-          option :verbose, short: '-v', desc: "Increase verbose level" do
-            @verbose += 1
-          end
-    
-          argument :file, type: String,
-                          required: true,
-                          usage: 'FILE',
-                          desc: "Input file"
-
-          examples [
-            '-o path/to/output.txt path/to/input.txt',
-            '-v -c 2 -o path/to/output.txt path/to/input.txt',
-          ]
-
-          description 'Example command'
-    
-          def initialize(**kwargs)
-            super(**kwargs)
-    
-            @verbose = 0
-          end
-    
-          def run(file)
-            puts "count=#{options[:count].inspect}"
-            puts "output=#{options[:output].inspect}"
-            puts "file=#{file.inspect}"
-            puts "verbose=#{@verbose.inspect}"
-          end
-    
-        end
-      end
-    end
-
-#### bin/my_cmd
-
-    #!/usr/bin/env ruby
-    
-    $LOAD_PATH.unshift(File.expand_path('../../lib',__FILE__))
-    require 'foo/cli/my_cmd'
-    
-    Foo::CLI::MyCmd.start
-
-#### --help
-
-    Usage: my_cmd [OPTIONS] [-o OUTPUT] FILE
-    
-    Options:
-        -c, --count INT                  Number of times (Default: 1)
-        -o, --output FILE                Optional output file
-        -v, --verbose                    Increase verbose level
-        -h, --help                       Print help information
-    
-    Arguments:
-        FILE                             Input file
-    
-    Examples:
-        my_cmd -o path/to/output.txt path/to/input.txt
-        my_cmd -v -c 2 -o path/to/output.txt path/to/input.txt
-    
-    Example command
-
-### Options
-
-Define an option:
-
-    option :foo, desc: "Foo option"
-
-With a custom short option:
-
-    option :foo, short: '-f',
-                 desc: "Foo option"
-
-With a custom long option:
-
-    option :foo, short: '--foo-opt',
-                 desc: "Foo option"
-
-With a custom usage string:
+## Requirements
 
-    option :foo, value: {usage: 'FOO'},
-                 desc: "Foo option"
+* [ruby] >= 2.7.0
 
-With a custom block:
+## Install
 
-    option :foo, desc: "Foo option" do |value|
-      @foo = Foo.new(value)
-    end
+```sh
+$ gem install command_kit
+```
 
-With a custom type:
+### gemspec
 
-    option :foo, value: {type: Integer},
-                 desc: "Foo option"
+```ruby
+gem.add_dependency 'command_kit', '~> 0.2'
+```
 
-With a default value:
+### Gemfile
 
-    option :foo, value: {type: Integer, default: 1},
-                 desc: "Foo option"
+```ruby
+gem 'command_kit', '~> 0.2'
+```
 
-With a required value:
+## Examples
 
-    option :foo, value: {type: String, required: true},
-                 desc: "Foo option"
+### lib/foo/cli/my_cmd.rb
 
-With a custom option value Hash map:
+```ruby
+require 'command_kit'
 
-    option :flag, value: {
-                    type: {
-                      'enabled'  => :enabled,
-                      'yes'      => :enabled,
-                      'disabled' => :disabled,
-                      'no'       => :disabled
-                    }
-                  },
-                  desc: "Flag option"
+module Foo
+  module CLI
+    class MyCmd < CommandKit::Command
 
-With a custom option value Array enum:
+      usage '[OPTIONS] [-o OUTPUT] FILE'
 
-    option :enum, value: {type: %w[yes no]},
-                  desc: "Enum option"
+      option :count, short: '-c',
+                     value: {
+                       type: Integer,
+                       default: 1
+                     },
+                     desc: "Number of times"
 
-With a custom option value Regexp:
+      option :output, short: '-o',
+                      value: {
+                        type: String,
+                        usage: 'FILE'
+                      },
+                      desc: "Optional output file"
 
-    option :date, value: {type: /(\d+)-(\d+)-(\d{2,4})/},
-                  desc: "Regexp optin" do |date,d,m,y|
-      # ...
-    end
+      option :verbose, short: '-v', desc: "Increase verbose level" do
+        @verbose += 1
+      end
 
-### Arguments
+      argument :file, required: true,
+                      usage: 'FILE',
+                      desc: "Input file"
 
-Define an argument:
+      examples [
+        '-o path/to/output.txt path/to/input.txt',
+        '-v -c 2 -o path/to/output.txt path/to/input.txt',
+      ]
 
-    argument :bar, desc: "Bar argument"
+      description 'Example command'
 
-With a custom usage string:
+      def initialize(**kwargs)
+        super(**kwargs)
 
-    option :bar, usage: 'BAR',
-                 desc: "Bar argument"
+        @verbose = 0
+      end
 
-With a custom block:
+      def run(file)
+        puts "count=#{options[:count].inspect}"
+        puts "output=#{options[:output].inspect}"
+        puts "file=#{file.inspect}"
+        puts "verbose=#{@verbose.inspect}"
+      end
 
-    argument :bar, desc: "Bar argument" do |bar|
-      # ...
     end
+  end
+end
+```
 
-With a custom type:
-
-    argument :bar, type: Integer,
-                   desc: "Bar argument"
-
-With a default value:
+### bin/my_cmd
 
-    argument :bar, default: "bar.txt",
-                   desc: "Bar argument"
+```ruby
+#!/usr/bin/env ruby
 
-An optional argument:
+$LOAD_PATH.unshift(File.expand_path('../../lib',__FILE__))
+require 'foo/cli/my_cmd'
 
-    argument :bar, required: true,
-                   desc: "Bar argument"
+Foo::CLI::MyCmd.start
+```
 
-A repeating argument:
+### --help
 
-    argument :bar, repeats: true,
-                   desc: "Bar argument"
-
-## Requirements
+    Usage: my_cmd [OPTIONS] [-o OUTPUT] FILE
 
-* [ruby] >= 2.7.0
+    Options:
+        -c, --count INT                  Number of times (Default: 1)
+        -o, --output FILE                Optional output file
+        -v, --verbose                    Increase verbose level
+        -h, --help                       Print help information
 
-## Install
+    Arguments:
+        FILE                             Input file
 
-    $ gem install command_kit
+    Examples:
+        my_cmd -o path/to/output.txt path/to/input.txt
+        my_cmd -v -c 2 -o path/to/output.txt path/to/input.txt
 
-### Gemfile
+    Example command
 
-    gem 'command_kit', '~> 0.1'
+### Reference
+
+* [CommandKit::Arguments](https://rubydoc.info/gems/command_kit/CommandKit/Arguments)
+* [CommandKit::Colors](https://rubydoc.info/gems/command_kit/CommandKit/Colors)
+* [CommandKit::Command](https://rubydoc.info/gems/command_kit/CommandKit/Command)
+* [CommandKit::CommandName](https://rubydoc.info/gems/command_kit/CommandKit/CommandName)
+* [CommandKit::Commands](https://rubydoc.info/gems/command_kit/CommandKit/Commands)
+  * [CommandKit::Commands::AutoLoad](https://rubydoc.info/gems/command_kit/CommandKit/Commands/AutoLoad)
+  * [CommandKit::Commands::AutoRequire](https://rubydoc.info/gems/command_kit/CommandKit/Commands/AutoRequire)
+* [CommandKit::Description](https://rubydoc.info/gems/command_kit/CommandKit/Description)
+* [CommandKit::Env](https://rubydoc.info/gems/command_kit/CommandKit/Env)
+  * [CommandKit::Env::Home](https://rubydoc.info/gems/command_kit/CommandKit/Env/Home)
+  * [CommandKit::Env::Path](https://rubydoc.info/gems/command_kit/CommandKit/Env/Path)
+* [CommandKit::Examples](https://rubydoc.info/gems/command_kit/CommandKit/Examples)
+* [CommandKit::ExceptionHandler](https://rubydoc.info/gems/command_kit/CommandKit/ExceptionHandler)
+* [CommandKit::Help](https://rubydoc.info/gems/command_kit/CommandKit/Help)
+  * [CommandKit::Help::Man](https://rubydoc.info/gems/command_kit/CommandKit/Help/Man)
+* [CommandKit::Interactive](https://rubydoc.info/gems/command_kit/CommandKit/Interactive)
+* [CommandKit::Main](https://rubydoc.info/gems/command_kit/CommandKit/Main)
+* [CommandKit::Options](https://rubydoc.info/gems/command_kit/CommandKit/Options)
+  * [CommandKit::Options::Quiet](https://rubydoc.info/gems/command_kit/CommandKit/Options/Quiet)
+  * [CommandKit::Options::Verbose](https://rubydoc.info/gems/command_kit/CommandKit/Options/Verbose)
+* [CommandKit::Pager](https://rubydoc.info/gems/command_kit/CommandKit/Pager)
+* [CommandKit::Printing](https://rubydoc.info/gems/command_kit/CommandKit/Printing)
+  * [CommandKit::Printing::Indent](https://rubydoc.info/gems/command_kit/CommandKit/Printing/Indent)
+* [CommandKit::ProgramName](https://rubydoc.info/gems/command_kit/CommandKit/ProgramName)
+* [CommandKit::Stdio](https://rubydoc.info/gems/command_kit/CommandKit/Stdio)
+* [CommandKit::Terminal](https://rubydoc.info/gems/command_kit/CommandKit/Terminal)
+* [CommandKit::Usage](https://rubydoc.info/gems/command_kit/CommandKit/Usage)
+* [CommandKit::XDG](https://rubydoc.info/gems/command_kit/CommandKit/XDG)
 
 ## Alternatives