facets 3.0.0 → 3.1.0

data/demo/core/integer/odd.rdoc

@@ -1,12 +0,0 @@
-== Integer#odd?
-
-    require 'facets/integer/odd'
-
-    (-101..101).step(2) do |n|
-      n.odd?.assert == true
-    end
-
-    (-100..100).step(2) do |n|
-      n.odd?.assert == false
-    end
-

data/demo/core/matchdata/match.rdoc

@@ -1,7 +0,0 @@
-= MatchData#match
-
-  require 'facets/matchdata/match'
-
-  md = /X(a)(b)(c)X/.match("YXabcXY")
-  md.match.assert == "XabcX"
-

data/demo/core/matchdata/matchset.rdoc

@@ -1,15 +0,0 @@
-== MatchData#matchtree
-
-  require 'facets/matchdata/matchset'
-
-  md = /(bb)(cc(dd))(ee)/.match "XXaabbccddeeffXX"
-  md.matchtree.assert == [["bb"], ["cc", ["dd"]], ["ee"]]
-
-  md = /(bb)c(c(dd))(ee)/.match "XXaabbccddeeffXX"
-  md.matchtree.assert == [["bb"], "c", ["c", ["dd"]], ["ee"]]
-
-== MatchData#matchset
-
-  md = /(bb)(cc(dd))(ee)/.match "XXaabbccddeeffXX"
-  md.matchset.assert == ["XXaa", [["bb"], ["cc", ["dd"]], ["ee"]], "ffXX"]
-

data/demo/core/module/cattr.rdoc

@@ -1,43 +0,0 @@
-== Class#cattr
-
-  require 'facets/module/cattr'
-
-  class CAttrMockObject
-    def initialize
-      @@a = 10
-    end
-    def b ; @@b ; end
-  end
-
-  Exception.refute.raised? do
-    CAttrMockObject.class_eval{ cattr :a }
-  end
-  t = CAttrMockObject.new
-  t.a.assert == 10
-
-== Class#cattr_reader
-
-  Exception.refute.raised? do
-    CAttrMockObject.class_eval { cattr_reader :a }
-  end
-  t = CAttrMockObject.new
-  t.a.assert == 10
-
-== Class#cattr_writer
-
-  Exception.refute.raised? do
-    CAttrMockObject.class_eval { cattr_writer :b }
-  end
-  t = CAttrMockObject.new
-  t.b = 5
-  t.b.assert == 5
-
-== Class#cattr_accessor
-
-  Exception.refute.raised? do
-    CAttrMockObject.class_eval { cattr_accessor :c }
-  end
-  t = CAttrMockObject.new
-  t.c = 50
-  t.c.assert == 50
-

data/demo/core/module/class_extend.rdoc

@@ -1,64 +0,0 @@
-== Module#class_extend
-
-  require 'facets/module/class_extend'
-
-Module using class_extend
-
-  mix = Module.new do
-    def i ; end
-    class_extend do
-      def n ; 42   ; end
-      def s ; self ; end
-    end
-  end
-
-Extends module
-
-  mix.n.assert == 42
-  mix.s.assert == mix
-
-Has expected methods
-
-  mix.instance_methods.map{ |m| m.to_s }.assert == ['i']
-
-transfers class methods to including class
-
-  mod = Module.new do
-    include mix
-  end
-  mod.n.assert == 42
-  mod.s.assert == mod
-
-Doesn't overwrite instance methods
-
-  c = Class.new do
-    include mix
-    def n ; 11 ; end
-  end
-  c.new.n.assert == 11
-
-Is overridable via including module
-
-  mod = Module.new do
-    include mix
-    class_extend do
-      def n ; super + 1 ; end
-    end
-  end
-  mod.n.assert == 43  # notice the difference!
-  mod.s.assert == mod
-
-Transfers class methods thru multiple levels of include
-
-  alt = Module.new do
-    include mix
-    class_extend do
-      def n ; super + 1 ; end
-    end
-  end
-  mod = Module.new do
-    include alt
-  end
-  mod.n.assert == 43
-  mod.s.assert == mod
-

data/demo/core/module/method_space.rdoc

@@ -1,55 +0,0 @@
-== Module#method_space
-
-  require 'facets/module/method_space'
-
-  class A
-    attr_writer :x
-    method_space :inside do
-      def x; @x; end
-    end
-  end
-
-  a = A.new
-  a.x = 10
-
-We can see that the `inside` method space has access to the instance space.
-
-  a.inside.x  #=> 10
-
-But there is no reader in the instance space.
-
-  expect NoMethodError do
-    a.x
-  end
-
-== Module#include_as
-
-  require 'facets/module/include_as'
-
-Module#include_as utilizes #method_space to allow modules to be included
-within a separated namespace.
-
-  module T
-    def t ; "Tt"  ; end
-    def r ; "Tr"  ; end
-    def q ; super ; end
-  end
-
-  class N
-    def q ; "Nq" ; end
-  end
-
-  class X < N
-    include_as :test => T
-
-    def n ; test.inspect ; end
-    def m ; test.t ; end
-    def o ; test.r ; end
-  end
-
-  x = X.new
-
-  x.m.assert == "Tt"
-  x.o.assert == "Tr"
-  x.q.assert == "Nq"
-

data/demo/core/string/bytes.rdoc

@@ -1,8 +0,0 @@
-== String#bytes
-
-  require 'facets/string/bytes'
-
-  s = "abc"
-
-  s.bytes.to_a.assert == s.unpack('C*')
-

data/demo/core/string/camelcase.rdoc

@@ -1,47 +0,0 @@
-== String#Camelcase
-
-  require 'facets/string/camelcase'
-
-The `camelcase` method converts snakecase strings into camelcase strings.
-
-  "abc_xyz".camelcase.assert == "abcXyz"
-
-Continious underscore characters are treated as if a single underscore
-character.
-
-  "abc____xyz".camelcase.assert == "abcXyz"
-
-Without an argument the first character is left alone.
-
-  "Camel_case".camelcase.assert == "CamelCase"
-
-Passing +:upper+ or +true+ to #camelcase captializes the first letter.
-This is known as upper-camelcase.
-
-  "Abc_xyz".camelcase(true).assert == "AbcXyz"
-  "Abc____xyz".camelcase(:upper).assert == "AbcXyz"
-
-Where as passing +false+ or +:lower+ downcases the first character,
-known as lower-camelcase.
-
-  "abc_xyz".camelcase(false).assert == "abcXyz"
-  "abc____xyz".camelcase(false).assert == "abcXyz"
-  "Abc_xyz".camelcase(:lower).assert == "abcXyz"
-  "Abc____xyz".camelcase(:lower).assert == "abcXyz"
-
-By passing a match string to the method we can make +camelcase+ 
-apply to each word in a string.
-
-  "abc xyz".camelcase(' ').assert  == "abcXyz"
-  "abc  xyz".camelcase(/\s/).assert == "abcXyz"
-  "abc\txyz".camelcase(/\s/).assert == "abcXyz"
-  "abc\nxyz".camelcase(/\s/).assert == "abcXyz"
-
-== String#lower_camelcase
-
-  "abc_xyz".lower_camelcase.assert == "abcXyz"
-
-== String#upper_camelcase
-
-  "abc_xyz".upper_camelcase.assert == "AbcXyz"
-

data/demo/core/string/characters.rdoc

@@ -1,11 +0,0 @@
-== String#characters
-
-The String#chars methods simply splits a string into
-an Array of character strings.
-
-  require 'facets/string/characters'
-
-  "abc".characters.assert == ["a","b","c"]
-
-  "ab\nc".characters.assert == ["a","b","\n","c"]
-

data/demo/core/string/cleave.rdoc

@@ -1,49 +0,0 @@
-== String#cleave
-
-  require 'facets/string/cleave'
-
-no spaces short word
-
-  s, x = 'whole', ['whole', '']
-  s.cleave.assert == x
-
-no spaces long word
-
-  s, x = 'Supercalifragilisticexpialidocious' , ['Supercalifragilisticexpialidocious', '']
-  s.cleave.assert == x
-
-exact middle two words
-
-  s, x = 'fancy split', ['fancy', 'split']
-  s.cleave.assert == x
-
-exact middle many words
-
-  s, x = 'All good Rubyists know how to party', ['All good Rubyists', 'know how to party']
-  s.cleave.assert == x
-
-closer to start
-
-  s, x = 'short splitter', ['short', 'splitter']
-  s.cleave.assert == x
-
-closer to start
-
-  s, x = 'Four score and seven years ago...', ['Four score and', 'seven years ago...']
-  s.cleave.assert == x
-
-closer to start
-
-  s, x = 'abc def ghijklm nop', ['abc def', 'ghijklm nop']
-  s.cleave.assert == x
-
-closer to end
-
-  s, x = 'extended split', ['extended', 'split']
-  s.cleave.assert == x
-
-closer to end
-
-  s, x = 'abc defghi jklm nop', [ 'abc defghi', 'jklm nop']
-  s.cleave.assert == x
-

data/demo/core/string/divide.rdoc

@@ -1,9 +0,0 @@
-== String#divide
-
-  require 'facets/string/divide'
-
-  s = "<p>This<b>is</b>a test.</p>"
-  d = s.divide(/<.*?>/)
-  e = ["<p>This", "<b>is", "</b>a test.", "</p>"]
-  d.assert == e
-

data/demo/core/string/each_char.rdoc

@@ -1,9 +0,0 @@
-== String#each_char
-
-  require 'facets/string/each_char'
-
-  a = []
-  i = "this"
-  i.each_char{ |w| a << w }
-  a.assert == ['t', 'h', 'i', 's']
-

data/demo/core/string/each_word.rdoc

@@ -1,9 +0,0 @@
-== String#each_word
-
-  require 'facets/string/each_word'
-
-  a = []
-  i = "this is a test"
-  i.each_word{ |w| a << w }
-  a.assert == ['this', 'is', 'a', 'test']
-

data/demo/core/string/end_with.rdoc

@@ -1,6 +0,0 @@
-= String#end_with?
-
-  require 'facets/string/end_with'
-
-  "xxboo".assert.end_with?('boo')
-

data/demo/core/string/expand_tabs.rdoc

@@ -1,69 +0,0 @@
-== String#expand_tab
-
-  require 'facets/string/expand_tab'
-
-We will use this string as a basis for demonstration.
-
-  tabs = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  |\tOne tab
-  | \tOne space and one tab
-  |    \t Six spaces, a tab, and a space
-  EOF
-
-Expanding tabs 0.
-
-  expected = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  |One tab
-  | One space and one tab
-  |     Six spaces, a tab, and a space
-  EOF
-
-  tabs.expand_tabs(0).assert == expected
-
-Expanding tabs 1.
-
-  expected = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  | One tab
-  |  One space and one tab
-  |      Six spaces, a tab, and a space
-  EOF
-
-  tabs.expand_tabs(1).assert == expected
-
-Expanding tabs 4.
-
-  expected = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  |    One tab
-  |    One space and one tab
-  |         Six spaces, a tab, and a space
-  EOF
-
-  tabs.expand_tabs(4).assert == expected
-
-Expanding tabs 8.
-
-  expected = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  |        One tab
-  |        One space and one tab
-  |         Six spaces, a tab, and a space
-  EOF
-
-  tabs.expand_tabs.assert == expected
-  tabs.expand_tabs(8).assert == expected
-
-Expanding tabs 16.
-
-  expected = <<-EOF.gsub(/^\s+\|/, '')
-  |
-  |                One tab
-  |                One space and one tab
-  |                 Six spaces, a tab, and a space
-  EOF
-
-  tabs.expand_tabs(16).assert == expected
-

data/demo/core/string/fold.rdoc

@@ -1,14 +0,0 @@
-== String#fold
-
-  require 'facets/string/fold'
-
-  s = "This is\na test.\n\nIt clumps\nlines of text."
-  o = "This is a test.\n\nIt clumps lines of text."
-  s.fold.assert == o
-
-leave spaces
-
-  s = "This is\na test.\n\n  This is pre.\n  Leave alone.\n\nIt clumps\nlines of text."
-  o = "This is a test.\n\n  This is pre.\n  Leave alone.\n\nIt clumps lines of text."
-  s.fold(true).assert == o
-