kyanite 0.5.0 → 0.5.1

data/Div

@@ -1,3 +1,4 @@
+# ruby encoding: utf-8
 
 [ | *Kyanite* | Object | Array | Set | Enumerable | Hash | ]     | Kyanite | TrueClass | FalseClass | NilClass | *Div* | 
 [ ] | *Div* | Tree::TreeNode | Optimizer | 
@@ -9,13 +10,6 @@
 * Undoable          Undo für komplexe Objekte
 
 
-== *Rake* 
-Beispiele siehe Rakefile.rb
-* Methode remove_task, um Tasks überschreiben zu können
-* Tasks werden beim Auflisten nach Namespace gruppiert, nicht verwendete Tasks lassen sich ausblenden, 
-* neuer Rake Task sleep_5
-
-
 == *Unit* *Tests* 
 Die Klasse UnitTest enthält Ergänzungen zu Test::Unit::TestCase:
 * Statusanzeige für durchlaufende Tests

data/History.txt

@@ -1,3 +1,6 @@
+== 0.5.1 2012-10-08
+* improved documentation
+
 == 0.5.0 2012-10-07
 * now works with Ruby 1.9.x
 

data/Manifest.txt

@@ -1,7 +1,3 @@
-0_rake_test.bat
-1_rake_install_gem.bat
-3_rake_deploy.bat
-4_ruby_script_console.bat
 Div
 History.txt
 License.txt
@@ -42,7 +38,6 @@ lib/kyanite/numeric/integer.rb
 lib/kyanite/numeric/numeric.rb
 lib/kyanite/operation.rb
 lib/kyanite/operation/call_tracker.rb
-lib/kyanite/operation/rake.rb
 lib/kyanite/operation/regexp.rb
 lib/kyanite/operation/unit_test.rb
 lib/kyanite/optimizer.rb

data/README.txt

@@ -1,3 +1,4 @@
+# ruby encoding: utf-8
 
 = *Kyanite*
 
@@ -10,7 +11,6 @@ http://kyanite.rubyforge.org
 == Features
 Kyanite is a general toolbox like Facets or ActiveSupport.
 * Transparent nil Handling, see NilClass
-* Beautiful Rake, see Div
 * Comfortable UnitTests, see Div
 
 
@@ -22,17 +22,17 @@ Kyanite is a general toolbox like Facets or ActiveSupport.
 
 
 == License
-[ ] cc-by-sa
-[ ] Creative Commons Attribution-Share Alike 3.0 Germany
-[ ] http://creativecommons.org/licenses/by-sa/3.0/de/deed.en
+cc-by-sa
+Creative Commons Attribution-Share Alike 3.0 Germany
+http://creativecommons.org/licenses/by-sa/3.0/de/deed.en
 
 
 == Homepage
-[ ] http://kyanite.rubyforge.org
+http://kyanite.rubyforge.org
 
 
 == Author
-[ ] Björn Klippstein
+Björn Klippstein
 
 
 == Disclaimer

data/Rakefile.rb

@@ -1,65 +1,58 @@
-
-#  ----------------------------------------------------------------------------------------------
-#  Deploy
-#  
+# ruby encoding: utf-8
 
 require 'rubygems'
 require 'hoe'
-require File.dirname(__FILE__) + '/lib/kyanite'
-# %w[rubygems rake rake/clean fileutils].each { |f| require f }
+require 'rake'
+# require File.dirname(__FILE__) + '/lib/kyanite'
+# require 'kyanite/rake'
 
 
+
+#  ----------------------------------------------------------------------------------------------
+#  Deploy
+#  
+# http://nubyonrails.com/articles/tutorial-publishing-rubygems-with-hoe
+#
 $hoe = Hoe.spec 'kyanite' do | p |
 
   # self.rubyforge_name = 'yourgemx' # if different than 'yourgem'
    
   p.developer('Bjoern Klippstein', 'klippstein@klippstein.com')
+  p.summary               = 'General toolbox like Facets or ActiveSupport.'  
+  p.url                   = 'http://kyanite.rubyforge.org'   
   p.remote_rdoc_dir = '' # Release to root only one project
   p.extra_deps            = [ ['activesupport',   '>= 3.2.8'],
                               ['facets',          '>= 2.9.3'],
                               ['rubytree',        '>= 0.8.3'] ]
-
-  # p.author                = 'Bjoern Klippstein' 
-  # p.email                 = 'bjoernklippstein@gmail.com'
-  # p.url                   = 'http://rapidrubyonrails.de' 
-  # p.url                   = 'http://kyanite.rubyforge.org' 
-  
-  # p.rubyforge_name        = p.name      
-  # p.summary               = 'General toolbox like Facets or ActiveSupport.'
-  # p.changes               = p.paragraphs_of("History.txt", 0..1).join("\n\n")
-  # p.clean_globs           |= %w[**/.DS_Store tmp *.log]
-  # path                    = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
-  # p.rsync_args            = "-av --delete --exclude=statsvn/"
+                              
 end
 
 
 
 
 #  ----------------------------------------------------------------------------------------------
-#  Kyanite
+#  Local Tasks
 #  
 
-# $rake_tasks_ausblenden = %w{ audit bundles:tm deps:email deps:fetch deps:list manifest manifest:refresh
-                             # announce clobber clobber_docs clobber_package clobber_rdoc check_manifest
-                             # config_hoe debug_gem email features gem gemspec generate_key install_gem install_gem_no_doc 
-                             # local_deploy multi package repackage post_blog ridocs  
-                             # rdoc redocs rerdoc release
-                             # website website_generate website_upload }
-# require 'kyanite/rake'
+# remove_task 'release_to_gemcutter'
+# remove_task 'ridocs'
+# Dir['tasks/**/*.rake'].each { |t| load t }
+# remove_task 'rdoc' 
+# remove_task 'docs' 
+# remove_task 'audit' 
+# remove_task 'dcov' 
+# remove_task 'debug_email' 
+# remove_task 'debug_gem' 
+# remove_task 'default' 
+# remove_task 'deps:email' 
+# remove_task 'multi' 
+# remove_task 'newb' 
 
 
 
 
-#  ----------------------------------------------------------------------------------------------
-#  Local Tasks
-#  
-
-# 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]
 
 
 

data/lib/kyanite/array/array.rb

@@ -1,4 +1,4 @@
-
+# ruby encoding: utf-8
 require 'facets/array/delete'           # Methoden delete_unless, delete_values, delete_values_at
 require 'facets/array/rotate'           # Methoden rotate, rotate!
 require 'facets/array/select'           # Methode select!
@@ -15,7 +15,7 @@ require 'kyanite/symbol'                # size
 # ---
 #  
 # == *Tools* *And* *Casts* *For* *Array*
-# [ ] See TestKyaniteArray for tests and examples.
+# See TestKyaniteArray for tests and examples.
 #
 #
 # Aus {Facets/Array}[http://facets.rubyforge.org/doc/api/core/classes/Array.html] eingefügt:
@@ -87,13 +87,6 @@ class Array
   
   
   
-
-  
-  
-
-  
-  
-
   
   
   

data/lib/kyanite/array/array2.rb

@@ -1,4 +1,4 @@
-
+# ruby encoding: utf-8
 require 'kyanite/array/array'   
    
 class Array 
@@ -18,7 +18,7 @@ class NilClass
   def row_to_nil;           nil;              end    
 end
 
-# Ein Array2 ist eine spezielle Form von Array, n�mlich immer zweidimensional. Siehe auch Matrix2!   
+# Ein Array2 ist eine spezielle Form von Array, nämlich immer zweidimensional. Siehe auch Matrix2!   
 # 
 # Ein Array2 kann <b>in jeder Zeile eine verschiedene Anzahl Spalten </b> haben (im Gegensatz zu Instanzen der Klasse Matrix2!)
 # Jede Zeile hat einen Zeilenheader (Zelle 0), einen Spaltenheader gibt es nicht.
@@ -36,7 +36,7 @@ class Array2 < Array
     end        
     
     
-    # Liefert eine bestimmte Zeile zur�ck.
+    # Liefert eine bestimmte Zeile zurück.
     #
     # Tests: TestMatrix2#test_matrix_zellen_und_zeilen    
     def row(i)                                    
@@ -74,8 +74,8 @@ class Array2 < Array
     
     
     # Liefert eine bereinigte Kopie des Array2.  
-    # Level=0:: Platzhalter f�r den More-Link durch echten More-Link ersetzen
-    # Level=1:: Zeilen ohne Zeilenheader werden gel�scht    
+    # Level=0:: Platzhalter für den More-Link durch echten More-Link ersetzen
+    # Level=1:: Zeilen ohne Zeilenheader werden gelöscht    
     #        
     def clean4view(level = 0)
         new = self.collect { |zeile| 

data/lib/kyanite/array/matrix2.rb

@@ -1,18 +1,18 @@
-
+# ruby encoding: utf-8
 require 'kyanite/array/array2'   
 
-# Datenstruktur f�r streng-zweidimensionale Matritzen. Erbt die Methoden von Array2 und Array. Beispiele siehe TestMatrix2.
+# Datenstruktur für streng-zweidimensionale Matritzen. Erbt die Methoden von Array2 und Array. Beispiele siehe TestMatrix2.
 #
 # Eine Matrix2 ist eine spezielle Form von Array2, sie hat <b>in jeder Zeile die gleiche Anzahl Spalten</b>.
 # Jede Zeile hat einen Zeilenheader row(0), jede Spalte einen Spaltenheader column(0).
 #
-# Man k�nnte auch die Standard-Library Matrix verwenden, aber die ist langsam, fehlerhaft und eher auf numerische Werte zugeschnitten denn auf beliebige Objekte.
+# Man könnte auch die Standard-Library Matrix verwenden, aber die ist langsam, fehlerhaft und eher auf numerische Werte zugeschnitten denn auf beliebige Objekte.
 #      
 # noch nicht implementiert: append!(top | bottom | left | right)   
 class Matrix2  < Array2
 
-    # Liefert eine bestimmte Spalte zur�ck.
-    # Dabei wird die Matrix2 vorher mit clean4view!(0) behandelt, d.h. sie ver�ndert sich ggf.!         
+    # Liefert eine bestimmte Spalte zurück.
+    # Dabei wird die Matrix2 vorher mit clean4view!(0) behandelt, d.h. sie verändert sich ggf.!         
     # 
     # Tests: TestMatrix2#test_spalten
     def column(j)                                
@@ -22,7 +22,7 @@ class Matrix2  < Array2
     
     
     # Setzt den Wert einer Spalte.
-    # Dabei wird die Matrix2 vorher mit clean4view!(0) behandelt, d.h. sie ver�ndert sich ggf.!      
+    # Dabei wird die Matrix2 vorher mit clean4view!(0) behandelt, d.h. sie verändert sich ggf.!      
     # 
     # Tests: TestMatrix2#test_spalten
     def set_column!(j,wert)                        
@@ -35,22 +35,22 @@ class Matrix2  < Array2
         return wertdup
     end
 
-    # Wieviele Spalten hat die Tabelle? Ma�geblich daf�r ist die Header-Spalte!
+    # Wieviele Spalten hat die Tabelle? Maßgeblich dafür ist die Header-Spalte!
     def column_size                                
         self[0].size
     end          
 
     
     # Liefert eine bereinigte Kopie der Matrix2.  
-    # Level=0:: Resize to Header, d.h. alle Zeilen werden auf die L�nge der ersten Zeile angepasst (beschnitten oder mit nil aufgef�llt) 
-    # Level=1:: Zeilen ohne Zeilenheader werden gel�scht
-    # Level=2:: Spalten ohne Spaltenheader werden gel�scht      
+    # Level=0:: Resize to Header, d.h. alle Zeilen werden auf die Länge der ersten Zeile angepasst (beschnitten oder mit nil aufgefüllt) 
+    # Level=1:: Zeilen ohne Zeilenheader werden gelöscht
+    # Level=2:: Spalten ohne Spaltenheader werden gelöscht      
     #
     # Test: TestMatrix2#test_resize_to_header
     #
     def clean4view(level = 0)
 
-        # Level 0 : Resize to Header, d.h. alle Zeilen werden auf die L�nge der ersten Zeile angepasst (beschnitten oder mit nil aufgef�llt) 
+        # Level 0 : Resize to Header, d.h. alle Zeilen werden auf die Länge der ersten Zeile angepasst (beschnitten oder mit nil aufgefüllt) 
         cs = self.column_size
         new = self.collect { |zeile| 
                                 zs = zeile.size
@@ -64,13 +64,13 @@ class Matrix2  < Array2
         return Matrix2.new(new) if level == 0                                       # Level 0
 
         
-        #Level 1 : Zeilen ohne Zeilenheader werden gel�scht
+        #Level 1 : Zeilen ohne Zeilenheader werden gelöscht
         new.collect!     { | zeile | zeile.row_to_nil }              
         new.compact!                                                  
         return Matrix2.new(new) if level == 1                                       # Level 1    
 
         
-        # Level 2 : Spalten ohne Spaltenheader werden gel�scht
+        # Level 2 : Spalten ohne Spaltenheader werden gelöscht
                 new.transpose!                                
                 new.collect! { | spalte | spalte.row_to_nil }              
                 new.compact!                                                  

data/lib/kyanite/array.rb

@@ -1,3 +1,4 @@
+# ruby encoding: utf-8
 
 require 'kyanite/array/matrix2' # das ist die oberste Ebene, array2 und array werden ebenfalls required
 require 'kyanite/enumerable/enumerable_enumerables'  

data/lib/kyanite/array_of_enumerables.rb

@@ -1,2 +1,2 @@
-
+# ruby encoding: utf-8
 require 'kyanite/enumerable/enumerable_enumerables'  

data/lib/kyanite/array_of_numerics.rb

@@ -1,2 +1,2 @@
-
+# ruby encoding: utf-8
 require 'kyanite/enumerable/enumerable_numerics'  

data/lib/kyanite/array_of_strings.rb

@@ -1,2 +1,2 @@
-
+# ruby encoding: utf-8
 require 'kyanite/enumerable/enumerable_strings'  

data/lib/kyanite/basics.rb

@@ -1,7 +1,6 @@
-
+# ruby encoding: utf-8
 # Required eine Auswahl wichtiger Kyanite-Libs
 
-$KCODE = 'UTF8'
 
 # ----------------------------------------------------------------
 # innerhalb von Verzeichnissen

data/lib/kyanite/dictionary.rb

@@ -1,4 +1,4 @@
-
+# ruby encoding: utf-8
 require 'hashery' # old: 'facets/dictionary'
 require 'kyanite/enumerable'             # is_collection?
 
@@ -9,9 +9,9 @@ require 'kyanite/enumerable'             # is_collection?
 #  
 #
 # == *Tools* *For* *Facets* *Dictionary*
-# [ ] A Dictionary is a ordered Hash. 
-# [ ] Expands {Facets/Dictionary}[http://facets.rubyforge.org/doc/api/more/classes/Dictionary.html].
-# [ ] See TestKyaniteDictionary for tests and examples.
+# A Dictionary is a ordered Hash. 
+# Expands {Facets/Dictionary}[http://facets.rubyforge.org/doc/api/more/classes/Dictionary.html].
+# See TestKyaniteDictionary for tests and examples.
 #
 #
 class Dictionary < Hashery::Dictionary

data/lib/kyanite/enumerable/enumerable_enumerables.rb

@@ -15,9 +15,9 @@ end
 #
 #
 # == *Enumeration* *Of* *Enumerations*
-# [ ] Für zweidimensionale Enumerables bzw. Aufzählungen von Objekten, die wiederum aufzählbar sind.
-# [ ] See TestKyaniteEnumerableEnumerables for tests and examples.
-# [ ] See ArrayOfEnumerables for an Array with modul EnumerableEnumerables included. 
+# Für zweidimensionale Enumerables bzw. Aufzählungen von Objekten, die wiederum aufzählbar sind.
+# See TestKyaniteEnumerableEnumerables for tests and examples.
+# See ArrayOfEnumerables for an Array with modul EnumerableEnumerables included. 
 #
 #
 module EnumerableEnumerables
@@ -51,8 +51,8 @@ end
 #
 #
 # == *Array* *Of* *Enumerations*
-# [ ] An ArrayOfEnumerables is an Array with modul EnumerableEnumerables included. 
-# [ ] See TestKyaniteEnumerableEnumerables for tests and examples.
+# An ArrayOfEnumerables is an Array with modul EnumerableEnumerables included. 
+# See TestKyaniteEnumerableEnumerables for tests and examples.
 #
 class ArrayOfEnumerables < Array   
   include EnumerableEnumerables

data/lib/kyanite/enumerable/enumerable_numerics.rb

@@ -5,8 +5,8 @@
 #
 #
 # == *Enumeration* *Of* *Numerics*
-# [ ] See TestKyaniteEnumerableNumerics for tests and examples.
-# [ ] See ArrayOfNumerics for an Array with modul EnumerableNumerics included. 
+# See TestKyaniteEnumerableNumerics for tests and examples.
+# See ArrayOfNumerics for an Array with modul EnumerableNumerics included. 
 #
 #
 module EnumerableNumerics
@@ -119,8 +119,8 @@ end #class
 #
 #
 # == *Array* *Of* *Numerics*
-# [ ] An ArrayOfNumerics is an Array with modul EnumerableNumerics included. 
-# [ ] See TestKyaniteEnumerableNumerics for tests and examples.
+# An ArrayOfNumerics is an Array with modul EnumerableNumerics included. 
+# See TestKyaniteEnumerableNumerics for tests and examples.
 #
 class ArrayOfNumerics < Array 
   include EnumerableNumerics

data/lib/kyanite/enumerable/enumerable_strings.rb

@@ -1,12 +1,13 @@
-# ruby encoding: utf-8
+# ruby encoding: utf-8 
+# ü
 
 # [ | Kyanite | Object | Array | Set | *Enumerable* | Hash | ]     | Enumerable | EnumerableNumerics | *EnumerableStrings* | EnumerableEnumerables | 
 # ---
 #
 #
 # == *Enumeration* *Of* *Strings*
-# [ ] See TestKyaniteEnumerableStrings for tests and examples.
-# [ ] See ArrayOfStrings for an Array with modul EnumerableStrings included. 
+# See TestKyaniteEnumerableStrings for tests and examples.
+# See ArrayOfStrings for an Array with modul EnumerableStrings included. 
 #
 # 
 module EnumerableStrings
@@ -42,8 +43,8 @@ end
 #
 #
 # == *Array* *Of* *Strings*
-# [ ] An ArrayOfstrings is an Array with modul EnumerableStrings included. 
-# [ ] See TestKyaniteEnumerableStrings for tests and examples.
+# An ArrayOfstrings is an Array with modul EnumerableStrings included. 
+# See TestKyaniteEnumerableStrings for tests and examples.
 #
 class ArrayOfStrings < Array
   include EnumerableStrings

data/lib/kyanite/enumerable/structure.rb

@@ -1,15 +1,18 @@
 # ruby encoding: utf-8
+require File.join(File.dirname(__FILE__), '..', '..', '..', 'smart_load_path.rb' ); smart_load_path   if $0 == __FILE__ 
 
 require 'kyanite/general/object'
 require 'kyanite/array/array'
+require 'kyanite/dictionary'
+
 
 
 
 class Object
 
-  # [ ] Enthält ein Objekt mehrere Objekte?
-  # [ ] String und Range gelten nicht als Collection.
-  # [ ] See TestKyaniteEnumerableStructure for tests and examples.
+  # Enthält ein Objekt mehrere Objekte?
+  # String und Range gelten nicht als Collection.
+  # See TestKyaniteEnumerableStructure for tests and examples.
   def is_collection?;                 false;          end
   
 end
@@ -17,10 +20,10 @@ end
 
 module Enumerable
 
-  # [ ] Enthält ein Objekt mehrere Objekte?
-  # [ ] Rückgabe: true  
-  # [ ] String und Range gelten nicht als Collection.
-  # [ ] See TestKyaniteEnumerableStructure for tests and examples.
+  # Enthält ein Objekt mehrere Objekte?
+  # Rückgabe: true  
+  # String und Range gelten nicht als Collection.
+  # See TestKyaniteEnumerableStructure for tests and examples.
   def is_collection?;                 true;          end
   
 end
@@ -32,10 +35,10 @@ class String
   # :section: Structure
   #  
 
-  # [ ] Enthält ein Objekt mehrere Objekte?
-  # [ ] Rückgabe: false  
-  # [ ] String und Range gelten nicht als Collection.
-  # [ ] See TestKyaniteEnumerableStructure for tests and examples.
+  # Enthält ein Objekt mehrere Objekte?
+  # Rückgabe: false  
+  # String und Range gelten nicht als Collection.
+  # See TestKyaniteEnumerableStructure for tests and examples.
   def is_collection?;                 false;          end
   
   
@@ -44,10 +47,10 @@ end
 
 class Range 
 
-  # [ ] Enthält ein Objekt mehrere Objekte?
-  # [ ] Rückgabe: false  
-  # [ ] String und Range gelten nicht als Collection.
-  # [ ] See TestKyaniteEnumerableStructure for tests and examples.
+  # Enthält ein Objekt mehrere Objekte?
+  # Rückgabe: false  
+  # String und Range gelten nicht als Collection.
+  # See TestKyaniteEnumerableStructure for tests and examples.
   def is_collection?;                 false;          end
   
 end
@@ -63,16 +66,16 @@ end
 #
 #
 # == *General* *Enumerations*
-# [ ] See TestKyaniteEnumerableStructure for tests and examples.
+# See TestKyaniteEnumerableStructure for tests and examples.
 #
 # 
 module Enumerable
 
-  # [ ] Liefert die Verteilung der size 
-  # [ ] oder die Verteilung der class 
-  # [ ] oder die Verteilung eines anderen Merkmals der aufgezählten Elemente.
-  # [ ] die Methode gibt es auch als Hash#distribution.  
-  # [ ] See TestKyaniteEnumerableStructure  for tests and examples.
+  # Liefert die Verteilung der size 
+  # oder die Verteilung der class 
+  # oder die Verteilung eines anderen Merkmals der aufgezählten Elemente.
+  # die Methode gibt es auch als Hash#distribution.  
+  # See TestKyaniteEnumerableStructure  for tests and examples.
   #
   def distribution( mode = :size)
     verteilung = Hash.new
@@ -135,7 +138,7 @@ module Enumerable
       end
       
     when :all
-      unless ( self.kind_of?(Hash) || self.kind_of?(Dictionary) )
+      unless ( self.kind_of?(Hash) || self.kind_of?(Hashery::Dictionary) )
         c = self.collect {|e| e.class}
       else
         c = self.collect {| key, value | value.class}      
@@ -174,14 +177,14 @@ end #module
 #
 if $0 == __FILE__ 
 
-  require 'kyanite/smart_load_path'; smart_load_path
   class Array
     include Enumerable
   end  
 
 
-  test = [ ]
-  see test.contentclass(:precision => :all)
+  test = [ 1,2,3]
+  puts "Hallo"
+  puts  test.contentclass(:precision => :all)
 
   
 

data/lib/kyanite/enumerable.rb

@@ -1,4 +1,4 @@
-
+# ruby encoding: utf-8  
 require 'kyanite/enumerable/enumerable_enumerables'
 require 'kyanite/enumerable/enumerable_numerics'
 require 'kyanite/enumerable/enumerable_strings'

data/lib/kyanite/general/callerutils.rb

@@ -1,4 +1,4 @@
-
+# ruby encoding: utf-8
 require 'kyanite/string/include'