show_rdoc_docu 0.0.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: db1c50ac59076f567439b3263d6bca31761e94c4fa3b64f4de149be65ded70bd
+  data.tar.gz: 82b48406bbf1d66f7ae2c484b4b5fdf8f9b2983691ef69d9a884215bc6de9dff
+SHA512:
+  metadata.gz: 623350e000477c71e7de99fb812a7e0dd093ab3dd909b056a72c0a68f58bfec62ce52a591b29ee2f77f69de78778dc36501c521d5223cfa1009631b0ff150303
+  data.tar.gz: 7fdee4413eed0deb6458f20665641f4c79c337f51f9ccf131ac61e31a127beaf57e94eb954ff8396e3f7b60fdcfccd7c6430289b284d6b180819bf7172335abf

data/lib/show_rdoc_docu/show_rdoc_docu.rb

@@ -0,0 +1,132 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+# === ShowRdocDocu
+#
+# Use this class to show rdoc documentation.
+#
+# It will be stored in @result.
+#
+# Usage example:
+#   require 'show_rdoc_docu'
+#   ShowRdocDocu.new
+# =========================================================================== #
+# require 'show_rdoc_docu'
+# =========================================================================== #
+require 'rdoc'
+require 'stringio'
+begin
+  require 'colours'
+rescue LoadError; end
+require 'opn'
+require 'show_rdoc_docu/version/version.rb'
+
+class ShowRdocDocu # === ShowRdocDocu.new
+
+  include Colours
+
+  attr_writer :result
+
+  # ========================================================================= #
+  # === initialize
+  # ========================================================================= #
+  def initialize(
+      i           = nil,
+      format_type = '--format=markdown',
+      run_already = true
+    )
+    reset
+    set_input(i)
+    @format_type = format_type # << '--format=ansi' # => ["-T", "--format=ansi"]
+    run if run_already
+  end
+
+  # ========================================================================= #
+  # === reset                                                     (reset tag)
+  # ========================================================================= #
+  def reset
+    @found_a_result = true
+    @be_verbose     = true
+  end
+
+  # ========================================================================= #
+  # === be_verbose?
+  # ========================================================================= #
+  def be_verbose?
+    @be_verbose
+  end
+
+  # ========================================================================= #
+  # === found_a_result?
+  # ========================================================================= #
+  def found_a_result?
+    @found_a_result
+  end; alias found_result? found_a_result? # === found_result?
+
+  # ========================================================================= #
+  # === set_input
+  # ========================================================================= #
+  def set_input(i = nil)
+    i = 'Array#push' if i.nil?
+    i = 'Array#push' if i.empty?
+    i = i.first if i.is_a? Array
+    @input = i
+  end
+
+  # ========================================================================= #
+  # === restore_stdout
+  # ========================================================================= #
+  def restore_stdout
+    $stdout = STDOUT
+  end
+
+  # ========================================================================= #
+  # === show_result
+  #
+  # Simply output the result.
+  # ========================================================================= #
+  def show_result
+    e result # This is the string output.
+  end; alias report        show_result # === report
+       alias report_result show_result # === report_result
+
+  # ========================================================================= #
+  # === result?
+  # ========================================================================= #
+  def result?
+    @result
+  end; alias result result? # === result
+
+  # ========================================================================= #
+  # === run
+  # ========================================================================= #
+  def run # (run tag)
+    _ = %w( -T )
+    _ << @format_type
+    # ======================================================================= #
+    # Next we delegate into RDoc::RI::Driver.process_args 
+    # ======================================================================= #
+    hash = RDoc::RI::Driver.process_args(_) # This hash can be passed to Driver.new
+    rdoc_driver = RDoc::RI::Driver.new(hash)
+    rdoc_driver.use_stdout = true
+    @result = ''.dup # We push the output into this instance variable.
+    $stdout = StringIO.new(@result) # Snatch all std-output.
+    begin # Must rescue here.
+      # @input is a String such as: "String#[]"
+      rdoc_driver.display_method(@input) # This will return a Fixnum.
+    rescue RDoc::RI::Driver::NotFoundError
+      if be_verbose?
+        opn; e 'We did not find anything about `'+simp(@input)+'`.'
+      end
+      @found_a_result = false
+    end
+    restore_stdout # And restore stdout again.
+  end
+
+end
+
+if __FILE__ == $PROGRAM_NAME
+  _ = ShowRdocDocu.new(ARGV)
+  _.show_result
+end # show_rdoc_docu String#new

data/lib/show_rdoc_docu/version/version.rb

@@ -0,0 +1,14 @@
+#!/System/Index/bin/ruby -w
+# Encoding: ISO-8859-1
+# frozen_string_literal: true
+# =========================================================================== #
+# require 'show_rdoc_docu/version/version.rb'
+# =========================================================================== #
+class ShowRdocDocu
+
+  # ========================================================================= #
+  # === VERSION
+  # ========================================================================= #
+  VERSION = '0.0.8'
+
+end

data/lib/show_rdoc_docu.rb

@@ -0,0 +1 @@
+require 'show_rdoc_docu/show_rdoc_docu.rb'

data/show_rdoc_docu.gemspec

@@ -0,0 +1,51 @@
+# =========================================================================== #
+# Gemspec for Project ShowRdocDocu.
+# =========================================================================== #
+require 'show_rdoc_docu'
+
+Gem::Specification.new { |s|
+
+  s.name    = 'show_rdoc_docu'
+  s.version = ShowRdocDocu::VERSION
+  s.date    = Time.now.strftime('%Y-%m-%d')
+
+  s.summary = <<-EOF
+
+    If you have specific suggestions to make this gem more
+    useful for others, please drop me an email at:
+
+      shevegen@gmail.com
+
+    Thank you.
+
+  EOF
+
+  s.description = <<-EOF
+
+    This library is called show_rdoc_docu.
+
+  EOF
+
+  s.extra_rdoc_files = %w()
+  
+  s.authors     = ['Robert A. Heiler']
+  s.email       = 'shevegen@gmail.com'
+  s.files       = Dir['**/*']
+  # s.files      << 'README.md'
+  if File.exist? 'USAGE.md'
+    s.files      << 'USAGE.md'
+  end
+  s.license     = 'GPL-2.0'
+  s.homepage    = 'https://github.com/shevegen/show_rdoc_docu'
+
+  s.required_ruby_version     = '>= '+RUBY_VERSION
+  s.required_rubygems_version = '>= '+Gem::VERSION
+  s.rubygems_version          = '>= '+Gem::VERSION
+
+  # ========================================================================= #
+  # Dependencies for the project:
+  # ========================================================================= #
+  s.add_dependency 'colours'
+  s.add_dependency 'opn'
+
+}

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: show_rdoc_docu
+version: !ruby/object:Gem::Version
+  version: 0.0.8
+platform: ruby
+authors:
+- Robert A. Heiler
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: colours
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: opn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |2+
+
+      This library is called show_rdoc_docu.
+
+email: shevegen@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/show_rdoc_docu.rb
+- lib/show_rdoc_docu/show_rdoc_docu.rb
+- lib/show_rdoc_docu/version/version.rb
+- show_rdoc_docu.gemspec
+homepage: https://github.com/shevegen/show_rdoc_docu
+licenses:
+- GPL-2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.3
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: 'If you have specific suggestions to make this gem more useful for others,
+  please drop me an email at:  shevegen@gmail.com  Thank you.'
+test_files: []