bitfields 0.1.3 → 0.1.4

data/README.markdown

@@ -1,5 +1,5 @@
 Save migrations and columns by storing multiple booleans in a single integer.  
-e.g. 3 = 1->true 2->true 4->false, 4 = 1->false 2->false 4->true, 5 = 1->true 2->false 4->true
+e.g. true-false-false = 1, false-true-false = 2,  true-false-true = 5 (1,2,4,8,..)
 
     class User < ActiveRecord::Base
       include Bitfields
@@ -9,13 +9,14 @@ e.g. 3 = 1->true 2->true 4->false, 4 = 1->false 2->false 4->true, 5 = 1->true 2-
     user = User.new(:seller => true, :insane => true)
     user.seller == true
     user.stupid? == false
-    user.my_bits == 9
+    user.my_bits == 3
 
  - records changes `user.chamges == {:seller => [false, true]}`
  - adds scopes `User.seller.stupid.first` (deactivate with `bitfield ..., :scopes => false`)
  - builds sql `User.bitfield_sql(:insane => true, :stupid => false) == 'users.my_bits IN (2, 3)'` (2 and 1+2)
  - builds not-index-using sql with `bitfield ... ,:query_mode => :bit_operator` and `User.bitfield_sql(:insane => true, :stupid => false) == '(users.my_bits & 3) = 1'`, always slower than IN() sql, since it will not use an existing index (tested for up to 64 values)
  - builds update sql `User.set_bitfield_sql(:insane => true, :stupid => false) == 'my_bits = (my_bits | 6) - 4'`
+ - **faster sql than any other bitfield lib** through combination of multiple bits into a single sql statement
  - gives access to bits `User.bitfields[:my_bits][:stupid] == 4`
 
 Install

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.1.4

data/bitfields.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{bitfields}
-  s.version = "0.1.3"
+  s.version = "0.1.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Michael Grosser"]
-  s.date = %q{2010-03-06}
+  s.date = %q{2010-04-25}
   s.email = %q{grosser.michael@gmail.com}
   s.extra_rdoc_files = [
     "README.markdown"

data/lib/bitfields.rb

@@ -53,7 +53,9 @@ module Bitfields
     end
 
     def bitfield_column(bit_name)
-      bitfields.detect{|c, bits| bits.keys.include?(bit_name.to_sym) }.first
+      found = bitfields.detect{|c, bits| bits.keys.include?(bit_name.to_sym) }
+      raise "Unknown bitfield #{bit_name}" unless found
+      found.first
     end
 
     def bitfield_sql(bit_values)

data/spec/bitfields_spec.rb

@@ -57,6 +57,14 @@ describe Bitfields do
     end
   end
 
+  describe :bitfield_column do
+    it "raises a nice error when i use a unknown bitfield" do
+      lambda{
+        User.bitfield_column(:xxx)
+      }.should raise_error(RuntimeError, 'Unknown bitfield xxx')
+    end
+  end
+
   describe 'attribute accessors' do
     it "has everything on false by default" do
       User.new.seller.should == false

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 1
-  - 3
-  version: 0.1.3
+  - 4
+  version: 0.1.4
 platform: ruby
 authors: 
 - Michael Grosser
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-03-06 00:00:00 +01:00
+date: 2010-04-25 00:00:00 +02:00
 default_executable: 
 dependencies: []