fech 0.1.0

data/spec/sources/headers/6.1.csv

@@ -0,0 +1 @@
+F1,FORM TYPE,FILER COMMITTEE ID NUMBER,CHANGE OF COMMITTEE NAME,COMMITTEE NAME,CHANGE OF ADDRESS,STREET 1,STREET 2,CITY,STATE,ZIP,COMMITTEE EMAIL,COMMITTEE WEB URL,COMMITTEE FAX NUMBER,SUBMISSION DATE,SIGNATURE LAST NAME,SIGNATURE FIRST NAME,SIGNATURE MIDDLE NAME,SIGNATURE PREFIX,SIGNATURE SUFFIX,DATE SIGNED,5. COMMITTEE TYPE,5. CANDIDATE ID NUMBER,5. CANDIDATE LAST NAME,5. CANDIDATE FIRST NAME,5. CANDIDATE MIDDLE NAME,5. CANDIDATE PREFIX,5. CANDIDATE SUFFIX,5. CANDIDATE OFFICE ,5. CANDIDATE STATE,5. CANDIDATE DISTRICT,5. PARTY CODE,5. PARTY TYPE,7. CUSTODIAN LAST NAME,7. CUSTODIAN FIRST NAME,7. CUSTODIAN MIDDLE NAME,7. CUSTODIAN PREFIX,7. CUSTODIAN SUFFIX,7. CUSTODIAN STREET 1,7. CUSTODIAN STREET 2,7. CUSTODIAN CITY,7. CUSTODIAN STATE,7. CUSTODIAN ZIP,7. CUSTODIAN TITLE,7. CUSTODIAN TELEPHONE,8. TREASURER LAST NAME,8. TREASURER FIRST NAME,8. TREASURER MIDDLE NAME,8. TREASURER PREFIX,8. TREASURER SUFFIX,8. TREASURER STREET 1,8. TREASURER STREET 2,8. TREASURER CITY,8. TREASURER STATE,8. TREASURER ZIP,8. TREASURER TITLE,8. TREASURER TELEPHONE,6. AFFILIATED CMTTE ID NUM,6. AFFILIATED CMTTE NAME,6. AFFILIATED STREET 1,6. AFFILIATED STREET 2,6. AFFILIATED CITY,6. AFFILIATED STATE,6. AFFILIATED ZIP,"6. RELATIONSHIP (with Filing
    Committe named in field #4)",6. ORGANIZATION TYPE,8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. a) BANK NAME,9. a) BANK STREET 1,9. a) BANK STREET 2,9. a) BANK CITY,9. a) BANK STATE,9. a) BANK ZIP,9. b) BANK NAME,9. b) BANK STREET 1,9. b) BANK STREET 2,9. b) BANK CITY,9. b) BANK STATE,9. b) BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

data/spec/sources/headers/6.2.csv

@@ -0,0 +1 @@
+F1,FORM TYPE,FILER COMMITTEE ID NUMBER,CHANGE OF COMMITTEE NAME,COMMITTEE NAME,CHANGE OF ADDRESS,STREET 1,STREET 2,CITY,STATE,ZIP,COMMITTEE EMAIL,COMMITTEE WEB URL,COMMITTEE FAX NUMBER,SUBMISSION DATE,SIGNATURE LAST NAME,SIGNATURE FIRST NAME,SIGNATURE MIDDLE NAME,SIGNATURE PREFIX,SIGNATURE SUFFIX,DATE SIGNED,5. COMMITTEE TYPE,5. CANDIDATE ID NUMBER,5. CANDIDATE LAST NAME,5. CANDIDATE FIRST NAME,5. CANDIDATE MIDDLE NAME,5. CANDIDATE PREFIX,5. CANDIDATE SUFFIX,5. CANDIDATE OFFICE ,5. CANDIDATE STATE,5. CANDIDATE DISTRICT,5. PARTY CODE,5. PARTY TYPE,5 (e). ORGANIZATION TYPE,5 (f). LEADERSHIP PAC,6. AFFILIATED CMTTE ID NUM,6. AFFILIATED CMTTE NAME,6. AFFILIATED STREET 1,6. AFFILIATED STREET 2,6. AFFILIATED CITY,6. AFFILIATED STATE,6. AFFILIATED ZIP,6. AFFILIATED RELATIONSHIP CODE (with Filing Committe named in field #4),7. CUSTODIAN LAST NAME,7. CUSTODIAN FIRST NAME,7. CUSTODIAN MIDDLE NAME,7. CUSTODIAN PREFIX,7. CUSTODIAN SUFFIX,7. CUSTODIAN STREET 1,7. CUSTODIAN STREET 2,7. CUSTODIAN CITY,7. CUSTODIAN STATE,7. CUSTODIAN ZIP,7. CUSTODIAN TITLE,7. CUSTODIAN TELEPHONE,8. TREASURER LAST NAME,8. TREASURER FIRST NAME,8. TREASURER MIDDLE NAME,8. TREASURER PREFIX,8. TREASURER SUFFIX,8. TREASURER STREET 1,8. TREASURER STREET 2,8. TREASURER CITY,8. TREASURER STATE,6. RELATIONSHIP (with Filing Committe named in field #4),8. TREASURER ZIP,6. ORGANIZATION TYPE,8. TREASURER TITLE,8. TREASURER TELEPHONE,8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. a) BANK NAME,9. a) BANK STREET 1,9. a) BANK STREET 2,9. a) BANK CITY,9. a) BANK STATE,9. a) BANK ZIP,9. b) BANK NAME,9. b) BANK STREET 1,9. b) BANK STREET 2,9. b) BANK CITY,9. b) BANK STATE,9. b) BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

data/spec/sources/headers/6.3.csv

@@ -0,0 +1 @@
+F1,FORM TYPE,FILER COMMITTEE ID NUMBER,CHANGE OF COMMITTEE NAME,COMMITTEE NAME,CHANGE OF ADDRESS,STREET 1,STREET 2,CITY,STATE,ZIP,CHANGE OF COMMITTEE EMAIL,COMMITTEE EMAIL,CHANGE OF COMMITTEE WEB URL,COMMITTEE FAX NUMBER,COMMITTEE WEB URL,SUBMISSION DATE,SIGNATURE LAST NAME,SIGNATURE FIRST NAME,SIGNATURE MIDDLE NAME,SIGNATURE PREFIX,SIGNATURE SUFFIX,DATE SIGNED,5. COMMITTEE TYPE,5. CANDIDATE ID NUMBER,5. CANDIDATE LAST NAME,5. CANDIDATE FIRST NAME,5. CANDIDATE MIDDLE NAME,5. CANDIDATE PREFIX,5. CANDIDATE SUFFIX,5. CANDIDATE OFFICE ,5. CANDIDATE STATE,5. CANDIDATE DISTRICT,5. PARTY CODE,5. PARTY TYPE,5 (e). ORGANIZATION TYPE,5 (e). LOBBYIST/REGISTRANT PAC ,5 (f). LOBBYIST/REGISTRANT PAC ,5 (f). LEADERSHIP PAC,6. AFFILIATED CMTTE ID NUM,6. AFFILIATED CMTTE NAME,6. AFFILIATED CANDIDATE ID NUM,6. AFFILIATED LAST NAME,6. AFFILIATED FIRST NAME,6. AFFILIATED MIDDLE NAME,6. AFFILIATED PREFIX,6. AFFILIATED SUFFIX,6. AFFILIATED STREET 1,6. AFFILIATED STREET 2,6. AFFILIATED CITY,6. AFFILIATED STATE,6. AFFILIATED ZIP,"6. AFFILIATED RELATIONSHIP CODE
  (with Filing Committe named in field #4)",7. CUSTODIAN LAST NAME,7. CUSTODIAN FIRST NAME,7. CUSTODIAN MIDDLE NAME,7. CUSTODIAN PREFIX,7. CUSTODIAN SUFFIX,7. CUSTODIAN STREET 1,7. CUSTODIAN STREET 2,7. CUSTODIAN CITY,7. CUSTODIAN STATE,7. CUSTODIAN ZIP,7. CUSTODIAN TITLE,7. CUSTODIAN TELEPHONE,8. TREASURER LAST NAME,8. TREASURER FIRST NAME,8. TREASURER MIDDLE NAME,8. TREASURER PREFIX,8. TREASURER SUFFIX,8. TREASURER STREET 1,8. TREASURER STREET 2,8. TREASURER CITY,8. TREASURER STATE,8. TREASURER ZIP,8. TREASURER TITLE,8. TREASURER TELEPHONE,8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. a) BANK NAME,9. a) BANK STREET 1,9. a) BANK STREET 2,9. a) BANK CITY,9. a) BANK STATE,9. a) BANK ZIP,9. b) BANK NAME,9. b) BANK STREET 1,9. b) BANK STREET 2,9. b) BANK CITY,9. b) BANK STATE,9. b) BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  (with Filing Committe named in field #4)",8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. BANK NAME,9. BANK STREET 1,9. BANK STREET 2,9. BANK CITY,9. BANK STATE,9. BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

data/spec/sources/headers/6.4.csv

@@ -0,0 +1 @@
+F1,FORM TYPE,FILER COMMITTEE ID NUMBER,CHANGE OF COMMITTEE NAME,COMMITTEE NAME,CHANGE OF ADDRESS,STREET 1,STREET 2,CITY,STATE,ZIP,CHANGE OF COMMITTEE EMAIL,COMMITTEE EMAIL,CHANGE OF COMMITTEE WEB URL,COMMITTEE FAX NUMBER,COMMITTEE WEB URL,SUBMISSION DATE,SIGNATURE LAST NAME,SIGNATURE FIRST NAME,SIGNATURE MIDDLE NAME,SIGNATURE PREFIX,SIGNATURE SUFFIX,DATE SIGNED,5. COMMITTEE TYPE,5. CANDIDATE ID NUMBER,5. CANDIDATE LAST NAME,5. CANDIDATE FIRST NAME,5. CANDIDATE MIDDLE NAME,5. CANDIDATE PREFIX,5. CANDIDATE SUFFIX,5. CANDIDATE OFFICE ,5. CANDIDATE STATE,5. CANDIDATE DISTRICT,5. PARTY CODE,5. PARTY TYPE,5 (e). ORGANIZATION TYPE,5 (e). LOBBYIST/REGISTRANT PAC ,5 (f). LOBBYIST/REGISTRANT PAC ,5 (f). LEADERSHIP PAC,6. AFFILIATED CMTTE ID NUM,6. AFFILIATED CMTTE NAME,6. AFFILIATED CANDIDATE ID NUM,6. AFFILIATED LAST NAME,6. AFFILIATED FIRST NAME,6. AFFILIATED MIDDLE NAME,6. AFFILIATED PREFIX,6. AFFILIATED SUFFIX,6. AFFILIATED STREET 1,6. AFFILIATED STREET 2,6. AFFILIATED CITY,6. AFFILIATED STATE,6. AFFILIATED ZIP,"6. AFFILIATED RELATIONSHIP CODE
  (with Filing Committe named in field #4)",7. CUSTODIAN LAST NAME,7. CUSTODIAN FIRST NAME,7. CUSTODIAN MIDDLE NAME,7. CUSTODIAN PREFIX,7. CUSTODIAN SUFFIX,7. CUSTODIAN STREET 1,7. CUSTODIAN STREET 2,7. CUSTODIAN CITY,7. CUSTODIAN STATE,7. CUSTODIAN ZIP,7. CUSTODIAN TITLE,7. CUSTODIAN TELEPHONE,8. TREASURER LAST NAME,8. TREASURER FIRST NAME,8. TREASURER MIDDLE NAME,8. TREASURER PREFIX,8. TREASURER SUFFIX,8. TREASURER STREET 1,8. TREASURER STREET 2,8. TREASURER CITY,8. TREASURER STATE,8. TREASURER ZIP,8. TREASURER TITLE,8. TREASURER TELEPHONE,8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. a) BANK NAME,9. a) BANK STREET 1,9. a) BANK STREET 2,9. a) BANK CITY,9. a) BANK STATE,9. a) BANK ZIP,9. b) BANK NAME,9. b) BANK STREET 1,9. b) BANK STREET 2,9. b) BANK CITY,9. b) BANK STATE,9. b) BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  (with Filing Committe named in field #4)",8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. BANK NAME,9. BANK STREET 1,9. BANK STREET 2,9. BANK CITY,9. BANK STATE,9. BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

data/spec/sources/headers/7.0.csv

@@ -0,0 +1 @@
+F1,FORM TYPE,FILER COMMITTEE ID NUMBER,CHANGE OF COMMITTEE NAME,COMMITTEE NAME,CHANGE OF ADDRESS,STREET 1,STREET 2,CITY,STATE,ZIP,CHANGE OF COMMITTEE EMAIL,COMMITTEE EMAIL,CHANGE OF COMMITTEE WEB URL,COMMITTEE WEB URL,EFFECTIVE DATE,SIGNATURE LAST NAME,SIGNATURE FIRST NAME,SIGNATURE MIDDLE NAME,SIGNATURE PREFIX,SIGNATURE SUFFIX,DATE SIGNED,5. COMMITTEE TYPE,5. CANDIDATE ID NUMBER,5. CANDIDATE LAST NAME,5. CANDIDATE FIRST NAME,5. CANDIDATE MIDDLE NAME,5. CANDIDATE PREFIX,5. CANDIDATE SUFFIX,5. CANDIDATE OFFICE ,5. CANDIDATE STATE,5. CANDIDATE DISTRICT,5. PARTY CODE,5. PARTY TYPE,5 (e). ORGANIZATION TYPE,5 (e). LOBBYIST/REGISTRANT PAC ,5 (f). LOBBYIST/REGISTRANT PAC ,5 (f). LEADERSHIP PAC,6. AFFILIATED CMTTE ID NUM,6. AFFILIATED CMTTE NAME,6. AFFILIATED CANDIDATE ID NUM,6. AFFILIATED LAST NAME,6. AFFILIATED FIRST NAME,6. AFFILIATED MIDDLE NAME,6. AFFILIATED PREFIX,6. AFFILIATED SUFFIX,6. AFFILIATED STREET 1,6. AFFILIATED STREET 2,6. AFFILIATED CITY,6. AFFILIATED STATE,6. AFFILIATED ZIP,"6. AFFILIATED RELATIONSHIP CODE
  (with Filing Committee named in field #4)",7. CUSTODIAN LAST NAME,7. CUSTODIAN FIRST NAME,7. CUSTODIAN MIDDLE NAME,7. CUSTODIAN PREFIX,7. CUSTODIAN SUFFIX,7. CUSTODIAN STREET 1,7. CUSTODIAN STREET 2,7. CUSTODIAN CITY,7. CUSTODIAN STATE,7. CUSTODIAN ZIP,7. CUSTODIAN TITLE,7. CUSTODIAN TELEPHONE,8. TREASURER LAST NAME,8. TREASURER FIRST NAME,8. TREASURER MIDDLE NAME,8. TREASURER PREFIX,8. TREASURER SUFFIX,8. TREASURER STREET 1,8. TREASURER STREET 2,8. TREASURER CITY,8. TREASURER STATE,8. TREASURER ZIP,8. TREASURER TITLE,8. TREASURER TELEPHONE,8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. a) BANK NAME,9. a) BANK STREET 1,9. a) BANK STREET 2,9. a) BANK CITY,9. a) BANK STATE,9. a) BANK ZIP,9. b) BANK NAME,9. b) BANK STREET 1,9. b) BANK STREET 2,9. b) BANK CITY,9. b) BANK STATE,9. b) BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  (with Filing Committee named in field #4)",8. AGENT LAST NAME,8. AGENT FIRST NAME,8. AGENT MIDDLE NAME,8. AGENT PREFIX,8. AGENT SUFFIX,8. AGENT STREET 1,8. AGENT STREET 2,8. AGENT CITY,8. AGENT STATE,8. AGENT ZIP,8. AGENT TITLE,8. AGENT TELEPHONE,9. BANK NAME,9. BANK STREET 1,9. BANK STREET 2,9. BANK CITY,9. BANK STATE,9. BANK ZIP,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

data/spec/sources/headers/ignore.csv

@@ -0,0 +1,5 @@
+COLUMN A REPORT TOTALS
+COLUMN B YEAR-TO-DATE TOTALS
+COLUMN B YTD TOTALS - LEVIN ACTIVITY
+(New line 30 fields added to end of this layout)
+(New line 18(b) & 18(c) fields at end of layout)

data/spec/sources/sa.csv

@@ -0,0 +1 @@
+canonical,^7,,^6,,^[2-5],,

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'rspec'
+require 'fech'
+
+RSpec.configure do |config|
+  config.mock_framework = :mocha
+end

data/spec/translator_spec.rb

@@ -0,0 +1,195 @@
+require 'spec_helper'
+
+describe Fech::Translator do
+  
+  describe "#add_translation" do
+    
+    before do
+      @translator = Fech::Translator.new
+    end
+
+    it "should ignore case when specified options are regular expressions" do
+      @translator.convert(:row => /^foo/, :field => 'bar') {}
+      @translator.get_translations(:row => "FoO", :field => 'bar', :action => :convert).size.should == 1
+    end
+    
+  end
+    
+  describe ".convert" do
+    
+    before do
+      @translator = Fech::Translator.new
+    end
+    
+    it "should add a new translation to instance's list" do
+      lambda {
+        @translator.convert(:row => 'foo', :field => 'bar') {}
+      }.should change{@translator.translations.count}.by(1)
+    end
+    
+    it "should save a given block as part of the translation" do
+      lambda {
+        @translator.convert(:row => 'foo', :field => 'bar') {|v| Date.parse(v)}
+      }.should_not raise_error
+      @translator.translations.first[:proc].should_not be_nil
+    end
+    
+    it "should raise error if no block is given" do
+      lambda {
+        @translator.convert(:row => 'foo', :field => 'bar')
+      }.should raise_error
+    end
+    
+    it "should not fail if not passed any limiting parameters" do
+      lambda {
+        @translator.convert {}
+      }.should_not raise_error
+    end
+    
+    it "should set defaults for unspecified parameters" do
+      @translator.convert {}
+      t = @translator.translations.last
+      t[:row].should == /.*/i
+      t[:field].should == /.*/i
+      t[:version].should == /.*/i
+    end
+    
+    it "should return the translation hash" do
+      ret = @translator.convert {}
+      ret.class.should == Hash
+      ret.keys.should =~ [:row, :field, :version, :proc, :action]
+    end
+    
+  end
+  
+  describe ".combine" do
+    
+    before do
+      @filing = Fech::Filing.new(723604)
+      @filing.stubs(:file_path).returns(File.join(File.dirname(__FILE__), 'data', '723604.fec'))
+    end
+    
+    it "should correctly compute derived fields" do
+      @filing.translator.combine(:row => /F3PN/, :field => :combined) do |row|
+        Date.parse(row[:coverage_through_date]) - Date.parse(row[:coverage_from_date])
+      end
+      original = Date.parse(@filing.summary.coverage_through_date) - Date.parse(@filing.summary.coverage_from_date)
+      @filing.summary.combined.should == original
+    end
+    
+    it "should allow indexing by original field name" do
+      @filing.translator.combine(:row => /F3PN/, :field => :combined) do |row|
+        Date.parse(row[:coverage_through_date]) - Date.parse(row[:coverage_from_date])
+      end
+      lambda {
+        @filing.summary.coverage_through_date
+      }.should_not raise_error
+    end
+    
+    it "should allow indexing by aliased field names" do
+      @filing.translate do |t|
+        t.alias :alias_a, :coverage_from_date, /F3PN/
+        t.alias :alias_b, :coverage_through_date, /F3PN/
+        t.combine(:row => /F3PN/, :field => :combined) do |row|
+          Date.parse(row[:alias_b]) - Date.parse(row[:alias_a])
+        end
+      end
+      lambda {
+        @filing.summary
+      }.should_not raise_error
+    end
+
+  end
+  
+  describe ".alias" do
+    
+    before do
+      @translator = Fech::Translator.new
+    end
+    
+    it "should add the given alias to @aliases" do
+      @translator.alias(:new_name, :old_name, /hdr/)
+      @translator.aliases.should =~ [{:row => /hdr/i, :alias => :new_name, :for => :old_name}]
+    end
+    
+    it "should not require :row" do
+      lambda {
+        @translator.alias(:new_name, :old_name)
+      }.should_not raise_error
+      @translator.aliases.should =~ [{:row => /.*/i, :alias => :new_name, :for => :old_name}]
+    end
+    
+  end
+  
+  describe ".applicable_translation?" do
+    
+    before do
+      @row_type = "SA18"
+      @field = "date_coverage_from"
+      @translation = Fech::Translator.new.convert(:row => "SA", :field => @field, :version => "7.0") {|v| Date.parse(v)}
+    end
+    
+    it "should return true if row and field are matches for the translation's regexes" do
+      Fech::Translator.applicable_translation?(@translation, :row => @row_type, :field => @field).should == true
+    end
+    
+    it "should return false if row, field, or version does not match" do
+      Fech::Translator.applicable_translation?(@translation, :row => @row_type, :field => @field, :version => "6.0").should == false
+    end
+    
+    it "should accept non-string values" do
+      lambda {
+        Fech::Translator.applicable_translation?(@translation, :row => Regexp.new(@row_type), :field => @field.to_s)
+      }.should_not raise_error
+    end
+    
+    it "should accept match parameters as a single opts hash" do
+      lambda {
+        Fech::Translator.applicable_translation?(@translation, {:row => Regexp.new(@row_type), :field => @field.to_s})
+      }.should_not raise_error
+      Fech::Translator.applicable_translation?(@translation, {:row => Regexp.new(@row_type), :field => @field.to_s}).should == true
+    end
+    
+  end
+  
+  describe ".get_translations" do
+    
+    before do
+      @translator = Fech::Translator.new
+      @translator.convert(:row => "sa", :field => :date_coverage_from) {|v| Date.parse(v)}
+      @translator.convert(:row => "sa", :field => :date_coverage_to) {|v| Date.parse(v)}
+      @translator.convert(:row => "sb", :field => /date.*/) {|v| Date.parse(v)}
+    end
+    
+    it "should return only translations that match the parameters" do
+      @translator.get_translations(:row => "sa").size.should == 2
+      @translator.get_translations(:row => "sb").size.should == 1
+    end
+    
+    it "should memoize output" do
+      Fech::Translator.expects(:applicable_translation?).times(3).returns(true)
+      @translator.get_translations(:row => "sa")
+      @translator.get_translations(:row => "sa")
+    end
+    
+    it "should only memoize based on unique key" do
+      Fech::Translator.expects(:applicable_translation?).times(6).returns(true)
+      @translator.get_translations(:row => "sa")
+      @translator.get_translations(:row => "sb")
+    end
+    
+  end
+  
+  describe "#add_default_translations" do
+    
+    before do
+      @translator = Fech::Translator.new(:include => [:names])
+    end
+    
+    it "should add all specified translations by default" do
+      @translator.translations.size.should > 0
+    end
+    
+  end
+  
+end

data/tasks/fech.rake

@@ -0,0 +1,41 @@
+require 'fech'
+require 'rspec'
+require 'rspec/core/rake_task'
+
+namespace :fech do
+  
+  desc "Recreate the column header maps from source .csv files"
+  task :maps do
+    # This will spit out a rendered mappings file, but will not be loaded by
+    # the gem by default. To use the new file, move it into the lib/fech
+    # folder of your active Fech gem.
+    source = 'sources/'
+    destination = ENV['destination'] || Dir.pwd
+    
+    if File.directory?(destination)
+      destination = File.join(destination, 'rendered_maps.rb')
+    end
+    
+    Fech::MapGenerator.convert_header_file_to_row_files(source)
+    Fech::MapGenerator.dump_row_maps_to_ruby(source, destination)
+    
+    puts "Successfully wrote out mappings to #{destination}"
+  end
+  
+  namespace :test do
+    
+    desc "Run all specs."
+    RSpec::Core::RakeTask.new(:spec) do |t|
+      t.pattern = 'spec/*_spec.rb'
+      t.verbose = false
+    end
+    
+    RSpec::Core::RakeTask.new(:coverage) do |t|
+      t.rcov = true
+      t.rcov_opts =  %w{--exclude gems\/,spec\/,features\/,seeds\/ --sort coverage}
+      t.verbose = true
+    end
+    
+  end
+  
+end

metadata

@@ -0,0 +1,280 @@
+--- !ruby/object:Gem::Specification 
+name: fech
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Michael Strickland
+- Evan Carmi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-29 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: fastercsv
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: people
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 21
+        segments: 
+        - 0
+        - 2
+        - 1
+        version: 0.2.1
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 2
+        - 6
+        version: "2.6"
+  type: :development
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: mocha
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: autotest
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: rcov
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: rdoc
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id010
+description: A Ruby library for interacting with electronic filings from the Federal Election Commission.
+email: 
+- michael.c.strickland@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.rdoc
+- Rakefile
+- autotest/discover.rb
+- fech.gemspec
+- lib/fech.rb
+- lib/fech/default_translations.rb
+- lib/fech/fech_utils.rb
+- lib/fech/filing.rb
+- lib/fech/map_generator.rb
+- lib/fech/mapped.rb
+- lib/fech/mappings.rb
+- lib/fech/translator.rb
+- lib/fech/version.rb
+- sources/F3P.csv
+- sources/F3P31.csv
+- sources/F3PS.csv
+- sources/F3S.csv
+- sources/HDR.csv
+- sources/SchA.csv
+- sources/SchB.csv
+- sources/SchC.csv
+- sources/SchC1.csv
+- sources/SchC2.csv
+- sources/SchD.csv
+- sources/SchE.csv
+- sources/SchF.csv
+- sources/TEXT.csv
+- sources/headers/3.csv
+- sources/headers/5.0.csv
+- sources/headers/5.1.csv
+- sources/headers/5.2.csv
+- sources/headers/5.3.csv
+- sources/headers/6.1.csv
+- sources/headers/6.2.csv
+- sources/headers/6.3.csv
+- sources/headers/6.4.csv
+- sources/headers/7.0.csv
+- sources/headers/ignore.csv
+- spec/data/723604.fec
+- spec/data/97405.fec
+- spec/default_translations_spec.rb
+- spec/fech_utils_spec.rb
+- spec/filing_spec.rb
+- spec/map_generator_spec.rb
+- spec/mapped_spec.rb
+- spec/mappings_spec.rb
+- spec/sources/F3P.csv
+- spec/sources/SchA.csv
+- spec/sources/SchB.csv
+- spec/sources/SchC.csv
+- spec/sources/headers/3.csv
+- spec/sources/headers/5.0.csv
+- spec/sources/headers/5.1.csv
+- spec/sources/headers/5.2.csv
+- spec/sources/headers/5.3.csv
+- spec/sources/headers/6.1.csv
+- spec/sources/headers/6.2.csv
+- spec/sources/headers/6.3.csv
+- spec/sources/headers/6.4.csv
+- spec/sources/headers/7.0.csv
+- spec/sources/headers/ignore.csv
+- spec/sources/sa.csv
+- spec/spec_helper.rb
+- spec/translator_spec.rb
+- tasks/fech.rake
+has_rdoc: true
+homepage: http://github.com/nytimes/fech
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: fech
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Ruby library for parsing FEC filings.
+test_files: []
+