rmtools 1.3.3 → 2.0.0.rc5

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+Manifest.txt
+Makefile
+*.out
+*.o
+*.so

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE

@@ -1,16 +1,22 @@
-Copyright (c) 2010-2013
-    Sergey Baev <tinbka@gmail.com>
+Copyright (c) 2010-2013 Sergey Baev <tinbka@gmail.com>
 
-This work is licensed under the same license as Ruby language.
+MIT License
 
-THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
-ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-SUCH DAMAGE.
+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

@@ -1,52 +1,103 @@
 ### RMTools
 [github](https://github.com/tinbka/rmtools)
 
-Collection of helpers for any need: strings, enumerables, Module... hundreds of bicycles, shortcuts you ever wanted to implement is here, optimized for performance.
-Small dev library (in progress for ever): fast and smart logger, binding explorer, backtrace formatter, all are console-colored.
-Started from basic classes, now it contains low-level helpers for ActiveRecord and makes LibXML more jQueryish.
+Collection of helpers for any need: strings, enumerables, modules... hundreds of bicycles and shortcuts you ever wanted to implement are here, optimized for performance.
+Small dev library (constantly in progress): fast and smart logger, binding explorer, backtrace formatter, each is console-colored.
+Started from basic classes, now it contains low-level helpers for ActiveRecord and makes LibXML more jqueryish.
 
-RMTools is based on opinion that some boiler-plate should be thrown away from Ruby making it more expressive with no (0~10%) performance penalty:
-`hash['id']` -> `hash.id`
-`ary.map(&:id)` -> `ary.ids`
-`ary.map {|h| h['id']}` -> `ary.ids`
-`comments.posts.sorted_uniq_by_id.select_by_user_id(user_id).sum_points` -> `comments.map {|c| c.post}.sort_by {|p| p.id}.uniq_by {|p| p.id}.select {|p| p.user_id == user_id}.sum {|p| p.points}`
+RMTools helps to throw away some boiler-plate making a code more intuitive. It comes with almost no (<< 10%) performance penalty:
+* `hash[:id]` -> `hash.id`
+* `ary.map(&:id)` -> `ary.ids`
+* `ary.map {|h| h[:id]}` -> `ary.ids`
+* `comments.posts.sorted_uniq_by_id.select_by_user_id(user_id).sum_points` -> `comments.map {|c| c.post}.sort_by {|p| p.id}.uniq_by {|p| p.id}.select {|p| p.user_id == user_id}.sum {|p| p.points}`
 
 ---
 
 It's still randomly documented since it's just my working tool.
 
-#### Expected to complete:
+#### Wanted to implement
+
+* Ruby code parser (StringScanner-based) reading an array of loaded ruby-files and making accurate hash-table of defined methods {"Class#method" => "def ... end"}
+* JSON-formatter for output ruby objects content in HTML presentation in order to inspect big objects using browser graphic abilities
+* Set theory based Range extension with support of both begin and end exclusion, and satisfying the next rules:
+  * `size(0..1) = size(0...1) = 1`
+  * `A = A - B | B`
+  *   `A ⊃ B -> size(A - B) = size(A) - size(B)`
 
-* Ruby code parser (StringScanner-based) reading array of loaded ruby-files and making accurate hash-table of defined methods {"Class#method" => "def ... end"}
-* JSON-formatter for output ruby objects content in HTML form in order to inspect big objects using browser abilities
-* Redis addon (inspired by redis-objects): store and search relations, data-typing. (maybe I'll create another gem for that)
 
 ### CHANGES
 
+##### Version 2.0.0
+
+* Array Meta-iterators
+  * Pattern has became a class variable. New names can be added to pattern by Array::add_iterator_name
+  * Speed has been drastically boosted by evaluating of every proper missing method. (Read comments in /enumerable/array_iterators.rb)
+  * Using meta-iterators in the new behaviour can smudge Array instance_methods namespace. Although it's not something that bad, that's possible to turn on the old behaviour by Array::fallback_to_clean_iterators!
+
+* Hash#method_missing
+  * hash.something gets hash[:something] || hash['something'], not other way
+  * hash.something= sets hash['something'] as did it before
+  * This change has been caused by large amounts of symbolic options keys and json decode returning symbolic keys (at least with a yajl library).
+  * Set behaviour, on the other hand, will not be changed since 1) it will be too hard to debug hashes in an old code; 2) it's not that frequently used; 3) setting hash key directly by :[]= makes a code clearer
+  
+* Class
+  * Added private #alias_constant
+
+* Array
+  * #avg and #avg_by for an empty array now return 0
+  * Fixed #rand_by for an empty array
+  * Added #intersects? aliased as #x?
+
+* Symbol
+  * Added #+, #split and #method_missing to proxy all possible methods to #to_s
+
+* Range
+  * Specified a concept of the extension (/enumerable/range.rb)
+  * Changed default Range#include? the way it can take range as argument
+  * Added XRange#first(count) and #last(count), analogically to Range#first and #last
+
+* ActiveRecord
+  * Moved declarative.rb from Rhack project. ::Base::declarative is a way of making tables like by migrations but on the fly
+  * Added ::Base#with_same(<column_name>)
+  * ::Base::non_null_scopes ignores non-nullable columns
+
+* Development kit
+  * RMTools::timer now resets $quiet and $log.mute_warn to previous values in case of ^C or another exception raised
+  * Fixed all potential problems with /dev, so require "rmtools_dev" is deprecated in favour of require "rmtools" and will be removed in the next update
+  * Read comments about format_trace in /dev/trace_format.rb
+  * BlackHole class is aliased as Void
+  * Added :detect_comments and :precede_comments options to ::RMLogger to automatically highlight comment blocks get logged
+
+* Structural changes
+  * Moved /b.rb into /core since #b is proved usability through some years
+  * Renamed /db into /active_record
+  * Merged /ip into /conversions
+  * The gem is now being produced in the bundle style: added Gemfile, .gemspec, etc
+
 ##### Version 1.3.3
 
 * Added to Array: #sort_along_by, #indices_map, #each_two
-* Enumerable#map_hash
+* Added Enumerable#map_hash
 * Range
-* * Fixed #size for backward ranges
-* * Fixed #x? and #-@ for neighbor numbers and non-integers in general
-* * added XRange#x?
-* * aliased #x? as #intersects?
+  * Fixed #size for backward ranges
+  * Fixed #x? and #-@ for neighbor numbers and non-integers in general
+  * added XRange#x?
+  * aliased #x? as #intersects?
 * Class#__init__ accepts block, auto__init__ed Thread and Proc
 
 ##### Version 1.3.0
 
 * Added ::ValueTraversal and ::KeyValueTraversal modules for treeish dir/enumerable search
 * String
-* * Cyrillic support: #fupcase, #fdowncase and instant up/down versions
-* * #to_search, #squeeze_newlines, #recordize
-* * key :js_caller to #parse for JS stacktrace lines as it given by stacktrace.js library
-* Added AR::Base::boolean_scopes! and ::non_null_scopes!
+  * Cyrillic support: #fupcase, #fdowncase and instant up/down versions
+  * #to_search, #squeeze_newlines, #recordize
+  * key :js_caller to #parse for JS stacktrace lines as it given by stacktrace.js library
+* Added ActiveRecord::Base::boolean_scopes! and ::non_null_scopes!
 * Added Object#ifndef for ivars caching
 * Fixed bugs
-* * Class#__init__ (case with nested classes)
-* * AR::Base::select_rand (case with :where query)
-* * ::rw and ::write (cases with encoding fail and non-string argument)
+  * Class#__init__ (case with nested classes)
+  * ActiveRecord::Base::select_rand (case with :where query)
+  * ::rw and ::write (cases with encoding fail and non-string argument)
 * Described the library and *marked down* this readme
 
 ##### Version 1.2.14

data/Rakefile

@@ -1,37 +1 @@
-require 'rake'
-require './lib/rmtools/install'
-compile_manifest
-
-RMTOOLS_VERSION = '1.3.3'
-begin
-    require 'hoe'
-    config = Hoe.spec 'rmtools' do |h|
-        h.developer("Sergey Baev", "tinbka@gmail.com")
-
-        #self.summary = 'Yet another Ruby applied lib'
-        h.description = 'Applied library primarily for debug and text/arrays/files processing purposes.'
-        h.urls = ['https://github.com/tinbka/rmtools']
-       
-        h.extra_deps = [['rake','>= 0.8.7'], ['activesupport','>= 2.3.8']]
-    end
-    config.spec.extensions << 'ext/extconf.rb'
-rescue LoadError
-    STDERR.puts "cannot load the Hoe gem. Distribution is disabled"
-rescue Exception => e
-    STDERR.puts "cannot load the Hoe gem, or Hoe fails. Distribution is disabled"
-    STDERR.puts "error message is: #{e.message}"
-end
-
-ruby  = RbConfig::CONFIG['RUBY_INSTALL_NAME']
-windoze = RUBY_PLATFORM =~ /mswin32/
-make = windoze ? 'nmake' : 'make'
-
-Dir.chdir "ext" do
-  unless system "#{ruby} extconf.rb #{ENV['EXTCONF_OPTS']}" and system make
-    # don't we have a compiler?
-    warn "failed to compile extension, continuing installation without extension"
-  end
-  if File.file? 'Makefile'
-    system "#{make} clean" and FileUtils.rm_f "Makefile"
-  end
-end unless ext_files_not_modified 'rmtools', RMTOOLS_VERSION
+require "bundler/gem_tasks"

data/lib/rmtools/{db/active_record.rb → active_record/base.rb}

@@ -18,6 +18,7 @@ module ActiveRecord
   end
 
   class Base
+    class_attribute :enums
     
     class << self
     
@@ -87,7 +88,6 @@ module ActiveRecord
           ) i", options])
       end
         
-      class_attribute :enums
       # virtual (only-in-ruby) "enum" type support
       def enum hash
         key = hash.keys.first
@@ -119,12 +119,12 @@ module ActiveRecord
       # including zero and empty string
       def non_null_scopes!
         boolean_scopes!
-        columns.names.to_syms.each {|col|
+        columns.select_null.names.to_syms.each {|col|
           unless respond_to? col
             scope col, where("#{quoted_table_name}.#{col} is not null")
           end
         }
-        rescue
+      rescue
         nil
       end
    
@@ -168,6 +168,10 @@ module ActiveRecord
       "#{self.class.name.tableize}/#{id}"
     end
     
+    def with_same(attr)
+      self.class.where(attr => self[attr])
+    end
+    
   end
   
   class Relation

data/lib/rmtools/active_record/declarative.rb

@@ -0,0 +1,153 @@
+# encoding: utf-8
+module ActiveRecord
+
+  module ConnectionAdapters
+    AbstractAdapter
+  
+    class VirtualTable < Table
+      
+      def debug_str meth, called, exist, *args
+        "Table.#{meth}(#{args.inspects*', '}) was#{' NOT' if !called} called due to #{'in' if !exist}existance"
+      end
+      
+      def column_exists *args
+        column_names = @base.columns(@table_name).names
+        options = args.extract_options!
+        names = args.dup
+        args << options
+        _or_ = (names[0] == :all) ? !names.shift : true
+        names.each {|name| return _or_ if name.to_s.in(column_names) == _or_}
+        !_or_
+      end
+      
+      def index_exists *indexes
+        column_indexes = @base.indexes(@table_name).columnss.flatten
+        _or_ = (indexes[0] == :all) ? !indexes.shift : true
+        indexes.each {|index| return _or_ if index.to_s.in(column_indexes) == _or_}
+        !_or_
+      end
+      
+      def initialize name, connection, map=nil
+        super name, connection
+        case map
+          when true; @map = []
+          when Array; @map = map
+        end
+      end
+      
+      def map!
+        map_names = @map.firsts.to_ss
+        @base.columns(@table_name).names.each {|name|
+          name.in(map_names) ? @map.reject! {|_| _[0] == name} : remove(name)
+        }
+        @map.each {|col| column *col}
+      end
+      
+      def column name, *args
+        to_be_called = !column_exists(name)
+        super if to_be_called
+        $log.debug {debug_str :column, to_be_called,  !to_be_called, name, *args}
+        @map << [name, *args] if @map
+      end
+        
+      %w{string text integer float decimal
+  datetime timestamp time date binary boolean}.each {|column_type| 
+          define_method(column_type) {|*args|
+            to_be_called = !column_exists(*args)
+            super if to_be_called
+            $log.debug {debug_str column_type, to_be_called,  !to_be_called, *args}
+            if @map
+              options = args.extract_options!
+              args = args.xprod(column_type)
+              args = args.xprod(options) if options
+              @map.concat args
+            end
+      } }
+      
+      def index name, *args
+        to_be_called = !index_exists(name)
+        super if to_be_called
+        $log.debug {debug_str :index, to_be_called, !to_be_called, name, *args}
+      end
+      
+      def timestamps
+        to_be_called = !column_exists('created_at', 'updated_at')
+        super if to_be_called
+        $log.debug {debug_str :timestamps, to_be_called, !to_be_called}
+        @map.concat [[:created_at, :datetime], [:updated_at, :datetime]] if @map
+      end
+      
+      def change *args
+        raise NotImplementedError, "don't use #change in declaration!"
+      end
+      
+      def change_default *args
+        raise NotImplementedError, "don't use #change_default in declaration!"
+      end
+      
+      def rename column_name, new_column_name
+        to_be_called = !column_exists(new_column_name)
+        super if to_be_called
+        $log.debug {debug_str :rename, to_be_called, !to_be_called, column_name, new_column_name}
+      end
+      
+      def references *args
+        to_be_called = !column_exists(*args.map {|col| "#{col}_id"})
+        super if to_be_called
+        $log.debug {debug_str :references, to_be_called,  !to_be_called, *args}
+      end
+      alias :belongs_to :references
+      
+      def remove *args
+        to_be_called = column_exists :all, *args
+        super if to_be_called
+        $log.debug {debug_str :remove, to_be_called, to_be_called, *args}
+      end
+      
+      def remove_references *args
+        to_be_called = column_exists(:all, *args.map {|col| "#{col}_id"})
+        super if to_be_called
+        $log.debug {debug_str :remove_references, to_be_called, to_be_called, *args}
+      end
+      alias :remove_belongs_to :remove_references
+      
+      def remove_index options
+        indexes = options.is(Hash) ? options[:column] : options
+        raise ArgumentError, "can remove only default format named indexes in declaration!" if !indexes
+        to_be_called = index_exists :all, *indexes
+        super if to_be_called
+        $log.debug {debug_str :remove_index, to_be_called,  to_be_called, options}
+      end
+      
+      def remove_timestamps
+        to_be_called = column_exists 'created_at', 'updated_at'
+        super if to_be_called
+        $log.debug {debug_str :remove_timestamps, to_be_called, to_be_called}
+      end
+      
+    end
+      
+  end
+
+  class << Base
+    
+    def declare(name, options={}, &block)
+      self.table_name = name
+      if !table_exists? or options[:force]
+        $log < "with options[:force] the `#{table_name}` table will have been recreated each time you load the #{model_name} model" if options[:force]
+        self.primary_key = options[:primary_key] if options[:id] != false and options[:primary_key]
+        $log.debug "connection.create_table(#{name}, #{options.inspect}) {}"
+        connection.create_table(name, options, &block)
+      elsif options[:map]
+        table = ConnectionAdapters::VirtualTable.new(name, connection, options[:map])
+        yield table
+        table.map!
+      else yield ConnectionAdapters::VirtualTable.new(name, connection)
+      end
+      reset_column_information
+    end
+    
+  end
+    
+end
+    

data/lib/rmtools/conversions/enum.rb

@@ -1,11 +1,23 @@
 # encoding: utf-8
-#require 'cgi'
 
 module Enumerable
   
-  # Simple http stringifying. Also stringifies multi-value hashes
+  # Simple http stringifying:
+  # {'a'=>10, 'b'=>20}.urlencode
+  # => "a=10&b=20"
+  # Stringifies hashes with multi-value values:
   # {'a'=>'10&20&30'}.urlencode
+  # or
+  # {'a'=>[10, 20, 30]}.urlencode
   # => "a=10&a=20&a=30"
+  # Stringifies hashes with multi-value keys as well:
+  # {['a', 'b']=>[10, 20]}.urlencode
+  # => "a=10&a=20&b=10&b=20"
+  # Stringifies hashes with hash-value values:
+  # {'a'=>{0=>10, 'b'=>{'c'=>20, 'd'=>30}}}.urlencode
+  # => "a[0]=10&a[b]=20"
+  
+  # TODO: deal with it
   def urlencode
     map {|k, v| next if !v
       k, v = k.to_s, v.to_s

data/lib/rmtools/{b.rb → core/b.rb}

@@ -1,22 +1,29 @@
-# encoding: utf-8
 # {obj.b -> self or false} with python logic
-# Since 2.3.8 active_support has analogue: #presence
+# Since 2.3.8 ActiveSupport has similar method: #presence
+# Though, #b is obviously more usable due to it's length, 
+# and still intuitive: "Boolean", "Being", "to Be"
+# Differs from #presence in that String#b do not use #strip for check
 
 class Object
   def b; self end
 end
+
 class Numeric
   def b; !zero? && self end
 end
+
 class String
   def b; !empty? && self end
 end
+
 class Proc
   def b; (self != NULL) && self end
 end
+
 class NilClass
   def b; false end
 end
+
 module Enumerable
   def b; !empty? && self end
 end

data/lib/rmtools/core/class.rb

@@ -51,6 +51,13 @@ class Class
     end
   end 
   
+  def alias_constant(name)
+    class_eval %{
+    def #{name}(key=nil)
+      key ? self.class::#{name}[key] : self.class::#{name}
+    end}
+  end
+  
 end
 
 require 'set'

data/lib/rmtools/core/js.rb

@@ -1,5 +1,6 @@
 # encoding: utf-8
-# js hash getter/setter and string concat logic
+
+# Javascript hash getter/setter and string concat logic
 class Hash
   alias :throw_no :method_missing
   
@@ -11,6 +12,8 @@ class Hash
   # hash.unknown_function # => nil
   # hash[:def] = 456
   # hash.def # => 456
+  #
+  # This priority should be stable, because 
   def method_missing(method, *args)
     str = method.to_s
     if str =~ /=$/
@@ -18,19 +21,19 @@ class Hash
     elsif !args.empty? or str =~ /[!?]$/
       throw_no method 
     else
-      a = self[str]
-      (a == default) ? self[method] : a
+      a = self[method]
+      (a == default) ? self[str] : a
     end
   end
   
   # Redefine since these methods are deprecated anyway
   def type
-    a = self['type']
-    (a == default) ? self[:type] : a
+    a = self[:type]
+    (a == default) ? self['type'] : a
   end
   def id
-    a = self['id']
-    (a == default) ? self[:id] : a
+    a = self[:id]
+    (a == default) ? self['id'] : a
   end
 
 end
@@ -42,13 +45,13 @@ class String
     #   immutable:
     # '123' + 95 # => '12395'
     # '123'.plus 95 # => raise TypeError
-    #   mutable:
-    # '123' << 95 # => '12395'
-    # '123'.concat 95 # => '123_'
     def +(str)
       plus str.to_s
     end
     
+    #   mutable:
+    # '123' << 95 # => '12395'
+    # '123'.concat 95 # => '123_'
     def <<(str)
       concat str.to_s
     end

data/lib/rmtools/core/kernel.rb

@@ -3,9 +3,11 @@ module Kernel
   
   # re-require
   def require!(file)
-    ['.rb', '.so', '.dll', ''].each {|ext| $".delete "#{file}#{ext}"}
-    file = File.expand_path file
-    ['.rb', '.so', '.dll', ''].each {|ext| $".delete "#{file}#{ext}"}
+    [file, File.expand_path(file)].find {|path|
+      ['.rb', '.so', '.dll', ''].find {|ext| 
+        $".delete "#{file}#{ext}"
+      }
+    } || $".del_where {|path| path[%r{/#{file}(.rb|.so|.dll)?$}]}
     require file
   end
 

data/lib/rmtools/core/proc.rb

@@ -3,6 +3,7 @@ class Proc
   NULL = lambda {|*x|} unless defined? Proc::NULL
   TRUE = lambda {|*x| true} unless defined? Proc::TRUE
   FALSE = lambda {|*x| false} unless defined? Proc::FALSE
+  SELF = lambda {|x| x} unless defined? Proc::FALSE
   attr_accessor :string
   
   def when
@@ -12,9 +13,17 @@ class Proc
     end
   end
   
-  def self.eval string, binding=nil
-    (proc = (binding || Kernel).eval "lambda {#{string}}").string = string
-    proc
+  class << self
+    
+    def eval string, binding=nil
+      (proc = (binding || Kernel).eval "lambda {#{string}}").string = string
+      proc
+    end
+    
+    def self; SELF end
+    def noop; NULL end
+    def true; TRUE end
+    def false; FALSE end
   end
   
   if RUBY_VERSION < '1.9'

data/lib/rmtools/core/symbol.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+class Symbol
+  
+  def +(str)
+    to_s + str
+  end
+  
+  def split(splitter='_')
+    to_s.split splitter
+  end
+  alias :/ :split
+  
+  alias :throw_no :method_missing
+  def method_missing(method, *args, &block)
+    if ''.respond_to? method
+      to_s.__send__ method, *args, &block
+    else
+      throw_no method
+    end
+  end
+  
+end

data/lib/rmtools/db.rb

@@ -2,7 +2,7 @@
 begin
   require 'active_record'
   ActiveRecord::Base
-  RMTools::require __FILE__, 'active_record'
+  RMTools::require 'active_record/*'
   # fix for that mystic bug
   #   /usr/lib/ruby/1.8/openssl/ssl-internal.rb:30: [BUG] Segmentation fault
   #   ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

data/lib/rmtools/dev/highlight.rb

@@ -26,7 +26,7 @@ end
 class Proc
   
   def inspect
-    "#{str=to_s}: #{@string ? Painter.green(@string) : "\n"+RMTools.highlighted_line(*source_location)}"
+    "#{to_s}#{@string ? ': '+Painter.green(@string) : source_location && ": \n"+RMTools.highlighted_line(*source_location)}"
   end
   
 end