census 0.4.0 → 0.4.1

data/README.rdoc

@@ -84,6 +84,25 @@ to render the partial:
 
   <%= render 'census/user_answers', :user => @user %>
 
+== Accessing a User's Answers
+
+From your User object, you can get to that user's answers using methods that
+are automatically generated for each of your data groups and questions. For
+example, let's assume you have a data group called "Physical Attributes" with
+questions for "Weight" and "Hair Color." You can retrieve a user's answers
+like this:
+
+	user.census_data.physical_attributes.weight
+	user.census_data.physical_attributes.hair_color
+
+If your data group and question names change frequently, or if you've exposed
+the census admin UI so that the questions can be changed by your users, you'll
+probably want to avoid relying on the auto-generated method names. Instead,
+you can access the user's answers using strings, like this:
+
+  user.census_data['Physical Attributes']['Weight']
+  user.census_data['Physical Attributes']['Hair Color']
+
 == Searching
 
 Census provides a search interface for finding users whose answers match a list

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/lib/census/user.rb

@@ -67,6 +67,14 @@ module Census
       def answer_for_choice(choice)
         answers.select {|a| a.question == choice.question && a.data == choice.value}.first || answers.build(:question => choice.question, :data => '')
       end
+      
+      #
+      # Returns a Census::UserData object that can be used to retrieve this user's
+      # answers.
+      #
+      def census_data
+        @census_data ||= Census::UserData.new(self)
+      end
 
       private
 

data/lib/census/user_data.rb

@@ -0,0 +1,53 @@
+module Census
+  class UserData
+
+    def initialize(user, data_group = nil)
+      @user = user
+      
+      if data_group
+        @questions = {}
+        define_question_methods(data_group)
+      else
+        @data_groups = {}
+        define_data_group_methods
+      end
+    end
+    
+    def [](key)
+      if @data_groups
+        @data_groups[key]
+      else
+        @user.first_answer_for(@questions[key]).formatted_data
+      end
+    end
+    
+    
+    private
+    
+    
+    def define_data_group_methods
+      DataGroup.all.each do |group|
+        @data_groups[group.name] = Census::UserData.new(@user, group)
+        
+        (class << self; self; end).class_eval do
+          define_method group.name.parameterize.underscore do
+            @data_groups[group.name]
+          end
+        end
+      end
+    end
+    
+    def define_question_methods(data_group)
+      data_group.questions.each do |question|
+        @questions[question.prompt] = question
+        
+        (class << self; self; end).class_eval do
+          define_method question.prompt.parameterize.underscore do
+            @user.first_answer_for(question).formatted_data
+          end
+        end
+      end
+    end
+
+  end
+end

data/test/models/answer_test.rb

@@ -29,13 +29,6 @@ class AnswerTest < ActiveSupport::TestCase
         a = Factory(:answer, :question => Factory(:question, :data_type => 'Number'), :data => '5389')
         assert_equal 5389, a.formatted_data
       end
-
-      should "format booleans" do
-        a = Factory(:answer, :question => Factory(:question, :data_type => 'Yes/No'), :data => '0')
-        assert_equal false, a.formatted_data
-        a.data = '1'
-        assert_equal true, a.formatted_data
-      end
       
     end
     

data/test/models/question_test.rb

@@ -168,44 +168,6 @@ class QuestionTest < ActiveSupport::TestCase
 
     end
 
-    context "with Yes/No data type" do
-
-      setup do
-        @question.data_type = 'Yes/No'
-      end
-
-      should "return a boolean sql transform" do
-        assert_equal "CAST(? AS CHAR)", @question.sql_transform
-      end
-
-      context "with answers" do
-
-        setup do
-          @answer1 = Factory(:answer, :question => @question)
-          @answer1.update_attribute(:data, false)
-          @answer2 = Factory(:answer, :question => @question, :data => true)
-        end
-
-        should "find answers matching true" do
-          assert @question.find_answers_matching(true).include?(@answer2)
-        end
-
-        should "not find answers not matching true" do
-          assert !@question.find_answers_matching(true).include?(@answer1)
-        end
-
-        should "find answers matching false" do
-          assert @question.find_answers_matching(false).include?(@answer1)
-        end
-
-        should "not find answers not matching false" do
-          assert !@question.find_answers_matching(false).include?(@answer2)
-        end
-
-      end
-
-    end
-
   end
       
 end

data/test/models/user_test.rb

@@ -6,4 +6,42 @@ class UserTest < ActiveSupport::TestCase
   should_accept_nested_attributes_for :answers
   should_allow_mass_assignment_of     :answers_attributes
 
+  context 'Looking up answers' do
+    
+    setup do
+      @data_group = Factory(:data_group, :name => 'Physical Attributes')
+      @question1 = Factory(:question, :prompt => 'Hair Color', :data_group => @data_group)
+      @question2 = Factory(:question, :prompt => 'Weight', :data_type => 'Number', :data_group => @data_group)
+
+      @user = Factory(:user)
+      @user.answers << Factory(:answer, :question => @question1, :data => 'Brown')
+      @user.answers << Factory(:answer, :question => @question2, :data => '150')
+    end
+    
+    context 'using auto-generated methods' do
+      
+      should 'return string values for string data types' do
+        assert_equal 'Brown', @user.census_data.physical_attributes.hair_color
+      end
+    
+      should 'return integer values for numeric data types' do
+        assert_equal 150, @user.census_data.physical_attributes.weight
+      end
+      
+    end
+
+    context 'using data group and question strings' do
+      
+      should 'return string values for string data types' do
+        assert_equal 'Brown', @user.census_data['Physical Attributes']['Hair Color']
+      end
+    
+      should 'return integer values for numeric data types' do
+        assert_equal 150, @user.census_data['Physical Attributes']['Weight']
+      end
+      
+    end
+    
+  end
+
 end

data/test/rails_root/config/initializers/census.rb

@@ -6,6 +6,17 @@ Census.configure do |config|
   # config.admin_role = 'current_user.admin?'
 end
 
+#
+# Define data types. All data is stored in the database as strings, and you can
+# provide procs that will be used to convert from the stored strings to any data
+# type you need.
+#
+# :sql_transform - should return a SQL fragment that will be used for comparing
+#                  data when doing search queries
+# :format_data   - is used to convert data from its string representation
+# :validate_data - is used to validate form field submissions, and should return
+#                  nil if the data is valid and an error message if it is invalid
+#
 Census::DataType.define("String")
 
 Census::DataType.define(
@@ -14,9 +25,3 @@ Census::DataType.define(
   :format_data    => lambda {|data| data.to_i unless data.blank? },
   :validate_data  => lambda {|data| "must be a number" unless data =~ /^\d*$/}
 )
-
-Census::DataType.define(
-  "Yes/No",
-  :sql_transform  => lambda {|column_name| "CAST(#{column_name} AS CHAR)"},
-  :format_data    => lambda {|data| %w(1 T t Y y).include?(data) unless data.blank? }
-)

data/test/rails_root/db/schema.rb

@@ -9,7 +9,7 @@
 #
 # It's strongly recommended to check this file into your version control system.
 
-ActiveRecord::Schema.define(:version => 20100416173354) do
+ActiveRecord::Schema.define(:version => 20100421154808) do
 
   create_table "answers", :force => true do |t|
     t.integer "question_id"

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 4
-  - 0
-  version: 0.4.0
+  - 1
+  version: 0.4.1
 platform: ruby
 authors: 
 - Mark Kendall
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-04-16 00:00:00 -04:00
+date: 2010-04-21 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -116,6 +116,7 @@ files:
 - lib/census/data_type.rb
 - lib/census/search.rb
 - lib/census/user.rb
+- lib/census/user_data.rb
 - rails/init.rb
 - shoulda_macros/census.rb
 has_rdoc: true
@@ -171,7 +172,7 @@ test_files:
 - test/rails_root/config/initializers/new_rails_defaults.rb
 - test/rails_root/config/initializers/session_store.rb
 - test/rails_root/config/routes.rb
-- test/rails_root/db/migrate/20100416173354_create_census_tables.rb
+- test/rails_root/db/migrate/20100421154808_create_census_tables.rb
 - test/rails_root/db/schema.rb
 - test/rails_root/test/factories/census.rb
 - test/rails_root/test/performance/browsing_test.rb