perception 0.1.5

data/0 start all Tests.bat

@@ -0,0 +1,20 @@
+
+
+@ECHO OFF 
+
+rem CODEPAGE �NDERN
+@cmd /C chcp 1252 > NUL
+
+
+
+echo.
+
+
+ruby test/_start_all.rb
+
+echo.
+echo.
+echo.
+pause
+
+

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2008-08-01
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,21 @@
+LICENSE: GNU General Public License (GPL)
+Autor: Bjoern Klippstein
+
+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/Manifest.txt

@@ -0,0 +1,29 @@
+lib/perception.rb
+lib/perception/const.rb
+lib/perception/date_and_time.rb
+lib/perception/logging.rb
+lib/perception/numeric.rb
+lib/perception/perception_main.rb
+lib/perception/perception_private.rb
+lib/perception/ppp.rb
+lib/perception/string_spread.rb
+lib/perception/test.rb
+0 start all Tests.bat
+History.txt
+init.rb
+License.txt
+Manifest.txt
+PostInstall.txt
+Rakefile.rb
+README.txt
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.html.erb
+demo/demo_pp.rb
+demo/demo_zz.rb
+test/_start_all.rb
+test/test_date_and_time.rb
+test/test_numeric.rb
+test/test_ppp.rb

data/PostInstall.txt

@@ -0,0 +1,6 @@
+
+Perception - Beautiful printouts for humans
+For more information on perception, see http://perception.rubyforge.org
+
+
+

data/README.txt

@@ -0,0 +1,55 @@
+= perception
+
+http://perception.rubyforge.org/
+
+== DESCRIPTION:
+
+Perception - Beautiful printouts for humans
+Perception is a intuitive toolkit for simple everyday debugging. 
+It offers a powerfull replacement for print, puts and pp. 
+
+You get auto-intended and structured output on your console without any configuration. 
+Perception also offers temporary printouts (overwritten by the next print), 
+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.
+
+
+== FEATURES/PROBLEMS:
+
+* FIX (list of features or problems)
+
+== SYNOPSIS:
+
+  FIX (code sample of usage)
+
+== REQUIREMENTS:
+
+* FIX (list of requirements)
+
+== INSTALL:
+
+* FIX (sudo gem install, anything else)
+
+== LICENSE:
+
+GNU General Public License (GPL)
+
+
+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/Rakefile.rb

@@ -0,0 +1,127 @@
+
+#  ----------------------------------------------------------------------------------------------
+#  NewGem
+#  
+
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/perception'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('perception', Perception::VERSION) do |p|
+  p.developer('Bjoern Klippstein', 'bjoernklippstein@gmail.com')
+  p.changes               = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.post_install_message  = 'PostInstall.txt'                                    # TODO remove if post-install message not required
+  p.rubyforge_name        = p.name                                               # TODO this is default value
+  p.extra_deps            = [
+                              ['kyanite',        '>= 0.3.1'],
+                            ]
+  p.extra_dev_deps        = [
+                              ['newgem', ">= #{::Newgem::VERSION}"]
+                          ]
+  
+  p.clean_globs           |= %w[**/.DS_Store tmp *.log]
+  path                    = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir       = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args            = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+# TODO - want other tests/tasks run by default? Add them to the list
+# task :default => [:spec, :features]
+
+
+
+#  ----------------------------------------------------------------------------------------------
+#  Kyanite
+#  
+
+$rake_tasks_ausblenden = %w{ bundles:tm deps:email deps:fetch deps:list manifest manifest:refresh
+                             announce check_manifest debug_gem email install_gem install_gem_no_doc 
+                             local_deploy package post_blog post_news ridocs test_deps}
+require 'kyanite/rake'
+
+
+
+
+
+
+
+#  ----------------------------------------------------------------------------------------------
+#  Documentation
+#  
+# http://github.com/mislav/hanna/tree/master
+
+# instead of 'rake/rdoctask':
+require 'hanna/rdoctask'
+
+desc 'Generate RDoc documentation for Perception'
+Rake::RDocTask.new do |rdoc|
+    rdoc.rdoc_dir = 'doc'
+    rdoc.title    = "Perception - Beautiful printouts for humans"
+    rdoc.rdoc_files.include('README.txt', 'License.txt')
+    rdoc.rdoc_files.include('lib/**/*.rb')
+    rdoc.rdoc_files.include('test/**/test_*.rb')
+    #rdoc.rdoc_files.exclude('lib/perception/array/array2')
+
+    rdoc.options += [
+        '-SNap',
+        '-w4',
+        '--charset=utf8',
+      ]
+end
+
+
+
+
+
+
+
+# Gem::Specification.new do |s|
+  # s.name = %q{perception}
+  # s.version = "0.0.1"
+  # s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  # s.authors = ["Bjoern Klippstein"]
+  # s.date = %q{2008-08-01}
+  # s.description = %q{Beautiful printouts for humans}
+  # s.email = ["b-klippstein@gmx.de"]
+  # s.extra_rdoc_files = ["History.txt", "License.txt", "Manifest.txt", "PostInstall.txt", "README.txt", "website/index.txt"]
+  # s.files = ["", "demo/demo.rb", "demo/demo_pp.rb", "lib/perception/const.rb", "lib/perception/date_and_time.rb", "lib/perception/logging.rb", "lib/perception/n
+# umeric.rb", "lib/perception/perception_main.rb", "lib/perception/perception_private.rb", "lib/perception/ppp.rb", "lib/perception/string_nested.rb", "lib/percep
+# tion/string_spread.rb", "log/see.log", "test/#_start_all_TESTS.bat", "test/_start_all.rb", "test/_testhelper.rb", "test/date_and_time_test.rb", "test/numeric_te
+# st.rb", "test/ppp_test.rb", "test/string_nested_test.rb", "History.txt", "License.txt", "Manifest.txt", "PostInstall.txt", "README.txt", "Rakefile", "config/hoe
+# .rb", "config/requirements.rb", "lib/perception.rb", "lib/perception/version.rb", "script/console", "script/console.cmd", "script/destroy", "script/destroy.cmd"
+# , "script/generate", "script/generate.cmd", "script/txt2html", "script/txt2html.cmd", "setup.rb", "tasks/deployment.rake", "tasks/environment.rake", "tasks/webs
+# ite.rake", "test/test_helper.rb", "test/test_perception.rb", "website/index.html", "website/index.txt", "website/javascripts/rounded_corners_lite.inc.js", "webs
+# ite/stylesheets/screen.css", "website/template.html.erb"]
+  # s.has_rdoc = true
+  # s.homepage = %q{http://perception.rubyforge.org}
+  # s.post_install_message = %q{
+# For more information on perception, see http://perception.rubyforge.org
+
+# NOTE: Change this information in PostInstall.txt
+# You can also delete it if you don't want it.
+
+
+# }
+  # s.rdoc_options = ["--main", "README.txt"]
+  # s.require_paths = ["lib"]
+  # s.rubyforge_project = %q{perception}
+  # s.rubygems_version = %q{1.2.0}
+  # s.summary = %q{Beautiful printouts for humans}
+
+  # if s.respond_to? :specification_version then
+    # current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    # s.specification_version = 2
+
+    # if current_version >= 3 then
+      # s.add_development_dependency(%q<hoe>, [">= 1.7.0"])
+    # else
+      # s.add_dependency(%q<hoe>, [">= 1.7.0"])
+    # end
+  # else
+    # s.add_dependency(%q<hoe>, [">= 1.7.0"])
+  # end
+# end

data/demo/demo_pp.rb

@@ -0,0 +1,163 @@
+
+if $0 == __FILE__ 
+  require File.join(File.dirname(__FILE__), '..', 'lib', 'perception' )  
+else
+  require 'perception'
+end
+
+
+ 
+module Perception #:nodoc
+
+  class DemoSee
+    @@initialized_count = 0
+  
+    def initialize( announce_first=true )
+      #seee.out << :log
+      @@initialized_count += 1
+      return  if (@@initialized_count == 1  &&  !announce_first)
+      #seee.slow!(0.5)
+      seee.left!
+      #seee.indent!
+      see ("\n" * 5)   if @@initialized_count > 1  
+      
+      if announce_first.kind_of?(String)
+        see announce_first
+        see '='*announce_first.size
+      else
+        see "Perception Demo ##{@@initialized_count}"
+        see "=================="
+      end
+      see
+      #wait_for_key('Press any key to start')
+      
+      
+    end # def
+  
+  
+  
+    # Printing basic types
+    def demo_see_basic_types
+      see '1dim Arrays:'
+      seee.indent!
+      see
+      see
+      see 'Other Objects:'
+      see []      
+      see 'ordinary string (without "")'
+      see '(next one is empty)'
+      see ''
+      see 1        
+      see 2      
+      see 3.0        
+      see nil
+      see true
+      see false
+      see :a_symbol
+ 
+      see ['complex array', [1,2,3], {:key => :value, :love => :baby}, 3.0 , '']
+    end # def
+    
+    
+    def demo_see_pp_object
+      seee.logger
+      see seee
+    end
+    
+    
+    def demo_see_pp_array  
+      @array1 = []
+      @array1 << ['this','is','an','array','1']
+      @array1 << ['this','is','another','array','2']
+      @array1 << ['and','this','is','another', :tree]
+      @array1 << ['no',{:key => :value},'just','another', 'array']
+      see @array1
+      see    
+      see          
+      @text1 = 'long_longlong_long_long'
+      @text2 = 'also_long, also_long, also_long_also'
+      @text3 = 'hallo'
+      @array2 = []
+      @array2 << %W{one a b c}
+      @array2 << ['two', @text1, @text2, @text3]
+      @array2 << ['three', @text2, @text2, @text1]
+      see @array2
+    end    
+
+    
+    def demo_see_pp_hash  
+      see({:this => :hash, :in => :one, :see => 'short hash in one line'})
+      see
+      see       
+      see({:this => :hash, :size => '> 3', :see => 'longer hash in multiple lines', :another_key => 'another value'})         
+      see
+      see       
+      @hash = { :hash => true,
+                :init => true,
+                :nil  => nil,
+                :symbol => :symbol,
+                :text => 'text',
+                :array => [1,2,3],
+                :integer => 1,
+                :string => 'hallo',
+                :nochn_hash => {:key => :value, :bla => :blubb, :array => [:a,:b,:c], :another_key => 'another value'}
+               }
+      see @hash  
+    end   
+
+
+    def demo_see_pp_dictionary
+      require 'facets/dictionary'
+        
+      @dictionary = Dictionary.new  
+      @dictionary[:a_dictionary] =    true
+      @dictionary[:b_init] =          true
+      @dictionary[:c_symbol] =        :symbol
+      @dictionary[:d_array] =         [1,2,3]
+      @dictionary[:e_integer] =       1
+      @dictionary[:f_string] =        'hallo'
+        @subdictionary = Dictionary.new    
+        @subdictionary[:a] =  :value
+        @subdictionary[:b] =  'blubb'
+        @subdictionary[:c] =  2
+        @subdictionary[:d] =  [:a,:b,:c]
+        @subdictionary[:e] =  { :key => :value}
+        @subdictionary[:f] =  'hallo'  
+      @dictionary[:g_subdictionary] = @subdictionary  
+      see @dictionary       
+    end
+    
+    
+    def self.see_all_demos
+      Perception::DemoSee.new('PrettyPrint Array').demo_see_pp_array     
+      Perception::DemoSee.new('PrettyPrint Object').demo_see_pp_object  
+      Perception::DemoSee.new('PrettyPrint Hash').demo_see_pp_hash       
+      #Perception::DemoSee.new('PrettyPrint Dictionary').demo_see_pp_dictionary      
+
+      
+      #Perception::DemoSee.new('PrettyPrint div').demo_see_basic_types  
+ 
+    end
+
+  
+  
+  end # class
+end # class
+
+
+if $0 == __FILE__ then
+
+Perception::DemoSee.see_all_demos
+
+   
+end
+
+  
+
+    
+
+
+
+
+
+