randexp 0.1.6 → 0.1.7

data/.gitignore

@@ -0,0 +1,9 @@
+coverage/*
+pkg/*
+rdoc/*
+gbin
+vendor
+.bundle
+Gemfile.lock
+.rvmrc
+

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+group :test do
+  gem 'rspec', "=1.3.0"
+  gem 'rake'
+  gem 'rcov'
+end

data/README.textile

@@ -0,0 +1,176 @@
+h1. randexp
+
+bq. by Ben Burkert
+
+h2. DESCRIPTION:
+
+randexp makes it easy to generate random string from most regular expressions.
+
+h2. REQUIREMENTS:
+ 
+* none!
+ 
+h2. INSTALL:
+ 
+  $ sudo gem install randexp
+
+h2. USAGE:
+
+randexp adds the #generate (or #gen, for short) method to the Regexp class,
+which generates a 'random' string that will match your regular expression.
+<pre>
+<code>
+  >> /abc|def/.gen
+      # => "def"
+</code>
+</pre>
+
+h2. Valid Regexp's
+
+randexp can only generate matching string from simple regular expression.
+Except for a few circumstances, wildcards are generally not allowed in the
+regular expression.  is pretty domain specific, so trying to guess when to
+terminate a random pattern would produce unhelpful data:
+
+<pre>
+<code>
+  >> /Aa{3}h*!/.gen
+      # => RuntimeError: Sorry, "h*" is too vague, try setting a range: "h{0,3}"
+  >> /Aa{3}h{3,15}!/.gen
+      => "Aaaahhhhh!"
+
+  >> /(never gonna (give you up|let you down), )*/.gen
+      => RuntimeError: Sorry, "(...)*" is too vague, try setting a range: "(...){0, 3}"
+  >> /(never gonna (give you up|let you down), ){3,5}/.gen
+      => "never gonna give you up, never gonna let you down, never gonna give you up, never gonna give you up, "
+</code>
+</pre>
+
+The exception being word characters (\w), which generate a random word from the Dictionary class.
+
+<pre>
+<code>
+  >> /\w+/.gen
+      => "groveling"
+</code>
+</pre>
+
+h3. Primitives & Complex matches
+
+The single character matchers supported are words(\w), whitespace(\s), and digits(\d).
+
+<pre>
+<code>
+  >> /\d{50}/.gen
+      => "50315410741096763188525493528315906035878741451037"
+</code>
+</pre>
+
+When a multiplicity constraint is placed on a word character, a word with the valid length is generated.
+
+<pre>
+<code>
+  >> /\w{10}/.gen  # a word with 10 letters
+      => "Chaucerism"
+
+  >> /\w{5,15}/.gen
+      => "cabalistic"
+</code>
+</pre>
+
+Complex matchers use the [:...:] syntax within the regular expression.
+
+<pre>
+<code>
+  >> /[:sentence:]/.gen
+      => "Nonhearer demetricize toppiece filicic possessedness rhodizite zoomagnetism earwigginess steady"
+</code>
+</pre>
+
+Complex matchers can also be added by extending the Randgen class.
+
+<pre>
+<code>
+  class Randgen
+    def self.serial_number(options = {})
+      /XX\d{4}-\w-\d{5}/.gen
+    end
+  end
+
+  >> /[:serial_number:]/.gen
+      => "XX3770-M-33114"
+</code>
+</pre>
+
+h3. Dictionary
+
+The Dictionary loads the local users' words file, allowing randomly generated words to be chosen from
+thousands of entries to the words file.  Words are mapped by their length to allow words to be randomly
+chosen based on size.
+
+h3. Real Names
+
+One can easily generate real names based on a wordlist.
+
+Random first name (male or female):
+<pre>
+<code>
+  >> Randgen.first_name
+      => "Malika"
+</code>
+</pre>
+
+Random first name, with a specific gender:
+<pre>
+<code>
+  >> Randgen.first_name(:gender => :male)
+      => "Rick"
+</code>
+</pre>
+
+Random first name, with a specific gender & length:
+<pre>
+<code>
+  >> Randgen.first_name(:gender => :male, :length => 10)
+      => "Kristopher"
+</code>
+</pre>
+
+Random last name:
+<pre>
+<code>
+  >> Randgen.last_name
+      => "Klocko"
+</code>
+</pre>
+
+Random name:
+<pre>
+<code>
+  >> Randgen.name
+    => "Rosendo Raynor"
+</code>
+</pre>
+
+alternative:
+<pre>
+<code>
+  >> /[:name:]/.gen
+      => "Marc Adams"
+</code>
+</pre>
+
+Random name, with a specific gender:
+<pre>
+<code>
+  >> Randgen.name(:gender => :female)
+      => "Tatiana Brakus"
+</code>
+</pre>
+
+
+h4. Contributors
+
+* Matt Aimonetti (mattetti)
+* Gerrit Kaiser (gerrit)
+* Mike Vincent (shame)

data/lib/randexp.rb

@@ -11,6 +11,7 @@ class Randexp
 end
 
 dir = File.dirname(__FILE__) + '/randexp'
+require dir + '/version'
 require dir + '/core_ext'
 require dir + '/dictionary'
 require dir + '/parser'

data/lib/randexp/reducer.rb

@@ -23,7 +23,7 @@ class Randexp
 
     def self.literal(cell, quantity = nil)
       case quantity
-      when :'?'         then ([''] + cell).pick * ''
+      when :'?'         then ([''] + cell).pick
       when :+, :'+?'    then raise "Sorry, \"#{cell * ''}+\" is too vague, try setting a range: \"#{cell * ''}{1,3}\""
       when :*, :'*?'    then raise "Sorry, \"#{cell * ''}*\" is too vague, try setting a range: \"#{cell * ''}{0,3}\""
       when Range        then quantity.pick.of { cell * '' } * ''

data/lib/randexp/version.rb

@@ -0,0 +1,3 @@
+class Randexp
+  VERSION = "0.1.7"
+end

data/randexp.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "randexp/version"
+
+Gem::Specification.new do |s|
+  s.name        = "randexp"
+  s.version     = Randexp::VERSION
+  s.authors     = ["Ben Burkert"]
+  s.email       = ["ben@benburkert.com"]
+  s.homepage    = "http://github.com/benburkert/randexp"
+  s.summary     = %q{Library for generating random strings.}
+  s.description = %q{Library for generating random strings from regular expressions.}
+
+  s.rubyforge_project = "randexp"
+
+  s.files            = `git ls-files`.split("\n")
+  s.test_files       = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables      = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.extra_rdoc_files = ["README", "LICENSE", "TODO"]
+  s.require_paths    = ["lib"]
+
+  # specify any dependencies here; for example:
+  # s.add_development_dependency "rspec"
+  # s.add_runtime_dependency "rest-client"
+end

data/spec/regression/regexp_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../spec_helper'
+require File.expand_path('../../spec_helper', __FILE__)
 
 describe "#{'*' * 80}\nRegression Specs:" do
   it "/abcd/                          => 'abcd'" do
@@ -125,6 +125,12 @@ describe "#{'*' * 80}\nRegression Specs:" do
     end
   end
 
+  it "/abc?/                          => ['ab', 'abc']" do
+    100.times do
+      ['ab', 'abc'].should include(/abc?/.gen)
+    end
+  end
+
   it "/(\\d{3}-)?\\d{3}-\\d{4}/          => /(\\d{3}-)?\\d{3}-\\d{4}/" do
     100.times do
       /(\d{3}-)?\d{3}-\d{4}/.gen.should =~ /(\d{3}-)?\d{3}-\d{4}/
@@ -160,7 +166,7 @@ describe "#{'*' * 80}\nRegression Specs:" do
       /\$\d{2,3}\.\d{2}/.gen.should =~ /\$\d{2,3}\.\d{2}/
     end
   end
-  
+
   it "/[:first_name:]/                => /\\w+/" do
     100.times do
       /[:first_name:]/.gen.should =~ /\w+/

data/spec/unit/core_ext/regexp_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../../spec_helper'
+require File.expand_path('../../../spec_helper', __FILE__)
 
 describe Regexp do
   describe "#gen" do

data/spec/unit/randexp/parser_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../../spec_helper'
+require File.expand_path('../../../spec_helper', __FILE__)
 
 describe Randexp::Parser do
   describe ".parse" do

data/spec/unit/randexp/reducer_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../../spec_helper'
+require File.expand_path('../../../spec_helper', __FILE__)
 
 describe Randexp::Reducer do
   describe ".reduce" do

data/spec/unit/randexp_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../spec_helper'
+require File.expand_path('../../spec_helper', __FILE__)
 
 describe Randexp do
   describe "#initialize" do

data/spec/unit/randgen_spec.rb

@@ -1,4 +1,4 @@
-require File.dirname(__FILE__) + '/../spec_helper'
+require File.expand_path('../../spec_helper', __FILE__)
 
 describe Randgen do
   describe ".bool" do

metadata

@@ -1,26 +1,27 @@
 --- !ruby/object:Gem::Specification 
 name: randexp
 version: !ruby/object:Gem::Version 
-  hash: 23
+  hash: 21
   prerelease: 
   segments: 
   - 0
   - 1
-  - 6
-  version: 0.1.6
+  - 7
+  version: 0.1.7
 platform: ruby
 authors: 
 - Ben Burkert
-autorequire: randexp
+autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2011-02-10 00:00:00 -08:00
+date: 2012-02-29 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
-description: Library for generating random strings.
-email: ben@benburkert.com
+description: Library for generating random strings from regular expressions.
+email: 
+- ben@benburkert.com
 executables: []
 
 extensions: []
@@ -30,24 +31,29 @@ extra_rdoc_files:
 - LICENSE
 - TODO
 files: 
+- .gitignore
+- CHANGELOG
+- Gemfile
 - LICENSE
 - README
+- README.textile
 - Rakefile
 - TODO
-- CHANGELOG
+- lib/randexp.rb
+- lib/randexp/core_ext.rb
 - lib/randexp/core_ext/array.rb
 - lib/randexp/core_ext/integer.rb
 - lib/randexp/core_ext/range.rb
 - lib/randexp/core_ext/regexp.rb
-- lib/randexp/core_ext.rb
 - lib/randexp/dictionary.rb
 - lib/randexp/parser.rb
 - lib/randexp/randgen.rb
 - lib/randexp/reducer.rb
+- lib/randexp/version.rb
 - lib/randexp/wordlists/female_names.rb
 - lib/randexp/wordlists/male_names.rb
 - lib/randexp/wordlists/real_name.rb
-- lib/randexp.rb
+- randexp.gemspec
 - spec/regression/regexp_spec.rb
 - spec/spec_helper.rb
 - spec/unit/core_ext/regexp_spec.rb
@@ -87,10 +93,16 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: "0"
 requirements: []
 
-rubyforge_project: 
+rubyforge_project: randexp
 rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: Library for generating random strings.
-test_files: []
-
+test_files: 
+- spec/regression/regexp_spec.rb
+- spec/spec_helper.rb
+- spec/unit/core_ext/regexp_spec.rb
+- spec/unit/randexp/parser_spec.rb
+- spec/unit/randexp/reducer_spec.rb
+- spec/unit/randexp_spec.rb
+- spec/unit/randgen_spec.rb