ssn_validator 1.0.4

data/lib/ssn_validator/models/ssn_high_group_code.rb

@@ -0,0 +1,5 @@
+require 'activerecord'
+
+class SsnHighGroupCode < ActiveRecord::Base
+
+end

data/lib/ssn_validator/models/ssn_high_group_code_loader.rb

@@ -0,0 +1,87 @@
+
+require 'net/http'
+class SsnHighGroupCodeLoader
+  def self.load_all_high_group_codes_files
+    months = ['Jan','Feb','Mar','Apr','May','June','July','Aug','Sept','Oct','Nov','Dec']
+    run_file_date = SsnHighGroupCode.maximum(:as_of)
+    run_file_date = run_file_date ? run_file_date.next_month.beginning_of_month : Date.new(2003,11,01)
+    last_file_date = Date.today.beginning_of_month
+    while run_file_date <= last_file_date
+      file_processed = false
+      run_file_month = months[run_file_date.month - 1]
+      run_file_year =  run_file_date.year
+      ['','corrected'].each do |mod|
+        break if file_processed
+        ['ssns','ssnvs'].each do |url_mod|
+          break if file_processed
+          (1..Date.today.day).each do |day|
+            string_day = day.to_s
+            string_day.insert(0,'0') if day < 10
+            string_year = run_file_year.to_s.last(2)
+            file_name = "HG#{run_file_month}#{string_day}#{string_year}#{mod}.txt"
+            text = Net::HTTP.get(URI.parse("http://www.socialsecurity.gov/employer/#{url_mod}/#{file_name}"))
+            unless text.include? 'File Not Found'
+              create_records(parse_text(text),extract_as_of_date(text))
+              run_file_date = run_file_date.next_month
+              file_processed = true
+              break
+            end
+          end
+        end
+      end
+    end
+  end
+
+  #Loads the most recent file from http://www.socialsecurity.gov/employer/ssns/highgroup.txt
+  def self.load_current_high_group_codes_file
+    text = Net::HTTP.get(URI.parse('http://www.socialsecurity.gov/employer/ssns/highgroup.txt'))
+    create_records(parse_text(text),extract_as_of_date(text))
+  end
+
+
+  private
+
+  def self.already_loaded?(file_as_of_date)
+    SsnHighGroupCode.find_by_as_of(file_as_of_date)
+  end
+
+  def self.create_records(area_groups,file_as_of)
+    if already_loaded?(file_as_of)
+      puts "File as of #{file_as_of} has already been loaded."
+    else
+      area_groups.each do |area_group|
+        SsnHighGroupCode.create(area_group.merge!(:as_of => file_as_of.to_s(:db)))
+      end
+      puts "File as of #{file_as_of} loaded."
+    end
+  end
+
+  #extract the date from the file in the format mm/dd/yy
+  def self.extract_as_of_date(text)
+    as_of_start_index = text =~ /\d\d\/\d\d\/\d\d/
+    Date.strptime($&,'%m/%d/%y') unless as_of_start_index.nil?
+  end
+
+  #The formatting of the file is a little bit messy. Sometimes tabs are
+  #used as delimiters and sometimes spaces are used as delimiters. Also, the asterisks indicating recent changes are not
+  #necessary for our purposes
+  #Returns an array of hashes.
+  def self.parse_text(text)
+    text.gsub!('*',' ')
+    text.gsub!(/\t/, ' ')
+    text_array = text.split(/\n/).compact
+    area_groups = []
+    text_array.each do |t|
+      t.gsub!(/\s+/,' ')
+      next if t =~ /[[:alpha:]]/ #skip over the header lines
+
+      if t =~ /\d\d\d \d\d/ #we want the lines with area group pairs
+        t.gsub(/\d\d\d \d\d/) do |s|
+          area_group = s.split(' ')
+          area_groups << {:area => area_group.first, :group => area_group.last}
+        end
+      end
+    end
+    return area_groups
+  end
+end

data/lib/ssn_validator/models/ssn_validator.rb

@@ -0,0 +1,94 @@
+module SsnValidator
+  class Ssn
+
+    attr_reader :ssn,:area,:group,:serial_number,:as_of
+    attr_reader :errors
+
+
+    #Instantiate the object passing in a social security number.
+    #The ssn can be a string or integer, with or without the '-'s.
+    def initialize(ssn)
+      @errors = []
+      ssn = ssn.to_s
+      if ssn =~ /-/ && ssn !~ /\d\d\d-\d\d-\d\d\d\d/
+        @errors << 'Hyphen misplaced.'
+      end
+
+      ssn.gsub!('-','')
+      if ssn.to_s.size != 9
+        @errors <<  'SSN not 9 digits long.'
+      end
+
+      if ssn =~ /\D/
+        @errors << 'Non-digit found.'
+      end
+
+      #known dummy numbers
+      if ["078051120","111111111","123456789","219099999","999999999"].include? ssn || (ssn >= "987654320" and ssn <= "987654329")
+        @errors << "Known dummy SSN."
+      end
+      #known invalid area, group and serial numbers
+      if ssn =~ /\d{3}00\d{4}|0000\Z/
+        @errors << "Invalid group or serial number."
+      end
+
+      @ssn = ssn
+      @area = ssn.first(3)
+      @group = ssn[3,2]
+      @serial_number = ssn.last(4)
+
+      if @errors.empty?
+        @ssn_high_group_code = SsnHighGroupCode.find_by_area(@area, :order => 'as_of desc')
+        if @ssn_high_group_code.nil?
+          @errors << "Area '#{@area}' has not been assigned."
+        else
+          @as_of = @ssn_high_group_code.as_of
+
+          define_group_ranks
+          
+          if @group_ranks[@group] > @group_ranks[@ssn_high_group_code.group]
+            @errors << "Group '#{@group}' has not been assigned yet for area '#{@area}'"
+          end
+        end
+      end
+
+
+    end
+
+    #Determines whether or not the passed in
+    #ssn passed all validations.
+    def valid?
+      @errors.empty?
+    end
+
+    #returns the death master record if there is one.
+    def death_master_file_record
+      DeathMasterFile.find_by_social_security_number(@ssn)
+    end
+
+    #Determines if the passed in ssn belongs to the deceased.
+    def death_master_file_hit?
+      !death_master_file_record.nil?
+    end
+
+
+    private
+
+    def define_group_ranks
+      @group_ranks = {}
+      rank = 0
+      (1..9).step(2) do |group|
+        @group_ranks.merge!("0#{group.to_s}" => rank += 1)
+      end
+      (10..98).step(2) do |group|
+        @group_ranks.merge!(group.to_s => rank += 1)
+      end
+      (2..8).step(2) do |group|
+        @group_ranks.merge!("0#{group.to_s}" => rank += 1)
+      end
+      (11..99).step(2) do |group|
+        @group_ranks.merge!(group.to_s => rank += 1)
+      end
+    end
+  end
+end

data/lib/ssn_validator/ntis.rb

@@ -0,0 +1,9 @@
+module SsnValidator
+  class Ntis
+    @@user_name = 'REPLACE WITH YOUR dmf.ntis.gov USER NAME'
+    cattr_accessor :user_name
+    
+    @@password = 'REPLACE WITH YOUR dmf.ntis.gov PASSWORD'
+    cattr_accessor :password
+  end
+end

data/lib/tasks/ssn_validator.rake

@@ -0,0 +1,24 @@
+
+namespace :ssn_validator do
+  desc "Loads the current file from http://www.socialsecurity.gov/employer/ssns/highgroup.txt if it hasn't already been loaded."
+  task :update_data => :environment do
+    SsnHighGroupCodeLoader.load_all_high_group_codes_files
+  end
+
+  namespace :death_master_file do
+    desc "Loads a death master file.  Specify the path of the file: PATH=path.  Specify the date of the data: AS_OF=YYYY-MM-DD.  Optimized for Mysql databases."
+    task :load_file => :environment do
+      if ENV["PATH"] && ENV["AS_OF"]
+        DeathMasterFileLoader.new(ENV["PATH"],ENV["AS_OF"]).load_file
+      else
+        puts "You must specify the PATH and AS_OF variables:  rake ssn_validator:death_master_file:load_file PATH='path/to/file' AS_OF='2009-03-01'"
+      end
+    end
+
+    desc "Determines the most recent file that has been loaded, and loads all subsequent files in order from the dmf.ntis.gov website.  Optimized for Mysql databases."
+    task :update_data => :environment do
+      DeathMasterFileLoader.load_update_files_from_web
+    end
+  end
+
+end

data/rdoc/classes/DeathMasterFile.html

@@ -0,0 +1,111 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: DeathMasterFile</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">DeathMasterFile</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/ssn_validator/models/death_master_file_rb.html">
+                lib/ssn_validator/models/death_master_file.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                ActiveRecord::Base
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>

data/rdoc/classes/DeathMasterFileLoader.html

@@ -0,0 +1,298 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: DeathMasterFileLoader</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">DeathMasterFileLoader</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/ssn_validator/models/death_master_file_loader_rb.html">
+                lib/ssn_validator/models/death_master_file_loader.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000006">get_file_from_web</a>&nbsp;&nbsp;
+      <a href="#M000005">load_file</a>&nbsp;&nbsp;
+      <a href="#M000007">load_update_files_from_web</a>&nbsp;&nbsp;
+      <a href="#M000003">new</a>&nbsp;&nbsp;
+      <a href="#M000004">valid?</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000007" class="method-detail">
+        <a name="M000007"></a>
+
+        <div class="method-heading">
+          <a href="#M000007" class="method-signature">
+          <span class="method-name">load_update_files_from_web</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Loads all the update files from dmf.ntis.gov. It starts with the last file
+loaded, and loads each missing file in sequence up to the current file.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000007-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000007-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/ssn_validator/models/death_master_file_loader.rb, line 67</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">load_update_files_from_web</span>
+    <span class="ruby-identifier">max_as_of</span> = <span class="ruby-constant">DeathMasterFile</span>.<span class="ruby-identifier">maximum</span>(<span class="ruby-identifier">:as_of</span>)
+    <span class="ruby-identifier">run_file_date</span> = <span class="ruby-identifier">max_as_of</span>.<span class="ruby-identifier">beginning_of_month</span>.<span class="ruby-identifier">next_month</span>
+    <span class="ruby-identifier">last_file_date</span> = <span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>.<span class="ruby-identifier">beginning_of_month</span>
+    <span class="ruby-keyword kw">while</span> <span class="ruby-identifier">run_file_date</span> <span class="ruby-operator">&lt;=</span> <span class="ruby-identifier">last_file_date</span>
+      <span class="ruby-identifier">url</span> = <span class="ruby-node">&quot;https://dmf.ntis.gov/dmldata/monthly/MA#{run_file_date.strftime(&quot;%y%m%d&quot;)}&quot;</span>
+      <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Loading file #{url}&quot;</span>
+      <span class="ruby-constant">DeathMasterFileLoader</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">url</span>,<span class="ruby-identifier">run_file_date</span>.<span class="ruby-identifier">strftime</span>(<span class="ruby-value str">&quot;%Y-%m-%d&quot;</span>)).<span class="ruby-identifier">load_file</span>
+      <span class="ruby-identifier">run_file_date</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>.<span class="ruby-identifier">month</span>
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000003" class="method-detail">
+        <a name="M000003"></a>
+
+        <div class="method-heading">
+          <a href="#M000003" class="method-signature">
+          <span class="method-name">new</span><span class="method-args">(path_or_url,file_as_of)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+path_or_url is the full path to the file to load on disk, or the url of an
+update file. as_of is a string in the formatt YYYY-MM-DD for which the file
+data is accurate.
+</p>
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000003-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000003-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/ssn_validator/models/death_master_file_loader.rb, line 11</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">path_or_url</span>,<span class="ruby-identifier">file_as_of</span>)
+    <span class="ruby-ivar">@file_path_or_url</span> = <span class="ruby-identifier">path_or_url</span>
+    <span class="ruby-ivar">@file_as_of</span> = <span class="ruby-identifier">file_as_of</span>
+    <span class="ruby-identifier">valid?</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000006" class="method-detail">
+        <a name="M000006"></a>
+
+        <div class="method-heading">
+          <a href="#M000006" class="method-signature">
+          <span class="method-name">get_file_from_web</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000006-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000006-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/ssn_validator/models/death_master_file_loader.rb, line 46</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">get_file_from_web</span>
+    <span class="ruby-identifier">uri</span> = <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-ivar">@file_path_or_url</span>)
+
+    <span class="ruby-identifier">request</span> = <span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP</span><span class="ruby-operator">::</span><span class="ruby-constant">Get</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">request_uri</span>)
+    <span class="ruby-identifier">request</span>.<span class="ruby-identifier">basic_auth</span>(<span class="ruby-constant">SsnValidator</span><span class="ruby-operator">::</span><span class="ruby-constant">Ntis</span>.<span class="ruby-identifier">user_name</span>,<span class="ruby-constant">SsnValidator</span><span class="ruby-operator">::</span><span class="ruby-constant">Ntis</span>.<span class="ruby-identifier">password</span>)
+
+    <span class="ruby-identifier">http</span> = <span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">host</span>, <span class="ruby-identifier">uri</span>.<span class="ruby-identifier">port</span>)
+    <span class="ruby-identifier">http</span>.<span class="ruby-identifier">use_ssl</span> = (<span class="ruby-identifier">uri</span>.<span class="ruby-identifier">port</span> <span class="ruby-operator">==</span> <span class="ruby-value">443</span>)
+    <span class="ruby-identifier">http</span>.<span class="ruby-identifier">verify_mode</span> = <span class="ruby-constant">OpenSSL</span><span class="ruby-operator">::</span><span class="ruby-constant">SSL</span><span class="ruby-operator">::</span><span class="ruby-constant">VERIFY_NONE</span>
+
+    <span class="ruby-identifier">response</span> = <span class="ruby-identifier">http</span>.<span class="ruby-identifier">request</span>(<span class="ruby-identifier">request</span>)
+
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;Invalid URL: #{@file_path_or_url}&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTPNotFound</span>)
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;Authorization Required: Invalid username or password.  Set the variables SsnValidator::Ntis.user_name and SsnValidator::Ntis.password in your environment.rb file.&quot;</span>) <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">Net</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTPUnauthorized</span>)
+
+    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">response</span>.<span class="ruby-identifier">body</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000005" class="method-detail">
+        <a name="M000005"></a>
+
+        <div class="method-heading">
+          <a href="#M000005" class="method-signature">
+          <span class="method-name">load_file</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000005-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000005-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/ssn_validator/models/death_master_file_loader.rb, line 32</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">load_file</span>
+
+    <span class="ruby-keyword kw">if</span> <span class="ruby-constant">DeathMasterFile</span>.<span class="ruby-identifier">connection</span>.<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">ActiveRecord</span><span class="ruby-operator">::</span><span class="ruby-constant">ConnectionAdapters</span><span class="ruby-operator">::</span><span class="ruby-constant">MysqlAdapter</span>)
+      <span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;Converting file to csv format for Mysql import.  This could take several minutes.&quot;</span>
+
+      <span class="ruby-identifier">csv_file</span> = <span class="ruby-identifier">convert_file_to_csv</span>
+
+      <span class="ruby-identifier">bulk_mysql_update</span>(<span class="ruby-identifier">csv_file</span>)
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">active_record_file_load</span>
+    <span class="ruby-keyword kw">end</span>
+
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+      <div id="method-M000004" class="method-detail">
+        <a name="M000004"></a>
+
+        <div class="method-heading">
+          <a href="#M000004" class="method-signature">
+          <span class="method-name">valid?</span><span class="method-args">()</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000004-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000004-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/ssn_validator/models/death_master_file_loader.rb, line 17</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">valid?</span>
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;path_or_url not specified&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@file_path_or_url</span>
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-value str">&quot;as_of not specified&quot;</span>) <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@file_as_of</span>
+    <span class="ruby-identifier">max_as_of</span> = <span class="ruby-constant">DeathMasterFile</span>.<span class="ruby-identifier">maximum</span>(<span class="ruby-identifier">:as_of</span>)
+    <span class="ruby-identifier">raise</span>(<span class="ruby-constant">ArgumentError</span>, <span class="ruby-node">&quot;A more recent file has already been processed.  DB as_of date #{max_as_of}&quot;</span>) <span class="ruby-keyword kw">if</span>  <span class="ruby-identifier">max_as_of</span> <span class="ruby-operator">&amp;&amp;</span> (<span class="ruby-identifier">max_as_of</span> <span class="ruby-operator">&gt;=</span> <span class="ruby-ivar">@file_as_of</span>.<span class="ruby-identifier">to_date</span>)
+
+    <span class="ruby-keyword kw">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exists?</span>(<span class="ruby-ivar">@file_path_or_url</span>)
+      <span class="ruby-ivar">@download_file</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span>(<span class="ruby-ivar">@file_path_or_url</span>)
+    <span class="ruby-keyword kw">elsif</span> <span class="ruby-constant">URI</span>.<span class="ruby-identifier">parse</span>(<span class="ruby-ivar">@file_path_or_url</span>).<span class="ruby-identifier">kind_of?</span>(<span class="ruby-constant">URI</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTP</span>)
+      <span class="ruby-ivar">@download_file</span> = <span class="ruby-identifier">get_file_from_web</span>
+    <span class="ruby-keyword kw">else</span>
+      <span class="ruby-identifier">raise</span>(<span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ENOENT</span>, <span class="ruby-ivar">@file_path_or_url</span>)
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>