concensus 0.0.5

data/.gitignore

@@ -0,0 +1,16 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in concensus.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    concensus (0.0.5)
+      activesupport
+      dbf
+      georuby
+      rspec
+      rubyzip
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (3.2.6)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    dbf (1.7.5)
+    diff-lcs (1.1.3)
+    georuby (1.9.7)
+    i18n (0.6.0)
+    multi_json (1.3.6)
+    redcarpet (2.1.1)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.1)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    rubyzip (0.9.9)
+    yard (0.8.2.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  concensus!
+  redcarpet
+  rspec
+  yard

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 adamjacobbecker
+
+MIT License
+
+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.md

@@ -0,0 +1,47 @@
+# Concensus
+
+Concensus is a gem for reading the United States Census Bureau's TIGER/Line Shapefiles.
+
+It uses the [georuby](http://rubygems.org/gems/georuby) gem to convert the shapefiles, which leaves you with access to all of the methods in the [georuby API](http://www.ruby-doc.org/gems/docs/g/georuby-1.9.7/GeoRuby/SimpleFeatures/MultiPolygon.html).
+
+## Install
+
+    gem 'concensus'
+
+
+## Use
+
+	Concensus::Place.find("CA", "Berkeley")
+		=> #<Concensus::Resource>
+		
+	Concensus::Place.find_all("CA")
+		=> [#<Concensus::Resource>, #<Concensus::Resource>, etc...]	
+	
+	california = Concensus::State.find("CA")
+	
+	california.geometry
+		=> #<GeoRuby::SimpleFeatures::MultiPolygon>
+	
+	california.geometry.to_array
+		=> [[[-119.000932, 33.535895], [-119.000932, 33.535823], [-118.997845, 33.534199], [-118.994453, 33.532711], [-118.992796, 33.531849], [-118.990046, 33.530288999999996], [-118.986199, 33.527425], ...], ...]
+		
+	california.geometry.to_array[0]
+		=> [[-119.000932, 33.535895], [-119.000932, 33.535823], ... ] 
+
+
+### Full Documentation
+[http://www.googl.com]()
+
+### Notes
+
+Some of the .zip files downloaded are quite large, so this gem requires temporary storage to unzip and cache the downloaded files. By default, we store these in `~/.concensus/tmp/`.
+
+If you're using Rails, you'll probably want to create an initializer with `Concensus.configure { |c| c.tmp_dir = "#{Rails.root}/tmp/concensus/" }`. This way, you can use Concensus with the (very temporary) writable storage on Heroku.
+
+#### Todo
+
+- Add support for switching Census year (already started, not fully implemented yet.)
+- Add more geographic areas, we only have a small bit of [what's available](http://www.census.gov/geo/www/tiger/tgrshp2010/availability.html).
+- Add support for storing downloaded and uncompressed .zips on S3. (Heroku has no persistent writable file storage.)
+
+**Support development by sending links to sick house music mixes:** [@AdamJacobBecker](http://www.twitter.com/AdamJacobBecker)

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/concensus.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/concensus/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["adamjacobbecker"]
+  gem.email         = ["ad@mbecker.cc"]
+  gem.description   = %q{"A small tool for reading United States Census TIGER/Line Shapefiles."}
+  gem.summary       = %q{"Converts U.S. Census Shapes to RGeo format."}
+  gem.homepage      = "https://github.com/adamjacobbecker/concensus"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "concensus"
+  gem.require_paths = ["lib"]
+  gem.version       = Concensus::VERSION
+    
+  %w{rspec yard redcarpet}.each do |x|
+    gem.add_development_dependency x
+  end
+  
+  %w{rspec activesupport rubyzip georuby dbf}.each do |x|
+    gem.add_dependency x
+  end
+end

data/lib/concensus/configuration.rb

@@ -0,0 +1,45 @@
+module Concensus
+  class Configuration
+    attr_accessor :year, :census_state_ids
+    attr_reader :tmp_dir, :default_tmp_dir
+    
+    # Temporary directory for storing .zip files and their contents.
+    # It's best if this directory persists as a "cache" of sorts, so
+    # that we're not hitting the Census server over and over.
+    # 
+    # On Heroku, set this to #{RAILS_ROOT}/tmp, which is Heroku's
+    # only writable storage.
+    def tmp_dir=(x)
+      @tmp_dir = x
+      FileUtils.mkdir_p(@tmp_dir)
+    end
+    
+    # This will become useful once we can switch years...
+    def root_url
+      "http://www2.census.gov/geo/tiger/TIGER#{@year}/"
+    end
+
+    def initialize
+      @year = 2010
+      
+      @tmp_dir = @default_tmp_dir = "#{Dir.home()}/.concensus/tmp/"
+      FileUtils.mkdir_p(@tmp_dir)
+      
+      # Not really sure what the Census' IT department was going for with this number system.
+      @census_state_ids = { "AL"=>"01","AK"=>"02","AZ"=>"04","AR"=>"05","CA"=>"06","CO"=>"08","CT"=>"09","DE"=>"10","DC"=>"11","FL"=>"12","GA"=>"13","HI"=>"15","ID"=>"16","IL"=>"17","IN"=>"18","IA"=>"19","KS"=>"20","KY"=>"21","LA"=>"22","ME"=>"23","MD"=>"24","MA"=>"25","MI"=>"26","MN"=>"27","MS"=>"28","MO"=>"29","MT"=>"30","NE"=>"31","NV"=>"32","NH"=>"33","NJ"=>"34","NM"=>"35","NY"=>"36","NC"=>"37","ND"=>"38","OH"=>"39","OK"=>"40","OR"=>"41","PA"=>"42","RI"=>"44","SC"=>"45","SD"=>"46","TN"=>"47","TX"=>"48","UT"=>"49","VT"=>"50","VA"=>"51","WA"=>"53","WV"=>"54","WI"=>"55","WY"=>"56","AS"=>"60","GU"=>"66","MP"=>"69","PR"=>"72","VI"=>"78" }
+    end
+  end
+
+  class << self
+    attr_accessor :configuration
+    
+    def configuration
+      @configuration = Configuration.new if @configuration.nil?
+      @configuration
+    end
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+end

data/lib/concensus/congressional.rb

@@ -0,0 +1,16 @@
+module Concensus
+  class Congressional < Resource
+    
+    # @return [Concensus::Resource] matched congressional district
+    def self.find(state, name = nil)
+      shp_file_path = get_and_unzip("CD/111/tl_2010_#{state_code_to_id(state)}_cd111.zip")
+      return process_find(shp_file_path, "NAMELSAD10", state, name)      
+    end
+    
+    # @return [Array] array of all congressional districts for a state
+    def self.find_all(state)
+      find(state)       
+    end
+
+  end
+end

data/lib/concensus/county.rb

@@ -0,0 +1,16 @@
+module Concensus
+  class County < Resource
+  
+    # @return [Concensus::Resource] matched county
+    def self.find(state, name = nil)
+      shp_file_path = get_and_unzip("COUNTY/2010/tl_2010_#{state_code_to_id(state)}_county10.zip")
+      return process_find(shp_file_path, "NAME10", state, name)      
+    end
+    
+    # @return [Array] all counties for a state
+    def self.find_all(state)
+      find(state)       
+    end
+    
+  end
+end

data/lib/concensus/place.rb

@@ -0,0 +1,16 @@
+module Concensus
+  class Place < Resource
+  
+    # @return [Concensus::Resource] matched place
+    def self.find(state, name = nil)
+      shp_file_path = get_and_unzip("PLACE/2010/tl_2010_#{state_code_to_id(state)}_place10.zip")
+      return process_find(shp_file_path, "NAME10", state, name)      
+    end
+    
+    # @return [Array] all places for a state
+    def self.find_all(state)
+      find(state)       
+    end
+    
+  end
+end

data/lib/concensus/resource.rb

@@ -0,0 +1,117 @@
+require "zip/zip"
+require "geo_ruby"
+require "geo_ruby/shp"
+require "open-uri"
+
+module Concensus  
+  class Resource
+    
+    # @return [MultiPolygon] georuby geometry object
+    attr_accessor :geometry
+    
+    # @return [String] this resource's name in the shpfile metadata    
+    attr_accessor :name
+    
+    # @return [String] the state this resource belongs to, if applicable
+    attr_accessor :state
+    
+    # @return [Fixnum] this resource's census year
+    attr_accessor :year
+      
+    def initialize(name, geometry, state)
+      @name = name
+      @geometry = geometry
+      @state = state
+      @year = Concensus::configuration.year
+    end
+    
+    # Checks for census zipfile in temporary storage. If not there, downloads it.
+    # Then, checks for unzipped files in temporary storage. If not there, unzips the archive.
+    #
+    # @return [String] path to shpfile in temporary storage
+    def self.get_and_unzip(uri)
+      safe_filename = uri.gsub("/", "_").gsub(".zip", "")
+      zipped_file_path = "#{Concensus::configuration.tmp_dir}#{safe_filename}.zip"
+      
+      if !File.exists?(zipped_file_path)
+        zipped_file = File.new(zipped_file_path, "wb")
+        ext_file = open(Concensus::configuration.root_url + uri)
+        zipped_file.write(ext_file.read)
+      end
+      
+      if !already_unzipped?(zipped_file_path)
+        unzipped_files = Zip::ZipFile.open(zipped_file_path)
+      
+        unzipped_files.each do |x|
+          file = File.new(Concensus::configuration.tmp_dir + safe_filename + file_extension(x.to_s), "wb")
+          file.write(x.get_input_stream.read)
+          file.close
+        end
+      end
+      
+      return "#{Concensus::configuration.tmp_dir}#{safe_filename}.shp"
+    end
+
+    # Converts the shpfile to a georuby object.
+    #
+    # If we're searching for a specific region in the shpfile,
+    # we find it by iterating over each region and matching
+    # by metadata. We return the first one we find.
+    # 
+    # @return [Array] returns array if we're looking for mulitple regions
+    # @return [Resource] returns resource if we're looking for a specific region
+    def self.process_find(shp_file_path, identifier, state, name = nil)
+      
+      # Prevent annoying georuby error messages
+      previous_stderr, $stderr = $stderr, StringIO.new
+      
+      if name
+        GeoRuby::Shp4r::ShpFile.open(shp_file_path) do |shp|
+          matched_shape = shp.find {|x| x.data[identifier].match(name) }
+          raise StandardError if !matched_shape
+          return Resource.new(matched_shape.data[identifier], matched_shape.geometry, state)
+        end
+      else
+        places = []
+        GeoRuby::Shp4r::ShpFile.open(shp_file_path).each do |shp|
+          places << Resource.new(shp.data[identifier], shp.geometry, state)
+        end
+        return places
+      end
+      
+      # Restore previous value of stderr
+      $stderr.string
+      $stderr = previous_stderr
+      
+    end
+
+    # Converts a state code, like "CA", to the US Census Bureau's numerical identifier.
+    # @param [String] two-letter state code
+    # @return [Fixnum] numerical census state identifier
+    def self.state_code_to_id(state_code)
+      Concensus::configuration.census_state_ids[state_code]
+    end
+    
+    # @return [Boolean] true if the zip's files are found in
+    #   temporary storage
+    def self.already_unzipped?(zipped_file_path)
+      file_path_without_extension = filename_without_extension(zipped_file_path)
+      File.exists?("#{file_path_without_extension}.shp") &&
+      File.exists?("#{file_path_without_extension}.dbf") &&
+      File.exists?("#{file_path_without_extension}.shx")
+    end
+    
+    # @param [String] filename
+    # @return [String]filename with the extension stripped.
+    def self.filename_without_extension(filename)
+      filename.gsub(/\.[a-z]*$/, "")
+    end
+  
+    # @param [String] filename
+    # @return [String] file's extension.    
+    def self.file_extension(filename)
+      filename[/\.[a-z]*$/]
+    end
+    
+  end
+end

data/lib/concensus/school.rb

@@ -0,0 +1,44 @@
+module Concensus
+  class School < Resource
+    
+    class Elementary < School
+      # @return [Concensus::Resource] matched elementary school district
+      def self.find(state, name = nil)
+        shp_file_path = get_and_unzip("ELSD/2010/tl_2010_#{state_code_to_id(state)}_elsd10.zip")
+        return process_find(shp_file_path, "NAME10", state, name)      
+      end
+
+      # @return [Array] all elementary school districts for a state
+      def self.find_all(state)
+        find(state)       
+      end
+    end
+    
+    class Secondary < School
+      # @return [Concensus::Resource] matched secondary school district
+      def self.find(state, name = nil)
+        shp_file_path = get_and_unzip("SCSD/2010/tl_2010_#{state_code_to_id(state)}_scsd10.zip")
+        return process_find(shp_file_path, "NAME10", state, name)      
+      end
+      
+      # @return [Array] all secondary school districts for a state
+      def self.find_all(state)
+        find(state)       
+      end
+    end
+    
+    class Unified < School
+      # @return [Concensus::Resource] matched unified school district
+      def self.find(state, name = nil)
+        shp_file_path = get_and_unzip("UNSD/2010/tl_2010_#{state_code_to_id(state)}_unsd10.zip")
+        return process_find(shp_file_path, "NAME10", state, name)      
+      end
+
+      # @return [Array] all unified school districts for a state
+      def self.find_all(state)
+        find(state)       
+      end
+    end
+        
+  end
+end

data/lib/concensus/state.rb

@@ -0,0 +1,20 @@
+module Concensus
+  class State < Resource
+  
+    # @return [Concensus::Resource] matched state
+    def self.find(state)
+      shp_file_path = get_and_unzip("STATE/2010/tl_2010_#{state_code_to_id(state)}_state10.zip")
+      return process_find(shp_file_path, "NAME10", state)[0]      
+    end
+    
+    # @return [Array] all states
+    def self.find_all
+      shapes = []
+      Concensus::configuration.census_state_ids.each do |state_code, _|
+        shapes << find(state_code)
+      end
+      return shapes
+    end
+    
+  end
+end

data/lib/concensus/state_legislative.rb

@@ -0,0 +1,31 @@
+module Concensus
+  class StateLegislative < Resource
+    
+    class Upper < StateLegislative
+      # @return [Concensus::Resource] matched state upper legislative district
+      def self.find(state, name = nil)
+        shp_file_path = get_and_unzip("SLDU/2010/tl_2010_#{state_code_to_id(state)}_sldu10.zip")
+        return process_find(shp_file_path, "NAMELSAD10", state, name)      
+      end
+
+      # @return [Array] all state's upper legislative districts
+      def self.find_all(state)
+        find(state)       
+      end
+    end
+    
+    class Lower < StateLegislative
+      # @return [Concensus::Resource] matched state lower legislative district
+      def self.find(state, name = nil)
+        shp_file_path = get_and_unzip("SLDL/2010/tl_2010_#{state_code_to_id(state)}_sldl10.zip")
+        return process_find(shp_file_path, "NAMELSAD10", state, name)      
+      end
+
+      # @return [Array] all state's lower legislative district
+      def self.find_all(state)
+        find(state)       
+      end      
+    end
+    
+  end
+end

data/lib/concensus/version.rb

@@ -0,0 +1,3 @@
+module Concensus
+  VERSION = "0.0.5"
+end

data/lib/concensus.rb

@@ -0,0 +1,16 @@
+require "concensus/version"
+require "concensus/configuration"
+require "concensus/resource"
+require "concensus/place"
+require "concensus/county"
+require "concensus/state"
+require "concensus/state_legislative"
+require "concensus/congressional"
+require "concensus/school"
+require "geo_ruby/simple_features"
+require "active_support"
+require "zip/zip"
+
+module Concensus
+end
+

data/lib/geo_ruby/simple_features.rb

@@ -0,0 +1,29 @@
+# Monkeypatches GeoRuby to add a couple class methods. 
+module GeoRuby
+  module SimpleFeatures
+    class MultiPolygon
+      # A shortcut for grabbing an array of coordinates from GeoRuby's MultiPolygon.
+      # @return [Array] an array of polygons, each one an array of coordinate pairs
+      def to_array
+        coord_array = self.as_json[:coordinates]
+        
+        ## Fixes weird, unnecessary extra array
+        0.upto(coord_array.count - 1).each do |i|
+          coord_array[i] = coord_array[i][0]
+        end
+        
+        return coord_array
+      end
+      
+      # @param [GeoRuby::SimpleFeatures::Point] GeoRuby Point object
+      # @return [Boolean] true if any of the Polygon's shapes contain this point
+      def contains_point?(point)
+        self.each do |shape|
+          return true if shape.contains_point?(point)
+        end
+        
+        return false
+      end
+    end
+  end
+end

data/spec/concensus/accuracy_spec.rb

@@ -0,0 +1,21 @@
+require 'concensus'
+
+describe Concensus do
+
+  describe "accuracy" do
+    it "should find correct the polygon for berkeley" do
+      berkeley = GeoRuby::SimpleFeatures::Point.from_x_y(-122.2728, 37.8717)
+      not_berkeley = GeoRuby::SimpleFeatures::Point.from_x_y(-122.2728, 30.8717)
+      Concensus::Place.find("CA", "Berkeley").geometry.contains_point?(berkeley).should be_true
+      Concensus::Place.find("CA", "Berkeley").geometry.contains_point?(not_berkeley).should be_false
+    end
+
+    it "should find correct the polygon for santa cruz" do
+      santa_cruz = GeoRuby::SimpleFeatures::Point.from_x_y(-122.0297, 36.9742)
+      not_santa_cruz = GeoRuby::SimpleFeatures::Point.from_x_y(-125.0297, 36.9742)
+      Concensus::Place.find("CA", "Santa Cruz").geometry.contains_point?(santa_cruz).should be_true
+      Concensus::Place.find("CA", "Santa Cruz").geometry.contains_point?(not_santa_cruz).should be_false
+    end
+  end
+  
+end

data/spec/concensus/configuration_spec.rb

@@ -0,0 +1,37 @@
+require 'concensus'
+
+describe Concensus do
+
+  describe "configuration" do
+    it "should have a root url" do
+      Concensus::configuration.root_url.should_not be_empty
+    end
+    
+    describe "should be able to manually set the tmp file" do
+      before { Concensus::configuration.tmp_dir = "tmp/concensustest/" }
+      after do
+        Dir::unlink(Concensus::configuration.tmp_dir)
+        Concensus::configuration.tmp_dir = Concensus::configuration.default_tmp_dir
+      end
+      
+      it "should create the new temp dir" do
+        File.directory?("tmp/concensustest/").should == true
+      end
+    end
+    
+    it "default year should be 2010" do
+      Concensus::configuration.year.should == 2010
+    end
+    
+    describe "should be able to manually set the year" do
+      before { Concensus::configuration.year = 2000 }
+      after { Concensus::configuration.year = 2010 }
+      
+      it "should be updated" do
+        Concensus::configuration.year.should == 2000
+        Concensus::configuration.root_url.should match(/2000/)
+      end
+    end
+  end  
+   
+end

data/spec/concensus/congressional_spec.rb

@@ -0,0 +1,15 @@
+require 'concensus'
+
+describe Concensus do
+  describe "congressional districts" do
+  
+    it "should be able to find a congressional district district for a state" do
+      Concensus::Congressional.find("CA", "13").should be_instance_of(Concensus::Resource)
+    end
+
+    it "should be able to find all upper legislative districts for a state" do
+      Concensus::Congressional.find_all("CA").should be_instance_of(Array)
+    end
+    
+  end
+end

data/spec/concensus/county_spec.rb

@@ -0,0 +1,15 @@
+require 'concensus'
+
+describe Concensus do
+  describe "counties" do
+    
+    it "should be able to find all counties for a state" do
+      Concensus::County.find_all("CA").should be_instance_of(Array)
+    end
+
+    it "should be able to find one county for a state" do
+      Concensus::County.find("CA", "Alameda").should be_instance_of(Concensus::Resource)
+    end
+        
+  end
+end

data/spec/concensus/place_spec.rb

@@ -0,0 +1,15 @@
+require 'concensus'
+
+describe Concensus do
+  describe "places" do
+    
+    it "should be able to find all places for a state" do
+      Concensus::Place.find_all("CA").should be_instance_of(Array)
+    end
+
+    it "should be able to find one places for a state" do
+      Concensus::Place.find("CA", "Berkeley").should be_instance_of(Concensus::Resource)
+    end
+    
+  end
+end

data/spec/concensus/school_spec.rb

@@ -0,0 +1,37 @@
+require 'concensus'
+
+describe Concensus do
+  describe "school districts" do
+    
+    describe "elementary" do
+      it "should be able to find an elementary school district for a state" do
+        Concensus::School::Elementary.find("AZ", "San Fernando").should be_instance_of(Concensus::Resource)
+      end
+
+      it "should be able to find all elementary school districts for a state" do
+        Concensus::School::Elementary.find_all("AZ").should be_instance_of(Array)
+      end
+    end
+    
+    describe "elementary" do
+      it "should be able to find a secondary school district for a state" do
+        Concensus::School::Secondary.find("AZ", "Tempe Union").should be_instance_of(Concensus::Resource)
+      end
+
+      it "should be able to find all secondary school districts for a state" do
+        Concensus::School::Secondary.find_all("AZ").should be_instance_of(Array)
+      end
+    end
+    
+    describe "unified" do
+      it "should be able to find a unified school district for a state" do
+        Concensus::School::Unified.find("AZ", "Chandler").should be_instance_of(Concensus::Resource)
+      end
+
+      it "should be able to find all unified school districts for a state" do
+        Concensus::School::Unified.find_all("AZ").should be_instance_of(Array)
+      end
+    end
+    
+  end
+end

data/spec/concensus/state_legislative_spec.rb

@@ -0,0 +1,26 @@
+require 'concensus'
+
+describe Concensus do
+  describe "state legislative districts" do
+    
+    describe "upper" do
+      it "should be able to find an upper legislative district for a state" do
+        Concensus::StateLegislative::Upper.find("CA", "13").should be_instance_of(Concensus::Resource)
+      end
+
+      it "should be able to find all upper legislative districts for a state" do
+        Concensus::StateLegislative::Upper.find_all("CA").should be_instance_of(Array)
+      end
+    end
+    
+    describe "lower" do
+      it "should be able to find a lower legislative district for a state" do
+        Concensus::StateLegislative::Lower.find("CA", "13").should be_instance_of(Concensus::Resource)
+      end
+
+      it "should be able to find all lower legislative districts for a state" do
+        Concensus::StateLegislative::Lower.find_all("CA").should be_instance_of(Array)
+      end
+    end
+  end
+end

data/spec/concensus/state_spec.rb

@@ -0,0 +1,11 @@
+require 'concensus'
+
+describe Concensus do
+  describe "states" do
+    
+    it "should be able to find a state" do
+      Concensus::State.find("CA").should be_instance_of(Concensus::Resource)
+    end  
+    
+  end
+end

metadata

@@ -0,0 +1,168 @@
+--- !ruby/object:Gem::Specification
+name: concensus
+version: !ruby/object:Gem::Version
+  version: 0.0.5
+  prerelease: 
+platform: ruby
+authors:
+- adamjacobbecker
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-07-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70135306169280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70135306169280
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &70135306168460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70135306168460
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: &70135306167620 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70135306167620
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70135306166780 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135306166780
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: &70135306166200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135306166200
+- !ruby/object:Gem::Dependency
+  name: rubyzip
+  requirement: &70135306165640 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135306165640
+- !ruby/object:Gem::Dependency
+  name: georuby
+  requirement: &70135306164940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135306164940
+- !ruby/object:Gem::Dependency
+  name: dbf
+  requirement: &70135306164140 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70135306164140
+description: ! '"A small tool for reading United States Census TIGER/Line Shapefiles."'
+email:
+- ad@mbecker.cc
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- concensus.gemspec
+- lib/concensus.rb
+- lib/concensus/configuration.rb
+- lib/concensus/congressional.rb
+- lib/concensus/county.rb
+- lib/concensus/place.rb
+- lib/concensus/resource.rb
+- lib/concensus/school.rb
+- lib/concensus/state.rb
+- lib/concensus/state_legislative.rb
+- lib/concensus/version.rb
+- lib/geo_ruby/simple_features.rb
+- spec/concensus/accuracy_spec.rb
+- spec/concensus/configuration_spec.rb
+- spec/concensus/congressional_spec.rb
+- spec/concensus/county_spec.rb
+- spec/concensus/place_spec.rb
+- spec/concensus/school_spec.rb
+- spec/concensus/state_legislative_spec.rb
+- spec/concensus/state_spec.rb
+homepage: https://github.com/adamjacobbecker/concensus
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: ! '"Converts U.S. Census Shapes to RGeo format."'
+test_files:
+- spec/concensus/accuracy_spec.rb
+- spec/concensus/configuration_spec.rb
+- spec/concensus/congressional_spec.rb
+- spec/concensus/county_spec.rb
+- spec/concensus/place_spec.rb
+- spec/concensus/school_spec.rb
+- spec/concensus/state_legislative_spec.rb
+- spec/concensus/state_spec.rb
+has_rdoc: