chars 0.1.0 → 0.1.1

data/History.txt

@@ -1,3 +1,8 @@
+=== 0.1.1 / 2009-04-01
+
+* Renamed CharSet#=~ to CharSet#===.
+* Added an alias from CharSet#=~ to CharSet#===.
+
 === 0.1.0 / 2009-03-16
 
 * Initial release.

data/Manifest.txt

@@ -1,6 +1,7 @@
 History.txt
 Manifest.txt
 README.txt
+TODO.txt
 Rakefile
 lib/chars.rb
 lib/chars/char_set.rb

data/README.txt

@@ -1,7 +1,7 @@
 = Chars
 
 * http://chars.rubyforge.org/
-* http://github.com/postmodern/chars
+* http://github.com/postmodern/chars/
 * Postmodern (postmodern.mod3 at gmail.com)
 
 == DESCRIPTION:
@@ -37,16 +37,22 @@ recognizing text and generating random text from specific character sets.
 
 == EXAMPLES:
 
-* Determine wether a byte belongs to a character set:
+* Determine whether a byte belongs to a character set:
 
     0x41.alpha?
     # => true
 
-* Determine wether a String belongs to a character set:
+* Determine whether a String belongs to a character set:
 
     "22e1c0".hex?
     # => true
 
+* Find all sub-strings that belong to a character set within a String:
+
+    ls = File.read('/bin/ls')
+    Chars.printable.strings_in(ls)
+    # => ["/lib64/ld-linux-x86-64.so.2", "KIq/", "5J~!", "%L~!", ...]
+
 * Return a random character from the set of all characters:
 
     Chars.all.random_char

data/TODO.txt

@@ -0,0 +1,13 @@
+== TODO:
+
+=== 0.1.2:
+
+* Remove CharSet#=~.
+
+=== 0.2.0:
+
+* Implement unicode CharSets.
+  * Rewrite CharSet#===.
+  * Rewrite CharSet#strings_in.
+  * Add unicode sets to Chars.
+

data/lib/chars/char_set.rb

@@ -162,7 +162,7 @@ module Chars
       index = 0
 
       while index <= (data.length - min_length)
-        if self =~ data[index...(index + min_length)]
+        if self === data[index...(index + min_length)]
           sub_index = (index + min_length)
 
           while self.include_char?(data[sub_index..sub_index])
@@ -189,23 +189,25 @@ module Chars
 
     alias + |
 
-      #
-      # Returns +true+ if all of the bytes within the specified _string_
-      # are included in the character set, returns +false+ otherwise.
-      #
-      #   Chars.alpha =~ "hello"
-      #   # => true
-      #
-      def =~(string)
-        return false unless string.respond_to?(:each_byte)
-
-        string.each_byte do |b|
-          return false unless include?(b)
-        end
+    #
+    # Returns +true+ if all of the bytes within the specified _string_
+    # are included in the character set, returns +false+ otherwise.
+    #
+    #   Chars.alpha === "hello"
+    #   # => true
+    #
+    def ===(string)
+      return false unless string.respond_to?(:each_byte)
 
-        return true
+      string.each_byte do |b|
+        return false unless include?(b)
       end
 
+      return true
+    end
+
+    alias =~ ===
+
     #
     # Inspects the character set.
     #

data/lib/chars/extensions/string.rb

@@ -3,63 +3,63 @@ require 'chars/chars'
 class String
 
   def numeric?
-    Chars::NUMERIC =~ self
+    Chars::NUMERIC === self
   end
 
   def octal?
-    Chars::OCTAL =~ self
+    Chars::OCTAL === self
   end
 
   def uppercase_hex?
-    Chars::UPPERCASE_HEXADECIMAL =~ self
+    Chars::UPPERCASE_HEXADECIMAL === self
   end
 
   def lowercase_hex?
-    Chars::LOWERCASE_HEXADECIMAL =~ self
+    Chars::LOWERCASE_HEXADECIMAL === self
   end
 
   def hex?
-    Chars::HEXADECIMAL =~ self
+    Chars::HEXADECIMAL === self
   end
 
   def uppercase_alpha?
-    Chars::UPPERCASE_ALPHA =~ self
+    Chars::UPPERCASE_ALPHA === self
   end
 
   def lowercase_alpha?
-    Chars::LOWERCASE_ALPHA =~ self
+    Chars::LOWERCASE_ALPHA === self
   end
 
   def alpha?
-    Chars::ALPHA =~ self
+    Chars::ALPHA === self
   end
 
   def alpha_numeric?
-    Chars::ALPHA_NUMERIC =~ self
+    Chars::ALPHA_NUMERIC === self
   end
 
   def punctuation?
-    Chars::PUNCTUATION =~ self
+    Chars::PUNCTUATION === self
   end
 
   def symbolic?
-    Chars::SYMBOLS =~ self
+    Chars::SYMBOLS === self
   end
 
   def space?
-    Chars::SPACE =~ self
+    Chars::SPACE === self
   end
 
   def printable?
-    Chars::PRINTABLE =~ self
+    Chars::PRINTABLE === self
   end
 
   def control?
-    Chars::CONTROL =~ self
+    Chars::CONTROL === self
   end
 
   def ascii?
-    Chars::ASCII =~ self
+    Chars::ASCII === self
   end
 
 end

data/lib/chars/version.rb

@@ -1,4 +1,4 @@
 module Chars
   # Chars version
-  VERSION = '0.1.0'
+  VERSION = '0.1.1'
 end

data/spec/char_set_spec.rb

@@ -180,7 +180,7 @@ describe Chars::CharSet do
   end
 
   it "should determine if a String is made up of the characters from the char set" do
-    (@char_set =~ "AABCBAA").should == true
-    (@char_set =~ "AADDEE").should_not == true
+    (@char_set === "AABCBAA").should == true
+    (@char_set === "AADDEE").should_not == true
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: chars
 version: !ruby/object:Gem::Version 
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors: 
 - Postmodern
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-16 00:00:00 -07:00
+date: 2009-04-12 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -20,7 +20,7 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        version: 1.10.0
+        version: 1.12.1
     version: 
 description: Chars is a Ruby library for working with various character sets, recognizing text and generating random text from specific character sets.
 email: 
@@ -33,10 +33,12 @@ extra_rdoc_files:
 - History.txt
 - Manifest.txt
 - README.txt
+- TODO.txt
 files: 
 - History.txt
 - Manifest.txt
 - README.txt
+- TODO.txt
 - Rakefile
 - lib/chars.rb
 - lib/chars/char_set.rb