chars 0.1.2 → 0.2.0

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+- 
+ChangeLog.*
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown --title 'Chars Documentation' --protected --files ChangeLog.md,LICENSE.txt

data/{History.txt → ChangeLog.md}

@@ -1,4 +1,9 @@
-=== 0.1.2 / 2009-09-21
+### 0.2.0 / 2010-10-27
+
+* Make sure all enumerable methods in {Chars::CharSet} return an
+  `Enumerator` object if no block is given.
+
+### 0.1.2 / 2009-09-21
 
 * Require Hoe >= 2.3.3.
 * Require YARD >= 0.2.3.5.
@@ -10,12 +15,12 @@
 * Moved to YARD based documentation.
 * All specs now pass on JRuby 1.3.1.
 
-=== 0.1.1 / 2009-04-01
+### 0.1.1 / 2009-04-01
 
 * Renamed CharSet#=~ to CharSet#===.
 * Added an alias from CharSet#=~ to CharSet#===.
 
-=== 0.1.0 / 2009-03-16
+### 0.1.0 / 2009-03-16
 
 * Initial release.
 * Provides character sets for:

data/LICENSE.txt

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2009-2010 Hal Brodigan
+
+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/{README.txt → README.md}

@@ -1,15 +1,15 @@
-= Chars
+# Chars
 
 * http://chars.rubyforge.org/
 * http://github.com/postmodern/chars/
 * Postmodern (postmodern.mod3 at gmail.com)
 
-== DESCRIPTION:
+## Description
 
 Chars is a Ruby library for working with various character sets,
 recognizing text and generating random text from specific character sets.
 
-== FEATURES:
+## Features
 
 * Provides character sets for:
   * Numeric ('0' - '9')
@@ -38,74 +38,56 @@ recognizing text and generating random text from specific character sets.
   * Signed ASCII ('\x00' - '\x7f')
   * ASCII ('\x00' - '\xff')
 
-== EXAMPLES:
+## Examples
 
-* Determine whether a byte belongs to a character set:
+Determine whether a byte belongs to a character set:
 
     0x41.alpha?
     # => true
 
-* Determine whether 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:
+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:
+Return a random character from the set of all characters:
 
     Chars.all.random_char
     # => "\x94"
 
-* Return a random Array of characters from the alpha-numeric character set:
+Return a random Array of characters from the alpha-numeric character set:
 
     Chars.alpha_numeric.random_chars(10)
     # => ["Q", "N", "S", "4", "x", "z", "3", "M", "F", "F"]
 
-* Return a random Array of a random length of unique characters from the visible character set:
+Return a random Array of a random length of unique characters from the
+visible character set:
+
     Chars.visible.random_distinct_chars(1..10)
     # => ["S", "l", "o", "8", "'", "q"]
 
-* Return a random String from the set of all characters:
+Return a random String from the set of all characters:
 
     Chars.all.random_string(10)
     # => "\xc2h\xad\xccm7\x1e6J\x13"
 
-* Return a random String with a random length between 5 and 10, from the
-  set of space characters:
+Return a random String with a random length between 5 and 10, from the
+set of space characters:
 
     Chars.space.random_string(5..10)
     # => "\r\v\n\t\n\f"
 
-== INSTALL:
-
-  $ sudo gem install chars
-
-== LICENSE:
-
-The MIT License
+## Install
 
-Copyright (c) 2009 Hal Brodigan
+    $ sudo gem install chars
 
-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:
+## License
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
+See {file:LICENSE.txt} for license information.
 
-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

@@ -1,24 +1,35 @@
-# -*- ruby -*-
-
 require 'rubygems'
-require 'hoe'
-require 'hoe/signing'
-require './tasks/spec.rb'
-require './tasks/yard.rb'
+require 'rake'
+
+begin
+  gem 'ore-tasks', '~> 0.1.2'
+  require 'ore/tasks'
 
-Hoe.spec('chars') do
-  self.rubyforge_name = 'chars'
-  self.developer('Postmodern','postmodern.mod3@gmail.com')
-  self.remote_rdoc_dir = '/'
-  self.extra_deps = [
-    ['yard', '>=0.2.3.5']
-  ]
+  Ore::Tasks.new
+rescue LoadError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `gem install ore-tasks` to install 'ore/tasks'."
+end
 
-  self.extra_dev_deps = [
-    ['rspec', '>=1.2.8']
-  ]
+begin
+  gem 'rspec', '~> 2.0.0'
+  require 'rspec/core/rake_task'
 
-  self.spec_extras = {:has_rdoc => 'yard'}
+  RSpec::Core::RakeTask.new
+rescue LoadError => e
+  task :spec do
+    abort "Please run `gem install rspec` to install RSpec."
+  end
 end
+task :default => :spec
 
-# vim: syntax=Ruby
+begin
+  gem 'yard', '~> 0.6.0'
+  require 'yard'
+
+  YARD::Rake::YardocTask.new  
+rescue LoadError => e
+  task :yard do
+    abort "Please run `gem install yard` to install YARD."
+  end
+end

data/chars.gemspec

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+
+begin
+  Ore::Specification.new do |gemspec|
+    # custom logic here
+  end
+rescue NameError
+  STDERR.puts "The 'chars.gemspec' file requires Ore."
+  STDERR.puts "Run `gem install ore` to install Ore."
+end

data/gemspec.yml

@@ -0,0 +1,16 @@
+name: chars
+summary: A Ruby library for working with various character sets
+description:
+  Chars is a Ruby library for working with various character sets,
+  recognizing text and generating random text from specific character sets.
+
+license: MIT
+homepage: http://github.com/postmodern/chars
+authors: Postmodern
+email: postmodern.mod3@gmail.com
+has_yard: true
+
+development_dependencies:
+  ore: ~> 0.2.0
+  ore-tasks: ~> 0.1.2
+  rspec: ~> 2.0.0

data/lib/chars/char_set.rb

@@ -42,10 +42,10 @@ module Chars
     #   character set.
     #
     def include_char?(char)
-      return false unless char.respond_to?(:each_byte)
-
-      char.each_byte do |b|
-        return include?(b)
+      if char.respond_to?(:each_byte)
+        char.each_byte.any? { |b| include?(b) }
+      else
+        false
       end
     end
 
@@ -69,8 +69,13 @@ module Chars
     # @yieldparam [String] char
     #   Each character in the character set.
     #
-    def each_char(&block)
-      each { |b| block.call(b.chr) } if block
+    # @return [Enumerator]
+    #   If no block is given, an enumerator object will be returned.
+    #
+    def each_char
+      return enum_for(:each_char) unless block_given?
+
+      each { |b| yield b.chr }
     end
 
     #
@@ -135,11 +140,14 @@ module Chars
     # @yieldparam [Integer] byte
     #   The random byte from the character set.
     #
-    # @return [Integer]
-    #   The number of times the given block was passed random bytes.
+    # @return [Enumerator]
+    #   If no block is given, an enumerator object will be returned.
     #
     def each_random_byte(n,&block)
-      n.times { block.call(random_byte) }
+      return enum_for(:each_random_byte,n) unless block_given?
+
+      n.times { yield random_byte }
+      return nil
     end
 
     #
@@ -154,11 +162,13 @@ module Chars
     # @yieldparam [String] char
     #   The random character from the character set.
     #
-    # @return [Integer]
-    #   The number of times the given block was passed random characters.
+    # @return [Enumerator]
+    #   If no block is given, an enumerator object will be returned.
     #
     def each_random_char(n,&block)
-      each_random_byte(n) { |b| block.call(b.chr) }
+      return enum_for(:each_random_char,n) unless block_given?
+
+      each_random_byte(n) { |b| yield b.chr }
     end
 
     #
@@ -172,9 +182,9 @@ module Chars
     #
     def random_bytes(length)
       if (length.kind_of?(Array) || length.kind_of?(Range))
-        return Array.new(length.sort_by { rand }.first) { random_byte }
+        Array.new(length.sort_by { rand }.first) { random_byte }
       else
-        return Array.new(length) { random_byte }
+        Array.new(length) { random_byte }
       end
     end
 
@@ -189,9 +199,9 @@ module Chars
     #
     def random_distinct_bytes(length)
       if (length.kind_of?(Array) || length.kind_of?(Range))
-        return self.entries.sort_by { rand }.slice(0...(length.sort_by { rand }.first))
+        self.entries.sort_by { rand }.slice(0...(length.sort_by { rand }.first))
       else
-        return self.entries.sort_by { rand }.slice(0...length) 
+        self.entries.sort_by { rand }.slice(0...length) 
       end
     end
 
@@ -342,13 +352,11 @@ module Chars
     #   # => true
     #
     def ===(string)
-      return false unless string.respond_to?(:each_byte)
-
-      string.each_byte do |b|
-        return false unless include?(b)
+      if string.respond_to?(:each_byte)
+        string.each_byte.all? { |b| include?(b) }
+      else
+        false
       end
-
-      return true
     end
 
     alias =~ ===

data/lib/chars/version.rb

@@ -1,4 +1,4 @@
 module Chars
   # Chars version
-  VERSION = '0.1.2'
+  VERSION = '0.2.0'
 end

data/spec/spec_helper.rb

@@ -1,5 +1,3 @@
-require 'rubygems'
-gem 'rspec', '>=1.1.3'
-require 'spec'
+require 'rspec'
 
 require 'chars/version'

metadata

@@ -1,88 +1,87 @@
 --- !ruby/object:Gem::Specification 
 name: chars
 version: !ruby/object:Gem::Version 
-  version: 0.1.2
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Postmodern
 autorequire: 
 bindir: bin
-cert_chain: 
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDQDCCAiigAwIBAgIBADANBgkqhkiG9w0BAQUFADBGMRgwFgYDVQQDDA9wb3N0
-  bW9kZXJuLm1vZDMxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixk
-  ARkWA2NvbTAeFw0wOTA2MDMwNDU5MDNaFw0xMDA2MDMwNDU5MDNaMEYxGDAWBgNV
-  BAMMD3Bvc3Rtb2Rlcm4ubW9kMzEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYK
-  CZImiZPyLGQBGRYDY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA
-  1wvANkTDHFgVih5XLjuTwTZjgBq1lBGybXJiH6Id1lY2JOMqM5FB1DDHVvvij94i
-  mJabN0zkzu6VKWC70y0IwOxY7CPokr0eFdK/D0y7mCq1P8QITv76i2YqAl0eYqIt
-  W+IhIkANQ7E6uMZIZcdnfadC6lPAtlKkqtd9crvRbFgr6e3kyflmohbRnTEJHoRd
-  7SHHsybE6DSn7oTDs6XBTNrNIn5VfZA0z01eeos/+zBm1zKJOK2+/7xtLLDuDU9G
-  +Rd+ltUBbvxUrMNZmDG29pnmN2xTRH+Q8HxD2AxlvM5SRpK6OeZaHV7PaCCAVZ4L
-  T9BFl1sfMvRlABeGEkSyuQIDAQABozkwNzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIE
-  sDAdBgNVHQ4EFgQUKwsd+PqEYmBvyaTyoL+uRuk+PhEwDQYJKoZIhvcNAQEFBQAD
-  ggEBAB4TvHsrlbcXcKg6gX5BIb9tI+zGkpzo0Z7jnxMEcNO7NGGwmzafDBI/xZYv
-  xkRH3/HXbGGYDOi6Q6gWt5GujSx0bOImDtYTJTH8jnzN92HzEK5WdScm1QpZKF1e
-  cezArMbxbSPaosxTCtG6LQTkE28lFQsmFZ5xzouugS4h5+LVJiVMmiP+l3EfkjFa
-  GOURU+rNEMPWo8MCWivGW7jes6BMzWHcW7DQ0scNVmIcCIgdyMmpscuAEOSeghy9
-  /fFs57Ey2OXBL55nDOyvN/ZQ2Vab05UH4t+GCxjAPeirzL/29FBtePT6VD44c38j
-  pDj+ws7QjtH/Qcrr1l9jfN0ehDs=
-  -----END CERTIFICATE-----
+cert_chain: []
 
-date: 2009-09-25 00:00:00 -07:00
+date: 2010-10-27 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
-  name: yard
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  name: ore
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 0.2.3.5
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: rspec
+        segments: 
+        - 0
+        - 2
+        - 0
+        version: 0.2.0
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: ore-tasks
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 1.2.8
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
+        segments: 
+        - 0
+        - 1
+        - 2
+        version: 0.1.2
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        version: 2.3.3
-    version: 
-description: |-
-  Chars is a Ruby library for working with various character sets,
-  recognizing text and generating random text from specific character sets.
-email: 
-- postmodern.mod3@gmail.com
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :development
+  version_requirements: *id003
+description: Chars is a Ruby library for working with various character sets, recognizing text and generating random text from specific character sets.
+email: postmodern.mod3@gmail.com
 executables: []
 
 extensions: []
 
 extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-- TODO.txt
+- README.md
+- ChangeLog.md
+- LICENSE.txt
 files: 
-- History.txt
-- Manifest.txt
-- README.txt
-- TODO.txt
+- .document
+- .rspec
+- .yardopts
+- ChangeLog.md
+- LICENSE.txt
+- README.md
 - Rakefile
+- chars.gemspec
+- gemspec.yml
 - lib/chars.rb
 - lib/chars/char_set.rb
 - lib/chars/chars.rb
@@ -90,40 +89,45 @@ files:
 - lib/chars/extensions/integer.rb
 - lib/chars/extensions/string.rb
 - lib/chars/version.rb
-- tasks/spec.rb
-- spec/spec_helper.rb
 - spec/char_set_spec.rb
 - spec/chars_spec.rb
 - spec/integer_spec.rb
+- spec/spec_helper.rb
 - spec/string_spec.rb
 has_rdoc: yard
-homepage: http://chars.rubyforge.org/
-licenses: []
-
+homepage: http://github.com/postmodern/chars
+licenses: 
+- MIT
 post_install_message: 
-rdoc_options: 
-- --main
-- README.txt
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      segments: 
+      - 0
       version: "0"
-  version: 
 requirements: []
 
 rubyforge_project: chars
-rubygems_version: 1.3.5
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Chars is a Ruby library for working with various character sets, recognizing text and generating random text from specific character sets.
-test_files: []
-
+summary: A Ruby library for working with various character sets
+test_files: 
+- spec/integer_spec.rb
+- spec/chars_spec.rb
+- spec/char_set_spec.rb
+- spec/string_spec.rb

data/Manifest.txt

@@ -1,18 +0,0 @@
-History.txt
-Manifest.txt
-README.txt
-TODO.txt
-Rakefile
-lib/chars.rb
-lib/chars/char_set.rb
-lib/chars/chars.rb
-lib/chars/extensions.rb
-lib/chars/extensions/integer.rb
-lib/chars/extensions/string.rb
-lib/chars/version.rb
-tasks/spec.rb
-spec/spec_helper.rb
-spec/char_set_spec.rb
-spec/chars_spec.rb
-spec/integer_spec.rb
-spec/string_spec.rb

data/TODO.txt

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

data/tasks/spec.rb

@@ -1,10 +0,0 @@
-require 'spec/rake/spectask'
-
-desc "Run all specifications"
-Spec::Rake::SpecTask.new(:spec) do |t|
-  t.libs += ['lib', 'spec']
-  t.spec_opts = ['--colour', '--format', 'specdoc']
-end
-
-task :test => :spec
-task :default => :spec

metadata.gz.sig

@@ -1,4 +0,0 @@
-m��8��‰�؈���&���I�Ҏܸ�g�I�i�:��w�ٓ�FJTn��:��gY��e���9������t��G�vh
F(I�(���q���P�I�2�.
ʶ(���M
-�
-��
-;��`��!�2��g6k�d=t���z���W���?�]�XԀ��$�{X&��_�"}��$:֭����$��$�w�V��&��yqc{�,j�Ӝ���C�w����