console_runner 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f8075476480adc8aea5a9508dca384fa66508a22
+  data.tar.gz: f58b9bedc8621e0ff85b83e918b3f64c2d8cb852
+SHA512:
+  metadata.gz: a717dc7f2387a0549d984d571a9cedaa1eb2f45f1e4575ff639d3d7e61ca55ee8cc3aeca2e55478d69ad4d308d54c94bded243bae7d781bc6a5baa2270d0fa29
+  data.tar.gz: 162a8c1b729c4eb5c833cdcc1efee701d597ec8879875adc0f05f105f01d52faf6188aad67d739c4a491718e415262f64e73d118e39084f8782866a4067b3c58

data/.coveralls.yml

@@ -0,0 +1 @@
+repo_token: Zt5KZXhBj3awn9OS5Hy6pDuVEGSrWWSjT

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/vendor/
+/.idea/
+*.gem

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.2.5
+before_install: gem install bundler -v 1.13.6

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in console_runner.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Yury Karpovich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,58 @@
+# ConsoleRunner
+[![Gem Version][GV img]][Gem Version]
+[![Build Status][BS img]][Build Status]
+[![Dependency Status][DS img]][Dependency Status]
+[![Code Climate][CC img]][Code Climate]
+[![Coverage Status][CS img]][Coverage Status]
+
+This gem provides you an ability to run any Ruby method from command-line (no any code modifications required!!!).
+One thing you need to do is to add an [YARD](http://yardoc.org/) tag annotation `@runnable`.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'console_runner'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install console_runner
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/yuri-karpovich/console_runner.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+
+
+[Gem Version]: https://rubygems.org/gems/console_runner
+[Build Status]: https://travis-ci.org/yuri-karpovich/console_runner
+[travis pull requests]: https://travis-ci.org/yuri-karpovich/console_runner/pull_requests
+[Dependency Status]: https://gemnasium.com/github.com/yuri-karpovich/console_runner
+[Code Climate]: https://codeclimate.com/github/yuri-karpovich/console_runner
+[Coverage Status]: https://coveralls.io/github/yuri-karpovich/console_runner
+
+[GV img]: https://badge.fury.io/rb/console_runner.png
+[BS img]: https://travis-ci.org/yuri-karpovich/console_runner.svg?branch=master
+[DS img]: https://gemnasium.com/badges/github.com/yuri-karpovich/console_runner.svg
+[CC img]: https://codeclimate.com/github/yuri-karpovich/console_runner.png
+[CS img]: https://coveralls.io/repos/github/yuri-karpovich/console_runner/badge.svg

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList['test/**/*_test.rb']
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "console_runner"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/console_runner.gemspec

@@ -0,0 +1,44 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'console_runner/version'
+
+Gem::Specification.new do |spec|
+  spec.name    = 'console_runner'
+  spec.version = ConsoleRunner::VERSION
+  spec.authors = ['Yury Karpovich']
+  spec.email   = %w(spoonest@gmail.com yuri.karpovich@gmail.com)
+
+  spec.summary     = 'Command-line runner for ruby code.'
+  spec.description = 'This gem provides you an ability to run any Ruby method ' \
+    'from command-line (no any code modifications required!!!)'
+  spec.homepage    = 'https://github.com/yuri-karpovich/console_runner'
+  spec.license     = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against ' \
+      'public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = ['c_run']
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.13'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'coveralls', '~> 0.8'
+  spec.add_dependency 'trollop', '~> 2.1'
+  spec.add_dependency 'yard', '~> 0.9'
+  spec.add_dependency 'colorize', '~> 0.8'
+end

data/exe/c_run

@@ -0,0 +1,86 @@
+# #!/usr/bin/env ruby
+# require 'trollop'
+#
+#
+# lib = File.expand_path(File.dirname(__FILE__) + '/../lib')
+# $LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+# require '../lib/file_parser'
+# require '../lib/cmd_parser'
+# require '../lib/runner'
+#
+# file_path         = ENV['DEBUG_FILE']
+# file_path       ||= File.realpath ARGV.shift
+# file_parser       = FileParser.new(file_path)
+#
+#
+# runnable_classes  = file_parser.list_classes(:runnable)
+# raise "One runnable Class should be specified in file.
+# Runnable class should be marked with @#{FileParser::RUNNABLE_TAG.to_s} tag" if runnable_classes.count != 1
+#
+# clazz             = runnable_classes.first
+# all_methods       = file_parser.list_methods(:all, clazz)
+# runnable_methods  = file_parser.list_methods(:runnable, clazz)
+# initialize_method = all_methods.find{|m| m.name == :initialize}
+# run_method        = all_methods.find{|m| m.name == :run}
+#
+#
+# cmd_parser = CmdParser.new(runnable_methods, initialize_method)
+# cmd = ARGV[0]
+# action_method = runnable_methods.find { |m| m.name.to_s ==  cmd } # get the subcommand
+# action_method ||= run_method
+# cmd_parser.parse_method  action_method
+# raise "Cannot run #{cmd} command because method is nil" unless action_method
+#
+#
+# puts "======================================================="
+# puts "Global options:"
+# puts cmd_parser.global_opts.map{|k,v| "     #{k} = #{v}" }.join("\n")
+# if initialize_method
+# puts "INIT: #{initialize_method.name}"
+# puts "INIT options:"
+# puts cmd_parser.init_method.cmd_opts.map{|k,v| "     #{k} = #{v}" }.join("\n")
+# end
+# puts "Subcommand: #{action_method.name}"
+# puts "Subcommand options:"
+# puts cmd_parser.method.cmd_opts.map{|k,v| "     #{k} = #{v}" }.join("\n")
+# puts "Remaining arguments: #{ARGV.inspect}" if ARGV != []
+# puts "======================================================="
+#
+#
+# Runner.run{
+#   require file_path
+#   class_full_name = clazz.title
+#   raise "#{class_full_name} is not defined" unless Module.const_defined?(class_full_name)
+#   klass_obj = Module.const_get(class_full_name)
+#   method_type = action_method.scope
+#   method_params = cmd_parser.method.params_array
+#
+#   case method_type
+#     when :class
+#       klass_obj.send(action_method.name, *method_params)
+#     when :instance
+#       init_params = cmd_parser.init_method.params_array
+#       # TODO catch errors
+#       obj = klass_obj.new(*init_params)
+#       obj.send(action_method.name, *method_params)
+#     else
+#       raise "Unknown method type: #{method_type}"
+#   end
+#
+# }
+#
+#
+#
+#
+#
+#
+#
+#
+#
+#
+# # raise "#{clazz.name}#initialize method should be specified" unless initialize_method
+# #
+# # raise "At least one method should be marked with @#{FileParser::RUNNABLE_TAG.to_s} tag.
+# # Also you may specify #run method and it will be executed by default.
+# # #run method don't need any code annotations as well." if runnable_methods.count == 0 unless run_method
+#

data/exe/c_run.rb

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require_relative '../test/simple_cov' if ENV['C_RUNNER_SCOV'].to_s == 'true'
+
+lib = File.expand_path('../../lib', __FILE__)
+$LOAD_PATH.unshift(lib) if File.directory?(lib) && !$LOAD_PATH.include?(lib)
+require 'console_runner'

data/lib/cmd_parser.rb

@@ -0,0 +1,223 @@
+require 'trollop'
+
+# Parses command line
+class CmdParser
+
+  # Parses method code
+  class ParsedMethod
+    attr_reader :method, :name, :param_tags, :option_tags
+    attr_accessor :cmd_opts
+
+    def initialize(method)
+      @method      = method
+      @name        = @method.name
+      @parameters  = @method.parameters
+      @param_tags  = FileParser.select_param_tags @method
+      @option_tags = FileParser.select_option_tags @method
+      @cmd_opts    = nil
+    end
+
+    def params_array
+      expected_params = @parameters.map(&:first).map.with_index { |p, i| [i, p] }.to_h
+      options_groups  = {}
+      get_params      = {}
+
+      expected_params.each do |index, name|
+        if options_group?(name)
+          options_groups[index] = name
+          get_params[index]     = option_as_hash(name)
+        else
+          get_params[index] = @cmd_opts[name.to_sym]
+        end
+      end
+      get_params = get_params.to_a.sort_by { |a| a[0] }.reverse
+
+      stop_delete = false
+      get_params.delete_if do |a|
+        index  = a[0]
+        value  = a[1]
+        result = false
+
+        if options_groups[index]
+          result = value == {}
+        else
+          result = value == nil
+        end
+        stop_delete = true unless result
+        next if stop_delete
+        result
+      end
+
+      get_params.sort_by { |a| a[0] }.map { |a| a[1] }
+    end
+
+    def param_tags_names
+      param_tags.map { |t| t.name }
+    end
+
+    def option_tags_names
+      option_tags.map { |t| t.pair.name.gsub(':', '') }
+    end
+
+    def options_group?(param_name)
+      option_tags.any? { |t| t.name == param_name }
+    end
+
+    def default_params
+      @parameters.map do |array|
+        array.map do |a|
+          if a
+            ['"', "'"].include?(a[0]) && ['"', "'"].include?(a[-1]) ? a[1..-2] : a
+          else
+            a
+          end
+        end
+      end.to_h
+    end
+
+    private
+
+    def option_as_hash(options_group_name)
+      result = {}
+      option_tags.select { |t| t.name == options_group_name }.each do |t|
+        option_name         = t.pair.name.gsub(':', '')
+        option_value        = @cmd_opts[option_name.to_sym]
+        result[option_name] = option_value if option_value
+      end
+      result
+    end
+  end
+
+  attr_reader :global_opts, :method, :init_method
+
+  # Should be executed before ARGV.shift
+  def initialize(runnable_methods, init_method= nil)
+    clazz        = runnable_methods.first.parent
+    sub_commands = runnable_methods.map { |m| m.name.to_s }
+    @parser      = Trollop::Parser.new
+    @parser.banner(FileParser.select_runnable_tags(clazz).map { |t| (t.text + "\n") }.join("\n"))
+    @parser.stop_on sub_commands
+
+    if init_method
+      @init_method = ParsedMethod.new init_method
+      same_methods = @init_method.param_tags_names & @init_method.option_tags_names
+      raise "You have the same name for @param and @option attribute(s): #{same_methods.join(', ')}.
+Use different names to `console_runner` be able to run #{@init_method.name} method." if same_methods.count > 0
+
+
+      @init_method.param_tags.each do |tag|
+        tag_name = tag.name
+        tag_text = tag.text
+        tag_type = tag.type
+        if tag_type == "Hash"
+          options = option_tags.select { |t| t.name == tag.name }
+          if options.count > 0
+            options.each do |option|
+              option_name = option.pair.name.gsub(':', '')
+              option_text = option.pair.text
+              option_type = option.pair.type
+              @parser.opt(option_name.to_sym, "(Ruby class: #{option_type}) " + option_text.to_s, type: CmdParser.parse_type(option_type))
+            end
+          else
+            @parser.opt(tag_name.to_sym, "(Ruby class: #{tag_type}) " + tag_text.to_s, type: CmdParser.parse_type(tag_type))
+          end
+        else
+          @parser.opt(tag_name.to_sym, "(Ruby class: #{tag_type}) " + tag_text.to_s, type: CmdParser.parse_type(tag_type))
+        end
+      end
+    end
+
+    @global_opts = Trollop::with_standard_exception_handling(@parser) do
+      begin
+        @parser.parse ARGV
+      rescue Trollop::CommandlineError => e
+        raise "You must provide one of available actions: #{sub_commands.join ', '}" unless sub_commands.include?(ARGV[0])
+        raise e
+      end
+    end
+
+    if @init_method
+      given_attrs           = @global_opts.keys.select { |k| k.to_s.include? '_given' }.map { |k| k.to_s.gsub('_given', '').to_sym }
+      @init_method.cmd_opts = @global_opts.select { |k, v| given_attrs.include? k }
+    end
+  end
+
+
+  def parse_method(method)
+    ARGV.shift
+    @method      = ParsedMethod.new method
+    same_methods = @method.param_tags_names & @method.option_tags_names
+    raise "You have the same name for @param and @option attribute(s): #{same_methods.join(', ')}.
+Use different names to `console_runner` be able to run #{@method.name} method." if same_methods.count > 0
+    method_params_tags = @method.param_tags
+
+    method_params_tags.each do |tag|
+      tag_name = tag.name
+      tag_text = tag.text
+      tag_type = tag.type
+      if tag_type == "Hash"
+        options = @method.option_tags.select { |t| t.name == tag.name }
+        if options.count > 0
+          options.each do |option|
+            option_name = option.pair.name.gsub(':', '')
+            option_text = option.pair.text
+            option_type = option.pair.type
+            @parser.opt(option_name.to_sym, "(Ruby class: #{option_type}) " + option_text.to_s, type: CmdParser.parse_type(option_type))
+          end
+        else
+          @parser.opt(tag_name.to_sym, "(Ruby class: #{tag_type}) " + tag_text.to_s, type: CmdParser.parse_type(tag_type))
+        end
+      else
+        @parser.opt(tag_name.to_sym, "(Ruby class: #{tag_type}) " + tag_text.to_s, type: CmdParser.parse_type(tag_type))
+      end
+    end
+    cmd_opts         = Trollop::with_standard_exception_handling @parser do
+      unless method_params_tags.count.zero?
+        raise Trollop::HelpNeeded if ARGV.empty?
+      end
+      # show help screen
+      @parser.parse ARGV
+    end
+    given_attrs      = cmd_opts.keys.select { |k| k.to_s.include? '_given' }.map { |k| k.to_s.gsub('_given', '').to_sym }
+    @method.cmd_opts = cmd_opts.select { |k, v| given_attrs.include? k }
+    @method.default_params.each do |k, v|
+      @method.cmd_opts[k.to_sym] ||= v
+    end
+
+    method_params_tags.select { |t| t.tag_name == 'param' }.map(&:name).each do |required_param|
+      next if @method.options_group? required_param
+      unless @method.cmd_opts[required_param.to_sym]
+        raise "You must specify required parameter: #{required_param}"
+      end
+    end
+  end
+
+  def self.parse_type(yard_type)
+    case yard_type
+      when 'String'
+        :string
+      when 'Integer'
+        :int
+      when 'Fixnum'
+        :int
+      when 'Float'
+        :float
+      when 'Boolean'
+        :boolean
+      when 'Array(String)'
+        :strings
+      when 'Array(Integer)'
+        :ints
+      when 'Array(Fixnum)'
+        :ints
+      when 'Array(Float)'
+        :floats
+      when 'Array(Boolean)'
+        :booleans
+      else
+        raise "Unsupported YARD type: #{yard_type}"
+    end
+  end
+
+end
+

data/lib/console_runner.rb

@@ -0,0 +1,79 @@
+module ConsoleRunner
+
+  require 'file_parser'
+  require 'cmd_parser'
+  require 'runner'
+
+  file_from_arg = ARGV.shift
+  raise ConsoleRunnerError, 'Specify file to be executed' unless file_from_arg
+  file_path ||= File.realpath file_from_arg
+  raise ConsoleRunnerError, "File doesn't exist: #{file_path}" unless File.exist? file_path
+  file_parser = FileParser.new(file_path)
+
+
+  runnable_classes = file_parser.list_classes(:runnable)
+  if runnable_classes.count != 1
+    raise ConsoleRunnerError, "One runnable Class should be specified in file.
+Runnable class should be marked with @#{FileParser::RUNNABLE_TAG} tag"
+  end
+
+  clazz             = runnable_classes.first
+  all_methods       = file_parser.list_methods(:all, clazz)
+  runnable_methods  = file_parser.list_methods(:runnable, clazz)
+  initialize_method = all_methods.find { |m| m.name == :initialize }
+  run_method        = all_methods.find { |m| m.name == :run }
+
+
+  cmd           = ARGV[0]
+  action_method = runnable_methods.find { |m| m.name.to_s == cmd } # get sub-command
+  action_method ||= run_method
+  cmd_parser    = CmdParser.new(runnable_methods, initialize_method)
+  raise ConsoleRunnerError, "Cannot run! You haven't specify any method to run." unless action_method
+  cmd_parser.parse_method action_method
+
+
+  puts '======================================================='
+  puts 'Global options:'
+  puts cmd_parser.global_opts.map { |k, v| "     #{k} = #{v}" }.join("\n")
+  if initialize_method
+    puts "INIT: #{initialize_method.name}"
+    puts 'INIT options:'
+    puts cmd_parser.init_method.cmd_opts.map { |k, v| "     #{k} = #{v}" }.join("\n")
+  end
+  puts "Subcommand: #{action_method.name}"
+  puts 'Subcommand options:'
+  puts cmd_parser.method.cmd_opts.map { |k, v| "     #{k} = #{v}" }.join("\n")
+  puts "Remaining arguments: #{ARGV.inspect}" if ARGV != []
+  puts '======================================================='
+
+
+  Runner.run {
+    require file_path
+    class_full_name = clazz.title
+    raise ConsoleRunnerError, "#{class_full_name} is not defined" unless Module.const_defined?(class_full_name)
+    klass_obj     = Module.const_get(class_full_name)
+    method_type   = action_method.scope
+    method_params = cmd_parser.method.params_array
+
+    case method_type
+      when :class
+        klass_obj.send(action_method.name, *method_params)
+      when :instance
+        init_params = cmd_parser.init_method.params_array
+        # TODO catch errors
+        obj         = klass_obj.new(*init_params)
+        obj.send(action_method.name, *method_params)
+      else
+        raise ConsoleRunnerError, "Unknown method type: #{method_type}"
+    end
+
+  }
+
+
+# raise ConsoleRunnerError, "#{clazz.name}#initialize method should be specified" unless initialize_method
+#
+# raise ConsoleRunnerError, "At least one method should be marked with @#{FileParser::RUNNABLE_TAG.to_s} tag.
+# Also you may specify #run method and it will be executed by default.
+# #run method don't need any code annotations as well." if runnable_methods.count == 0 unless run_method
+
+end

data/lib/console_runner/version.rb

@@ -0,0 +1,3 @@
+module ConsoleRunner
+  VERSION = "0.1.1"
+end

data/lib/console_runner_error.rb

@@ -0,0 +1 @@
+class ConsoleRunnerError < Exception; end

data/lib/file_parser.rb

@@ -0,0 +1,88 @@
+require 'yard'
+require 'console_runner/version'
+require 'console_runner_error'
+
+# Parses code in a file
+class FileParser
+  attr_reader :all_objects
+
+  RUNNABLE_TAG = :runnable
+
+  # Parse file with #YARD::CLI::Stats
+  #
+  # @param [String] file_path path to the file to be parsed,
+  # @return[Array]
+  def initialize(file_path)
+    raise ConsoleRunnerError "Cannot find file #{file_path}" unless File.exist?(file_path)
+    code = YARD::CLI::Stats.new
+    code.run(file_path)
+    @all_objects = code.all_objects
+  end
+
+
+  # List methods
+  # @param [Symbol] scope :all - list all methods, :runnable - list only runnable methods
+  # @param [YARD::CodeObjects::ClassObject, nil] clazz list methods of specified class only
+  def list_methods(scope= :all, clazz = nil)
+    all_methods       = @all_objects.select { |o| o.type == :method }
+    all_class_methods = []
+    all_class_methods = clazz.children.select { |m| m.class == YARD::CodeObjects::MethodObject } if clazz
+
+    case scope
+      when :all
+        if clazz
+          all_class_methods
+        else
+          all_methods
+        end
+      when RUNNABLE_TAG
+        if clazz
+          all_class_methods.select { |m| m.has_tag? RUNNABLE_TAG }
+        else
+          all_methods.select { |m| m.has_tag? RUNNABLE_TAG }
+        end
+      else
+        raise ":key can be :all or #{RUNNABLE_TAG}"
+    end
+  end
+
+  # List classes
+  # @param [Symbol] scope :all - list all classes, :runnable - list only runnable classes
+  def list_classes(scope= :all)
+    all_classes = @all_objects.select { |o| o.type == :class }
+    case scope
+      when :all
+        all_classes
+      when RUNNABLE_TAG
+        all_classes.select { |m| m.has_tag? RUNNABLE_TAG }
+      else
+        raise ':key can be :all or :runnable'
+    end
+  end
+
+  def self.select_runnable_tags(yard_object)
+    yard_object.tags.select { |t| t.tag_name == RUNNABLE_TAG.to_s }
+  end
+
+  def self.select_option_tags(yard_object)
+    yard_object.tags.select { |t| t.tag_name == 'option' }
+  end
+
+  def self.select_param_tags(yard_object)
+    yard_object.tags.select { |t| t.tag_name == 'param' }
+  end
+
+end
+
+# YARD::Tags::Library.define_tag "Run in Console", :runnable, :with_types_and_name
+YARD::Tags::Library.define_tag 'Console Tool Description', FileParser::RUNNABLE_TAG
+
+module YARD
+  module CLI
+    class Stats < Yardoc
+      def print_statistics; end
+
+      def print_undocumented_objects; end
+    end
+  end
+end

data/lib/runner.rb

@@ -0,0 +1,21 @@
+module Runner
+
+  def self.run &block
+    start_time = Time.now
+    puts "Start Time: #{start_time}"
+    Thread.current[:id] = 'main'
+
+    yield
+
+    trap 'SIGCHLD' do
+      loop do
+        pid = Process.waitpid(-1, Process::WNOHANG) rescue nil
+        break unless pid
+      end
+    end
+
+    finish_time = Time.now
+    puts "Finish Time: #{finish_time} (Duration: #{((finish_time - start_time) / 60).round(2) } minutes)"
+  end
+
+end

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification
+name: console_runner
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Yury Karpovich
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-04-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: trollop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: This gem provides you an ability to run any Ruby method from command-line
+  (no any code modifications required!!!)
+email:
+- spoonest@gmail.com
+- yuri.karpovich@gmail.com
+executables:
+- c_run
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- console_runner.gemspec
+- exe/c_run
+- exe/c_run.rb
+- lib/cmd_parser.rb
+- lib/console_runner.rb
+- lib/console_runner/version.rb
+- lib/console_runner_error.rb
+- lib/file_parser.rb
+- lib/runner.rb
+homepage: https://github.com/yuri-karpovich/console_runner
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Command-line runner for ruby code.
+test_files: []