nano 0.8.1

data/README.dev

@@ -0,0 +1,12 @@
+
+If your are insterested in working on this library there are a couple things to know.
+
+First, we use Reap rather then Rake to handle the most common package management choirs.
+Go to reap.rubyforge.org for more info.
+
+We still use Rake for a couple odd tasks, like building the method index file. Speaking of which,
+remember to run 'rake all' to build the index and the special require files. See the Rakefile itself 
+for more details. I'll comment more on this at a later time.
+
+For manual installation we use setup.rb.
+

data/Rakefile

@@ -0,0 +1,124 @@
+
+require 'rake'
+require 'reap/reap-all'
+
+require 'yaml'
+require 'uri'
+require 'fileutils'
+require 'nanosys'
+
+raise 'Not running from the correct location. Aborted.' unless File.directory?('lib')
+
+LIBPATH = 'lib'
+GENPATH = 'lib/nano'
+REQPATH = 'nano'
+DATPATH = 'data/site_ruby/nano'
+
+#-----------------------------------------------------
+# Read in the nano directory and sort-out per class
+#-----------------------------------------------------
+Methods = {}
+MethodSets = []
+
+task :scrape_methods do
+  Dir.chdir('lib/nano') do
+    dg = Dir.glob( '**/*.rb' )
+    dg.each { |f|
+      klass, meth = f.split('/')
+      if meth
+        (Methods[ klass ] ||= []) << meth.chomp('.rb')
+      else  # a method-set
+        MethodSets << klass.chomp('.rb')
+      end
+    }
+  end
+end
+
+#-----------------------------------------------------
+# Save method index to file in yaml format
+#-----------------------------------------------------
+desc %{generate method index file}
+task :index => [ :scrape_methods ] do
+  print "Creating method index... "
+  loc = File.join( DATPATH, 'index.yaml' )
+  File.open( loc, 'w' ) { |f|
+    f << Methods.to_yaml
+  }
+  puts "[done]"
+end
+
+#-----------------------------------------------------
+# Do anything with the method sets?
+#-----------------------------------------------------
+
+#-----------------------------------------------------
+# Generate base require
+#-----------------------------------------------------
+desc %Q{generate base require file}
+task :base do
+  print "Creating base file... "
+  fn = File.expand_path("#{GENPATH}/base.rb")
+  fc = ''
+  NanoSystem.base.each { |bf|
+    fc << %Q{require '#{REQPATH}/#{bf}'\n}
+  }
+  File.open( fn, 'w' ) { |f| f << fc }
+  puts "[done]"
+end
+
+#-----------------------------------------------------
+# Generate full require
+#-----------------------------------------------------
+desc %Q{generate full require file}
+task :full do
+  print "Creating full file... "
+  fn = File.expand_path("#{GENPATH}/full.rb")
+  fc = ''
+  NanoSystem.full.each { |bf|
+    fc << %Q{require '#{REQPATH}/#{bf}'\n}
+  }
+  File.open( fn, 'w' ) { |f| f << fc }
+  puts "[done]"
+end
+
+#-----------------------------------------------------
+# Create per class feature files
+#-----------------------------------------------------
+desc %Q{generate per-class feature files.}
+task :perclass do
+  print "Creating per class files... "
+  NanoSystem.classes.each { |classname|
+    rfs = NanoSystem.files( classname )
+    File.open( "#{GENPATH}/#{classname.downcase}.rb", 'w' ) { |f|
+      rfs.each { |r|
+        unless NanoSystem.noauto.include?(r) or NanoSystem.unsafe.include?(r)
+          f << %Q{require '#{REQPATH}/#{r}'\n}
+        end
+      }
+    }
+  }
+  puts "[done]"
+end
+
+#-----------------------------------------------------
+# Do everything needed
+#-----------------------------------------------------
+desc %{do all required prepetory tasks}
+task :allprep => [ :index, :base, :full, :perclass ] do
+end
+
+#-----------------------------------------------------
+# List Methods
+#-----------------------------------------------------
+desc %{output a list of all methods}
+task 'list' => [ :scrape_methods ] do
+  #y Methods
+  s= ''
+  Methods.keys.sort.each { |k|
+    ms = Methods[k].collect{ |m| URI.unescape(m) }.sort
+    s << "#{k}:\n"
+    ms.each { |m| s << "  #{m}\n" }
+  }
+  puts s
+end
+

data/Reapfile

@@ -0,0 +1,87 @@
+--- %YAML:1.0
+
+TITLE: &title Nano Methods
+NAME: &pkg nano
+VERSION: '0.8.1'
+AUTHOR: Trans
+EMAIL: transfire@gmail.com
+HOMEPAGE: "http://nano.rubyforge.org"
+
+SUMMARY: Ruby's Atomic Library
+
+DESCRIPTION: >
+  Nano Methods is a cornicopia of extension methods for
+  the Ruby programming language. Nano's extensions are
+  unique by virtue of thier atomicity. Methods are stored
+  in their own files, allowing for highly granular
+  control of requirements.
+
+RUBYFORGE:
+  PROJECT: 'nano'
+  USERNAME: transami
+
+PUBLISH:
+  HOST: rubyforge
+  TYPE: web
+  USERNAME: transami
+  PROJECT: nano
+  DIR: 'pub/www'
+
+TEST:
+  FILES:
+    - 'test/**/tc_*.rb'
+  OPTIONS: ~
+
+RDOC:
+  TITLE: *title
+  DIR: 'pub/www/doc'
+  TEMPLATE: jamis #html #ruby-red
+  OPTIONS: ['--merge', '--promiscuous', '--all']
+  MAIN: README
+  INCLUDE:
+    - 'README'
+    - 'COPYING'
+    - 'lib/**/*.rb'
+  EXCLUDE: []
+
+PACKAGE:
+  DIR: pkg
+  INCLUDE:
+    - 'lib/**/*'
+    - 'data/**/*'
+    - 'ext/**/*'
+    - 'bench/**/*'
+    - 'test/**/*'
+    - 'rdoc/**/*'
+    - 'doc/**/*'
+    - 'pub/**/*'
+    - 'demo/**/*'
+    - 'samples/**/*'
+    - 'examples/**/*'
+    - 'setup.rb'
+    - '[A-Z]*'
+  EXCLUDE:
+    - InstalledFiles
+  AUTOREQUIRE: ~
+  REQUIREMENTS: []
+  DEPENDENCIES: []
+  EXECUTABLES: []
+  ZIP: true
+  GZIP: true
+  BZIP2: true
+  GEM: true
+
+ANNOUNCE:
+  TO: transfire@gmail.com #ruby-talk@ruby-lang.org
+  FROM: transfire@gmail.com
+  DOMAIN: jupiterzeus.net
+  SERVER: smtp.gmail.com
+  PORT: 25
+  ACCOUNT: transfire@gmail.com
+  AUTHTYPE: login  #cram_md5 #plain
+  TLS: true
+  FILE: ANN-0.8.1
+  SLOGAN: ALL YOUR BASE ARE BELONG TO RUBY!
+  INFO:
+    - http://nano.rubyforge.org
+

data/TODO

@@ -0,0 +1,43 @@
+-- !!todo
+
+# IT IS ALWAYS A GOOD IDEA TO WRITE A TEST!
+# AND ITS ALWAYS A FINE THING TO IMPROVE DOCUMENTATION!
+
+- hash/invert: What about letting Hash#invert take a block that specifies
+  what to do when a collision occurs?
+
+- hash/at_rand: allow for a _number_ of values, keys and pairs to be returned.
+
+- > Yep. Gone. But I may replace with a version that deletes only the first 
+  > matching element. Thoughts?
+  If you don't want to do that I would rather add an option hash to .delete and
+  use :once => true or something similar. (More expressive)
+
+- numeric/bound_by: Numeric includes Comparable. Maybe drop this, but 
+  might it be reasonable for Numeric but no other comparables?
+
+- nil/[]: Why should nil respond to [], but not to .each? I don't think 
+  nil should be treated as a container.
+  nil/length: See above.
+
+- nil/method_missing: I'm not so sure about this. There is a lot of 
+  libraries depending on nil raising exceptions on failed method access. I 
+  also think that this could make programming errors very hard to find.
+
+- fileutils/head&tail: Hm, I think the block forms ought to be equivalent to 
+  tail -f and so on. Then the block forms should also return all lines by default
+  instead of only the first 10.
+
+- fileutils/which: Should probably be based on fileutils/where_is as they have 
+  lots of common code. The two methods should probably also use RUBY_PLATFORM instead
+  of checking for ALT_SEPARATOR.
+
+- module/memoize: Should the main memoize method be defined as it is? 
+  (see bottom of file).
+
+- kernel/demo: It can be implemented as demo "1+1"  using Binding.of_caller. 
+  Using only the block is possibly with SCRIPT_LINES__ or File access and is quite ugly.
+
+- hash/weave: Document how does it compare to Hash#merge?
+
+- Could use a better String#word_wrap method.

data/Version

@@ -0,0 +1,14 @@
+0.8.0 Nano Revolution
+0.7.2 George II
+0.7.1 Quick George
+0.7.0 Georgian Transform
+0.6.3 Gemstone
+0.6.2 Refinement I
+0.6.1 Florian's Mixes
+0.6.0 Florian's Onslaught
+0.5.0 First Release
+0.4.0 Raspberry
+0.3.0 ABC
+0.2.0 Succ
+0.1.0 TomsLib
+

data/data/site_ruby/nano/base

@@ -0,0 +1,32 @@
+
+# nano-methods considered base (ie. fundemental)
+
+kernel/require_nano.rb
+array/to_h.rb
+binding/eval.rb
+binding/self.rb
+binding/caller.rb
+comparable/cmp.rb
+enumerable/collect_with_counter.rb
+enumerable/each_slice.rb
+float/round_off.rb
+float/round_to.rb
+float/round_at.rb
+hash/slice.rb
+hash/to_h.rb
+kernel/fn.rb
+kernel/called.rb
+kernel/here.rb
+matchdata/match.rb
+module/basename.rb
+nilclass/to_f.rb
+nilclass/to_h.rb
+object/metaclass.rb
+proc/to_method.rb
+range/to_r.rb
+regexp/to_re.rb
+string/blank%3F.rb
+string/cmp.rb
+string/to_re.rb
+symbol/not.rb
+time/to_time

data/data/site_ruby/nano/index.yaml

@@ -0,0 +1,422 @@
+--- 
+kernel: 
+  - call_stack
+  - p
+  - get_by_id
+  - demo
+  - resc
+  - require_all
+  - fn
+  - require_nano
+  - require_esc
+  - autoreload
+  - autoreload_glob
+  - bug%21
+  - nack
+  - silence_warnings
+  - method_name
+  - "__require__"
+  - maybe
+  - require_local
+  - returning
+  - here
+  - called
+  - warn_with_line
+  - silently
+integer: 
+  - odd%3F
+  - times_collect
+  - times_map
+  - fact
+  - factorial
+  - ordinal
+  - multiple%3F
+  - even%3F
+module: 
+  - redefine_method
+  - redirect_method
+  - initializer
+  - clone_renaming
+  - undef
+  - clone_removing
+  - modspace
+  - instance_methods
+  - sattr
+  - attr_tester
+  - integrate
+  - basename
+  - generate_instance_method_name
+  - sattr_setter
+  - redirect
+  - alias_module_function
+  - namespace
+  - abstract
+  - cattr_reader
+  - wrap_method
+  - cattr_writer
+  - include_as
+  - rename_method
+  - attr_setter
+  - rename
+  - dirname
+  - sattr_accessor
+  - remove
+  - sattr_tester
+  - sort_on
+  - cattr_accessor
+  - sattr_reader
+  - equate_on
+  - redef
+  - clone_using
+  - by_name
+  - memoize
+  - wrap
+  - sattr_writer
+continuation: 
+  - "%3A%3Acreate"
+symbol: 
+  - camelcase
+  - to_proc
+  - downcase%3F
+  - succ
+  - upcase%3F
+  - camelize
+  - not
+  - pad
+  - to_const
+  - underscore
+  - capitalized%3F
+  - to_str
+regexp: 
+  - to_regexp
+  - to_re
+  - arity
+class: 
+  - descendents
+  - remove_subclasses
+  - remove_descendents
+  - subclasses
+  - by_name
+time: 
+  - change
+  - to_date
+  - to_s
+  - "%3A%3Adays_extrema"
+  - stamp
+  - to_time
+  - elapse
+dir: 
+  - "%3A%3Arecurse"
+  - "%3A%3Als_r"
+hash: 
+  - collate
+  - assert_has_keys
+  - graph%21
+  - join
+  - has_only_keys%3F
+  - swapkey%21
+  - alias%21
+  - "%5B%5D%3D"
+  - at
+  - each
+  - to_ostruct
+  - inverse
+  - "%3C%3C"
+  - rand_value
+  - has_keys%3F
+  - "%5B%5D"
+  - assert_has_only_keys
+  - keys_to_sym
+  - collate%21
+  - "%3A%3Azipnew"
+  - delete_unless
+  - replace_each
+  - shuffle%21
+  - rand_key
+  - to_h
+  - slice
+  - traverse%21
+  - keys_to_sym%21
+  - traverse
+  - shuffle
+  - to_ostruct_recurse
+  - swap%21
+  - keys_to_s%21
+  - keys_to_s
+  - weave
+  - rand_pair
+  - update_each
+date: 
+  - to_date
+  - days_in_month
+  - to_s
+  - stamp
+  - to_time
+  - days_of_month
+matchdata: 
+  - matchtree
+  - matchset
+  - match
+proc: 
+  - to_method
+  - compose
+  - "%2A"
+pathname: 
+  - descend
+  - ascend
+numeric: 
+  - distance
+  - succ
+  - to_b
+  - ceil_multiple
+  - pred
+range: 
+  - within%3F
+  - umbrella
+  - to_r
+  - to_range
+nilclass: 
+  - size
+  - "%5B%5D"
+  - length
+  - to_f
+  - to_h
+  - method_missing
+  - empty%3F
+  - include%3F
+array: 
+  - "%5B%5D%3D"
+  - at_rand%21
+  - rand_index
+  - first%21
+  - first%3D
+  - rand_subset
+  - select%21
+  - slap
+  - tail
+  - "%5B%5D"
+  - delete_unless
+  - delete_values
+  - rotate%21
+  - shuffle%21
+  - last_index
+  - thru
+  - at_rand
+  - foot
+  - range
+  - to_b
+  - to_h
+  - pick%21
+  - mid
+  - delete_values_at
+  - head
+  - pos
+  - rotate
+  - shuffle
+  - middle
+  - pick
+  - last%21
+  - last%3D
+  - store
+  - bulk
+ostruct: 
+  - ostruct_update
+  - "%5B%5D%3D"
+  - "%5B%5D"
+enumerable: 
+  - find_collisions
+  - map_with_counter
+  - none%3F
+  - each_unique_pair
+  - eF
+  - graph
+  - filter_collect
+  - one%3F
+  - map_with_index
+  - ideal_entropy
+  - "%2A%2A"
+  - partition_by
+  - each_permutation
+  - probability
+  - collect_with_counter
+  - collect_with_index
+  - to_h
+  - each_by
+  - "%25"
+  - compact_collect
+  - frequency
+  - compact_map
+  - filter_map
+  - occur
+  - "%3A%3Acombinations"
+  - "%3A%3Across"
+  - commonality
+  - each_combination
+  - each_slice
+  - unique_by
+  - entropy
+  - cross
+comparable: 
+  - cap
+  - cmp
+  - at_least
+  - at_most
+  - clip
+binding: 
+  - call_stack
+  - "%3A%3Aof_caller"
+  - "%5B%5D%3D"
+  - self
+  - of_caller
+  - "__DIR__"
+  - "%5B%5D"
+  - "__LINE__"
+  - eval
+  - method_name
+  - defined%3F
+  - called
+  - caller
+  - "__FILE__"
+  - local_variables
+object: 
+  - constant
+  - copy
+  - set_with
+  - to_bool
+  - superup
+  - methods
+  - special_class
+  - super_method
+  - assign_from
+  - "__class__"
+  - super_send
+  - generate_method_name
+  - with_reader
+  - to_b
+  - val%3F
+  - with_writer
+  - object_class
+  - false%3F
+  - new
+  - with_accessor
+  - bool%3F
+  - metaclass
+  - assign_with
+  - true%3F
+  - set_from
+  - method%21
+  - singleton_class
+  - object_hexid
+  - deep_copy
+  - in%3F
+logger: 
+  - format
+  - format_message
+string: 
+  - word_filter%21
+  - push
+  - shift
+  - dresner
+  - plural
+  - word_filter
+  - unix_crypt
+  - camelcase
+  - "%3A%3Apatterns"
+  - humanize
+  - at
+  - margin
+  - dequote
+  - word_wrap
+  - last
+  - unpack
+  - at_rand%21
+  - rand_index
+  - nchar
+  - singular
+  - brief
+  - similarity
+  - rand_byte
+  - first%21
+  - first%3D
+  - to_proc
+  - demodulize
+  - to_date
+  - dresner%21
+  - chars
+  - slap
+  - downcase%3F
+  - first_char
+  - "%3A%3Arand_letter"
+  - bracket%21
+  - unix_crypt%21
+  - bytes
+  - basename
+  - succ
+  - probability
+  - cmp
+  - whitespace%3F
+  - at_rand
+  - upcase%3F
+  - first
+  - uppercase%3F
+  - word_wrap%21
+  - fold
+  - camelize
+  - lowercase%3F
+  - range
+  - to_a
+  - to_b
+  - to_re
+  - last_char
+  - line_wrap
+  - tabto
+  - align_center
+  - words
+  - indent
+  - align_right
+  - to_const
+  - pop
+  - "%3A%3Arandom"
+  - align_left
+  - tab
+  - range_of_line
+  - frequency
+  - to_time
+  - to_arr
+  - ordinal
+  - shuffle
+  - each_char
+  - unshift
+  - each_word
+  - bracket
+  - index_all
+  - quote
+  - soundex
+  - last%21
+  - last%3D
+  - range_all
+  - mscan
+  - blank%3F
+  - rand_byte%21
+  - shatter
+  - underscore
+  - natcmp
+  - capitalized%3F
+  - lines
+float: 
+  - round_off
+  - round_at
+  - round_to
+  - "approx?"
+fileutils: 
+  - wc
+  - tail
+  - which
+  - safe_ln
+  - head
+  - slice
+  - whereis
+file: 
+  - "%3A%3Asplit_all"
+  - "%3A%3Aopen_as_string"
+  - "%3A%3Acreate"