ffidb 0.12.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 832a289161ba25e274a8a6d3a20a1592ec40bff4e3774400e6d7f5b3286335c5
+  data.tar.gz: 6b27cb31d52109e2a44c5c8a72f830b772d306206acec33add96eb8faf23e464
+SHA512:
+  metadata.gz: 3b6bc06df8f1d94ded39f0370874d6c02c2f6dc33321f8a7affc51a3f53e2db5300b9291447b5528758a9ba5b22e3402a45b01f5ee17cca5acb642db531298ea
+  data.tar.gz: 4fba31365dbb2b0567dd381075b8f36c3d3bcf07324c9edf143f19e7472e7eabe1c6a17a00fff7b945e55ca47db33b81d1c7eb034e28de32753bff0adb1da820

data/AUTHORS

@@ -0,0 +1 @@
+* Arto Bendiken <arto@bendiken.net>

data/CHANGES.md

@@ -0,0 +1,7 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

data/CREDITS.md

@@ -0,0 +1,2 @@
+Credits
+=======

data/README.md

@@ -0,0 +1,201 @@
+FFI DB Command-Line Interface (CLI)
+===================================
+
+[![Project license](https://img.shields.io/badge/license-Public%20Domain-blue.svg)](https://unlicense.org)
+[![RubyGems gem version](https://img.shields.io/gem/v/ffidb.svg)](https://rubygems.org/gems/ffidb)
+
+Installation
+------------
+
+The tool can be installed quickly and easily on any computer that has
+[Ruby](https://www.ruby-lang.org/en/) available:
+
+    $ gem install ffidb
+
+After installation, download and initialize the FFI DB registry as follows:
+
+    $ ffidb init
+
+Your local FFI DB registry is located at the path `$HOME/.ffidb/`.
+
+Examples (API)
+--------------
+
+### Loading the library
+
+    require 'ffidb'
+
+### Enumerating FFI functions
+
+    FFIDB::Registry.open do |registry|
+      registry.open_library(:zlib) do |library|
+        library.each_function do |function|
+          p function
+        end
+      end
+    end
+
+Reference (CLI)
+---------------
+
+    Commands:
+      ffidb export LIBRARY|SYMBOL...  # Generate C/C++/Go/Java/Python/Ruby/etc code
+      ffidb help [COMMAND]            # Describe available commands or one specific command
+      ffidb init                      # Initialize the registry (at: ~/.ffidb)
+      ffidb list [LIBRARY]            # List FFI libraries and symbols
+      ffidb parse HEADER...           # Parse .h header files
+      ffidb search PATTERN            # Search for FFI symbols using a glob pattern
+      ffidb show SYMBOL               # Show FFI symbol information
+      ffidb update                    # Fetch updates to the registry (at: ~/.ffidb)
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+### Initializing the Registry
+
+    Usage:
+      ffidb init
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Initializes the local FFIDB registry, a prerequisite for using FFIDB.
+
+      Your local FFIDB registry is located at $HOME/.ffidb.
+
+      This command is equivalent to:
+
+        $ git clone --depth=1 https://github.com/ffidb/ffidb.git $HOME/.ffidb
+
+### Updating the Registry
+
+    Usage:
+      ffidb update
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Updates the local FFIDB registry, pulling updates from GitHub.
+
+      Your local FFIDB registry is located at $HOME/.ffidb.
+
+      This command is equivalent to:
+
+        $ cd $HOME/.ffidb && git pull
+
+### Listing Libraries and Symbols
+
+    Usage:
+      ffidb list [LIBRARY]
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Lists libraries with their FFI symbols (such as functions).
+
+      For example:
+
+        $ ffidb list lua
+
+### Searching Libraries and Symbols
+
+    Usage:
+      ffidb search PATTERN
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Searches for FFI symbols (for example, functions) using a glob pattern.
+
+      For example:
+
+        $ ffidb search sqlite3_*_blob
+
+### Viewing Symbol Information
+
+    Usage:
+      ffidb show SYMBOL
+
+    Options:
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Shows information about an FFI symbol (for example, a function).
+
+      For example:
+
+        $ ffidb show lua_callk
+
+### Generating FFI Bindings
+
+    Usage:
+      ffidb export LIBRARY|SYMBOL...
+
+    Options:
+      -f, [--format=FORMAT]            # Specify the output FORMAT (for example: java)
+      -L, [--library-path=DIRECTORY]   # Load all libraries from DIRECTORY
+          [--exclude=PATTERN]          # Exclude symbols matching the glob PATTERN
+          [--exclude-from=FILE]        # Read exclude patterns from FILE
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Generates code for a target language (e.g., C/C++/Java/Python/Ruby/etc).
+
+      Currently supported target formats and programming languages:
+
+        --format=c                     # C99
+        --format=c++                   # C++11
+        --format=dart                  # Dart & Flutter
+        --format=go                    # Go (cgo)
+        --format=java                  # Java (JNA)
+        --format=json                  # JSON
+        --format=lisp                  # Common Lisp (CFFI)
+        --format=python                # Python (ctypes)
+        --format=ruby                  # Ruby (FFI)
+        --format=yaml                  # YAML
+
+      For example:
+
+        $ ffidb export lua -f=c        # Export Lua bindings as C code
+        $ ffidb export lua -f=cpp      # Export Lua bindings as C++ code
+        $ ffidb export lua -f=java     # Export Lua bindings as Java JNA code
+        $ ffidb export lua -f=python   # Export Lua bindings as Python ctypes code
+        $ ffidb export lua -f=ruby     # Export Lua bindings as Ruby FFI code
+
+### Parsing C Header Files
+
+    Usage:
+      ffidb parse HEADER...
+
+    Options:
+      -C, [--config=FILE]              # Use a library.yaml configuration FILE
+      -D, [--define=VAR[=VAL]]         # Define VAR as a preprocessor symbol
+      -I, [--include=DIRECTORY]        # Add DIRECTORY to the headers search path
+      -d, [--debug], [--no-debug]      # Enable debugging
+      -v, [--verbose], [--no-verbose]  # Be verbose (print warnings)
+      -q, [--quiet], [--no-quiet]      # Be quiet (silence non-fatal errors)
+
+    Description:
+      Parses .h header files, outputting YAML using the FFIDB schema.
+
+      Note: parsing requires installation of the 'ffi-clang' library:
+
+        $ gem install ffi-clang

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -0,0 +1 @@
+0.12.0

data/bin/ffidb

@@ -0,0 +1,387 @@
+#!/usr/bin/env ruby -W1
+# This is free and unencumbered software released into the public domain.
+
+require_relative '../lib/ffidb'
+
+require 'thor' # https://rubygems.org/gems/thor
+
+require 'pathname'
+require 'yaml'
+
+class CLI < Thor
+  include FFIDB::Sysexits
+
+  def self.exit_on_failure?() true end
+
+  class_option :debug, aliases: '-d', type: :boolean, desc: "Enable debugging"
+  class_option :verbose, aliases: '-v', type: :boolean, desc: "Be verbose (print warnings)"
+  class_option :quiet, aliases: '-q', type: :boolean, desc: "Be quiet (silence non-fatal errors)"
+
+  desc "export LIBRARY|SYMBOL...", "Generate C/C++/Go/Java/Python/Ruby/etc code"
+  long_desc <<~EOS
+    Generates code for a target language (e.g., C/C++/Java/Python/Ruby/etc).
+
+    Currently supported target formats and programming languages:
+
+      --format=c                     # C99
+      --format=c++                   # C++11
+      --format=dart                  # Dart & Flutter
+      --format=go                    # Go (cgo)
+      --format=java                  # Java (JNA)
+      --format=json                  # JSON
+      --format=lisp                  # Common Lisp (CFFI)
+      --format=python                # Python (ctypes)
+      --format=ruby                  # Ruby (FFI)
+      --format=yaml                  # YAML
+
+    For example:
+
+      $ ffidb export lua -f=c        # Export Lua bindings as C code
+      $ ffidb export lua -f=cpp      # Export Lua bindings as C++ code
+      $ ffidb export lua -f=java     # Export Lua bindings as Java JNA code
+      $ ffidb export lua -f=python   # Export Lua bindings as Python ctypes code
+      $ ffidb export lua -f=ruby     # Export Lua bindings as Ruby FFI code
+  EOS
+  option :format, aliases: '-f', default: nil, desc: "Specify the output FORMAT (for example: java)"
+  option :type, aliases: '-t', default: nil, desc: "Specify the symbol TYPE (enum/struct/function)"
+  option :header, type: :boolean, default: true, desc: "Output the file header, or not"
+  option :module, aliases: '-M', default: nil, desc: "Provide name for the top-level module or namespace"
+  option :library_path, aliases: '-L', banner: 'DIRECTORY', desc: "Load all libraries from DIRECTORY"
+  option :exclude, repeatable: true, banner: 'PATTERN', desc: "Exclude symbols matching the glob PATTERN"
+  option :exclude_from, repeatable: true, banner: 'FILE', desc: "Read exclude patterns from FILE"
+  option :disable, repeatable: true, banner: 'PATTERN', desc: "Disable symbols matching the glob PATTERN"
+  option :disable_from, repeatable: true, banner: 'FILE', desc: "Read disable patterns from FILE"
+  def export(pattern, *patterns)
+    patterns.prepend(pattern)
+    symbol_kind = self.options[:type] ? self.options[:type].to_sym : nil
+
+    format = (self.options[:format] || 'yaml').to_sym
+
+    excludes = []
+    (self.options[:exclude] || []).each do |symbol|
+      excludes += symbol.include?(',') ? symbol.split(',') : [symbol]
+    end
+    (self.options[:exclude_from] || []).map do |exclude_path|
+      exclude_path = Pathname(exclude_path)
+      raise Errno::ENOENT, exclude_path.to_s unless exclude_path.exist?
+      exclude_path.each_line { |line| excludes << line.chomp }
+    end
+    excludes.sort!.uniq!
+    excludes.map! do |exclude_pattern|
+      FFIDB::Glob.new(exclude_pattern, ignore_case: false, match_substring: false)
+    end
+
+    disables = []
+    (self.options[:disable] || []).each do |symbol|
+      disables += symbol.include?(',') ? symbol.split(',') : [symbol]
+    end
+    (self.options[:disable_from] || []).map do |disable_path|
+      disable_path = Pathname(disable_path)
+      raise Errno::ENOENT, disable_path.to_s unless disable_path.exist?
+      disable_path.each_line { |line| disables << line.chomp }
+    end
+    disables.sort!.uniq!
+    disables.map! do |disable_pattern|
+      FFIDB::Glob.new(disable_pattern, ignore_case: false, match_substring: false)
+    end
+
+    self.check_registry_exists!
+    FFIDB::Registry.open do |registry|
+      exports = []
+      patterns.each do |pattern|
+        if library = registry.open_library(pattern)
+          library.each_symbol do |symbol|
+            next if symbol_kind && symbol_kind != symbol.kind
+            exports << [library, symbol.kind_weight, symbol] unless excludes.any? { |x| x === symbol.name }
+          end
+        else
+          matcher = FFIDB::Glob.new(pattern, ignore_case: true, match_substring: false)
+          registry.find_symbols(matcher) do |symbol, library|
+            next if symbol_kind && symbol_kind != symbol.kind
+            exports << [library, symbol.kind_weight, symbol] unless excludes.any? { |x| x === symbol.name }
+          end
+        end
+      end
+
+      FFIDB::Exporter.for(format).new(**options).emit do |export|
+        prev_library = nil
+        exports.sort!.uniq.each do |library, _, symbol|
+          if library != prev_library
+            export.finish_library if prev_library
+            export.begin_library(library)
+            prev_library = library
+          end
+          disabled = disables.any? { |pattern| pattern === symbol.name }
+          export.export_symbol(symbol, disabled: disabled)
+        end
+        export.finish_library if prev_library
+      end
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "init", "Initialize the registry (at: ~/.ffidb)"
+  long_desc <<~EOS
+    Initializes the local FFIDB registry, a prerequisite for using FFIDB.
+
+    Your local FFIDB registry is located at $HOME/.ffidb (#{FFIDB::Registry.default_path}).
+
+    This command is equivalent to:
+
+      $ git clone --depth=1 #{FFIDB::Registry::GIT_HTTPS_URL} $HOME/.ffidb
+  EOS
+  def init
+    registry_path = FFIDB::Registry.default_path
+    if registry_path.exist?
+      error = "The registry at #{registry_path} has already been initialized."
+      warn "#{$0}: #{set_color(error, :yellow)}" if verbose?
+      return
+    end
+    git_command = %Q(git clone --depth=1 #{FFIDB::Registry::GIT_HTTPS_URL} #{registry_path})
+    system git_command # TODO: improve this
+    if $?.exitstatus.nonzero?
+      error = "Failed to execute `#{git_command}`: exit code #{$?.exitstatus}."
+      warn "#{$0}: #{set_color(error, :red)}"
+      exit $?.exitstatus
+    end
+    Dir.chdir registry_path
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "list [LIBRARY]", "List FFI libraries and symbols"
+  long_desc <<~EOS
+    Lists libraries with their FFI symbols (such as functions).
+
+    For example:
+
+      $ ffidb list lua
+  EOS
+  option :type, aliases: '-t', default: nil, desc: "Specify the symbol TYPE (enum/struct/function)"
+  def list(library_name = nil)
+    symbol_kind = self.options[:type] ? self.options[:type].to_sym : nil
+    self.check_registry_exists!
+    FFIDB::Registry.open do |registry|
+      registry.each_library do |library|
+        next if library_name && library_name != library.name
+        p library if debug?
+        library.each_symbol do |symbol|
+          next if symbol_kind && symbol_kind != symbol.kind
+          p symbol if debug?
+          print "#{library.name}"
+          print verbose? ? "@#{library.version}" : '' # TODO: resolve stable symlinks
+          print "\t#{symbol.name}"
+          if verbose?
+            print "\t#{symbol.kind}"
+            print "\t\t// #{symbol.definition.to_s}" if symbol.function?
+          end
+          puts
+        end
+      end
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "parse HEADER...", "Parse .h header files"
+  long_desc <<~EOS
+    Parses .h header files, outputting YAML using the FFIDB schema.
+
+    Note: parsing requires installation of the 'ffi-clang' library:
+
+      $ gem install ffi-clang
+  EOS
+  option :config, aliases: '-C', banner: 'FILE', desc: "Use a library.yaml configuration FILE"
+  option :define, aliases: '-D', repeatable: true, banner: 'VAR[=VAL]', desc: "Define VAR as a preprocessor symbol"
+  option :include, aliases: '-I', repeatable: true, banner: 'DIRECTORY', desc: "Add DIRECTORY to the headers search path"
+  option :format, aliases: '-f', default: nil, desc: "Specify the output FORMAT (default: yaml)"
+  def parse(path, *paths)
+    base_directory = nil
+    paths.prepend(path)
+    paths = paths.inject([]) do |paths, path|
+      path = Pathname(path)
+      case
+        when !path.exist?
+          raise "Path does not exist: #{path}"
+        when path.directory?
+          base_directory = path if base_directory.nil?
+          paths.concat(Dir["#{path}/**/*.h"].sort.map { |p| Pathname(p) })
+        else paths << path
+      end
+    end
+    base_directory = paths.first.dirname if base_directory.nil?
+
+    begin
+      $VERBOSE = nil # suppress deprecation warnings from ffi-clang
+      require 'ffi/clang' # https://rubygems.org/gems/ffi-clang
+      $VERBOSE = false
+    rescue LoadError => error
+      raise error if debug?
+      warn "#{$0}: #{set_color(error, :red)}"
+      exit EX_UNAVAILABLE
+    end
+
+    FFIDB::HeaderParser.new(base_directory: base_directory, debug: verbose? || debug?).tap do |parser|
+      # Parse a library.yaml configuration file, if given:
+      library = nil
+      if config_path = self.options[:config]
+        config_path = Pathname(config_path)
+        raise Errno::ENOENT, config_path.to_s unless config_path.exist?
+        config = YAML.load(config_path.read).transform_keys(&:to_sym)
+        (config[:configure] || []).each do |var_and_val|
+          parser.parse_macro! var_and_val
+        end
+        (config[:exclude] || []).each do |symbol|
+          parser.exclude_symbols[symbol] = true
+        end
+        (config[:include] || []).each do |symbol|
+          parser.include_symbols[symbol] = true
+        end
+      end
+
+      # Parse and define all specified -D preprocessor symbols:
+      (self.options[:define] || []).each do |var_and_val|
+        parser.parse_macro! var_and_val
+      end
+
+      # Add all specified -I directories to the headers search path:
+      (self.options[:include] || []).each do |dir_path|
+        parser.add_include_path! Pathname(dir_path).expand_path
+      end
+
+      FFIDB::Exporter.for(self.options[:format] || :yaml).new(**options).emit do |export|
+        export.begin_library(library)
+        paths.each do |path|
+          header = parser.parse_header(path) do |exception|
+            case exception
+              when FFIDB::ParseError
+                warn "#{$0}: #{set_color(exception.to_s, :red)}" unless quiet?
+              when FFIDB::ParseWarning
+                warn "#{$0}: #{set_color(exception.to_s, :yellow)}" if verbose?
+              else raise exception
+            end
+          end
+          export.export_header(header)
+        end
+        export.finish_library
+      end
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "search PATTERN", "Search for FFI symbols using a glob pattern"
+  long_desc <<~EOS
+    Searches for FFI symbols (for example, functions) using a glob pattern.
+
+    For example:
+
+      $ ffidb search sqlite3_*_blob
+  EOS
+  option :type, aliases: '-t', default: nil, desc: "Specify the symbol TYPE (enum/struct/function)"
+  def search(pattern)
+    symbol_kind = self.options[:type] ? self.options[:type].to_sym : nil
+    matcher = FFIDB::Glob.new(pattern, ignore_case: true, match_substring: true)
+    p self.options, matcher if debug?
+    self.check_registry_exists!
+    FFIDB::Registry.open do |registry|
+      registry.find_symbols(matcher, kind: symbol_kind) do |symbol, library|
+        puts "#{library.name}\t#{symbol.name}" # TODO: improve formatting
+      end
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "show SYMBOL", "Show FFI symbol information"
+  long_desc <<~EOS
+    Shows information about an FFI symbol (for example, a function).
+
+    For example:
+
+      $ ffidb show lua_callk
+  EOS
+  option :type, aliases: '-t', default: nil, desc: "Specify the symbol TYPE (enum/struct/function)"
+  def show(symbol_name)
+    symbol_kind = self.options[:type] ? self.options[:type].to_sym : nil
+    p self.options, symbol_name if debug?
+    self.check_registry_exists!
+    FFIDB::Registry.open do |registry|
+      found = registry.find_symbols(symbol_name, kind: symbol_kind) do |symbol, library|
+        puts symbol.to_yaml
+        puts
+      end
+      raise FFIDB::SymbolNotFound.new(symbol_kind || :symbol, symbol_name) unless found
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  desc "update", "Fetch updates to the registry (at: ~/.ffidb)"
+  long_desc <<~EOS
+    Updates the local FFIDB registry, pulling updates from GitHub.
+
+    Your local FFIDB registry is located at $HOME/.ffidb (#{FFIDB::Registry.default_path}).
+
+    This command is equivalent to:
+
+      $ cd $HOME/.ffidb && git pull
+  EOS
+  def update
+    registry_path = self.check_registry_exists!
+    Dir.chdir registry_path
+    git_command = %Q(git pull)
+    system git_command # TODO: improve this
+    if $?.exitstatus.nonzero?
+      error = "Failed to execute `#{git_command}` in #{registry_path}: exit code #{$?.exitstatus}."
+      warn "#{$0}: #{set_color(error, :red)}"
+      exit $?.exitstatus
+    end
+  rescue => error
+    raise error if debug?
+    warn "#{$0}: #{set_color(error, :red)}"
+    exit error.respond_to?(:exit_code) ? error.exit_code : EX_SOFTWARE
+  end
+
+  protected
+
+  def check_registry_exists!
+    registry_path = FFIDB::Registry.default_path
+    raise FFIDB::RegistryError, "Registry at #{registry_path} not initialized (run `#{$0} init` first?)" unless registry_path.exist?
+    registry_path
+  end
+
+  def debug?() self.options[:debug] end
+  def verbose?() self.options[:verbose] || self.debug? end
+  def quiet?() self.options[:quiet] end
+end # CLI
+
+# Fix for https://github.com/erikhuda/thor/issues/398
+class Thor::Shell::Basic
+  def print_wrapped(message, options = {})
+    indent = (options[:indent] || 0).to_i
+    if indent.zero?
+      self.stdout.puts message
+    else
+      message.each_line do |message_line|
+        self.stdout.print ' ' * indent
+        self.stdout.puts message_line.chomp
+      end
+    end
+  end
+end # Thor::Shell::Basic
+
+CLI.start(ARGV)