fcc 1.0.0 → 1.1

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fcc
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: '1.1'
 platform: ruby
 authors:
 - Jeff Keen
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-12 00:00:00.000000000 Z
+date: 2011-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -39,89 +39,75 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.18'
 - !ruby/object:Gem::Dependency
-  name: lightly
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.3
-  type: :runtime
+        version: '2.1'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.3
+        version: '2.1'
 - !ruby/object:Gem::Dependency
-  name: rubyzip
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.2
-  type: :runtime
+        version: 12.3.3
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.3.2
-- !ruby/object:Gem::Dependency
-  name: logger
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: 3.9.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: 3.9.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 12.3.3
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: awesome_print
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: '0'
 description: ''
 email: jeff@keen.me
 executables:
@@ -131,15 +117,13 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".document"
-- ".github/workflows/release.yml"
-- ".github/workflows/tests.yml"
 - ".gitignore"
-- CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
+- VERSION
 - bin/console
 - bin/setup
 - fcc.gemspec
@@ -147,23 +131,18 @@ files:
 - lib/fcc/station.rb
 - lib/fcc/station/cache.rb
 - lib/fcc/station/extended_info.rb
+- lib/fcc/station/extended_info/parser.rb
 - lib/fcc/station/index.rb
 - lib/fcc/station/info.rb
-- lib/fcc/station/lms_data.rb
-- lib/fcc/station/parsers/extended_info.rb
-- lib/fcc/station/parsers/lms_data.rb
-- lib/fcc/station/record_delegate.rb
-- lib/fcc/station/record_group.rb
-- lib/fcc/station/result.rb
+- lib/fcc/station/result_delegate.rb
 - lib/version.rb
-- package.json
 - spec/fcc_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/jkeen/fcc
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -178,9 +157,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
-signing_key: 
+rubygems_version: 3.1.2
+signing_key:
 specification_version: 4
 summary: Searches the FCC's FM, AM, and TV databases
 test_files:

data/.github/workflows/release.yml

@@ -1,27 +0,0 @@
----
-name: Generate New Release
-
-on:
-  workflow_dispatch:
-
-jobs:
-  release:
-    name: Release
-    runs-on: ubuntu-18.04
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v2
-        with:
-          fetch-depth: 0
-          persist-credentials: false
-      - name: Setup Node.js
-        uses: actions/setup-node@v2
-        with:
-          node-version: 14
-      - name: Install Dependencies
-        run: yarn install --frozen-lockfile
-      - name: Release
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GEM_HOST_API_KEY: ${{ secrets.GEM_HOST_API_KEY }}
-        run: node_modules/.bin/semantic-release

data/.github/workflows/tests.yml

@@ -1,53 +0,0 @@
-name: Tests
-on: 
-  push:
-  pull_request:
-concurrency:
-  group: ci-tests-${{ github.ref }}-1
-  cancel-in-progress: true
-jobs:
-  test:
-    name: Run Tests
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ ubuntu-latest ]
-        ruby: [ '2.7' ]
-    runs-on: ${{ matrix.os }}
-    steps:
-    - uses: actions/checkout@v3
-    - name: Set up Ruby
-      uses: ruby/setup-ruby@v1
-      with:
-        ruby-version: ${{ matrix.ruby }}
-    - uses: actions/cache@v3
-      with:
-        path: vendor/bundle
-        key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
-        restore-keys: |
-          ${{ runner.os }}-gems-
-    - name: Bundle Install
-      run: |
-        gem install bundler
-        bundle install --jobs 4 --retry 3
-
-    - name: Run RSpec
-      run: bundle exec rspec -f j -o tmp/rspec_results.json -f p
-
-    - name: RSpec Report
-      uses: SonicGarden/rspec-report-action@v2
-      with:
-        token: ${{ secrets.GITHUB_TOKEN }}
-        json-path: tmp/rspec_results.json
-      if: always()
-  publish:
-    name: Release
-    runs-on: ubuntu-latest
-    if: github.ref == 'refs/heads/main'
-    needs: [test]
-    steps:
-      - name: Dispatch Release
-        uses: benc-uk/workflow-dispatch@v1
-        with:
-          workflow: Generate New Release
-          token: ${{ secrets.GITHUB_TOKEN }}

data/CHANGELOG.md

@@ -1,11 +0,0 @@
-fcc changelog
-
-# 1.0.0 (2023-02-12)
-
-## [1.4.0](https://github.com/jkeen/fcc/compare/v1.4.0...v1.3.0) (2022-11-25)
-
-
-## [1.3.0](https://github.com/jkeen/fcc/compare/v1.3.0...v1.2.1) (2022-07-10)
-
-- Combine data from multiple sources to get a full picture of the station data (transition api, public api, LMS csv files)
-- Now includes related transmitters, repeaters, low power stations, etc

data/lib/fcc/station/lms_data.rb

@@ -1,139 +0,0 @@
-require 'httparty'
-require 'open-uri'
-require 'net/http'
-require 'uri'
-require 'date'
-require_relative './parsers/lms_data'
-
-module FCC
-  module Station
-    class LmsData
-      BASE_URI = 'https://enterpriseefiling.fcc.gov/dataentry/api/download/dbfile'
-      # include HTTParty
-
-      def find_all_related(call_sign: )
-        stations = find_related_stations(call_sign: call_sign)
-        translators = find_translators_for(call_sign: stations.keys)
-        stations.merge(translators)
-      end
-
-      def find_translators_for(call_sign: )
-        call_signs = [call_sign].flatten
-
-        records = common_station_data.entries.select do |entry|
-          call_signs.any? { |call_sign| call_signs_match?(call_sign, entry['callsign']) }
-        end 
-
-        facility_ids = records.map { |r| r['facility_id'] }.uniq.compact
-
-        matched_facilities = facilities.entries.select do |facility|
-          facility_ids.include?(facility['primary_station']) #{}|| facility_ids.include?(facility['facility_id'])
-        end
-
-        {}.tap do |hash|
-          matched_facilities.each do |record|
-            hash[record['callsign']] = record['facility_id']
-          end
-        end
-      end
-
-      def find_related_stations(call_sign: )
-        call_signs = [call_sign].flatten
-
-        records = common_station_data.entries.select do |entry|
-          call_signs.any? { call_signs_match?(call_sign, entry['callsign']) }
-        end
-
-        correlated_app_ids = records.map { |m| m['eeo_application_id'] }
-        matches = common_station_data.entries.select do |entry|
-          correlated_app_ids.include?(entry['eeo_application_id'])
-        end
-
-        {}.tap do |hash|
-          matches.each do |record|
-            hash[record['callsign']] = record['facility_id']
-          end
-        end
-      end
-
-      def facilities
-        @facilities ||= read(:facility)
-      end
-
-      def common_station_data
-        @common_station_data ||= read(:common_station)
-      end
-
-      def find_facilities(facility_ids:, call_signs: [])
-        matched_facilities = facilities.entries.select do |facility|
-          facility_ids.include?(facility['primary_station']) || facility_ids.include?(facility['facility_id']) || call_signs.include?(facility['callsign'])
-        end
-
-        {}.tap do |hash|
-          matched_facilities.each do |record|
-            hash[record['callsign']] = record['facility_id']
-          end
-        end
-      end
-
-      def find_call_signs(call_signs:)
-        common_station_data.entries.select do |entry|
-          call_signs.any? do |call_sign|
-            call_signs_match?(call_sign, entry['callsign'])
-          end
-        end
-      end
-
-      def read(file_name)
-        key = "#{lms_date}-#{file_name}"
-        remote_url = URI("#{BASE_URI}/#{lms_date}/#{file_name}.zip")
-        FCC.log remote_url
-        contents = FCC.cache.fetch key do
-          begin
-            temp_file = http_download_uri(remote_url)
-            break if temp_file.empty?
-
-            contents = ""
-            Zip::File.open_buffer(temp_file) do |zf| 
-              contents = zf.read(zf.entries.first)
-              break
-            end
-
-            value = contents
-          rescue Exception => e
-            FCC.error(e.message)
-            value = nil
-          ensure
-            value
-          end
-        end
-
-        if contents
-          CSV.parse(contents, col_sep: '|', headers: true)
-        end
-      end
-
-      protected
-
-      def call_signs_match?(ours, theirs)
-        theirs.to_s.upcase.to_s == ours.to_s.upcase.to_s || theirs.to_s.upcase =~ Regexp.new("^#{ours.to_s.upcase}[-—–][A-Z0-9]+$")
-      end
-
-      def http_download_uri(uri)
-        FCC.log 'Downloading ' + uri.to_s
-        begin
-          Tempfile.create { HTTParty.get(uri)&.body }
-        rescue Exception => e
-          FCC.error "=> Exception: '#{e}'. Skipping download."
-
-          raise e
-          return false
-        end
-      end
-
-      def lms_date
-        Date.today.strftime('%m-%d-%Y')
-      end
-    end
-  end
-end

data/lib/fcc/station/parsers/extended_info.rb

@@ -1,78 +0,0 @@
-require 'httparty'
-
-module FCC
-  module Station
-    module Parsers
-      class ExtendedInfo < HTTParty::Parser
-        def parse
-          results = []
-          body.each_line do |row|
-            attrs = {}
-            attrs[:raw] = row
-            fields = row.split('|').slice(1...-1).collect(&:strip).map { |v| v == '-' ? "" : v }
-
-            attrs[:call_sign]                = fields[0]
-            attrs[:frequency]                = parse_frequency(fields[1])
-            attrs[:band]                     = fields[2]
-            attrs[:channel]                  = fields[3]
-            attrs[:antenna_type]             = fields[4] # Directional Antenna (DA) or NonDirectional (ND)
-            attrs[:operating_hours]          = fields[5] if fields[5] && attrs[:band]&.upcase == "AM" # (Only used for AM)
-            attrs[:station_class]            = fields[6]
-            attrs[:region_2_station_class]   = fields[7] if fields[7] && attrs[:band]&.upcase == "AM" # (only used for AM)
-            attrs[:status]                   = fields[8]
-            attrs[:city]                     = fields[9]
-            attrs[:state]                    = fields[10]
-            attrs[:country]                  = fields[11]
-            attrs[:file_number]              = fields[12]  #File Number (Application, Construction Permit or License) or
-            attrs[:signal_strength]          = parse_signal_strength(fields[13]) # Effective Radiated Power --
-            attrs[:effective_radiated_power] = parse_signal_strength(fields[14]) # Effective Radiated Power -- vertically polarized (maximum)
-            attrs[:haat_horizontal]          = fields[15] # Antenna Height Above Average Terrain (HAAT) -- horizontal polarization
-            attrs[:haat_vertical]            = fields[16] # Antenna Height Above Average Terrain (HAAT) -- vertical polarization
-            attrs[:fcc_id]                   = fields[17] # Facility ID Number (unique to each station)
-            attrs[:latitude]                 = parse_latitude(fields[18], fields[19], fields[20], fields[21])
-            attrs[:longitude]                = parse_longitude(fields[22], fields[23], fields[24], fields[25])
-            attrs[:licensed_to]              = fields[26] # Licensee or Permittee
-
-            results << attrs
-          end
-
-          results
-        end
-
-        def parse_longitude(direction, degrees, minutes, seconds)
-          decimal_degrees = degrees.to_i + (minutes.to_f / 60) + (seconds.to_f / 3600)
-
-          "#{direction =~ /W/ ? '-' : ''}#{decimal_degrees}"
-        end
-
-        def parse_latitude(direction, degrees, minutes, seconds)
-          decimal_degrees = degrees.to_i + (minutes.to_f / 60) + (seconds.to_f / 3600)
-
-          "#{direction =~ /S/ ? '-' : ''}#{decimal_degrees}"
-        end
-
-        def parse_signal_strength(power_string)
-          return unless power_string.present?
-
-          number, unit = power_string.strip.scan(/^([0-9.]+)\s+(\w+)$?/).flatten
-          multiplier   = case unit&.downcase
-                          when "w"
-                            1
-                          when "kw"
-                            1000
-                          when "mw"
-                            1000000
-                          else
-                            1
-                         end
-      
-          number.to_f * multiplier
-        end
-
-        def parse_frequency(freq)
-          freq.to_f
-        end
-      end
-    end
-  end
-end

data/lib/fcc/station/parsers/lms_data.rb

@@ -1,13 +0,0 @@
-require 'httparty'
-
-module FCC
-  module Station
-    module Parsers
-      class LmsData < HTTParty::Parser
-        def parse
-          body
-        end
-      end
-    end
-  end
-end

data/lib/fcc/station/record_delegate.rb

@@ -1,121 +0,0 @@
-require 'active_support/inflector'
-
-module FCC
-  module Station
-    class RecordDelegate
-      def initialize(result)
-        @result = result
-      end
-
-      def method_missing(m, *args, &block)
-        return find_result(@result, m) unless @result.is_a?(Array)
-        return find_result(@result.first, m) if @result.size == 1
-
-        filtered_results = @result.filter { |result|
-          result[:status] == 'LIC' # Licensed only, no construction permits
-        }
-
-        filtered_results = filtered_results.collect { |res|
-          find_result(res, m)
-        }.uniq
-
-        filtered_results.size == 1 ? filtered_results.first : filtered_results
-      end
-
-      def to_json
-        return {}.tap do |record|
-          [Station::Result::EXTENDED_ATTRIBUTES | Station::Result::BASIC_ATTRIBUTES].flatten.each do |attr|
-            record[attr.to_sym] = send(attr.to_sym)
-          end
-
-          %i[contact owner community].each do |attr|
-            result = send(attr.to_sym)
-            next unless result
-
-            record[attr] ||= if result.is_a?(Struct)
-                               result.to_h.compact
-                             elsif result.is_a?(Array) && result.compact.size > 0
-                               result
-                             elsif result.present?
-                               result.to_s
-                             end
-          end
-        end
-      end
-
-      def has_data?
-        @result.present?
-      end
-
-      def id
-        super || send(:fcc_id)
-      end
-
-      def frequency
-        super&.to_f
-      end
-
-      def rf_channel
-        super || send(:channel)
-      end
-
-      def operating_hours
-        super&.downcase
-      end
-
-      def owner
-        @owner ||= begin
-          contact = Contact.new(
-            name: party_name || licensed_to,
-            address: party_address_1, 
-            address2: party_address_2, 
-            city: (party_city || city), 
-            state: (party_state || state), 
-            zip_code: party_zip_1,
-            country: country,
-            phone: party_phone
-          )
-
-          contact if contact.to_h.compact.any?
-        end
-      end
-
-      def community
-        @community ||= begin
-          community = Community.new(city: community_city || city, state: community_state || state, country: country)
-          community if community.to_h.compact.any?
-        end
-      end
-
-      def contact
-        contact = main_studio_contact
-
-        return unless contact
-        @contact ||= begin
-          contact = Contact.new(name: contact['contactName'], title: contact['contactTitle'], address: contact['contactAddress1'], address2: contact['contactAddress2'], city: contact['contactCity'], state: contact['contactState'], zip_code: contact['contactZip'], phone: contact['contactPhone'], fax: contact['contactFax'], email: contact['contactEmail'], website: contact['contactWebsite'])
-          contact if contact.to_h.compact.any?
-        end
-      end
-
-      def inspect
-        "<RecordDelegate:[#{band}] #{frequency} #{call_sign} — #{community.city} #{community.state} />"
-      end
-
-      private
-
-      def find_key(result, name)
-        result&.keys&.detect { |d| name.to_s == d.to_s } || result&.keys&.detect { |d| name.to_s == d.to_s.underscore }
-      end
-
-      def find_result(result, name)
-        matched_key = find_key(result, name)
-
-        if matched_key
-          result[matched_key]
-        else
-          nil
-        end
-      end
-    end
-  end
-end

data/lib/fcc/station/record_group.rb

@@ -1,49 +0,0 @@
-require 'active_support/inflector'
-
-module FCC
-  module Station
-    class RecordGroup
-      def initialize(results = [])
-        @results = results.map do |result| 
-          result.is_a?(RecordDelegate) ? result : RecordDelegate.new(result)
-        end
-      end
-
-      def to_json
-        return {}.tap do |record|
-          [Station::Result::EXTENDED_ATTRIBUTES | Station::Result::BASIC_ATTRIBUTES].flatten.each do |attr|
-            record[attr.to_sym] = result_attribute(attr.to_sym)
-          end
-
-          %i[contact owner community].each do |attr|
-            result = result_attribute(attr.to_sym)
-            next unless result
-
-            record[attr] ||= if result.is_a?(Struct)
-                               result.to_h.compact
-                             elsif result.is_a?(Array) && result.compact.size > 0
-                               result
-                             elsif result.present?
-                               result.to_s
-                             end
-          end
-        end
-      end
-
-      def result_attribute(attr)
-        @results.collect { |r| r.send(attr.to_sym) }.compact.first
-      end
-
-      def method_missing(m, *args, &block)
-        result = result_attribute(m.to_sym)
-
-        if result.is_a?(Array) && result.size == 1 
-          result = result.first
-        end
-
-        result
-      end
-
-    end
-  end
-end