eaternet 1.0.4 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6a05d4cd0cc0d3226970b904914b26df1f449698
-  data.tar.gz: 8671f3df54ad1b83c57b48603a60ab5118a13540
+  metadata.gz: 2c5fc04785f93aff0b3300b78b1b66b4b1dca9e7
+  data.tar.gz: 6fc295109586d5d5e9a04376d692c1ffa172fd46
 SHA512:
-  metadata.gz: 0a585fec3107eaa0e5006664f7426403b2cbb23933ef52607b9613acec8cc82a873058c3b57dcb8c550cf594a92440f4222453c2cad7a2b77e54d1f71b287b3c
-  data.tar.gz: a8ae0719ef5b1028c641478ae72e4554cbb2a8528d1764a25622e42166344f03e1782fe8efbd9b98b3f6735e26b864de6aef4b3893fef283870745979310a81b
+  metadata.gz: 41310f9717ff94054e7bc171857bac46d218737a8c0429473958542b98a4dcbaff8b1f0535ca14aaf883a22e951f3718d4e61c879852a3c4398f738c07fdc394
+  data.tar.gz: 15d68d3206700ced17e5df1cf37a5f386cce7136d21f7ec8184c9f44a91cc14fd20676241cd95a086e5ca623c99bb579543024c38fe805574b891b9f73d44aa6

data/Guardfile

@@ -6,7 +6,7 @@
 
 ## Uncomment to clear the screen before every task
 clearing :on
-guard :minitest do
+guard :minitest, all_after_pass: true do
   watch(%r{^test/(.*)_test\.rb$})
   watch(%r{^lib/(.+)\.rb$})         { |m| "test/#{m[1]}_test.rb" }
   watch(%r{^test/test_helper\.rb$}) { 'test' }

data/README.md

@@ -16,12 +16,13 @@ information daily on our website.
 
 ## Available Adapters
 
-| Area              | Agency                               | Ruby Class | Notes     |
-|-------------------|--------------------------------------|------------|-----------|
-| Las Vegas         | Southern Nevada Health District      | [`Snhd`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/snhd.rb)     | Needs refactoring and docs |
-| New York City     | City of New York Health Deptartment  | [`Nyc`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/nyc.rb)       | [Dataset wiki page](https://github.com/eaternet/adapters/wiki/Agency:-New-York-City) |
+| Area               | Agency                               | Ruby Class | Notes     |
+|--------------------|--------------------------------------|------------|-----------|
+| Austin, TX         | City of Austin                       |  `Austin`  | [Development has started](https://github.com/eaternet/adapters-ruby/pull/43) |
+| Las Vegas          | Southern Nevada Health District      | [`Snhd`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/snhd.rb)     | Needs refactoring and docs |
+| New York City      | City of New York Health Department   | [`Nyc`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/nyc.rb)       | [Dataset wiki page](https://github.com/eaternet/adapters/wiki/Agency:-New-York-City) |
 | Portland, OR, USA  | Multnomah Couty Environmental Health | [`Multco`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/multco.rb) | Deprecated. Needs to be updated to use the Accela API |
-| San Francisco     | City of San Francisco                | [`Sf`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/sf.rb)         | Needs docs |
+| San Francisco      | City of San Francisco                | [`Sf`](https://github.com/eaternet/adapters-ruby/blob/master/lib/eaternet/agencies/sf.rb)         | Needs docs |
 
 
 ## Usage

data/lib/eaternet.rb

@@ -2,16 +2,21 @@ require 'eaternet/agencies/multco'
 require 'eaternet/agencies/nyc'
 require 'eaternet/agencies/sf'
 require 'eaternet/agencies/snhd'
+require 'eaternet/agencies/austin'
 
 module Eaternet
   # Make the actual adapters easily available
   # to the application-level as:
   #
+  # * `Eaternet::Austin` — Austin, TX
   # * `Eaternet::Nyc`    – New York City
   # * `Eaternet::Sf`     - San Francisco
   # * `Eaternet::Snhd`   — Las Vegas area
   # * `Eaternet::Multco` — Portland area, Oregon, USA
   include Eaternet::Agencies
+
+  class UnsupportedError < StandardError
+  end
 end
 
 Zip.warn_invalid_date = false if ENV['RUBYZIP_NO_WARN_INVALID_DATE']

data/lib/eaternet/agencies/austin.rb

@@ -0,0 +1,105 @@
+require 'eaternet/socrata'
+
+module Eaternet
+  module Agencies
+
+    # @see https://data.austintexas.gov/dataset/Restaurant-Inspection-Scores/ecmv-9xxi
+    class Austin < Eaternet::Lives_1_0::Adapter
+      include Eaternet::Loggable
+      include Eaternet::Lives_1_0::CsvParser
+
+      # Create an Austin data-source, ready for querying.
+      #
+      # @example
+      #   austin = Eaternet::Austin.new
+      #
+      # @param [String] csv_path for unit testing
+      def initialize(csv_path: nil)
+        @table_file = csv_path
+      end
+
+      # @example Print the number of restaurants in the city.
+      #   puts austin.businesses.count
+      #
+      # @return [Enumerable<Business>]
+      def businesses
+        map_csv { |row| try_to_create(:business, from_csv_row: row) }
+          .uniq
+          .compact
+      end
+
+      def inspections
+        map_csv { |row| try_to_create(:inspection, from_csv_row: row) }
+          .compact
+      end
+
+      def violations
+        raise Eaternet::UnsupportedError.new(
+          'The city of Austin does not publish violation data'
+        )
+      end
+
+      def legends
+        raise Eaternet::UnsupportedError.new(
+          'The city of Austin does not assign letter grades'
+        )
+      end
+
+      def feed_info
+        Eaternet::Lives_1_0::FeedInfo.new do |fi|
+          fi.feed_date = Date.today
+          fi.feed_version = '1.0'
+          fi.municipality_name = 'Austin'
+          fi.municipality_url = 'http://www.austintexas.gov/department/health'
+        end
+      end
+
+
+
+      def inspection(row)
+        Eaternet::Lives_1_0::Inspection.new do |i|
+          i.business_id = row['Facility ID']
+          i.date =        Date.strptime(row['Inspection Date'], '%m/%d/%Y')
+          i.score =       row['Score'].to_i
+        end
+      end
+
+      def business(row)
+        Eaternet::Lives_1_0::Business.new do |b|
+          fail ArgumentError, 'No address found' if row['Address'].nil?
+
+          # Address is a multi-line, multi-value cell
+          address_lines = row['Address'].split("\n")
+          address = address_lines.first
+          city    = address_lines[1].split(',').first
+
+          b.business_id = row['Facility ID']
+          b.name =        row['Restaurant Name']
+          b.address =     address
+          b.city =        city
+          b.postal_code = row['Zip Code']
+          b.state       = 'TX'
+        end
+      end
+
+
+
+      def table_file
+        @table_file ||= Austin.download_via_url
+      end
+
+      def self.download_via_url
+        Eaternet::Util.download_and_cache(source: csv_url, dest: Tempfile.new('austin'))
+      end
+
+      def self.csv_url
+        Eaternet::Socrata.csv_url domain: 'data.austintexas.gov', dataset: 'ecmv-9xxi'
+      end
+
+      def adapter_name
+        'Austin'
+      end
+
+    end
+  end
+end

data/lib/eaternet/agencies/nyc.rb

@@ -192,12 +192,6 @@ module Eaternet
         end
       end
 
-      def map_csv(&row_handler)
-        CSV.new(File.open(table_file, encoding: 'utf-8'), headers: true)
-          .lazy
-          .map { |row| row_handler.call(row) }
-      end
-
       def table_file
         @table_file ||= Nyc.download_via_url
       end
@@ -209,9 +203,7 @@ module Eaternet
       end
 
       def self.csv_url
-        domain = 'data.cityofnewyork.us'
-        dataset = 'xx67-kt59'
-        "https://#{domain}/api/views/#{dataset}/rows.csv?accessType=DOWNLOAD"
+        Eaternet::Socrata.csv_url domain: 'data.cityofnewyork.us', dataset: 'xx67-kt59'
       end
 
       def adapter_name

data/lib/eaternet/lives_1_0/adapter.rb

@@ -11,7 +11,7 @@ module Eaternet
       # @required Yes
       # @return [Enumerable<Business>]
       def businesses
-        fail 'Override this to return an Enumerable of Business'
+        fail 'Override Adapter#businesses to return an Enumerable of Business'
       end
 
       # @example Compute the average inspection score for SomeCity.
@@ -26,7 +26,7 @@ module Eaternet
       # @required Yes
       # @return [Enumerable<Inspection>]
       def inspections
-        fail 'Override this to return an Enumerable of Inspection'
+        fail 'Override Adapter#inspections to return an Enumerable of Inspection'
       end
 
       # @required No

data/lib/eaternet/lives_1_0/csv_parser.rb

@@ -14,6 +14,12 @@ module Eaternet
         csv_map(csv) { |row| try_to_create to_type, from_csv_row: row }
       end
 
+      def map_csv(&row_handler)
+        CSV.new(File.open(table_file, encoding: 'utf-8'), headers: true)
+          .lazy
+          .map { |row| row_handler.call(row) }
+      end
+
       def csv_map(filename, &block)
         csv_rows(filename).lazy.map { |row| block.call(row) }
       end

data/lib/eaternet/socrata.rb

@@ -0,0 +1,7 @@
+module Eaternet
+  module Socrata
+    def self.csv_url(domain:, dataset:)
+      "https://#{domain}/api/views/#{dataset}/rows.csv?accessType=DOWNLOAD"
+    end
+  end
+end

data/lib/eaternet/version.rb

@@ -1,3 +1,3 @@
 module Eaternet
-  VERSION = '1.0.4'
+  VERSION = '1.1.0'
 end

data/test/eaternet/agencies/austin_test.rb

@@ -0,0 +1,82 @@
+require 'test_helper'
+
+require 'eaternet'
+require 'eaternet/lives_1_0'
+
+AUSTIN_CSV = 'test/fixtures/austin.csv'
+
+class AustinAdapterTest < Minitest::Test
+  @@agency = Eaternet::Austin.new(csv_path: AUSTIN_CSV)
+
+  #
+  # Businesses
+  #
+
+  def test_businesses_returns_an_enumerator_of_business
+    assert enumerable_of? Eaternet::Lives_1_0::Business, @@agency.businesses
+  end
+
+  def test_businesses_returns_lives_attributes
+    b = @@agency.businesses.first
+    assert_equal '2801033', b.business_id
+    assert_equal '15th Street Cafe', b.name
+    assert_equal '303 W 15TH ST', b.address
+    assert_equal 'AUSTIN', b.city
+    assert_equal '78701', b.postal_code
+    assert_equal 'TX', b.state
+  end
+
+  def test_businesses_returns_correct_city
+    b = @@agency.businesses.to_a[2]
+    assert_equal 'BUDA', b.city
+  end
+
+  def test_businesses_returns_unique_rows
+    assert_equal 3, @@agency.businesses.to_a.size
+  end
+
+  #
+  # Inspections
+  #
+
+  def test_inspections_returns_an_enumerable_of_inspection
+    assert enumerable_of? Eaternet::Lives_1_0::Inspection, @@agency.inspections
+  end
+
+  def test_inspections_returns_correct_attributes
+    i = @@agency.inspections.first
+    assert_equal '2801033',             i.business_id
+    assert_equal Date.new(2015, 5, 13), i.date
+    assert_equal 97,                    i.score
+  end
+
+  #
+  # Violations
+  #
+
+  def test_violations_raises_an_unsupported_error
+    assert_raises(Eaternet::UnsupportedError) { @@agency.violations }
+  end
+
+  def test_violations_raises_an_error_with_a_message
+    begin
+      @@agency.violations
+    rescue => e
+      assert_match /does not/, e.to_s
+    end
+  end
+
+
+  # #
+  # # metadata
+  # #
+  #
+  def test_implements_feed_info
+    assert_instance_of Eaternet::Lives_1_0::FeedInfo, @@agency.feed_info
+  end
+
+  def test_legends_raises_an_unsupported_error
+    assert_raises(Eaternet::UnsupportedError) { @@agency.legends }
+  end
+
+end

data/test/fixtures/austin.csv

@@ -0,0 +1,56 @@
+Restaurant Name,Zip Code,Inspection Date,Score,Address,Facility ID,Process Description
+15th Street Cafe,78701,05/13/2015,97,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+15th Street Cafe,78701,05/22/2013,91,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+15th Street Cafe,78701,06/18/2014,97,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+15th Street Cafe,78701,12/02/2014,93,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+15th Street Cafe,78701,09/13/2012,93,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+15th Street Cafe,78701,12/05/2013,97,"303 W 15TH ST
+AUSTIN, TX 78701
+(30.277553492000038, -97.74209889799994)",2801033,Routine Inspection
+1st Food Mart,78704,02/09/2015,94,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+1st Food Mart,78704,02/14/2013,97,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+1st Food Mart,78704,07/26/2012,97,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+1st Food Mart,78704,01/16/2014,90,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+1st Food Mart,78704,06/17/2013,100,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+1st Food Mart,78704,07/29/2014,90,"1410 S 1ST ST
+AUSTIN, TX 78704
+(30.25030317900007, -97.75485926699997)",10677646,Routine Inspection
+Austin Recovery,78610,06/05/2015,100,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+Austin Recovery,78610,10/09/2014,95,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+Austin Recovery,78610,09/13/2013,96,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+Austin Recovery,78610,05/01/2014,97,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+Austin Recovery,78610,02/13/2015,100,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+Austin Recovery,78610,02/27/2013,92,"13207 WRIGHT ROAD
+BUDA, TX 78610
+(30.084734110000056, -97.75172505999996)",10774078,Routine Inspection
+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eaternet
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.1.0
 platform: ruby
 authors:
 - Robb Shecter
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-20 00:00:00.000000000 Z
+date: 2015-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -239,6 +239,7 @@ files:
 - Rakefile
 - eaternet.gemspec
 - lib/eaternet.rb
+- lib/eaternet/agencies/austin.rb
 - lib/eaternet/agencies/multco.rb
 - lib/eaternet/agencies/multco_lib/misc.rb
 - lib/eaternet/agencies/nyc.rb
@@ -257,10 +258,12 @@ files:
 - lib/eaternet/lives_1_0/violation.rb
 - lib/eaternet/loggable.rb
 - lib/eaternet/prototype.rb
+- lib/eaternet/socrata.rb
 - lib/eaternet/util.rb
 - lib/eaternet/validated_object.rb
 - lib/eaternet/version.rb
 - lib/ext/enumerator.rb
+- test/eaternet/agencies/austin_test.rb
 - test/eaternet/agencies/multco_test.rb
 - test/eaternet/agencies/nyc_test.rb
 - test/eaternet/agencies/sf_test.rb
@@ -274,6 +277,7 @@ files:
 - test/eaternet/loggable_test.rb
 - test/eaternet/util_test.rb
 - test/ext/enumerator_test.rb
+- test/fixtures/austin.csv
 - test/fixtures/nyc.csv
 - test/script.rb
 - test/test_helper.rb
@@ -302,6 +306,7 @@ signing_key:
 specification_version: 4
 summary: Regional adapters for restaurant health scores
 test_files:
+- test/eaternet/agencies/austin_test.rb
 - test/eaternet/agencies/multco_test.rb
 - test/eaternet/agencies/nyc_test.rb
 - test/eaternet/agencies/sf_test.rb
@@ -315,6 +320,7 @@ test_files:
 - test/eaternet/loggable_test.rb
 - test/eaternet/util_test.rb
 - test/ext/enumerator_test.rb
+- test/fixtures/austin.csv
 - test/fixtures/nyc.csv
 - test/script.rb
 - test/test_helper.rb