bri 0.4.3 → 0.4.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b20f64d2f12c1afba4d051de9aa6a091167743eefdc88410dddec663795e271f
-  data.tar.gz: 6c34a20f61319303f3877cdda56d757fc29a83ee8b89c8b2a9c4529b8f02d372
+  metadata.gz: 74b87ae62d01b5be9164734271754be0cc3a1ef68ad3b35bd78b633d829a529a
+  data.tar.gz: 27fdfe717c1cea3b49525ff5e9c59b462757d1d86db440bd4dc1fd9719f47c70
 SHA512:
-  metadata.gz: 6732a87a376c437b97f84f06617baea7b7e2f23ac208d1124adad119ff52beb65081208ec3d11a863a72718e43a5aeacb15a73fc76aad63ef0c2ab84e44e9c40
-  data.tar.gz: bc7d3406f8cca348c58f1435e88174d46f159243ff09661b9ddc0114bdc967d6954e1be263602692af4af98f24e3bf2285a8f69fb9d04311fc54f9ec7753b13b
+  metadata.gz: e0d96c3ae752ec0b5b3fb59ad58da596869fd91665282eeb588ba8c03041b3f26040f331189b9db84a6d55aaf5e5540430dddbd07c925a7dde198ed6939bc7f0
+  data.tar.gz: 4f3cc64561cb91cc53caf689611c32f6daf8d0482eb2bee3407358fad32fd808e0b70ce613c979b57917c0c2afe4b135f48f46e19de8888a167591d205aadecc

data/Changelog

@@ -1,3 +1,13 @@
+0.4.4
+  - No longer display all found class/module documentation found. If core
+  documentation is available, output only that, otherwise falls back to gem
+  documentation. To show all found documentation use the --all command line
+  paramter.
+  - Remove blank lines between list items. While these make lists with
+  multi row items more readable, they waste a lot of space for lists 
+  containing only single row items. The blank line will be reintroduced for
+  lists containing multi row elements later on.
+
 0.4.3
   - If multiple documentations are found that are all class documentations,
     display all of these. This is useful in cases that gems extend core 

data/README.rdoc

@@ -24,7 +24,14 @@ Bri is a Beautiful RI formatter.
 
 = Usage
 
- bri Array # looks up the class description of Array in the ri documentation
+ bri Array # looks up the class description of Array in the ri documentation.
+           # As of 0.4.4 this form will only output core documentation if
+           # available, falling back to gem documentation if no core
+           # documentation is found. This way you can look at the documentation
+           # of core classes that gems love to money patch without having
+           # to scroll back through your terminal.
+           # If you really want to see everything there is, use --all:
+ bri --all Array
 
  bri Array.class_method # looks up the class method of the given class
 

data/bin/bri

@@ -1,12 +1,12 @@
 #!/usr/bin/env ruby
 require 'bri'
 require 'optparse'
-require 'byebug'
 
 @options = {
   :list_classes => false,
   :list_methods => false,
-  :list_names   => false
+  :list_names   => false,
+  :show_all     => false
 }
 
 def parse_options 
@@ -24,6 +24,7 @@ def parse_options
     opts.on( nil, "--methods", "List known methods" ) { |v| @options[:list_methods] = true }
     opts.on( "-l", "--list-names", "List known namespaces/methods" ) { |v| @options[:list_names] = true }
     opts.on( "-w", "--width [COLUMNS]", "Set the output width", Integer ) { |v| Bri.width = v.to_i - 8 }
+    opts.on( "-a", "--all", "Output all documentation for the term. Prefers core documents otherwise") { |v| @options[:show_all] = true }
     opts.on_tail( "-h", "--help", "This help text" ) { puts opts; exit }
   end
   parser.parse!( ARGV )
@@ -44,5 +45,5 @@ elsif @options[:list_methods]
 elsif @options[:list_names]
   puts Bri.list_names
 else
-  puts Bri.ri( ARGV[0] )
+  puts Bri.ri( ARGV[0], show_all: @options[:show_all] )
 end

data/lib/bri.rb

@@ -11,7 +11,7 @@ require_relative 'bri/match'
 module Bri
   DEFAULT_WIDTH = 72
 
-  def self.ri( query )
+  def self.ri( query, show_all: false )
     results = Bri::Matcher.new( query ).find
 
     if results.size == 0
@@ -19,7 +19,14 @@ module Bri
     elsif results.size == 1
       results.first.to_s
     elsif results.all? { |r| r.is_a?(Bri::Match::Class) }
-      results.map(&:to_s)
+      if show_all
+        results.map(&:to_s)
+      else
+        gem_docs, core_docs = results.partition { |r| r.origin =~ %r{gem\b} }
+
+        docs_to_output = core_docs.empty? ? gem_docs : core_docs
+        docs_to_output.map(&:to_s)
+      end
     else
       qualified_methods = results.map(&:full_name).sort
       ERB.new( Bri::Templates::MULTIPLE_CHOICES, nil, '<>' ).result( binding )

data/lib/bri/renderer.rb

@@ -50,7 +50,7 @@ module Bri
               rendered_items.map! { |item| item.gsub( /\n/, "\n#{INDENT}" ) }
           end
 
-          "#{rendered_items.join( "\n\n" )}\n"
+          "#{rendered_items.join( "\n" )}\n"
 
         else
           text = extract_text( element, width, alignment_width )
@@ -66,44 +66,43 @@ module Bri
     end
 
     def self.extract_text( element, width, label_alignment_width = 0, conserve_newlines = false )
-      text = case element
-               when RDoc::Markup::Paragraph
-                 join_char = conserve_newlines ? "\n" : " "
-                 element.parts.map(&:strip).join( join_char )
-
-               when RDoc::Markup::BlankLine
-                 ""
-
-               when RDoc::Markup::Rule
-                 "-" * width
-
-               when RDoc::Markup::Verbatim
-                 element.parts.map { |part| part.prepend( "  " ) }.join
-
-               when RDoc::Markup::Heading
-                 "<h>#{element.text}</h>" 
-
-               when RDoc::Markup::ListItem
-                 parts = element.parts.map { |part| extract_text( part, width, 0, true ) }.join
-
-                 if element.label
-                   labels = element.label.map { |l| "#{l}:" }.join("\n")
-                   sprintf( "%*s %s", -label_alignment_width, labels, parts )
-                 else
-                   parts
-                 end
-
-               when RDoc::Markup::List
-                 render( element, width - INDENT_WIDTH )
-
-                when RDoc::Markup::Document
-                  element.parts.
-                          map { |part| extract_text( part, width, label_alignment_width, conserve_newlines ) }.
-                          join
-               else  
-                 raise "Don't know how to handle type #{element.class}: #{element.inspect}"
-             end
-      text << "\n"
+      case element
+        when RDoc::Markup::Paragraph
+          join_char = conserve_newlines ? "\n" : " "
+          element.parts.map(&:strip).join( join_char ) + "\n"
+
+        when RDoc::Markup::BlankLine
+          "\n"
+
+        when RDoc::Markup::Rule
+          "-" * width + "\n"
+
+        when RDoc::Markup::Verbatim
+          element.parts.map { |part| part.prepend( "  " ) }.join + "\n"
+
+        when RDoc::Markup::Heading
+          "<h>#{element.text}</h>\n" 
+
+        when RDoc::Markup::ListItem
+          parts = element.parts.map { |part| extract_text( part, width, 0, true ) }.join
+
+          if element.label
+            labels = element.label.map { |l| "#{l}:" }.join("\n")
+            sprintf( "%*s %s", -label_alignment_width, labels, parts )
+          else
+            parts
+          end
+
+        when RDoc::Markup::List
+          render( element, width - INDENT_WIDTH ) + "\n"
+
+         when RDoc::Markup::Document
+           element.parts.
+                   map { |part| extract_text( part, width, label_alignment_width, conserve_newlines ) }.
+                   join + "\n"
+        else  
+          raise "Don't know how to handle type #{element.class}: #{element.inspect}"
+      end
     end
 
     def self.replace_markup( text )

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bri
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
 platform: ruby
 authors:
 - Sven Riedel
@@ -137,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.4
 signing_key: 
 specification_version: 4
 summary: Beautified RI in the spirit of fastri/qri. Unlike fastri, bri builds on top