fcc 0.1.0 → 1.1

data/.rvmrc

@@ -1 +0,0 @@
-rvm 1.9.2-head@fccc

data/README.rdoc

@@ -1,28 +0,0 @@
-= fcc
-
-Queries the FCC database for FM information.
-
-FCC::FM.find("KUT") #=> KUT station info
-
-FCC::AM.find("KLBJ") #=> KLBJ station info
-
-FCC::FM.find_all(:city => "Austin", :state => "TX") #=> [FM::Station, FM::Station, FM::Station]
-
-
-TODO: Dry some of this out.
-
-== Contributing to fcc
- 
-* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
-* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2011 Jeff Keen. See LICENSE.txt for
-further details.
-

data/lib/am.rb

@@ -1,126 +0,0 @@
-require 'open-uri'
-
-module FCC
-  class AM
-    class Station
-      attr_reader :call_letters, :band, :hours, :file_number, :station_class, :fcc_id, :city, :state, :country, :licensed_to, :latitude, :longitude
-      def initialize(*fields)
-        @raw =                fields
-        @call_letters =       fields[0]
-        @frequency =          fields[1]
-        @band =               fields[2]
-        #                     fields[3]  # Not used for AM
-        #                     fields[4]  # Directional Antenna (DA) or NonDirectional (ND)
-        @hours =              fields[5]  # Hours of operation for this record (daytime, nighttime, or unlimited)
-        @domestic_class =     fields[6]  # Domestic US Station class
-        @international_class =fields[7]  # International station class
-        @fm_status =          fields[8]
-        @city =               fields[9]
-        @state =              fields[10]
-        @country =            fields[11]
-        @file_number =        fields[12] # File Number (Application, Construction Permit or License) or Docket Number (Rulemaking)
-        @signal_strength =    fields[13] # Power
-        #                     fields[14] # Not used
-        #                     fields[15] # Not used
-        #                     fields[16] # Not used
-        @fcc_id =             fields[17] # Facility ID Number (unique to each station)
-        @latitude =           latitude(fields[18], fields[19], fields[20], fields[21])
-        @longitude =          longitude(fields[22], fields[23], fields[24], fields[25])
-
-        @licensed_to =        fields[26] # Licensee or Permittee
-        #                     fields[27] # Kilometers distant (radius) from entered latitude, longitude
-        #                     fields[28] # Miles distant (radius) from entered latitude, longitude
-        #                     fields[29] # Azimuth, looking from center Lat, Lon to this record's Lat, Lon
-        #                     fields[30] # Application ID number (from CDBS database)***
-      end
-      
-      private 
-      
-      def longitude(direction, degrees, minutes, seconds)
-        "#{(direction =~ /S/ ? "-" : "")}#{degrees}.#{minutes}"
-      end
-
-      def latitude(direction, degrees, minutes, seconds)
-        "#{(direction =~ /S/ ? "-" : "")}#{degrees}.#{minutes}"
-      end
-
-      def signal_strength(raw_signal)
-        raw_signal.gsub(/\.\s+/, ".0 ") if raw_signal
-      end
-
-      def frequency(freq)
-        freq[/[0-9]+\.?[0-9]/] if freq
-      end
-    end
-
-    BASE_URL = "http://www.fcc.gov/fcc-bin/amq"
-
-    def self.find(call_letters)
-      raise ArgumentError, "no call letters were supplied" if call_letters.nil? || call_letters.strip.length == 0
-
-      find_all(:call_letters => call_letters).first
-    end
-
-    def self.find_all(conditions = {})
-      results = []
-      query(conditions.merge(:band => "AM")) do |feed|
-        feed.each_line do |row|
-          fields = row.split("|").select { |field| (field.strip! && !field.nil?)}
-          results << Station.new(*fields)
-        end
-      end
-      # if call letters are supplied, return matches that match call letters exactly.
-      # FCC does partial matches (from the start of the string), so that "KUT" will return "KUTT", also
-      if conditions[:call_letters]
-        exact_matches =  results.select { |d| d.call_letters == conditions[:call_letters] }
-        results = exact_matches if (exact_matches)
-      end
-
-      #sort by signal strength
-      if results.size > 1
-        results.sort_by { |s| s.signal_strength}.reverse
-      else
-        results
-      end
-    end
-
-    private
-
-    def self.query(conditions = {})
-      query = ""
-      prepare_args(conditions).each { |k,v| query += "#{k}=#{v}&" }
-      url = "#{BASE_URL}?#{query}"
-      feed = open(url)
-      yield feed
-    end
-
-    def self.prepare_args(params)
-      return {
-        :state => params[:state],
-        :call => params[:call_letters],
-        :city => params[:city],
-        :arn => nil,
-        :serv => params[:band],
-        :vac => nil,
-        :freq => params[:frequency] || params[:frequency_lower] || "530",
-        :fre2 => params[:frequency] || params[:frequency_upper] || "1700",
-        :facid => nil,
-        :class => nil,
-        :dkt => nil,
-        :dist => nil,
-        :dlat2 => nil,
-        :dlon2 => nil,
-        :mlon2 => nil,
-        :mlat2 => nil,
-        :slat2 => nil,
-        :slon2 => nil,
-        # :NS => "N",
-        # :e => 9,
-        :EW => "W",
-        :list => 4, # pipe separated output
-        :size => 9
-       }
-    end
-
-  end
-end

data/lib/fm.rb

@@ -1,144 +0,0 @@
-require 'open-uri'
-
-module FCC
-  class FM
-    class Station
-      attr_reader :call_letters, :band, :channel, :fm_status, :latitude, :longitude, :file_number, :station_class, :fcc_id, :city, :state, :country, :licensed_to
-      def initialize(*fields)
-        @raw =                fields
-        @call_letters =       fields[0]
-        @frequency =          frequency(fields[1])
-        @band =               fields[2]
-        @channel =            fields[3]
-        #                     fields[4]  # Directional Antenna (DA) or NonDirectional (ND)
-        #                     fields[5]  # (Not Used for FM)
-        @station_class =      fields[6]
-        #                     fields[7]  # (Not Used for FM)
-        @fm_status =          fields[8]
-        @city =               fields[9]
-        @state =              fields[10]
-        @country =            fields[11]
-        @file_number =        fields[12] # File Number (Application, Construction Permit or License) or Docket Number (Rulemaking)
-        @signal_strength =    signal_strength(fields[13]) # Effective Radiated Power -- horizontally polarized  (maximum)
-        #                     fields[14] # Effective Radiated Power -- vertically polarized  (maximum)
-        #                     fields[15] # Antenna Height Above Average Terrain (HAAT) -- horizontal polarization
-        #                     fields[16] # Antenna Height Above Average Terrain (HAAT) -- vertical polarization
-        @fcc_id =             fields[17] # Facility ID Number (unique to each station)
-
-        @latitude =           latitude(fields[18], fields[19], fields[20], fields[21])
-        @longitude =          longitude(fields[22], fields[23], fields[24], fields[25])
-
-        @licensed_to =        fields[26] # Licensee or Permittee
-        #                     fields[27] # Kilometers distant (radius) from entered latitude, longitude
-        #                     fields[28] # Miles distant (radius) from entered latitude, longitude
-        #                     fields[29] # Azimuth, looking from center Lat, Lon to this record's Lat, Lon
-        #                     fields[30] # Antenna Radiation Center Above Mean Sea Level (RCAMSL) - Horizontally Polarized - meters
-        #                     fields[31] # Antenna Radiation Center Above Mean Sea Level (RCAMSL) - Vertically Polarized - meters
-        #                     fields[32] # Directional Antenna ID Number
-        #                     fields[33] # Directional Antenna Pattern Rotation (degrees)
-        #                     fields[34] # Antenna Structure Registration Number
-        #                     fields[35] # Application ID number (from CDBS database)***
-      end
-
-      def good?
-        return false if @call_letters == "NEW"
-        return false if @call_letters == "-"
-        return false if @band != "FM"
-        #@call_letters =~ /^[^0-9]/
-
-        true
-      end
-
-      private
-
-      def longitude(direction, degrees, minutes, seconds)
-        "#{(direction =~ /S/ ? "-" : "")}#{degrees}.#{minutes}"
-      end
-
-      def latitude(direction, degrees, minutes, seconds)
-        "#{(direction =~ /S/ ? "-" : "")}#{degrees}.#{minutes}"
-      end
-
-      def signal_strength(raw_signal)
-        raw_signal.gsub(/\.\s+/, ".0 ") if raw_signal
-      end
-
-      def frequency(freq)
-        freq[/[0-9]+\.?[0-9]/] if freq
-      end
-    end
-
-    BASE_URL = "http://www.fcc.gov/fcc-bin/fmq"
-
-    def self.find(call_letters)
-      raise ArgumentError, "no call letters were supplied" if call_letters.nil? || call_letters.strip.length == 0
-
-      find_all(:call_letters => call_letters).first
-    end
-
-    def self.find_all(conditions = {})
-      results = []
-      query(conditions.merge(:band => "FM")) do |feed|
-        feed.each_line do |row|
-          fields = row.split("|").select { |field| (field.strip! && !field.nil?)}
-          results << Station.new(*fields)
-        end
-      end
-      #remove invalid values, such as "NEW", or "-", stations starting with numbers, and non-FM bands
-      results = results.select(&:good?)
-      # if call letters are supplied, return matches that match call letters exactly.
-      # FCC does a starts_with search, so that "KUT" will return "KUTT", also
-      if conditions[:call_letters]
-        exact_matches =  results.select { |d| d.call_letters == conditions[:call_letters] }
-        results = exact_matches if (exact_matches)
-      end
-
-      results
-      #sort by signal strength
-      if results.size > 1
-        results.sort_by { |s| s.signal_strength}.reverse
-      else
-        results
-      end
-    end
-
-    private
-
-    def self.query(conditions = {})
-      query = ""
-      prepare_args(conditions).each { |k,v| query += "#{k}=#{v}&" }
-      url = "#{BASE_URL}?#{query}"
-      feed = open(url)
-      yield feed
-    end
-
-    def self.prepare_args(params)
-      return {
-        :state => params[:state],
-        :call => params[:call_letters],
-        :city => params[:city],
-        :arn => nil,
-        :serv => params[:band],
-        :vac => nil,
-        :freq => params[:frequency] || params[:frequency_lower] || "0.0",
-        :fre2 => params[:frequency] || params[:frequency_upper] || "108.0",
-        :facid => nil,
-        :class => nil,
-        :dkt => nil,
-        :dist => nil,
-        :dlat2 => nil,
-        :dlon2 => nil,
-        :mlon2 => nil,
-        :mlat2 => nil,
-        :slat2 => nil,
-        :slon2 => nil,
-        # :NS => "N",
-        # :e => 9,
-        :EW => "W",
-        :list => 4, # pipe separated output
-        :size => 9
-       }
-    end
-
-  end
-end

data/test/helper.rb

@@ -1,18 +0,0 @@
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'test/unit'
-require 'shoulda'
-
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
-$LOAD_PATH.unshift(File.dirname(__FILE__))
-require 'fcc'
-
-class Test::Unit::TestCase
-end

data/test/test_fcc.rb

@@ -1,7 +0,0 @@
-require 'helper'
-
-class TestFcc < Test::Unit::TestCase
-  should "probably rename this file and start testing for real" do
-    flunk "hey buddy, you should probably rename this file and start testing for real"
-  end
-end