rubiks 0.0.1 → 0.0.2

data/Gemfile

@@ -2,6 +2,3 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in rubiks.gemspec
 gemspec
-
-gem 'yajl-ruby'
-gem 'redis'

data/examples/finance/.rvmrc

@@ -0,0 +1 @@
+rvm use jruby-1.7.0

data/examples/finance/Gemfile

@@ -0,0 +1,11 @@
+source 'http://rubygems.org'
+
+gem 'rubiks', :path => '../../'
+
+gem 'activerecord', :require => 'active_record'
+gem 'activerecord-jdbcpostgresql-adapter'
+gem 'awesome_print'
+gem 'jruby-openssl'
+gem 'mondrian-olap'
+gem 'pry'
+gem 'pry-nav'

data/examples/finance/app.rb

@@ -0,0 +1,14 @@
+require 'bundler'
+Bundler.require
+require 'pry'
+
+ActiveRecord::Base.establish_connection(YAML.load_file('./database.yml'))
+require './domain'
+
+query = "SELECT {[Measures].[Balance]} ON COLUMNS, {[Customers].children} ON ROWS FROM [CubeAccountSnapshots] WHERE ([Date].[2012].[4])"
+
+cas = CubeAccountSnapshot.last
+
+binding.pry
+
+cas.mdx query

data/examples/finance/database.yml

@@ -0,0 +1,5 @@
+adapter: postgresql
+encoding: utf8
+host: localhost
+username: postgres
+database: finance_development

data/examples/finance/domain.rb

@@ -0,0 +1,44 @@
+module Dimensions
+  class Account < ActiveRecord::Base
+    include Rubiks::Dimension
+
+    hierarchy 'Asset/Liability' do
+      level :asset_liability
+      level :account_type
+    end
+
+    hierarchy 'Institution' do
+      level :institution
+    end
+  end
+
+  class Customer < ActiveRecord::Base
+    include Rubiks::Dimension
+
+    hierarchy 'Gender' do
+      level :gender
+    end
+  end
+
+  class Date < ActiveRecord::Base
+    include Rubiks::Dimension
+
+    hierarchy 'Date' do
+      level :year
+      level :quarter
+      level :month
+    end
+  end
+end
+
+module Facts
+  class AccountSnapshot < ActiveRecord::Base
+    include Rubiks::Fact
+
+    dimension :account
+    dimension :customer
+    dimension :date
+
+    measure :balance
+  end
+end

data/examples/finance/setup

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+# Requires PostgreSQL
+# Setup the finance_development DB
+
+require 'bundler'
+Bundler.require
+
+config = YAML.load_file('./database.yml')
+
+ActiveRecord::Base.establish_connection(config.merge('database' => 'postgres'))
+ActiveRecord::Base.connection.create_database(config['database'])
+
+ActiveRecord::Base.establish_connection(config)
+
+ActiveRecord::Migration.create_table :accounts do |t|
+  t.string :asset_liability
+  t.string :account_type
+  t.string :institution
+end
+
+ActiveRecord::Migration.create_table :dates do |t|
+  t.integer :year
+  t.integer :quarter
+  t.integer :month
+  t.integer :day
+end
+
+ActiveRecord::Migration.create_table :customers do |t|
+  t.string :name
+  t.string :gender
+end
+
+ActiveRecord::Migration.create_table :account_snapshots do |t|
+  t.references :account
+  t.references :date
+  t.references :customer
+  t.decimal :balance
+end
+
+require './domain'
+
+account   = Dimensions::Account.create(:asset_liability => 'ASSET', :account_type => 'Savings', :institution => 'ACU - Awesome Credit Union')
+customer  = Dimensions::Customer.create(:name => 'JohnnyT', :gender => 'Male')
+date      = Dimesnions::Date.create(:year => 2012, :quarter => 4, :month => 11, :day => 31)
+
+Facts::AccountSnapshot.create(:account => account, :customer => customer, :date => date, :balance => 100.00)

data/lib/rubiks/cube.rb

@@ -1,9 +1,95 @@
 module Rubiks
-  class Cube
-    def dimensions
+  module Cube
+    def self.included(klass)
+      klass.extend Rubiks::Cube::ClassMethods
     end
 
-    def measures
+    module ClassMethods
+      def dimension(name)
+        model_name = name.to_s
+        dimensions << model_name
+        belongs_to model_name, :class_name => "Dimensions::#{model_name.classify}"
+      end
+
+      def dimensions
+        @dimensions ||= []
+      end
+
+      def measure(name)
+        measures << name
+      end
+
+      def measures
+        @measures ||= []
+      end
+    end
+
+    def mdx(query)
+      res = olap.execute(query)
+      output = []
+      output << res.column_full_names
+      res.values.each{ |v| output << v }
+      output.join("\n")
+    end
+
+    def to_s
+      "#<#{self.class.name}>"
+    end
+
+    def inspect
+      "#<#{self.class.name} dims: #{self.class.dimensions.inspect}>"
+    end
+
+
+    private
+
+    def olap
+      @olap ||= Mondrian::OLAP::Connection.create(mondrian_config)
+    end
+
+    def mondrian_config
+      @mondrian_config ||= begin
+        ar_config = ActiveRecord::Base.connection.config
+
+        {
+          :driver   => ar_config[:adapter],
+          :host     => ar_config[:host],
+          :database => ar_config[:database],
+          :username => ar_config[:username],
+          :password => ar_config[:password],
+          :schema   => mondrian_schema
+        }
+      end
+    end
+
+    def mondrian_schema
+      rubiks_cube = self
+      @mondrian_schema ||= Mondrian::OLAP::Schema.define do
+        cube rubiks_cube.class.name do
+          table rubiks_cube.class.table_name
+
+          rubiks_cube.class.reflections.each do |name, reflection|
+            dimension reflection.name.titleize, :foreign_key => reflection.foreign_key do
+
+              reflection.class_name.constantize.hierarchies.each do |h|
+                hierarchy :has_all => true, :primary_key => :id do
+                  table reflection.table_name
+
+                  h.levels.each do |l|
+                    level l.to_s.titleize, :column => l
+                  end
+                end
+              end
+
+            end
+          end
+
+          rubiks_cube.class.measures.each do |m|
+            measure m.to_s.titleize, :column => m, :aggregator => 'avg'
+          end
+        end
+      end
     end
+
   end
 end

data/lib/rubiks/dimension.rb

@@ -1,6 +1,23 @@
 module Rubiks
-  class Dimension
+  module Dimension
+    def self.included(klass)
+      klass.extend Rubiks::Dimension::ClassMethods
+    end
+
+    module ClassMethods
+      def hierarchy(name, &block)
+        new_hierarchy = Hierarchy.new(name)
+        new_hierarchy.instance_eval(&block) if block_given?
+        hierarchies << new_hierarchy
+      end
+
+      def hierarchies
+        @hierarchies ||= []
+      end
+    end
+
     def hierarchies
+      self.class.hierarchies
     end
   end
 end

data/lib/rubiks/hierarchy.rb

@@ -0,0 +1,15 @@
+module Rubiks
+  class Hierarchy
+    attr_accessor :name
+    attr_reader :levels
+
+    def initialize(name)
+      @name = name
+      @levels = []
+    end
+
+    def level(name)
+      levels << name
+    end
+  end
+end

data/lib/rubiks/transformers/lookup_transformer.rb

@@ -0,0 +1,81 @@
+module Rubiks
+  module Transformers
+    module LookupTransformer
+      ##
+      # Public instance methods
+      #
+      # Looks up the member or creates a new member if missing
+      # @param[ActiveRecord Class] The class to lookup
+      # @param[String] The external natural key (PK)
+      # @return[Object] The found or created member
+      def lookup_member(klass, natural_key)
+        model_name = klass.name.underscore
+        cache_key = "rubiks.lookup.#{model_name}.#{natural_key}"
+
+        if id = cache.read(cache_key)
+          klass.find_by_id(id)
+
+        elsif existing_member = klass.where(:natural_key => natural_key).first
+          cache.write(cache_key, existing_member.id)
+          existing_member
+
+        else
+          new_member = klass.new
+          new_member.natural_key = natural_key
+
+          new_member.save!
+          cache.write(cache_key, new_member.id)
+          new_member
+        end
+      end
+
+      # Looks up the surrogate key based off a natural key
+      # @param[ActiveRecord Class] The class to lookup
+      # @param[String] The external natural key (PK)
+      # @return[Integer] The surrogate key of the found or created member
+      def lookup(klass, natural_key)
+        model_name = klass.name.underscore
+        cache_key = "rubiks.lookup.#{model_name}.#{natural_key}"
+
+        if id = cache.read(cache_key)
+          id
+
+        elsif existing_member = klass.where(:natural_key => natural_key).first
+          cache.write(cache_key, existing_member.id)
+          existing_member.id
+
+        else
+          new_member = klass.new
+          new_member.natural_key = natural_key
+
+          new_member.save!
+          cache.write(cache_key, new_member.id)
+          new_member.id
+        end
+      end
+
+      def lookup_date(input)
+        date =  if input == :today
+                  Date.today
+                elsif input == :yesterday
+                  1.day.ago
+                elsif input.kind_of? Integer
+                  Time.at(input)
+                else
+                  Date.parse(input)
+                end
+
+        date.strftime('%Y%m%d').to_i
+      rescue
+        -1
+      end
+
+      private
+
+      def cache
+        @cache ||= Rails.cache
+      end
+
+    end
+  end
+end

data/lib/rubiks/version.rb

@@ -1,3 +1,3 @@
 module Rubiks
-  VERSION = '0.0.1'
+  VERSION = '0.0.2'
 end

data/lib/rubiks.rb

@@ -3,12 +3,9 @@ require 'rubiks/version'
 module Rubiks
   autoload :Cube,       'rubiks/cube'
   autoload :Dimension,  'rubiks/dimension'
+  autoload :Hierarchy,  'rubiks/hierarchy'
 
-  module Cubes
-    # autoload :Base,  'rubiks/cubes/base'
-  end
-
-  module Dimensions
-    # autoload :Base,  'rubiks/dimensions/base'
+  module Transformers
+    autoload :LookupTransformer, 'rubiks/transformers/lookup_transformer'
   end
 end

data/rubiks.gemspec

@@ -19,11 +19,13 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency 'arel'
 
-  gem.add_development_dependency 'rake'
-  gem.add_development_dependency 'minitest'
-  gem.add_development_dependency 'rb-fsevent'
+  gem.add_development_dependency 'awesome_print'
   gem.add_development_dependency 'guard'
   gem.add_development_dependency 'guard-minitest'
+  gem.add_development_dependency 'minitest'
+  gem.add_development_dependency 'pry'
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rb-fsevent'
   gem.add_development_dependency 'simplecov'
   gem.add_development_dependency 'simplecov-gem-adapter'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubiks
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-18 00:00:00.000000000 Z
+date: 2012-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: arel
@@ -28,7 +28,39 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: awesome_print
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -60,7 +92,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: rb-fsevent
+  name: pry
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -76,7 +108,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: guard
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -92,7 +124,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: guard-minitest
+  name: rb-fsevent
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -153,9 +185,17 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- examples/finance/.rvmrc
+- examples/finance/Gemfile
+- examples/finance/app.rb
+- examples/finance/database.yml
+- examples/finance/domain.rb
+- examples/finance/setup
 - lib/rubiks.rb
 - lib/rubiks/cube.rb
 - lib/rubiks/dimension.rb
+- lib/rubiks/hierarchy.rb
+- lib/rubiks/transformers/lookup_transformer.rb
 - lib/rubiks/version.rb
 - rubiks.gemspec
 - test/rubiks/test_cube.rb
@@ -173,18 +213,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 3892697901423370992
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 3892697901423370992
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.24