perception 0.3.3 → 0.3.4

data/Manifest.txt

@@ -1,9 +1,9 @@
 console.rb
-History.txt
-License.txt
+History.rdoc
+License.rdoc
 Manifest.txt
 Rakefile.rb
-README.txt
+README.rdoc
 version.rb
 demo/demo_pp.rb
 demo/demo_system_info.rb

data/{README.txt → README.rdoc}

@@ -1,8 +1,7 @@
-# ruby encoding: utf-8
 
 = Perception - Readable Printouts For Logs And Console
 
-http://bklippstein.github.com/perception/
+http://bklippstein.github.com/perception/frames.html
 
 Powerfull replacement for print, puts and pp. Intuitive toolkit for simple everyday debugging. 
 
@@ -21,20 +20,11 @@ use +see+ instead of pp, puts, print.
 [] There are demos included. Run them.  
 
 
-== License
-cc-by-sa
-
-Creative Commons Attribution-Share Alike 3.0 Germany
-
-http://creativecommons.org/licenses/by-sa/3.0/de/deed.en
-
-
-== Homepage
-http://bklippstein.github.com/perception/
-
-
-== Author
-Björn Klippstein
+== More Info
+* *Documentation*: {http://bklippstein.github.com/drumherum/frames.html github.com/drumherum}
+* *Source* *code*: {https://github.com/bklippstein/drumherum github.com/bklippstein/drumherum}
+* *License*: {http://creativecommons.org/licenses/by-sa/3.0/de/deed.en cc-by-sa Creative Commons Attribution-Share Alike 3.0 Germany}
+* *Autor*: {mailto:klippstein@klippstein.com Björn Klippstein}
 
 
 == Disclaimer

data/Rakefile.rb

@@ -1,11 +1,11 @@
 # ruby encoding: utf-8
-# ü
 
 require 'drumherum'
 smart_init
 require 'version' 
-require 'rdoc/task'
+require 'yard'
 require 'drumherum/rake'
+YARD::Rake::YardocTask.new
 
 Drumherum.github_username = 'bklippstein'
 require 'perception'
@@ -22,68 +22,27 @@ $hoe = Hoe.spec Drumherum.project_name do
    
   developer('Bjoern Klippstein', 'klippstein@klippstein.com')
   summary               = 'Beautiful and readable printouts for console and logs.' 
-  extra_deps            << ['drumherum',  '>= 0.1.10']
+  extra_deps            << ['drumherum',  '>= 0.1.19']
   extra_deps            << ['kyanite',    '>= 0.5.17']
   extra_deps            << ['highline',   '>= 1.6.15']
   remote_rdoc_dir = '' # Release to root only one project  
-  urls                  = [["http://#{Drumherum.github_username}.github.com/#{Drumherum.project_name}/"]]
+  urls                  = [[Drumherum.url_docs], [Drumherum.url_source]]
                               
 end
 
 
 
-#  ----------------------------------------------------------------------------------------------
-#  Documentation
-#  
-# http://rubeh.tumblr.com/post/27622544/rake-rdoctask-with-all-of-the-options-stubbed-out
-# http://www.java2s.com/Code/Ruby/Language-Basics/RDocoptionsareusedlikethisrdocoptionsnames.htm
-#   
-
-remove_task 'docs' 
-
-desc "generate RDoc documentation"
-Rake::RDocTask.new(:docs) do |rd| 
-
-    rd.title    = "#{Drumherum.project_class.to_s} #{Drumherum.project_version}"
-
-    rd.rdoc_dir = 'doc'   
-    rd.rdoc_files.include('lib/**/*.rb')
-    # rd.rdoc_files.include('test/**/test_*.rb')
-    rd.rdoc_files.include('README.txt', 'License.txt', 'History.txt' )
-
-    rd.options += [
-        '--tab-width', '4',
-        '--main', 'README.txt',
-        '--show-hash',        # A name of the form #name in a comment is a possible hyperlink to an instance method name. When displayed, the # is removed unless this option is specified.
-        '--line-numbers',
-        '--all',
-        '--charset=utf8'      
-      ]      
-      
-end
-
-
-
-
-
-
 
 #  ----------------------------------------------------------------------------------------------
-#  Local Tasks
+#  Hide Tasks
 #  
+ 
+ hide_tasks [ :announce, :audit, :check_extra_deps, :clobber_docs, :clobber_package, :default ]
+ hide_tasks [ :dcov, :debug_email, :docs, :gem, :git_add, :git_commit, :git_push, :install_gem ]
+ hide_tasks [ :newb, :package, :post_blog, :publish_docs, :release, :release_sanity, :release_to_gemcutter ]
+ hide_tasks [ :repackage, :ridocs, :sleep_15, :sleep_5, :utf8, :yard, :yard_post ]
+
 
-remove_task 'ridocs'
-remove_task 'rdoc' 
-remove_task 'audit' 
-remove_task 'dcov' 
-remove_task 'debug_email' 
-remove_task 'debug_gem' 
-remove_task 'deploy' 
-remove_task 'deps:email' 
-remove_task 'install_gem'
-remove_task 'multi' 
-remove_task 'newb' 
-#Dir['tasks/**/*.rake'].each { |t| load t }  
 
 
 

data/lib/perception/const.rb

@@ -6,7 +6,9 @@ if $0 == __FILE__
   require 'perception'
 end
 
-module Perception #:nodoc
+# Some constant definitions
+#
+module Perception 
 
   unless defined?(TIME_FORMATS)
     TIME_FORMATS = {

data/lib/perception/date_and_time.rb

@@ -7,10 +7,15 @@ if $0 == __FILE__
 end
 
 
-module Perception #:nodoc
+module Perception 
  module TimeI 
  
-
+ 
+  # ------------------------------------------------------------------------------
+  # @group Using inspect_see for to_s and pretty_print
+  #     
+ 
+ # @return [String]
  def inspect_see(options={})
     norm =              options[:norm]        || :iso
     precision_max = 4
@@ -23,12 +28,13 @@ module Perception #:nodoc
  
  
 
-
+ # @return [String]
   def to_s
     self.inspect_see(:precision => 5)
   end  
   
   
+ # @return [String]  
   def pretty_print(q)
     q.text(self.inspect_see(:precision => 5))
   end    
@@ -40,7 +46,7 @@ end # module Perception
 
 
 
-class Time #:nodoc:
+class Time 
   include Perception::TimeI
 end
 

data/lib/perception/logging.rb

@@ -7,29 +7,49 @@ if $0 == __FILE__
 end
 
 
-module Perception #:nodoc
+module Perception 
 
   class SeeSession
   
+  # @group Logging
+  
+
+    # Looks for a good place to save the log file,
+    # creates log directory & log file if necessary and
+    # instantiates Logger Object.
+    # 
+    # Where is my logfile? Try
+    #  see seee.logger
+    #  =>
+    #  <Logger:0x2a57d20
+    #    @default_formatter = #<Logger::Formatter:0x2a57cc0  @datetime_format=nil>,
+    #    @formatter =         nil,
+    #    @level =             0,
+    #    @logdev =            #<Logger::LogDevice:0x2a57c60  @dev=#<File:C:/Ruby-Projekte/perception/log/see.log>,  @filename='C:/Ruby-Projekte/perception/log/see.log',  @mutex=#<<>>,  @shift_age=0,  @shift_size=1048576>,
+    #    @progname =          nil>
+    #
+    # @return [Logger]
+    #
     def logger( logdir=nil, filename='see.log' )
       return @logger  if @logger
-      require 'logger' unless defined?(Logger)
+      require 'logger'    unless defined?(Logger)
       
       # Logfile festlegen
-      unless logdir
-        mycaller = CallerUtils.mycaller(:skip => ['perception', 'ruby\gems', 'ruby/gems', 'rubygems', 'test/unit']) 
-        logdir =   CallerUtils.mycaller_maindir(mycaller) + '/log'           if mycaller
+      unless logdir      
+        smart_init   if Drumherum.directory_main.empty?
+        logdir = File.expand_path(File.join(Drumherum.directory_main, 'log'))
+        # puts "logdir= #{logdir}   size=#{logdir.split('/').size}"
       end
-      if ( logdir.nil?  ||  logdir == 'test/log' )
+      if ( logdir.nil?  ||  logdir.empty?  ||  logdir == 'test/log'  ||  logdir.split('/').size <= 2)
         require 'tmpdir'
         logdir = Dir::tmpdir + '/log'
       end
+      mycaller = CallerUtils.mycaller(:skip => ['perception', 'ruby\gems', 'ruby/gems', 'test/unit'])    
       logfile =  File.join(logdir, filename)
-      puts "\nmycaller=#{mycaller.inspect_pp}"
-      puts "\nlogdir=#{logdir.inspect_pp}"
-      puts "\nlogfile=#{logfile.inspect_pp}"
-      
-            
+      #puts "mycaller=#{mycaller.inspect_pp}"
+      #puts "logdir=#{logdir.inspect_pp}"
+      #puts "logfile=#{logfile.inspect_pp}"
+           
       # Erzeugen, wenn nötig
       begin
         # Dir erzeugen
@@ -40,7 +60,11 @@ module Perception #:nodoc
         # File erzeugen
         unless File.exist?(logfile)
           File.open(logfile,(File::WRONLY | File::APPEND | File::CREAT)) 
-          log_status("Logfile created by #{mycaller}")
+          if  (mycaller.nil? || mycaller.empty?)
+            log_status
+          else
+            log_status("Logfile created by #{mycaller}") 
+          end
         end
         #Logger erzeugen
         @logger =        Logger.new( logfile )
@@ -55,7 +79,18 @@ module Perception #:nodoc
     end # def        
     
     
-    
+    # Prints a separator, the actual time and an optional message in the log file.
+    # Usage:
+    #  seee.log_status "My Message"
+    #  => (in log file)
+    #
+    #   ------------------------------------------------------------------------------------------------------------------------
+    #   2012-10-17 Wednesday 10:47:05
+    #   My Message  
+    #
+    # @return [void]
+    # @param [String] message message to print
+    # 
     def log_status(message='')
       status =  "\n\n\n# " + ('-'*120) + "\n"
       status += "# " + Time.now.inspect_see + "\n"

data/lib/perception/numeric.rb

@@ -8,10 +8,78 @@ end
 
 
 
-module Perception #:nodoc
+module Perception 
 
  module NumericI 
+ 
+    # ------------------------------------------------------------------------------
+    # @group Slash needless digits
+    #   
+    
+    # Slash needless digits.
+    # Needless are digits that are
+    # * beyond the measurement precision or
+    # * not perceived by humans (instead they disturb the reception)    
+    #
+    # Example:
+    #    input (+/-)     result (+)     result (-)   result.class
+    #  ----------------------------------------------------------
+    #       12567.89          12600         -12600         Fixnum
+    #       1256.789           1260          -1260         Fixnum
+    #      123.56789            124           -124         Fixnum
+    #         100.01            100           -100         Fixnum
+    #          100.0            100           -100         Fixnum
+    #           99.9           99.9          -99.9          Float
+    #           12.0             12            -12         Fixnum
+    #             12             12            -12         Fixnum
+    #       12.56789           12.6          -12.6          Float
+    #       1.256789           1.26          -1.26          Float
+    #            1.5            1.5           -1.5          Float
+    #              0              0              0         Fixnum
+    #      0.1256789          0.126         -0.126          Float
+    #     0.01256789         0.0126        -0.0126          Float
+    #    0.001256789        0.00126       -0.00126          Float
+    #   0.0001256789       0.000126      -0.000126          Float
+    #
+    # @return [Numeric]
+    # @param [Integer] precision How many digits are significant?
+    def significant( precision = 3)
+    
+        # sprintf mit gemischter Schreibweise
+        fucking_c_lib_result = sprintf("%.#{precision}g", self)
+        fucking_c_lib_result =~ /^(.*)e/
+        meine_zahl = $+ || fucking_c_lib_result            
+        exponent = $'
+        # pp meine_zahl
+        # pp exponent
+        
+        #  ohne Exponent
+        if exponent.nil?
+          result = meine_zahl.to_f
+          if result.abs >= (10**(precision-1))  ||  result == result.to_i
+            return result.to_i
+          else
+            return result
+          end          
+         
+        # mit Exponent
+        else
+     
+          result = meine_zahl.to_f * 10**(exponent.to_i)
+          if exponent[0..0] == '+' 
+            return result.to_i
+          
+          else
+            return result
+
+          end
+        
+        end # Expontent?
+    end # def significant   
 
+    # ------------------------------------------------------------------------------
+    # @group Easily human readable numbers
+    #    
     
     # Formatiert eine Zahl so, dass sie leicht menschenlesbar wird: 
     # - Quasi-rechtsbündig (mit dem Komma als Bezugspunkt, abhängig von der Klassenzugehörigkeit der Zahl)
@@ -76,56 +144,19 @@ module Perception #:nodoc
     end
     
     
-    # Streicht überflüssige Stellen weg.
-    # Wandelt in Integer um, wenn das ohne Informationsverlust möglich ist.
-    # Überflüssig sind Stellen, die 
-    # * jenseits der Messprecision liegen oder
-    # * nicht von Menschen wahrgenommen werden (stattdessen stören sie die Rezeption)
-    # 
-    def significant( precision = 3)
-    
-        # sprintf mit gemischter Schreibweise
-        fucking_c_lib_result = sprintf("%.#{precision}g", self)
-        fucking_c_lib_result =~ /^(.*)e/
-        meine_zahl = $+ || fucking_c_lib_result            
-        exponent = $'
-        # pp meine_zahl
-        # pp exponent
-        
-        #  ohne Exponent
-        if exponent.nil?
-          result = meine_zahl.to_f
-          if result.abs >= (10**(precision-1))  ||  result == result.to_i
-            return result.to_i
-          else
-            return result
-          end          
-         
-        # mit Exponent
-        else
-     
-          result = meine_zahl.to_f * 10**(exponent.to_i)
-          if exponent[0..0] == '+' 
-            return result.to_i
-          
-          else
-            return result
-
-          end
-        
-        end # Expontent?
-    end # def significant      
+   
     
 
   end # module NumericI 
 end # module Perception
 
 
-class Numeric #:nodoc:
+class Numeric 
   include Perception::NumericI
 end
 
-class NilClass #:nodoc:
+# @private
+class NilClass 
     def size(*a);                       0;              end  
 end
 
@@ -151,11 +182,15 @@ if $0 == __FILE__  &&  Drumherum::loaded? then
 
   when :try1 #-------------------------------------------------------------------------------   
   
+    seee.out << :log
     test = [12567.89, 1256.789, 123.56789, 100.01, 100.0, 99.9, 12.0, 12, 12.56789, 1.256789, 1.5, 0, 0.1256789,0.01256789,0.001256789,0.0001256789, ]
     test.each do |t|
+    
+      see_print "#"
       see_print t.to_s.rjust(15)
       see_print t.significant.to_s.rjust(15)
       see_print (t * -1).significant.to_s.rjust(15)
+      see_print t.significant.class.to_s.rjust(15)      
       see_print "\n"
     end
     

data/lib/perception/perception_main.rb

@@ -27,7 +27,7 @@ require 'kyanite/enumerable/structure'   # Methode contentclass
 # printing two informations in one line without destroying the structure and
 # optionally slows down printing to readable speed, depending on the complexity of the output.
 #
-module Perception #:nodoc
+module Perception 
   
   # Eine SeeSession-Instanz entspricht einer Session mit der Konsole.
   class SeeSession  

data/lib/perception/perception_private.rb

@@ -9,7 +9,7 @@ end
 
 
 
-module Perception #:nodoc
+module Perception 
 
   
   # Eine SeeSession-Instanz entspricht einer Session mit der Konsole.

data/lib/perception/ppp.rb

@@ -7,70 +7,22 @@ if $0 == __FILE__
 end
 
 
-
+# patches pretty print
 class PPP < PP
 
 
-  # ------------------------------------------------------------------------------
-  #  
-  #   
-
-  def self.pp(obj, out=$>, width=79 )
-    q = PPP.new(out, width, "\n")
-    q.guard_inspect_key {q.pp(obj)}
-    q.flush
-    #$pp = q
-    out
-  end  
-  
-  # sorgt dafür, dass Listen länger als 3 Elemente untereinander ausgegeben werden
-  def seplist(list, sep=nil, iter_method=:each) # :yield: element
-    sep = lambda { comma_newline }   if (sep.kind_of?(Integer)  &&  list.size > sep )
-    sep = lambda { comma_breakable } if (sep.nil? || sep.kind_of?(Integer))
-    first = true
-    list.__send__(iter_method) {|*v|
-      if first
-        first = false
-      else
-        sep.call
-      end
-      yield(*v)
-    }
-  end
-    
-  def comma_newline
-    text ","
-    breakable('',9999)   
-  end    
-
-  
-  # Hashes mit mehr als drei Keys werden untereinander dargestellt
-  def pp_hash(obj)
-    group(1, '{', '}') {
-      seplist(obj, 3, :each_pair) {|k, v|
-        group {
-          pp k
-          text '=>'
-          group(1) {
-            breakable ''
-            pp v
-          }
-        }
-      }
-    }
-  end  
-  
   
   
+
   
   # ------------------------------------------------------------------------------
-  #  
-  #     
-  
-
+  # @group Beautify: reworking the pretty print results
+  #       
   
   
-  # Nachbearbeitung des PrettyPrint-Results
+  # reworking the pretty print results
+  # @return [String]
+  #
   def self.beautify(string)
     begin
       result = string# .gsub!("`","'")
@@ -88,7 +40,9 @@ class PPP < PP
   end # def
   
   
-  # Klassifiziert die Struktur eines Objektes für die Ausgabe
+  # Classifies the structure of an object for output  
+  # @return [Symbol]  
+  #
   def self.classify_structure(object)
   
     # Hash
@@ -111,8 +65,10 @@ class PPP < PP
   
   
   
-  # Level 2+ : nur noch eine Zeile  
-  # Level 3+ : komplexe Objekte zusammenkürzen  
+  # Level 2+ : only one line left
+  # Level 3+ : clip complex objects
+  # @return [String]  
+  #
   def self.beautify_focus_level1(string) 
     #return string
     replaces = [[/\n/, ''], [/ {2,}/,' ']]
@@ -124,7 +80,9 @@ class PPP < PP
   
   
   
-  # Object
+  # Beautify for Objects
+  # @return [String]  
+  #
   def self.beautify_object(string) 
     result = string
     result.gsub!(/= *\n */m, '=' )  # unnötigen Zeilenumbruch vermeiden
@@ -154,7 +112,9 @@ class PPP < PP
   
   
   
-  # Hash
+  # Beautify for Hashes
+  # @return [String]  
+  #
   def self.beautify_hash(string) 
     result = string
     result.gsub!(/=> *\n */m, '=>' )  # unnötigen Zeilenumbruch vermeiden
@@ -219,9 +179,11 @@ class PPP < PP
   end      
   
   
-  
-  # Eindimensionales Array
-  # oder Objekt, das sich wie ein Array ausdruckt -- vor der eckigen Klammer ist ein Identifier erlaubt, z.B. WP[ 1, 2, 3]   
+  # Beautify for one-dimensional arrays
+  # or any object that prints like an array.
+  # In front of the brackets there are identifier allowed, eg WP [1, 2, 3]    
+  # @return [String]  
+  #  
   def self.beautify_array_1dim(string) 
     return string
     # tabstops = result[1..-2].analyze_columns( :level_start  => 0,     
@@ -240,9 +202,10 @@ class PPP < PP
   end      
   
   
-  
-  # Zweidimensionales Array  
-  # very hackish
+  # Beautify for two-dimensional arrays -  
+  # very dirty.
+  # @return [String]  
+  #    
   def self.beautify_array_2dim(string) 
     result = string
 
@@ -296,9 +259,15 @@ class PPP < PP
   end        
   
   
+
+
+  # Beautify for complex objects.
+  #
   # Mehrere Ausgaben in einer Zeile.
   # Die einzelnen Ausgaben liegen als Array vor.
   # Das Ergebnis soll aber nicht wie ein Array ausssehen.
+  # @return [String]  
+  #      
   def self.beautify_multi(string)
     result = string
     result = beautify_focus_level1(result)    
@@ -320,20 +289,78 @@ class PPP < PP
   
   
       
+  # ------------------------------------------------------------------------------
+  # @group Pretty Print Patches
+  #    
+  
+
+  def self.pp(obj, out=$>, width=79 )
+    q = PPP.new(out, width, "\n")
+    q.guard_inspect_key {q.pp(obj)}
+    q.flush
+    #$pp = q
+    out
+  end  
+  
+  
+
+  # ensures that lists with more than three elements are displayed line by line
+  def seplist(list, sep=nil, iter_method=:each) # :yield: element
+    sep = lambda { comma_newline }   if (sep.kind_of?(Integer)  &&  list.size > sep )
+    sep = lambda { comma_breakable } if (sep.nil? || sep.kind_of?(Integer))
+    first = true
+    list.__send__(iter_method) {|*v|
+      if first
+        first = false
+      else
+        sep.call
+      end
+      yield(*v)
+    }
+  end
+    
+    
+  def comma_newline
+    text ","
+    breakable('',9999)   
+  end    
+
+  
   
+  # hashes with more than three keys are displayed line by line  
+  def pp_hash(obj)
+    group(1, '{', '}') {
+      seplist(obj, 3, :each_pair) {|k, v|
+        group {
+          pp k
+          text '=>'
+          group(1) {
+            breakable ''
+            pp v
+          }
+        }
+      }
+    }
+  end    
   
   
 
 end # class
 
 
-class String # :nodoc:
+class String 
+
+  # @return [String]
   def pretty_print(q)
     q.text "'#{self}'"
   end
+  
 end
 
-class Set # :nodoc:
+
+class Set 
+
+  # @return [String]
   def pretty_print(q)
     q.group(1, '{', '}') {
       q.seplist(self) {|v|
@@ -342,13 +369,17 @@ class Set # :nodoc:
     }
   end
 
+  
   def pretty_print_cycle(q)
     q.text(empty? ? '{}' : '{...}')
   end
+  
 end
 
 
-class Dictionary # :nodoc:
+class Dictionary 
+
+ # @return [String]
   def inspect
     ary = []
     each {|k,v| ary << k.inspect + "=>" + v.inspect}
@@ -357,7 +388,9 @@ class Dictionary # :nodoc:
 end
 
 
-class Dictionary # :nodoc:
+class Dictionary 
+
+  # @return [String]
   def pretty_print(q)
     q.pp_hash self
   end

data/lib/perception/string_spread.rb

@@ -8,8 +8,8 @@ end
 require 'kyanite/array_of_enumerables'
 
 
-module Perception #:nodoc
-  module StringSpreadI #:nodoc
+module Perception 
+  module StringSpreadI 
   
 
   def analyze_columns(options={})
@@ -129,7 +129,7 @@ module Perception #:nodoc
   end # module
 end # module
 
-class String #:nodoc:
+class String 
   include Perception::StringSpreadI
 end
 

data/version.rb

@@ -1,6 +1,6 @@
 
 
 module Perception #:nodoc
-  VERSION = '0.3.3'
+  VERSION = '0.3.4'
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perception
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-15 00:00:00.000000000 Z
+date: 2012-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: drumherum
@@ -18,7 +18,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.1.19
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ! '>='
       - !ruby/object:Gem::Version
-        version: 0.1.10
+        version: 0.1.19
 - !ruby/object:Gem::Dependency
   name: kyanite
   requirement: !ruby/object:Gem::Requirement
@@ -97,17 +97,17 @@ email:
 executables: []
 extensions: []
 extra_rdoc_files:
-- History.txt
-- License.txt
+- History.rdoc
+- License.rdoc
 - Manifest.txt
-- README.txt
+- README.rdoc
 files:
 - console.rb
-- History.txt
-- License.txt
+- History.rdoc
+- License.rdoc
 - Manifest.txt
 - Rakefile.rb
-- README.txt
+- README.rdoc
 - version.rb
 - demo/demo_pp.rb
 - demo/demo_system_info.rb
@@ -128,12 +128,12 @@ files:
 - test/test_numeric.rb
 - test/test_ppp.rb
 - .gemtest
-homepage: 
+homepage: http://bklippstein.github.com/perception/frames.html
 licenses: []
 post_install_message: 
 rdoc_options:
 - --main
-- README.txt
+- README.rdoc
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement