kyanite 0.3.1

data/0 start all Tests.bat

@@ -0,0 +1,23 @@
+
+
+@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,88 @@
+lib/kyanite.rb
+lib/kyanite/array/array2.rb
+lib/kyanite/array/array.rb
+lib/kyanite/array/matrix2.rb
+lib/kyanite/enumerable/enumerable_enumerables.rb
+lib/kyanite/enumerable/enumerable_numerics.rb
+lib/kyanite/enumerable/enumerable_strings.rb
+lib/kyanite/enumerable/structure.rb
+lib/kyanite/general/callerutils.rb
+lib/kyanite/general/classutils.rb
+lib/kyanite/general/kernel.rb
+lib/kyanite/general/nil.rb
+lib/kyanite/general/object.rb
+lib/kyanite/general/true_false.rb
+lib/kyanite/general/undoable.rb
+lib/kyanite/numeric/float.rb
+lib/kyanite/numeric/integer.rb
+lib/kyanite/numeric/numeric.rb
+lib/kyanite/operation/call_tracker.rb
+lib/kyanite/operation/rake.rb
+lib/kyanite/operation/unit_test.rb
+lib/kyanite/operation/regexp.rb
+lib/kyanite/string/cast.rb
+lib/kyanite/string/chars.rb
+lib/kyanite/string/chars_const.rb
+lib/kyanite/string/diff.rb
+lib/kyanite/string/div.rb
+lib/kyanite/string/include.rb
+lib/kyanite/string/list.rb
+lib/kyanite/string/mgsub.rb
+lib/kyanite/string/nested.rb
+lib/kyanite/string/random.rb
+lib/kyanite/string/split.rb
+lib/kyanite/array.rb
+lib/kyanite/array_of_enumerables.rb
+lib/kyanite/array_of_numerics.rb
+lib/kyanite/array_of_strings.rb
+lib/kyanite/basics.rb
+lib/kyanite/dictionary.rb
+lib/kyanite/enumerable.rb
+lib/kyanite/general.rb
+lib/kyanite/hash.rb
+lib/kyanite/matrix2.rb
+lib/kyanite/nil.rb
+lib/kyanite/numeric.rb
+lib/kyanite/operation.rb
+lib/kyanite/optimizer.rb
+lib/kyanite/rake.rb
+lib/kyanite/range.rb
+lib/kyanite/set.rb
+lib/kyanite/smart_load_path.rb
+lib/kyanite/string.rb
+lib/kyanite/symbol.rb
+lib/kyanite/tree.rb
+lib/kyanite/undoable.rb
+lib/kyanite/unit_test.rb
+0 start all Tests.bat
+History.txt
+init.rb
+License.txt
+Manifest.txt
+PostInstall.txt
+Rakefile.rb
+README.txt
+test/array/test_array.rb
+test/array/test_matrix2.rb
+test/enumerable/test_enumerable_enumerables.rb
+test/enumerable/test_enumerable_numerics.rb
+test/enumerable/test_enumerable_strings.rb
+test/enumerable/test_structure.rb
+test/general/test_classutils.rb
+test/general/test_nil.rb
+test/general/test_object.rb
+test/general/test_true_false.rb
+test/numeric/test_numeric_integer.rb
+test/string/test_cast.rb
+test/string/test_chars.rb
+test/string/test_diff.rb
+test/string/test_list.rb
+test/string/test_nested.rb
+test/string/test_split.rb
+test/_start_all.rb
+test/test_dictionary.rb
+test/test_hash.rb
+test/test_optimizer.rb
+test/test_range.rb
+test/test_set.rb
+test/test_tree.rb

data/PostInstall.txt

@@ -0,0 +1,4 @@
+
+Kyanite is a general toolbox like Facets or ActiveSupport.
+For more information on Kyanite, see http://kyanite.rubyforge.org
+

data/README.txt

@@ -0,0 +1,48 @@
+= Kyanite
+
+* FIX (url)
+
+== DESCRIPTION:
+
+FIX (describe your package)
+
+== 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:
+
+(The MIT License)
+
+Copyright (c) 2008 FIXME full name
+
+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,79 @@
+
+#  ----------------------------------------------------------------------------------------------
+#  NewGem
+#  
+
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+require File.dirname(__FILE__) + '/lib/kyanite'
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+$hoe = Hoe.new('kyanite', Kyanite::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            = [
+                              ['activesupport',   '>= 2.2.2'],
+                              ['facets',          '>= 2.5.0'],
+                              ['rubytree',        '>= 0.5.2'] 
+                            ]
+  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 Kyanite'
+Rake::RDocTask.new do |rdoc|
+    rdoc.rdoc_dir = 'doc'
+    rdoc.title    = "Kyanite is a general toolbox like Facets or ActiveSupport"
+    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/kyanite/array/array2')
+    rdoc.rdoc_files.exclude('lib/kyanite/array/matrix2')
+    rdoc.rdoc_files.exclude('lib/kyanite.rb')
+    rdoc.options += [
+        '-SNap',
+        '-w4',
+        '--charset=utf8',
+      ]
+end
+
+

data/init.rb

@@ -0,0 +1,2 @@
+
+require File.join(File.dirname(__FILE__),  'lib', 'kyanite.rb' )  

data/lib/kyanite.rb

@@ -0,0 +1,39 @@
+
+# Required alle Kyanite-Libs
+# -- eine Auswahl der wichtigsten Kyanite-Libs required man mit 
+# require 'kyanite/basics'
+
+$KCODE = 'UTF8'
+
+if $:.include?(File.dirname(__FILE__))  ||  $:.include?(File.expand_path(File.dirname(__FILE__)))
+  # puts 'Path schon aktuell'
+else
+  $:.unshift(File.dirname(__FILE__)) 
+end
+
+
+# Die Versionsnummer steht ausserdem 
+#   * im Script '2 install gem.bat'
+#   * in der gem-Verkn�pfung
+module Kyanite
+  VERSION = '0.3.1'
+end
+    
+
+  require 'kyanite/array'
+# require 'kyanite/basics'            # Auswahl
+  require 'kyanite/dictionary'
+  require 'kyanite/enumerable'       
+  require 'kyanite/general'
+  require 'kyanite/hash'
+# require 'kyanite/matrix2'           # ist schon in array
+# require 'kyanite/nil'               # ist schon in general
+  require 'kyanite/numeric'
+# require 'kyanite/operation'         # nur manuell   
+  require 'kyanite/optimizer'
+  require 'kyanite/range'
+  require 'kyanite/set'
+  require 'kyanite/string'
+  require 'kyanite/symbol'
+  require 'kyanite/tree'
+# require 'kyanite/unit_test'         # nur f�r Tests

data/lib/kyanite/array.rb

@@ -0,0 +1,5 @@
+
+require 'kyanite/array/matrix2' # das ist die oberste Ebene, array2 und array werden ebenfalls required
+require 'kyanite/enumerable/enumerable_enumerables'  
+require 'kyanite/enumerable/enumerable_numerics'  
+require 'kyanite/enumerable/enumerable_strings'  

data/lib/kyanite/array/array.rb

@@ -0,0 +1,172 @@
+
+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!
+require 'facets/to_hash'                # Methode to_h (in der Facets-Bibliothek falsch einsortiert?)
+
+require 'kyanite/enumerable'            # 
+require 'kyanite/general/object'        # Methode respond
+require 'kyanite/general/classutils'    # <=> für Class
+require 'kyanite/symbol'                # size 
+
+
+# Array, ArrayOfNumerics, ArrayOfStrings, ArrayOfEnumerables, Set
+#  
+# Tests und Beispiele siehe TestKyaniteArray
+#
+# Aus {Facets/Array}[http://facets.rubyforge.org/doc/api/core/classes/Array.html] eingefügt:
+# * *delete_unless*      <tt>(&block)</tt>              Ergänzung zum regulären +delete_if+
+# * *delete_values*      <tt>(*values)</tt>               Findet und löscht bestimmte Werte 
+# * *delete_values_at*   <tt>(*selectors)</tt>       Löscht Elemente an bestimmten Positionen
+#
+# * *rotate*             <tt>(n=1)</tt>              Alles rückt n Positionen auf
+# * <b>select!</b>       <tt>{ |obj| block }</tt>    Wie +select+, aber modifiziert das Objekt
+# * *to_h*               <tt>(arrayed=nil)</tt>      Converts a two-element associative array into a hash. 
+# * *to_hash*            <tt>()</tt>                 (Unterschied zu +to_h+ ???)
+#     
+# 
+class Array    
+ 
+  # schneidet vorne ein Element ab und gibt den Rest zurück.
+  # Wenn der Rest nur noch aus einem Element besteht, wird er 'pur' zurückgeliefert und nicht als Array.
+  # Nützlich für Rekursionen. Bsp.:
+  #   [1,2,3].shift_complement  =>  [2,3]
+  #   [1,2,3].shift_complement.shift_complement  =>  3
+  #   [1,2,3].shift_complement.shift_complement.shift_complement  =>  nil
+  #
+  # Tests und Beispiele siehe TestKyaniteArray#test_array_shift_complement
+  #
+  def shift_complement
+    if self.size > 2
+      self[1..-1]
+    else
+      self[-1]
+    end
+  end
+  
+  
+
+  
+  
+  # Formuliert den Index eines Arrays
+  #  :pos     als positive Angabe
+  #  :neg     als negative Angabe
+  #  :inv     wenn positiv, dann negativ und umgekehrt 
+  # 
+  # Liefert eine Integerzahl.
+  #
+  # Tests und Beispiele siehe TestKyaniteArray#test_rephrase_index
+  #
+  def rephrase_index(i, style=:inv)
+    return i    if i >  (size-1)
+    return i    if i <  -size
+    case style
+    when :inv
+          if i >=0    # pos >> neg
+            (i - size)
+          else        # neg >> pos
+            (i + size)
+          end
+    when :pos
+          if i >= 0   # pos bleibt
+            i
+          else        # neg >> pos
+            (i + size)
+          end    
+    when :neg
+          if i >= 0   # pos >> neg
+            (i - size)
+          else        # neg bleibt
+            i
+          end    
+    end #case
+  end #def
+  
+  
+  
+
+  
+  
+
+  
+  
+# ==================================================================================
+# divide
+#      
+
+
+
+  # Set#divide doesn't work well recursively because Set can't handle Sets of Sets properly
+  #
+  #
+  # Test und Beispiel siehe TestKyaniteArray#test_divide
+  #  
+  def divide(&func)
+    require 'tsort'
+    class << dig = {}		# :nodoc:
+      include TSort
+      alias tsort_each_node each_key
+      def tsort_each_child(node, &block)
+        fetch(node).each(&block)
+      end #def
+    end #class
+
+    each { |u|
+              dig[u] = a = []
+              each{ |v| func.call(u, v) and a << v }
+          }
+
+    result = []
+    dig.each_strongly_connected_component { |css| result << (self.class.new(css))  }
+    result
+  end #def
+  
+  
+  
+  
+# ==================================================================================
+# Zufall
+#      
+  
+  
+  # Bringt das Array in eine zufällige Reihenfolge
+  def shuffle
+    sort_by { rand }
+  end
+
+  
+  # In-place-Variante von shuffle
+  def shuffle!
+    self.replace shuffle
+  end  
+  
+
+
+end #  class Array         
+
+
+
+class NilClass
+  def shift_complement;               nil;            end  
+end
+
+    
+    
+    
+
+
+
+
+
+    
+    
+    
+    
+
+
+    
+    
+    
+    
+    
+