uber 0.0.4 → 0.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 516c9e7445cdc09ca9cc33afce8ffbb32494d1c0
-  data.tar.gz: d9e02ab06a8282723242cd9486331a44f1c42ce1
+  metadata.gz: edb6b44ba23dd1481ffbf6f258d045199811e0c4
+  data.tar.gz: 2f2146e0d6badc1744de2c4eaf1c087285b90146
 SHA512:
-  metadata.gz: c517333088ac322d06847427c10694c6fbea60e20e74e433fb0f41f035478ea326c85169e6bf80572c81e6170684cb0b659ce5311a2ffc6476f09600913896d9
-  data.tar.gz: 4cb7b1e5069343dc6209794f01f23af9305bec11a4d8dad6be89f3ab18e62793edf78272b56ab655a1ac1dbfb5fea7905aaf5ecc5ef8bbf0133ab1ed0d1037e3
+  metadata.gz: 5de60ad7830b232f1e5e0bcae0f12481320ca0737296e63cb84e3cd4d40b9ea9f142ee2390af1601d6d02fdf284df13cf76a263384ad82836fd90ad06e093529
+  data.tar.gz: 76dd7644a760d64eec0291f49cc1009cfd077e6d3e2bb2bf681924060fd44b3a89c82d106d9a27c1ad6b8b8ea89be2454494190aa801b9c30ed8ba5edd83bf26

data/CHANGES.md

@@ -1,3 +1,7 @@
+# 0.0.5
+
+Add `Uber::Version` for simple gem version deciders.
+
 # 0.0.4
 
 * Fix a bug where `dynamic: true` wouldn't invoke a method but try to run it as a block.

data/README.md

@@ -65,15 +65,19 @@ Usually DSL methods accept a number of options that can either be static values,
 Here's an example from Cells.
 
 ```ruby
-cache :show, tags: lambda { Tag.last }, expire_in: 5.mins, ttl: :time_to_live
+cache :show, tags: lambda { Tag.last }, expires_in: 5.mins, ttl: :time_to_live
 ```
 
-Usually, when processing these options, you'd have to check every option for its type, evaluate the `tag:` lambda in a particular context, call the `#time_to_live` instance method, etc.
+Usually, when processing these options, you'd have to check every option for its type, evaluate the `tags:` lambda in a particular context, call the `#time_to_live` instance method, etc.
 
 This is abstracted in `Uber::Options` and could be implemented like this.
 
 ```ruby
-options = Uber::Options.new(tags: lambda { Tag.last }, expire_in: 5.mins, ttl: :time_to_live)
+require 'uber/options'
+
+options = Uber::Options.new(tags:       lambda { Tag.last },
+                            expires_in: 5.mins,
+                            ttl:        :time_to_live)
 ```
 
 Just initialize `Options` with your actual options hash. While this usually happens on class level at compile-time, evaluating the hash happens at run-time.
@@ -82,25 +86,27 @@ Just initialize `Options` with your actual options hash. While this usually happ
 class User < ActiveRecord::Base # this could be any Ruby class.
   # .. lots of code
 
-  def time_to_live
+  def time_to_live(*args)
     "n/a"
   end
 end
 
 user = User.find(1)
 
-options.evaluate(user, *args) #=> {tags: "hot", expire_in: 300, ttl: "n/a"}
+options.evaluate(user, *args) #=> {tags: "hot", expires_in: 300, ttl: "n/a"}
 ```
 
 ## Evaluating Dynamic Options
 
 To evaluate the options to a real hash, the following happens:
 
-* The `tags:` lambda is executed in `user` context (using `instance_exec`). This allows accessing instance variables or calling instance methods. All `*args` are passed as block parameters to the lambda.
+* The `tags:` lambda is executed in `user` context (using `instance_exec`). This allows accessing instance variables or calling instance methods.
 * Nothing is done with `expires_in`'s value, it is static.
 * `user.time_to_live?` is called as the symbol `:time_to_live` indicates that this is an instance method.
 
-The default behaviour is to treat `Proc`s, lambdas and symbolized `:method` names as dynamic options, everything else is considered static. This is a pattern well-known from Rails and other frameworks.
+The default behaviour is to treat `Proc`s, lambdas and symbolized `:method` names as dynamic options, everything else is considered static. Optional arguments from the `evaluate` call are passed in either as block or method arguments for dynamic options.
+
+This is a pattern well-known from Rails and other frameworks.
 
 ## Evaluating Elements
 
@@ -127,12 +133,36 @@ Use `Options::Value#evaluate` to handle single values.
 Evaluating an options hash can be time-consuming. When `Options` contains static elements only, it behaves *and performs* like an ordinary hash.
 
 
-Uber::Options.new volume: 9, track: lambda { |s| s.track }
+# Version
+
+When writing gems against other gems involves checking for versions and loading appropriate version strategies (e.g. "is Rails >= 4.0?". Uber gives you `Version` for easy, semantic version deciders.
+
+```ruby
+  version = Uber::Version.new("1.2.3")
+```
+
+The API currently gives you `>=` and `~`.
+
+```ruby
+  version >= "1.1" #=> true
+  version >= "1.3" #=> false
+```
+
+The `~` method does a semantic check (currently on major and minor level, only).
+
+```ruby
+  version.~ "1.1" #=> false
+  version.~ "1.2" #=> true
+  version.~ "1.3" #=> false
+```
 
+Accepting a list of versions, it makes it simple to check for multiple minor versions.
 
-dynamic: true
+```ruby
+  version.~ "1.1", "1.0" #=> false
+  version.~ "1.1", "1.2" #=> true
+```
 
-only use for declarative assets, not at runtime (use a hash)
 
 # Undocumented Features
 

data/lib/uber/uber_version.rb

@@ -0,0 +1,3 @@
+module Uber
+  VERSION = "0.0.5"
+end

data/lib/uber/version.rb

@@ -1,3 +1,32 @@
 module Uber
-  VERSION = "0.0.4"
-end
+  class Version < Hash
+    def initialize(version)
+      @version = Gem::Version.new(version)
+      major, minor, patch = @version.segments
+
+      self[:major] = major || 0
+      self[:minor] = minor || 0
+      self[:patch] = patch || 0
+    end
+
+    def >=(version)
+      major, minor, patch = parse(version)
+
+      self[:major] >= major and self[:minor] >= minor and self[:patch] >= patch
+    end
+
+    def ~(*versions)
+      !! versions.find do |v|
+        major, minor, patch = parse(v)
+
+        self[:major] == major and self[:minor] == minor
+      end
+    end
+
+  private
+    def parse(version)
+      major, minor, patch = Gem::Version.new(version).segments
+      [major||0, minor||0, patch||0]
+    end
+  end
+end

data/test/inheritance_test.rb

@@ -21,9 +21,6 @@ class InheritanceTest < MiniTest::Spec
 
     CODE_BLOCK = lambda { |base| base.class_eval { extend ClassMethods } } # i want that to be executed at every include
 
-    instance_exec do
-      @block = CODE_BLOCK # this would happen in inherited_included do .. end
-    end
 
     def self.included(includer) #
       # CODE_BLOCK.call(base)

data/test/version_test.rb

@@ -0,0 +1,20 @@
+require 'test_helper'
+
+
+class VersionTest < MiniTest::Spec
+    subject { Uber::Version.new("1.2.3") } # Rails version
+
+    it { subject.~("1.0").must_equal false }
+    it { subject.~("1.1").must_equal false }
+    it { subject.~("1.2").must_equal true }
+    it { subject.~("1.3").must_equal false }
+    it { subject.~("2.2").must_equal false }
+    it { subject.~("1.0", "1.1").must_equal false }
+    it { subject.~("1.0", "1.1", "1.2").must_equal true }
+    it { subject.~("1.2", "1.3").must_equal true }
+
+    it { (subject >= "1.2").must_equal true }
+    it { (subject >= "1.1").must_equal true }
+    it { (subject >= "1.3").must_equal false }
+    it { (subject >= "2.1").must_equal false }
+end

data/uber.gemspec

@@ -1,12 +1,13 @@
 # -*- encoding: utf-8 -*-
-require File.expand_path('../lib/uber/version', __FILE__)
+require File.expand_path('../lib/uber/uber_version', __FILE__)
 
 Gem::Specification.new do |gem|
   gem.authors       = ["Nick Sutterer"]
   gem.email         = ["apotonick@gmail.com"]
   gem.description   = %q{A gem-authoring framework.}
   gem.summary       = %q{Gem-authoring tools like class method inheritance in modules, dynamic options and more.}
-  gem.homepage      = ""
+  gem.homepage      = "https://github.com/apotonick/uber"
+  gem.license       = "MIT"
 
   gem.files         = `git ls-files`.split($\)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }

metadata

@@ -1,41 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: uber
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.5
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-08 00:00:00.000000000 Z
+date: 2014-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.10.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.10.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 5.0.0
 description: A gem-authoring framework.
@@ -45,7 +45,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
+- ".gitignore"
 - CHANGES.md
 - Gemfile
 - LICENSE
@@ -54,15 +54,18 @@ files:
 - lib/uber.rb
 - lib/uber/inheritable_attr.rb
 - lib/uber/options.rb
+- lib/uber/uber_version.rb
 - lib/uber/version.rb
 - test/inheritable_attr_test.rb
 - test/inheritance_test.rb
 - test/options_test.rb
 - test/test_helper.rb
+- test/version_test.rb
 - test/zeugs.rb
 - uber.gemspec
-homepage: ''
-licenses: []
+homepage: https://github.com/apotonick/uber
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -70,17 +73,17 @@ 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.0.3
+rubygems_version: 2.2.1
 signing_key: 
 specification_version: 4
 summary: Gem-authoring tools like class method inheritance in modules, dynamic options
@@ -90,4 +93,6 @@ test_files:
 - test/inheritance_test.rb
 - test/options_test.rb
 - test/test_helper.rb
+- test/version_test.rb
 - test/zeugs.rb
+has_rdoc: