any_value 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 34e46954b67b61b298a1fb9032192aa102cf7c47
+  data.tar.gz: 922af0fc2c8b978580bab08fd6b94809af4e9748
+SHA512:
+  metadata.gz: 4015a9e6956be16714891d3923be52db9a238d0da720abe18a623a7b722f381f9a65547580053b7ca90ba22d5c565127351b6aedf365811fcd872247144b692b
+  data.tar.gz: 0d0e6c196643d1992b8ca8f417594f4e450243e750f27f1fd8c030946bf87c3fd03d8ecffba4d5fdebb12cdb3c1269c5f3654b0ff267e5b482fc08ebfbf15517

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.1

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in anything.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Wojtek Mach
+
+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.md

@@ -0,0 +1,115 @@
+# Anything
+
+[![Build Status](https://travis-ci.org/wojtekmach/anything.svg)](https://travis-ci.org/wojtekmach/anything)
+
+Anything is a collection of helper methods like: `anything`, `any_number`, `any_string` that is useful for testing nested data structures (like arrays or hashes) when you care more about some particular elements and the "shape" of the data, than about the entire data structure.
+
+So, instead of either:
+
+* Asserting all elements, even the attributes you don't really care about (ids, created_at fields etc)
+
+```ruby
+def test_create
+  item1 = Item.create!(name: "Item 1")
+  item2 = Item.create!(name: "Item 2")
+
+  get "/items"
+
+  assert_equal [
+    {"id" => item1.id, "name" => "Item 1"},
+    {"id" => item2.id, "name" => "Item 2"},
+  ], JSON(response.body)
+end
+```
+
+or
+
+* Extracting out subset of attributes you care about:
+
+```ruby
+def test_create
+  item1 = Item.create!(name: "Item 1")
+  item2 = Item.create!(name: "Item 2")
+
+  get "/items"
+
+  assert_equal [
+    "Item 1", "Item 2",
+  ], JSON(response.body).map { |h| h['name'] }
+end
+```
+
+You can do this:
+
+```ruby
+def test_create
+  item1 = Item.create!(name: "Item 1")
+  item2 = Item.create!(name: "Item 2")
+
+  get "/items"
+
+  assert_equal [
+    {"id" => any_integer, "name" => "Item 1"},
+    {"id" => any_integer, "name" => "Item 2"},
+  ], JSON(response.body)
+end
+```
+
+## Usage
+
+All you have to do is to include `Anything` module to your program/test/whatever.
+
+Example:
+
+```ruby
+require 'anything'
+
+class Minitest::Test
+  include Anything
+end
+
+require 'minitest/autorun'
+
+class Test < Minitest::Test
+  def test_anything
+    assert_equal any_number, 42
+  end
+end
+```
+
+### Composition
+
+You can compose helpers like this:
+
+```ruby
+acronym = upcase_string ^ string_of_length(3)
+
+acronym == "NBA"  # => true
+acronym == "nba"  # => false
+acronym == "NASA" # => false
+```
+
+And like that for arrays:
+
+```ruby
+array_of_integers = array_of(any_integer)
+
+array_of_integers == [1, 2, 3]   # => true
+array_of_integers == [1, nil, 3] # => false
+```
+
+See: https://github.com/wojtekmach/anything/blob/master/test/anything_test.rb for more examples.
+
+## Installation
+
+The gem is not released to rubygems.org yet, since this name is taken.
+
+You can install it via bundler by adding `gem 'anything', github: 'wojtekmach/anything'` to your Gemfile or by cloning it and running `rake install`.
+
+## Contributing
+
+1. Fork it ( https://github.com/wojtekmach/anything/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*_test.rb']
+  t.libs << 'test'
+end
+
+task :default => :test

data/any_value.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "any_value/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "any_value"
+  spec.version       = AnyValue::VERSION
+  spec.authors       = ["Wojtek Mach"]
+  spec.email         = ["wojtek@wojtekmach.pl"]
+
+  spec.summary       = %q{Helper objects for testing nested data structures}
+  spec.description   = spec.summary
+  spec.homepage      = "https://github.com/wojtekmach/any_value"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "minitest"
+end

data/lib/any_value/version.rb

@@ -0,0 +1,3 @@
+module AnyValue
+  VERSION = "0.1.0"
+end

data/lib/any_value.rb

@@ -0,0 +1,285 @@
+# Sometimes, especially when working with JSON APIs,
+# when testing I found myself wanting to test the "shape" of data and only some particular elements, rather than either:
+#
+# - test everything - which is tricky with things like auto_increment primary keys, created_at fields etc
+# - test only subset of data - do stuff like: `JSON(response.body).map { |h| h['name'] }.should == ['Item 1', 'Item 2']
+#
+# Here, I want to try something different. See:
+# `test_why_someone_would_ever_use_it`
+
+require "any_value/version"
+require "delegate"
+require "set"
+require "date"
+require "uri"
+
+module AnyValue
+  class Anything
+    def initialize(*args)
+      @args = args
+    end
+
+    def ==(*)
+      true
+    end
+
+    def inspect
+      "#<%s>" % self.class.name.sub("Anything::", "")
+    end
+
+    def ^(other)
+      Composite.new(self, other)
+    end
+
+    def to_ary
+      self
+    end
+
+    def to_str
+      self
+    end
+  end
+  def anything
+    Anything.new
+  end
+
+  class Composite < SimpleDelegator
+    def initialize(left, right)
+      super(left)
+      @right = right
+    end
+
+    def ==(o)
+      __getobj__.==(o) && @right.==(o)
+    end
+
+    def ^(other)
+      Composite.new(self, other)
+    end
+
+    def inspect
+      "#<Composite #{__getobj__.inspect} #{@right.inspect}>"
+    end
+  end
+
+  class AnyInteger < Anything
+    def ==(o)
+      o.is_a?(Integer)
+    end
+  end
+  def any_integer
+    AnyInteger.new
+  end
+
+  class AnyNumber < Anything
+    def ==(o)
+      o.is_a?(Numeric)
+    end
+  end
+  def any_number
+    AnyNumber.new
+  end
+
+  class EvenNumber < AnyNumber
+    def ==(o)
+      super && o.even?
+    end
+  end
+  def even_number
+    EvenNumber.new
+  end
+
+  class OddNumber < AnyNumber
+    def ==(o)
+      super && o.odd?
+    end
+  end
+  def odd_number
+    OddNumber.new
+  end
+
+  class AnyString < Anything
+    def ==(o)
+      o.is_a?(String)
+    end
+
+    def to_str
+      self
+    end
+  end
+  def any_string
+    AnyString.new
+  end
+
+  class OneOf < Anything
+    def initialize(*values)
+      super
+      @values = values
+    end
+
+    def ==(o)
+      @values.include?(o)
+    end
+
+    def inspect
+      "#<OneOf #{@values.map(&:inspect).join(" ")}>"
+    end
+  end
+  def one_of(*values)
+    OneOf.new(*values)
+  end
+
+  class StringOfLength < AnyString
+    def initialize(expected_length)
+      super
+      @expected_length = expected_length
+    end
+
+    def ==(o)
+      super && o.length == @expected_length 
+    end
+    
+    def inspect
+      "#<StringOfLength #@expected_length>"
+    end
+  end
+  def string_of_length(expected_length)
+    StringOfLength.new(expected_length)
+  end
+
+  class StringMatching < AnyString
+    def initialize(pattern)
+      super
+      @pattern = pattern
+    end
+
+    def ==(o)
+      super && o =~ @pattern
+    end
+
+    def inspect
+      "#<StringMatching #@pattern>"
+    end
+  end
+  def string_matching(pattern)
+    StringMatching.new(pattern)
+  end
+
+  # It's the same as:
+  #
+  # sorted_array = array_of(increasing)
+  class SortedArray < Anything
+    def ==(o)
+      o == o.sort
+    end
+
+    def to_ary
+      self
+    end
+  end
+  def sorted_array
+    SortedArray.new
+  end
+
+  class ArrayOf < Anything
+    def initialize(element)
+      unless element.is_a?(Anything)
+        raise ArgumentError, "invalid argument: #{element.inspect}" 
+      end
+
+      super
+      @element = element
+    end
+
+    def ==(o)
+      o.all? { |x| x == @element }
+    end
+
+    def inspect
+      "#<ArrayOf #{@element.inspect}>"
+    end
+  end
+  def array_of(element)
+    ArrayOf.new(element)
+  end
+
+  class AnyUnique < Anything
+    def initialize
+      @seen = Set.new
+    end
+    def ==(o)
+      if @seen.include?(o)
+        false
+      else
+        @seen << o
+        true
+      end
+    end
+  end
+  def any_unique
+    @_any_unique ||= AnyUnique.new
+  end
+
+  class Increasing < Anything
+    def initialize
+      @last = nil
+      @for_inspect = nil
+    end
+
+    def ==(o)
+      @for_inspect = @last
+      if @last
+        result = o > @last
+        @last = o
+        result
+      else
+        @last = o
+        super
+      end
+    end
+
+    def inspect
+      "#<Increasing last=#{@for_inspect.inspect}>"
+    end
+  end
+  def increasing
+    @_increasing ||= Increasing.new
+  end
+
+  class UpcaseString < AnyString
+    def ==(o)
+      super && o.upcase == o
+    end
+  end
+  def upcase_string
+    UpcaseString.new
+  end
+
+  class AnyTime < Anything
+    def ==(o)
+      o.is_a?(Time)
+    end
+  end
+  def any_time
+    AnyTime.new
+  end
+
+  class AnyDate < Anything
+    def ==(o)
+      o.is_a?(Date)
+    end
+  end
+  def any_date
+    AnyDate.new
+  end
+
+  class AnyHTTPURI < Anything
+    def ==(o)
+      uri = URI(o)
+      uri.is_a?(URI::HTTP)
+    end
+  end
+  def any_http_uri
+    AnyHTTPURI.new
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: any_value
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Wojtek Mach
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-01-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Helper objects for testing nested data structures
+email:
+- wojtek@wojtekmach.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- any_value.gemspec
+- lib/any_value.rb
+- lib/any_value/version.rb
+homepage: https://github.com/wojtekmach/any_value
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Helper objects for testing nested data structures
+test_files: []