state_store 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.3"
+end
+
+group :test do 
+  gem "rspec", "~>2.9.0"
+end
+

data/Gemfile.lock

@@ -0,0 +1,31 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.6)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.9.0)
+      rspec-core (~> 2.9.0)
+      rspec-expectations (~> 2.9.0)
+      rspec-mocks (~> 2.9.0)
+    rspec-core (2.9.0)
+    rspec-expectations (2.9.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.9.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.8.3)
+  rdoc (~> 3.12)
+  rspec (~> 2.9.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Arturs Meisters
+
+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.rdoc

@@ -0,0 +1,19 @@
+= state_store
+
+Description goes here.
+
+== Contributing to state_store
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2012 Arturs Meisters. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,45 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "state_store"
+  gem.homepage = "http://github.com/kalifs/state_store"
+  gem.license = "MIT"
+  gem.summary = %Q{Convert numeric value to Array of states}
+  gem.description = %Q{Create numeric value to Array of states.}
+  gem.email = "arturs.meisters@gmail.com"
+  gem.authors = ["Arturs Meisters"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "state_store #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/state_store/binary_store.rb

@@ -0,0 +1,59 @@
+module StateStore
+  class BinaryStore
+    attr_reader :statuses, :states, :total_positions
+
+    def initialize(statuses)
+      raise ArgumentError.new("Only array is accepted.") unless statuses.is_a?(Array)
+      @statuses = statuses
+      @states = statuses.size
+      @total_positions = 2**@states-1
+    end
+
+    def humanize(value)
+      raise ArgumentError.new("Out of range") if self.total_positions < value
+      value_to_statuses(value)
+    end
+
+    def has_status?(symbol,value) 
+      human_array = humanize(value)
+      human_array.include?(symbol)
+    end
+
+    def index(index,state)
+      statuses[index] if state.to_s == "1"
+    end
+
+    private
+
+    def value_to_statuses(value)
+      result = []
+      normalized_array(value_to_binary_array(value)).each_with_index do |state,index|
+        if current_status = index(index,state)
+          result << current_status
+        end
+      end
+      result
+    end
+
+    def normalized_array(array)
+      (Array.new(self.states - array.size, "0")+ array)
+    end
+
+    def value_to_binary_array(value)
+      value.to_s(2).split("")
+    end
+
+    class BinaryValue
+      attr_reader :value,:store
+
+      def initialize(store,value)
+        @value = value
+        @store = store
+      end
+
+      def has_status?(symbol)
+        self.store.has_status?(symbol,self.value)
+      end
+    end
+  end
+end

data/lib/state_store/extension.rb

@@ -0,0 +1,53 @@
+module StateStore
+  module Extension
+
+    module ClassMethods
+      def has_statuses *statuses
+        @state_store_options = statuses && statuses.last.is_a?(Hash) && statuses.pop || {}
+        raise ArgumentError.new("No statuses given") if statuses.empty? 
+        raise ArgumentError.new(":in is required") unless @state_store_options[:in]
+        @store = StateStore::BinaryStore.new(statuses)
+        override_method_store_in_method
+      end 
+
+      def state_store_store
+        @store
+      end
+
+      def state_store_options
+        @state_store_options
+      end
+
+      private
+
+      def override_method_store_in_method
+        class_eval  <<-ALIAS,__FILE__,__LINE__+1  
+          if self.instance_methods.include?(:#{self.state_store_options[:in]})
+            alias :status_store_original_#{self.state_store_options[:in]} :#{self.state_store_options[:in]}
+          end
+        ALIAS
+
+        self.class_eval do 
+          define_method self.state_store_options[:in] do 
+            original_method_name = :"status_store_original_#{self.class.state_store_options[:in]}"
+            value = self.respond_to?(original_method_name) ? self.send(original_method_name) : super
+            self.class.state_store_store.humanize(value)
+          end
+        end
+      end
+    end
+
+    module InstanceMethods
+      def self.included(base)
+
+        def method_missing(method_name, *args)
+          if method_name.to_s == "has_#{self.class.state_store_options[:in]}?"
+            self.class.state_store_store.has_status?(args[0],self.send(self.class.state_store_options[:in]))
+          else
+            super
+          end
+        end 
+      end
+    end
+  end
+end

data/lib/state_store.rb

@@ -0,0 +1,11 @@
+require 'state_store/binary_store'
+require 'state_store/extension'
+
+module StateStore
+  def self.included(base_klass)
+    base_klass.extend(StateStore::Extension::ClassMethods)
+    base_klass.class_eval do 
+      include StateStore::Extension::InstanceMethods
+    end
+  end
+end

data/spec/binary_store_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+require 'state_store'
+
+describe StateStore::BinaryStore do 
+  let(:klass){StateStore::BinaryStore}
+
+  it "should create new store instance with statuses" do 
+    expect{
+      klass.new([])
+      klass.new([:read])
+      klass.new([:read,:write])
+    }.not_to raise_error
+  end
+
+  it "it should raise error when statuses not Array" do 
+    expect{
+      klass.new(Object.new)
+    }.to raise_error(ArgumentError,"Only array is accepted.")
+  end
+
+  describe "attributes" do 
+    let(:statuses){[:one,:two,:five]}
+    it "should assign received statuses to statuses" do 
+      store = klass.new(statuses)
+      store.statuses.should eq(statuses)
+    end
+
+    it "should assign states statuses size" do 
+      store = klass.new(statuses)
+      store.states.should eq(statuses.size)
+    end
+
+    it "should calculate and assign total positions to total_positions" do 
+      store = klass.new(statuses)
+      store.total_positions.should eq((2**statuses.size)-1)
+    end
+  end
+
+  it "should convert value to array with matching human statuses" do 
+    store = klass.new([:read,:write,:execute])
+    store.humanize(0).should eq([])
+    store.humanize(1).should eq([:execute])
+    store.humanize(2).should eq([:write])
+    store.humanize(3).should eq([:write,:execute])
+    store.humanize(4).should eq([:read])
+    store.humanize(5).should eq([:read,:execute])
+    store.humanize(6).should eq([:read,:write])
+    store.humanize(7).should eq([:read,:write,:execute])
+  end
+
+  it "should raise error when given value is greated then store total positions" do 
+    store = klass.new([:one])
+    expect{
+      store.humanize(2)
+    }.to raise_error(ArgumentError,"Out of range")
+  end
+
+  it "should detect if value include given status" do 
+    store = klass.new([:read,:write,:execute])
+    store.has_status?(:read,5).should be_true
+    store.has_status?(:read,3).should be_false
+  end
+
+  it "should return human status for given index when given state is '1'" do 
+    store = klass.new([:one,:two])
+    store.index(1,"1").should eq(:two)
+    store.index(1,"0").should be_nil
+  end
+end

data/spec/binary_value_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+require 'state_store'
+
+describe StateStore::BinaryStore::BinaryValue do 
+  let(:store){double("store")}
+  let(:klass){StateStore::BinaryStore::BinaryValue}
+
+  it "should create new with store and value" do 
+    expect{
+      klass.new(store,4)
+    }.not_to raise_error
+  end
+
+  describe "attributes" do 
+    it "should have value" do 
+      value = klass.new(store,4)
+      value.value.should eq(4)
+    end
+
+    it "should have store" do 
+      value =klass.new(store,4)
+      value.store.should eq(store)
+    end
+  end
+
+  it "should detect if it has status" do 
+    value = klass.new(store,4)
+    store.should_receive(:has_status?).with(:read,4)
+    value.has_status?(:read)
+  end
+end

data/spec/extension_spec.rb

@@ -0,0 +1,69 @@
+require 'spec_helper'
+require 'state_store'
+
+describe StateStore::Extension do
+  let(:klass){Class.new}
+  
+  it "should add #has_store class method" do 
+    klass.send(:include,StateStore)
+    klass.should.respond_to?(:has_store)
+  end
+
+  describe "ClassMethods" do 
+    before(:each) do 
+      klass.send(:include,StateStore)
+    end
+
+    it "should raise error when no statuses is given" do 
+      expect{
+        klass.has_statuses()
+      }.to raise_error(ArgumentError,"No statuses given")
+    end
+
+    it "should raise error when no :in key is given" do 
+      expect{
+        klass.has_statuses :read,:write
+      }.to raise_error(ArgumentError,":in is required")
+    end
+
+    it "should create store with given statuses" do 
+      klass.has_statuses :read,:write, :in => :status
+      klass.state_store_store.statuses.should eq([:read,:write])
+    end
+
+    it "should store given options in #state_store_options" do 
+      klass.has_statuses :read,:write, :in => :status 
+      klass.state_store_options.should eq({:in => :status})
+    end
+  end
+
+  describe "InstanceMethods" do 
+    let(:object){klass.new}
+    before(:each){
+      klass.class_eval do 
+        def status_name
+          5
+        end
+      end
+      klass.send(:include,StateStore)
+    }
+
+    it "should call store #has_status? when #has_status_name? is called on klass instance" do 
+      klass.has_statuses :read,:write,:execute, :in => :status_name
+      klass.any_instance.stub(:status_name).and_return(5)
+      
+      object.has_status_name?(:read).should be_true
+      object.has_status_name?(:write).should be_false
+    end
+
+    it "should call store #humanize when [status_name] is called on instance of class" do 
+      klass.has_statuses :read,:write,:execute, :in => :status_name
+      object.status_name.should eq([:read,:execute])
+    end 
+
+    it "should call super if base class not respond to method" do 
+
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper.rb"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+end

data/state_store.gemspec

@@ -0,0 +1,61 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "state_store"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Arturs Meisters"]
+  s.date = "2012-03-29"
+  s.description = "Create numeric value to Array of states."
+  s.email = "arturs.meisters@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "lib/state_store.rb",
+    "lib/state_store/binary_store.rb",
+    "lib/state_store/extension.rb",
+    "spec/binary_store_spec.rb",
+    "spec/binary_value_spec.rb",
+    "spec/extension_spec.rb",
+    "spec/spec_helper.rb",
+    "state_store.gemspec"
+  ]
+  s.homepage = "http://github.com/kalifs/state_store"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Convert numeric value to Array of states"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.3"])
+    else
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+    end
+  else
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.3"])
+  end
+end
+

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: state_store
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Arturs Meisters
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &18782820 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: *18782820
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &18781480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *18781480
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &18799320 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+  type: :development
+  prerelease: false
+  version_requirements: *18799320
+description: Create numeric value to Array of states.
+email: arturs.meisters@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/state_store.rb
+- lib/state_store/binary_store.rb
+- lib/state_store/extension.rb
+- spec/binary_store_spec.rb
+- spec/binary_value_spec.rb
+- spec/extension_spec.rb
+- spec/spec_helper.rb
+- state_store.gemspec
+homepage: http://github.com/kalifs/state_store
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2956134080418210540
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Convert numeric value to Array of states
+test_files: []