gull 0.4.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 499056dd7d0dfaf61fd26893aac65a8f8b2f802f
-  data.tar.gz: 989cda9df71c6d5fc5d31c3ae9c4ff6a26e7ff7b
+SHA256:
+  metadata.gz: 7924e8188cee18f8b12e1a420d6ea68d1e0951c1c7c7e53f9d87b11b528d23f0
+  data.tar.gz: 517bb2c4a28d250207ddd22c51173b2be3392e0f1059b89110cc2af11a48af65
 SHA512:
-  metadata.gz: 7b86f770036bbae32dd13ad68d793fc62043bbf199d3e980cdb92455e26c0498a952d1212a5af69ec26403377da32edce66ee2efdfa68d4e5249a6dc23a5ed35
-  data.tar.gz: ffe0a676c31958d1c51c25a50a1be6d13046ba88689f734ec4a82112062c4d87e4c5cc6ef6abb52751689e3879a14e15d5d0f4d7fdd532e125eade99e47ff140
+  metadata.gz: 79015c143ade595b2d021986b48c0e7dbe78c83f2f42b787e9b7027914263631b3a6581a7491c607cef8037240465e056d8200f4eb9770016a9e88c83b022b71
+  data.tar.gz: 61d48682d8434559a7b14347765b3537cfc32c78f7c23e5ff137dcfe7d5571e3e98bbd8a8c79be198959351e3bd8913da7e0c02f82ad8310bf7a33ad7784d974

data/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        ruby-version: ['3.1', '3.2', '3.3', '3.4']
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler-cache: true
+      - name: Run tests
+        run: bundle exec rspec
+      - name: Run linter
+        run: bundle exec rubocop

data/.gitignore

@@ -1,22 +1,6 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
+/.bundle
+/coverage
+/pkg
+/tmp
 Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
-*.bundle
-*.so
-*.o
-*.a
-mkmf.log
+.ruby-version

data/.rubocop.yml

@@ -1,5 +1,38 @@
 AllCops:
+  TargetRubyVersion: 3.1
+  NewCops: enable
+  SuggestExtensions: false
   Exclude:
     - 'spec/spec_helper.rb'
+    - 'gull.gemspec'
+    - 'vendor/**/*'
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*'
+Metrics/MethodLength:
+  Max: 20
+  Exclude:
+    - 'spec/**/*'
+Metrics/AbcSize:
+  Max: 35
+  Exclude:
+    - 'spec/**/*'
+Metrics/ClassLength:
+  Enabled: false
+Metrics/CyclomaticComplexity:
+  Enabled: false
+Metrics/PerceivedComplexity:
+  Enabled: false
+Layout/LineLength:
+  Max: 80
+  Exclude:
+    - 'spec/**/*'
 Style/StringLiterals:
-  EnforcedStyle: single_quotes
+  EnforcedStyle: single_quotes
+Style/StringConcatenation:
+  Exclude:
+    - 'spec/**/*'
+Style/Documentation:
+  Enabled: false
+Naming/PredicateMethod:
+  Enabled: false

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+1.0.1 (03/07/2026) - Add YARD doc comments to all public classes and methods. Expand README with polygon, error handling, and client usage examples. Handle malformed JSON responses (raise `HttpError` instead of `JSON::ParserError`). Handle missing time fields in alert data (return `nil` instead of raising `TypeError`).
+
+***
+
+1.0.0 (03/07/2026) - Major rewrite: migrate from defunct `alerts.weather.gov` XML feed to `api.weather.gov/alerts` JSON API. Drop all runtime dependencies (`httpclient`, `nokogiri`) in favor of Ruby stdlib (`net/http`, `json`). Require Ruby >= 3.1. Add `area` option for state-based filtering. Replace Travis CI with GitHub Actions. Add RuboCop. **Breaking:** remove `url` option (use `area` instead), remove `Polygon#image_url`, remove `strict` option.
+
+***
+
 0.4.0 (07/26/2016) - Merged pull request #2 from [schrockwell](https://github.com/schrockwell), which adds `to_wkt` to `Polygon` which formats the polygon points as Well-Known Text (WKT). Removed `centroid` method, use new `to_wkt` method with an external geospatial library instead.
 
 ***
@@ -43,7 +51,7 @@
 ***
 
 0.2.0 (10/02/2014) - Introduced Polygon type.
- 
+
 ***
 
 0.1.1 (10/01/2014) - Refactored and simplified alert processing.

data/Gemfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 source 'https://rubygems.org'
 
 # Specify your gem's dependencies in gull.gemspec

data/Guardfile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 guard :rspec, cmd: 'bundle exec rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014 Seth Deckard
+Copyright (c) 2014-2026 Seth Deckard
 
 MIT License
 

data/README.md

@@ -1,12 +1,8 @@
 [![Gem Version](https://badge.fury.io/rb/gull.svg)](http://badge.fury.io/rb/gull)
-[![Build Status](https://travis-ci.org/sethdeckard/gull.svg?branch=master)](https://travis-ci.org/sethdeckard/gull)
-[![Coverage Status](https://coveralls.io/repos/sethdeckard/gull/badge.svg?branch=master)](https://coveralls.io/r/sethdeckard/gull)
-[![Code Climate](https://codeclimate.com/github/sethdeckard/gull/badges/gpa.svg)](https://codeclimate.com/github/sethdeckard/gull)
-[![Dependency Status](https://gemnasium.com/sethdeckard/gull.svg)](https://gemnasium.com/sethdeckard/gull)
-[![security](https://hakiri.io/github/sethdeckard/gull/master.svg)](https://hakiri.io/github/sethdeckard/gull/master)
+[![CI](https://github.com/sethdeckard/gull/actions/workflows/ci.yml/badge.svg)](https://github.com/sethdeckard/gull/actions/workflows/ci.yml)
 # Gull
 
-Ruby client for parsing NOAA/NWS alerts, warnings, and watches. The name comes from the type of bird featured on the NOAA logo. Please read the Notes/Caveats section for limitations.
+Ruby client for parsing NOAA/NWS alerts, warnings, and watches. The name comes from the type of bird featured on the NOAA logo. Zero runtime dependencies -- uses only Ruby stdlib (`net/http`, `json`).
 
 ## Installation
 
@@ -40,7 +36,7 @@ alert.effective_at
 alert.expires_at
 alert.published_at
 alert.area
-alert.polygon
+alert.polygon           # Gull::Polygon or nil
 alert.geocode.fips6
 alert.geocode.ugc
 alert.urgency
@@ -49,41 +45,61 @@ alert.certainty
 alert.vtec
 ```
 
-To get alerts for a single state, territory, or marine zone just pass an optional URL
+To get alerts for a single state or territory, pass the area option:
 
 ```ruby
-oklahoma_url = 'http://alerts.weather.gov/cap/ok.php?x=1'
-alerts = Gull::Alert.fetch(url: oklahoma_url)
+alerts = Gull::Alert.fetch(area: 'OK')
 ```
 
-You can also generate a map (a really long URL pointing to a map) of the polygon if alert has one (requires Google Static Maps API Key)
+### Polygons
+
+Alerts with geographic boundaries include a `Polygon` object:
 
 ```ruby
-alert.polygon.image_url 'YOUR_GOOGLE_API_KEY'
+alert.polygon.coordinates
+# => [[34.57, -97.56], [34.77, -97.38], ...]
+
+alert.polygon.to_s
+# => "34.57,-97.56 34.77,-97.38 ..."
 
-=> "http://maps.googleapis.com/maps/api/staticmap?size=640x640&maptype=roadmap&path=color:0xff0000|weight:3|fillcolor:0xff000060|38.73,-94.22|38.75,-94.16|38.57,-93.94|38.4,-93.84|38.4,-93.91|38.73,-94.22&key=YOUR_GOOGLE_API_KEY"
+alert.polygon.to_wkt
+# => "POLYGON((-97.56 34.57, -97.38 34.77, ...))"
 ```
 
-Options can be passed for map to override defaults
+### Error Handling
+
+```ruby
+begin
+  alerts = Gull::Alert.fetch
+rescue Gull::TimeoutError => e
+  # request timed out
+rescue Gull::HttpError => e
+  # non-success response or connection failure
+  e.original # wrapped exception, if any
+end
+```
+
+### Advanced: Client
+
+For direct access to unparseable features, use `Client`:
 
 ```ruby
-options = { width: 600, height: 300, color: '0xfbf000', weight: 4,
-            fillcolor: '0xfbf00070', maptype: 'hybrid' }
-alert.polygon.image_url 'YOUR_GOOGLE_API_KEY', options
+client = Gull::Client.new(area: 'OK')
+alerts = client.fetch
+client.errors # features that could not be parsed
 ```
 
-##Notes, Caveats
-This library provides a simplified/flattened model of the [Common Alerting Protocol](http://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.html) based only on the elements NWS utilizes in their [public Atom feeds](http://alerts.weather.gov/). If you need a complete CAP parser I suggest looking at [RCAP](https://github.com/farrel/RCAP).
+## Notes, Caveats
 
-The NWS will often cancel or update alerts before their expiration time. The public Atom feeds only provide current active alerts and do not include these separate update and cancellation CAP messages.
+This library fetches active alerts from the [NWS API](https://api.weather.gov) (`api.weather.gov/alerts/active`), which returns GeoJSON. No authentication is required but the API does require a `User-Agent` header (set automatically by the gem). See the [NWS API docs](https://www.weather.gov/documentation/services-web-api) for more details.
 
-The public Atom feeds have not always been reliable in terms of uptime and are often delayed by 2-3 minutes. If you are considering using this (or another gem/library that accesses the public Atom feeds) for mission critical purposes then you should explore other options.
+The NWS will often cancel or update alerts before their expiration time. The API only returns currently active alerts.
 
 ### Urgency
 
-| Symbol        | Definition          
+| Symbol        | Definition
 | :------------- |:-------------
-| :immediate  | Responsive action should betaken immediately
+| :immediate  | Responsive action should be taken immediately
 | :expected  | Responsive action should be taken soon (within next hour)
 | :future  | Responsive action should be taken in the near future
 | :past  | Responsive action is no longer required
@@ -91,7 +107,7 @@ The public Atom feeds have not always been reliable in terms of uptime and are o
 
 ### Severity
 
-| Symbol        | Definition          
+| Symbol        | Definition
 | :------------- |:-------------
 | :extreme  | Extraordinary threat to life or property
 | :severe  | Significant threat to life or property
@@ -101,7 +117,7 @@ The public Atom feeds have not always been reliable in terms of uptime and are o
 
 ### Certainty
 
-| Symbol        | Definition          
+| Symbol        | Definition
 | :------------- |:-------------
 | :very_likely  | Highly likely (p > ~ 85%) or certain
 | :likely  | Likely (p > ~50%)

data/Rakefile

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 

data/gull.gemspec

@@ -1,5 +1,6 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'gull/version'
 
@@ -9,22 +10,29 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Seth Deckard']
   spec.email         = ['seth@deckard.me']
   spec.summary       = 'Client for parsing NOAA/NWS alerts, warnings, and watches.'
-  spec.description   = 'Client for parsing NOAA/NWS alerts, warnings, and watches.'
+  spec.description   = 'Fetches and parses NOAA/NWS alerts, warnings, and watches from api.weather.gov. Zero runtime dependencies.'
   spec.homepage      = 'https://github.com/sethdeckard/gull'
   spec.license       = 'MIT'
+  spec.required_ruby_version = '>= 3.1'
+
+  spec.metadata = {
+    'source_code_uri' => 'https://github.com/sethdeckard/gull',
+    'changelog_uri' => 'https://github.com/sethdeckard/gull/blob/master/CHANGELOG.md',
+    'bug_tracker_uri' => 'https://github.com/sethdeckard/gull/issues'
+  }
 
-  spec.files         = `git ls-files -z`.split("\x0")
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(AGENTS|CLAUDE)\.md$})
+  end
   spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
-  spec.add_runtime_dependency 'httpclient'
-  spec.add_runtime_dependency 'nokogiri', '>= 1.6.8'
-
   spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'guard-rspec'
   spec.add_development_dependency 'rake'
-  spec.add_development_dependency 'rspec', '>=3.0'
-  spec.add_development_dependency 'coveralls'
-  spec.add_development_dependency 'guard'
+  spec.add_development_dependency 'rspec', '>= 3.0'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-rake'
+  spec.add_development_dependency 'simplecov'
   spec.add_development_dependency 'webmock'
 end

data/lib/gull/alert.rb

@@ -1,80 +1,114 @@
-require 'httpclient'
-require 'nokogiri'
+# frozen_string_literal: true
 
 module Gull
-  # Gull represents an NWS/NOAA alert and provides the ability to fetch
-  # them from the public web service
+  # Represents a single NWS weather alert (warning, watch, or
+  # advisory). Use +Alert.fetch+ to retrieve active alerts from the
+  # NWS API.
   class Alert
-    attr_accessor :id, :title, :summary, :link, :alert_type, :polygon, :area,
-                  :effective_at, :expires_at, :updated_at, :published_at,
-                  :urgency, :severity, :certainty, :geocode, :vtec
+    # @!attribute id [rw] NWS alert identifier
+    # @!attribute title [rw] Alert headline
+    # @!attribute summary [rw] Full alert description text
+    # @!attribute link [rw] Canonical URL for this alert
+    # @!attribute alert_type [rw] Event type (e.g. "Tornado Warning")
+    # @!attribute polygon [rw] Alert area as a Polygon, or nil
+    # @!attribute area [rw] Human-readable area description
+    # @!attribute effective_at [rw] Time the alert takes effect
+    # @!attribute expires_at [rw] Time the alert expires
+    # @!attribute updated_at [rw] Onset time, or sent time if absent
+    # @!attribute published_at [rw] Time the alert was sent
+    # @!attribute urgency [rw] Urgency level as a Symbol
+    # @!attribute severity [rw] Severity level as a Symbol
+    # @!attribute certainty [rw] Certainty level as a Symbol
+    # @!attribute geocode [rw] Geocode with UGC and FIPS codes
+    # @!attribute vtec [rw] VTEC string, or nil
+    attr_accessor :id, :title, :summary, :link, :alert_type, :polygon,
+                  :area, :effective_at, :expires_at, :updated_at,
+                  :published_at, :urgency, :severity, :certainty,
+                  :geocode, :vtec
 
     def initialize
       self.geocode = Geocode.new
     end
 
+    # Fetches active alerts from the NWS API.
     def self.fetch(options = {})
-      client = Client.new options
+      client = Client.new(options)
       client.fetch
     end
 
-    def parse(element)
-      parse_core_attributes element
-      parse_times element
-      parse_categories element
-
-      parse_polygon element.xpath('cap:polygon').inner_text
-      parse_geocode element.xpath('cap:geocode')
-      parse_vtec element.xpath('cap:parameter')
+    # Populates this alert from a GeoJSON feature hash.
+    def parse(feature)
+      props = feature['properties']
+      parse_core_attributes(feature, props)
+      parse_times(props)
+      parse_categories(props)
+      parse_polygon(feature)
+      parse_geocode(props)
+      parse_vtec(props)
     end
 
     private
 
-    def parse_core_attributes(element)
-      self.id = element.css('id').inner_text
-      self.title = element.css('title').inner_text
-      self.summary = element.css('summary').inner_text
-      self.link = parse_link element
-      self.alert_type = element.xpath('cap:event').inner_text
-      self.area = element.xpath('cap:areaDesc').inner_text
+    def parse_core_attributes(feature, props)
+      self.id = props['id']
+      self.title = props['headline']
+      self.summary = props['description']
+      self.link = props['@id'] || feature['id']
+      self.alert_type = props['event']
+      self.area = props['areaDesc']
     end
 
-    def parse_link(element)
-      link = element.css('link').first
-      link.attributes['href'].value unless link.nil?
+    def parse_times(props)
+      self.effective_at = parse_time(props['effective'])
+      self.expires_at = parse_time(props['expires'])
+      self.published_at = parse_time(props['sent'])
+      self.updated_at = parse_time(props['onset'] || props['sent'])
     end
 
-    def parse_times(element)
-      self.updated_at = Time.parse(element.css('updated').inner_text)
-      self.published_at = Time.parse(element.css('published').inner_text)
-      self.effective_at = Time.parse(element.xpath('cap:effective').inner_text)
-      self.expires_at = Time.parse(element.xpath('cap:expires').inner_text)
+    def parse_time(value)
+      value ? Time.parse(value) : nil
     end
 
-    def parse_categories(element)
-      self.urgency = code_to_symbol element.xpath('cap:urgency').inner_text
-      self.severity = code_to_symbol element.xpath('cap:severity').inner_text
-      self.certainty = code_to_symbol element.xpath('cap:certainty').inner_text
+    def parse_categories(props)
+      self.urgency = code_to_symbol(props['urgency'])
+      self.severity = code_to_symbol(props['severity'])
+      self.certainty = code_to_symbol(props['certainty'])
     end
 
-    def parse_polygon(text)
-      return if text.empty?
-      self.polygon = Polygon.new text
+    def parse_polygon(feature)
+      geometry = feature['geometry']
+      return if geometry.nil?
+
+      coords = geometry['coordinates']
+      return if coords.nil? || coords.empty?
+
+      ring = coords.first
+      ring = ring.first if geometry['type'] == 'MultiPolygon'
+      self.polygon = Polygon.new(ring)
     end
 
-    def parse_geocode(element)
-      return if element.children.css('value').first.nil?
+    def parse_geocode(props)
+      geocode_data = props['geocode']
+      return if geocode_data.nil?
 
-      geocode.fips6 = element.children.css('value').first.inner_text
-      geocode.ugc = element.children.css('value').last.inner_text
+      ugc = geocode_data['UGC']
+      geocode.ugc = ugc&.join(' ')
+
+      fips = geocode_data['SAME']
+      geocode.fips6 = fips&.join(' ')
     end
 
-    def parse_vtec(element)
-      value = element.children.css('value').inner_text
-      self.vtec = value.empty? ? nil : value
+    def parse_vtec(props)
+      params = props['parameters']
+      return if params.nil?
+
+      vtec_values = params['VTEC']
+      self.vtec = vtec_values&.first
     end
 
     def code_to_symbol(code)
+      return :unknown if code.nil?
+
       code.tr(' ', '_').downcase.to_sym
     end
   end

data/lib/gull/client.rb

@@ -1,65 +1,80 @@
-require 'httpclient'
-require 'nokogiri'
+# frozen_string_literal: true
 
 module Gull
-  # Client exposes methods and options for fetching alerts from the NWS/NOAA
-  # web service
+  # Low-level HTTP client for the NWS alerts API. Handles
+  # fetching, parsing, and error wrapping. Most callers should
+  # use +Alert.fetch+ instead.
   class Client
+    URL = 'https://api.weather.gov/alerts/active'
+    USER_AGENT = "gull/#{VERSION} (Ruby #{RUBY_VERSION})".freeze
+
+    # Features that could not be parsed are collected here.
     attr_accessor :errors
 
     def initialize(options = {})
-      @options = {
-        url: 'http://alerts.weather.gov/cap/us.php?x=1',
-        strict: false
-      }.merge options
+      @options = options
     end
 
+    # Fetches active alerts and returns an Array of Alert objects.
     def fetch
       self.errors = []
-      content = response
-      document = Nokogiri::XML content do |config|
-        config.strict if @options[:strict]
-      end
-      process document.xpath('//xmlns:feed/xmlns:entry', namespaces)
+      json = response
+      data = JSON.parse(json)
+      process(data['features'] || [])
+    rescue JSON::ParserError
+      raise HttpError, 'Unexpected response from NWS API'
     end
 
     private
 
     def response
-      client = HTTPClient.new
-      begin
-        return client.get_content @options[:url]
-      rescue HTTPClient::TimeoutError
-        raise TimeoutError, 'Timeout while connecting to NWS web service'
-      rescue HTTPClient::KeepAliveDisconnected, HTTPClient::BadResponseError,
-             SocketError, Errno::ECONNREFUSED, Errno::ECONNRESET
-        raise HttpError, 'Could not connect to NWS web service'
+      uri = build_uri
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+      request = Net::HTTP::Get.new(uri)
+      request['User-Agent'] = USER_AGENT
+      request['Accept'] = 'application/geo+json'
+      result = http.request(request)
+      unless result.is_a?(Net::HTTPSuccess)
+        raise HttpError, "NWS API returned #{result.code}"
       end
+
+      result.body
+    rescue Net::OpenTimeout, Net::ReadTimeout
+      raise TimeoutError,
+            'Timeout while connecting to NWS web service'
+    rescue SocketError, Errno::ECONNREFUSED, Errno::ECONNRESET
+      raise HttpError,
+            'Could not connect to NWS web service'
     end
 
-    def process(entries)
-      alerts = []
-      entries.each do |entry|
-        alert = create_instance entry
-        alerts.push alert unless alert.nil?
-        errors.push entry if alert.nil?
+    def build_uri
+      uri = URI(URL)
+      if @options[:area]
+        params = URI.decode_www_form(uri.query || '')
+        params << ['area', @options[:area]]
+        uri.query = URI.encode_www_form(params)
       end
+      uri
+    end
 
+    def process(features)
+      alerts = []
+      features.each do |feature|
+        alert = create_instance(feature)
+        alerts.push(alert) unless alert.nil?
+        errors.push(feature) if alert.nil?
+      end
       alerts
     end
 
-    def create_instance(entry)
-      return if entry.xpath('cap:event').empty?
+    def create_instance(feature)
+      properties = feature['properties']
+      return if properties.nil? || properties['event'].nil?
 
       alert = Alert.new
-      alert.parse entry
+      alert.parse(feature)
       alert
     end
-
-    def namespaces
-      { 'xmlns' => 'http://www.w3.org/2005/Atom',
-        'cap' => 'urn:oasis:names:tc:emergency:cap:1.1',
-        'ha' => 'http://www.alerting.net/namespace/index_1.0' }
-    end
   end
 end

data/lib/gull/error.rb

@@ -1,6 +1,10 @@
+# frozen_string_literal: true
+
 require 'English'
 
 module Gull
+  # Raised when the NWS API returns a non-success response or the
+  # connection fails. Wraps the original exception, if any.
   class HttpError < StandardError
     attr_reader :original
 
@@ -10,6 +14,7 @@ module Gull
     end
   end
 
+  # Raised when the NWS API request times out.
   class TimeoutError < HttpError
   end
 end

data/lib/gull/geocode.rb

@@ -1,5 +1,10 @@
+# frozen_string_literal: true
+
 module Gull
+  # Holds UGC zone codes and FIPS county codes for an alert area.
   class Geocode
+    # @!attribute fips6 [rw] Space-separated FIPS 6 codes
+    # @!attribute ugc [rw] Space-separated UGC zone codes
     attr_accessor :fips6, :ugc
   end
 end