mana-potion 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 927b2e38bdfad7feb263cfdcaf83309ec84eba6a
-  data.tar.gz: 6fe541621b542f6f422a23e84cb8d3e2ae64e69c
+  metadata.gz: 735689e5d94123b058f3099c06d7cadec9db9864
+  data.tar.gz: abc86482d07f616384e54cbd0d8ffd4d3926a759
 SHA512:
-  metadata.gz: 0a3c5c70b86493937fb00725c2bf2470036c53930117f9e933227b12b42e75d5798d5bd2550eb157d012eafe307a3d9f717b56e79fb61ab13ad08457d4e3f5eb
-  data.tar.gz: 0d0d53d421600cc260a4317adb6447ad014cc3b2d64e2c3aa57508af9fbf23a0da9de85b0bab941cd1dbd4b661400f37209a36a3d981c3c9cfd4f9d19b3c68b2
+  metadata.gz: 32097819c50541441855dac941b36897d6efebf6e11b4704cfd0ae9517682e800f2c7b55aa31b88213c680eae8dbac3cb3c2a2a98d9839696fc2776a5f0c1a14
+  data.tar.gz: de3d91e9c9925fe8e8f4cf77bf8a1ec9645c14241d7abd0ba5b2154792adba7bb99f1e6e58243fbcae6dc6958dc6c7552e7bbb7ca72effde98c2734a6090f47f

data/README.md

@@ -72,6 +72,34 @@ class Post < ActiveRecord::Base
 end
 ```
 
+Trying to create a `Post` without an `User` will raise an error:
+```ruby
+Post.create! # Raises a MissingOwnerError
+```
+
+To allow nil value for `User`, include the `allow_nil: true` option:
+
+```ruby
+class Post < ActiveRecord::Base
+  include ManaPotion::Pool
+  belongs_to :user
+
+  mana_pool_for :user, allow_nil: true
+end
+
+Post.create! # Doesn't raise any errors
+```
+
+If you want to check the user's remaining usages, you may use the `ManaPotion::CheckUsage#remaining` method:
+
+```ruby
+user = User.create!
+ManaPotion::CheckUsage.new(Post.new, user, 5, 1.day).remaining # => 5
+
+user.posts.create!
+ManaPotion::CheckUsage.new(Post.new, user, 5, 1.day).remaining # => 4
+```
+
 
 ## Development
 

data/lib/mana-potion/pool.rb

@@ -2,17 +2,26 @@ require 'mana-potion/check_usage'
 
 module ManaPotion
   module Pool
+    class MissingOwnerError < StandardError; end
+
     def self.included(other)
       other.extend ClassMethods
     end
 
     module ClassMethods
-      def mana_pool_for(association, limit: 1, period: 1.day)
+      def mana_pool_for(association, limit: 1, period: 1.day, allow_nil: false)
         before_validation do
+          owner = send(association)
+
+          if owner.nil?
+            raise MissingOwnerError, "#{self.class.name} it's missing its #{association}. If you want to allow that, include the allow_nil: true option in your Pool configuration." unless allow_nil
+            next
+          end
+
           limit = instance_exec &limit if limit.respond_to?(:call)
           period = instance_exec &period if period.respond_to?(:call)
 
-          check_usage = ManaPotion::CheckUsage.new(self, send(association), limit, period)
+          check_usage = ManaPotion::CheckUsage.new(self, owner, limit, period)
           if check_usage.exceeded?
             errors.add(association, :limit, limit: limit, count: check_usage.count)
           end

data/lib/mana-potion/version.rb

@@ -1,3 +1,3 @@
 module ManaPotion
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mana-potion
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - mrodrigues
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-08-30 00:00:00.000000000 Z
+date: 2015-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -153,7 +153,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.7
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Do you need to limit some resource's creation rate? It's simple to do it