preconditions 0.2.1 → 0.3.0

data/README.md

@@ -32,7 +32,7 @@ To use the fluent DSL API use the `check(arg).is {}` form like so:
 
     class MyMath
       def sqrt(num)
-        Preconditions.check(num) { is_not_nil and has_type(Integer) and satisfies(">= 0") { arg >= 0 } }
+        Preconditions.check(num) { is_not_nil and has_type(Integer) and satisfies(">= 0") { num >= 0 } }
         num.sqrt
       end
     end
@@ -42,7 +42,7 @@ be supplied to add the argument name to any raised errors, or one can use the `#
 
     class MyMath
       def sqrt(num)
-        Preconditions.check(num).named('num') { is_not_nil and has_type(Integer) and satisfies(">= 0") { arg >= 0 } }
+        Preconditions.check(num).named('num') { is_not_nil and has_type(Integer) and satisfies(">= 0") { num >= 0 } }
         num.sqrt
       end
     end

data/VERSION

@@ -1 +1 @@
-0.2.1
+0.3.0

data/lib/condition_checker.rb

@@ -58,6 +58,16 @@ class ConditionChecker
     true
   end
 
+  # DSL call.  Establishes that the checked argument matches the given regular expression
+  # @raises [ArgumentError] if the argument does not match the supplied regex
+  # @return true
+  def matches(regex)
+    if arg !~ regex
+      raise ArgumentError, format_message("must match the regex /#{regex.to_s}/")
+    end
+    true
+  end
+
   # DSL call.  Establishes that the checked argument satisfies an arbitrary condition specified in a block.  If the
   # block evaluates to true the argument passes; if it evaluates to false it fails and an [ArgumentError] is raised.
   # An optional message may be supplied to describe what the block is checking.

data/preconditions.gemspec

@@ -4,15 +4,14 @@
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
-  s.name = %q{preconditions}
-  s.version = "0.2.1"
+  s.name = "preconditions"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = [%q{tucker}]
-  s.date = %q{2011-05-25}
-  s.description = %q{The Preconditions library provides a simple set of methods for checking arguments being passed into a method.  Instead of writing custom checks and raising exceptions directly in your code you can use Preconditions to verify basic properties of your arguments (not-nil, satisfying a boolean expression, being of a certain type/duck-type) and raise the appropriate exception for you.
-}
-  s.email = %q{tucker+rubygems@glyde.com}
+  s.authors = ["tucker"]
+  s.date = "2012-07-31"
+  s.description = "The Preconditions library provides a simple set of methods for checking arguments being passed into a method.  Instead of writing custom checks and raising exceptions directly in your code you can use Preconditions to verify basic properties of your arguments (not-nil, satisfying a boolean expression, being of a certain type/duck-type) and raise the appropriate exception for you.\n"
+  s.email = "tucker+rubygems@glyde.com"
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.md"
@@ -31,11 +30,11 @@ Gem::Specification.new do |s|
     "spec/preconditions_spec.rb",
     "spec/spec_helper.rb"
   ]
-  s.homepage = %q{http://github.com/ctucker/preconditions}
-  s.licenses = [%q{MIT}]
-  s.require_paths = [%q{lib}]
-  s.rubygems_version = %q{1.8.3}
-  s.summary = %q{Preconditions checking support inspired by Guava}
+  s.homepage = "http://github.com/ctucker/preconditions"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.22"
+  s.summary = "Preconditions checking support inspired by Guava"
   s.test_files = [
     "spec/preconditions_dsl_spec.rb",
     "spec/preconditions_spec.rb",

data/spec/preconditions_dsl_spec.rb

@@ -1,4 +1,4 @@
-require "rspec"
+require 'rspec'
 require 'preconditions'
 
 describe "dsl expression" do
@@ -35,6 +35,19 @@ describe "dsl expression" do
     res.should == arg
   end
 
+  it 'should raise on a matches check if the regex does not match' do
+    arg = 'some string'
+    expect {
+      Preconditions.check(arg) { matches(/other thing/) }
+    }.to raise_exception(ArgumentError)
+  end
+
+  it 'should return true on a matches check if the regex does match' do
+    arg = 'some string'
+    res = Preconditions.check(arg) { matches(/me/) }
+    res.should == arg
+  end
+
   it "should evaluate a satisfies block using the instance-local arg value" do
     x = 1
     expect {

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: preconditions
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 19
   prerelease: 
   segments: 
   - 0
-  - 2
-  - 1
-  version: 0.2.1
+  - 3
+  - 0
+  version: 0.3.0
 platform: ruby
 authors: 
 - tucker
@@ -15,9 +15,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-25 00:00:00 Z
+date: 2012-07-31 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
+  name: yard
   version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -30,10 +31,10 @@ dependencies:
         - 0
         version: 0.6.0
   type: :development
-  requirement: *id001
   prerelease: false
-  name: yard
+  requirement: *id001
 - !ruby/object:Gem::Dependency 
+  name: bluecloth
   version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -44,10 +45,10 @@ dependencies:
         - 0
         version: "0"
   type: :development
-  requirement: *id002
   prerelease: false
-  name: bluecloth
+  requirement: *id002
 - !ruby/object:Gem::Dependency 
+  name: bundler
   version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -60,10 +61,10 @@ dependencies:
         - 0
         version: 1.0.0
   type: :development
-  requirement: *id003
   prerelease: false
-  name: bundler
+  requirement: *id003
 - !ruby/object:Gem::Dependency 
+  name: jeweler
   version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -76,10 +77,10 @@ dependencies:
         - 2
         version: 1.5.2
   type: :development
-  requirement: *id004
   prerelease: false
-  name: jeweler
+  requirement: *id004
 - !ruby/object:Gem::Dependency 
+  name: rcov
   version_requirements: &id005 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -90,10 +91,10 @@ dependencies:
         - 0
         version: "0"
   type: :development
-  requirement: *id005
   prerelease: false
-  name: rcov
+  requirement: *id005
 - !ruby/object:Gem::Dependency 
+  name: rspec
   version_requirements: &id006 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -106,10 +107,10 @@ dependencies:
         - 0
         version: 2.6.0
   type: :development
-  requirement: *id006
   prerelease: false
-  name: rspec
+  requirement: *id006
 - !ruby/object:Gem::Dependency 
+  name: ci_reporter
   version_requirements: &id007 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
@@ -120,9 +121,8 @@ dependencies:
         - 0
         version: "0"
   type: :development
-  requirement: *id007
   prerelease: false
-  name: ci_reporter
+  requirement: *id007
 description: |
   The Preconditions library provides a simple set of methods for checking arguments being passed into a method.  Instead of writing custom checks and raising exceptions directly in your code you can use Preconditions to verify basic properties of your arguments (not-nil, satisfying a boolean expression, being of a certain type/duck-type) and raise the appropriate exception for you.
 
@@ -176,7 +176,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.8.3
+rubygems_version: 1.8.22
 signing_key: 
 specification_version: 3
 summary: Preconditions checking support inspired by Guava