metar-parser 0.9.9 → 0.9.10

data/{README.rdoc → README.md}

@@ -1,25 +1,47 @@
-= metar - Downloads and parses weather status
+metar - Downloads and parses weather status
+===========================================
 
 The information comes from the National Oceanic and Atmospheric Association's raw data source.
 
-= Implementation
+Implementation
+==============
 
 * Parses METAR strings using a state machine.
 
-= Example
+Usage
+=====
+
+```ruby
+require 'rubygems' if RUBY_VERSION < '1.9'
+require 'metar'
+```
+
+Examples
+========
+
+Hello World
+-----------
 
 This prints the latest weather report for Portland International Airport:
 
-require 'rubygems'
-require 'metar'
+```ruby
+station = Metar::Station.find_by_cccc( 'KPDX' )
+puts station.report.to_s
+```
+
+Countries
+---------
 
-raw    = Metar::Raw.new( 'KPDX' )
-parser = Metar::Parser.new( raw )
-report = Metar::Report.new( parser )
+```ruby
+# List countries:
+puts Metar::Station.countries
 
-puts report.to_s
+# Find a country's weather stations:
+spanish = Metar::Station.find_all_by_country( 'Spain' )
+```
 
-= Data format descrition
+The METAR Data Format
+=====================
 
 * WMO
   * http://www.wmo.int/pages/prog/www/WMOCodes/Manual/Volume-I-selection/Sel2.pdf (pages 27-38)
@@ -32,7 +54,11 @@ puts report.to_s
   * http://weather.cod.edu/notes/metar.html
   * http://www.met.tamu.edu/class/METAR/metar-pg3.html - incomplete
 
-= Other software
+Alternative Software
+====================
+
+Ruby
+----
 
 Other Ruby libraries offering METAR parsing:
 * ruby-metar - http://github.com/brandonh/ruby-metar
@@ -46,8 +72,10 @@ There are two gems which read the National Oceanic and Atmospheric Association's
 Interactive map:
 * http://www.spatiality.at/metarr/frontend/
 
-= Testing
+Testing
+=======
 
 The tests use a local copy of the weather stations list: data/nsd_cccc.txt
 
 If missing, the file gets downloaded before running tests.
+

data/lib/metar/station.rb

@@ -1,5 +1,6 @@
 require 'rubygems' if RUBY_VERSION < '1.9'
 require 'open-uri'
+require 'set'
 
 # A Station can be created without downloading data from the Internet.
 # The class downloads and caches the NOAA station list when it is first requested.
@@ -31,11 +32,15 @@ module Metar
         end
       end
 
+      def countries
+        all_structures.reduce( Set.new ) { |a, s| a.add( s[ :country ] ); a }
+      end
+
       def all
         all_structures.collect do |h|
           options = h.clone
-          cccc = options.delete(:cccc)
-          new(cccc, h)
+          cccc    = options.delete(:cccc)
+          new(cccc, options)
         end
       end
 
@@ -44,6 +49,10 @@ module Metar
         not find_data_by_cccc(cccc).nil?
       end
 
+      def find_all_by_country( country )
+        all.select { | s | s.country == country }
+      end
+
       def find_by_cccc(cccc)
         all.find { |station| station.cccc == cccc }
       end
@@ -114,6 +123,12 @@ module Metar
       Station.exist?(@cccc)
     end
 
+    def report
+      raw    = Metar::Raw.new( @cccc )
+      parser = Metar::Parser.new( raw )
+      Metar::Report.new( parser )
+    end
+
     private
 
     class << self

data/lib/metar/version.rb

@@ -3,7 +3,7 @@ module Metar
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 9
-    TINY  = 9
+    TINY  = 10
 
     STRING = [ MAJOR, MINOR, TINY ].join( '.' )
   end

metadata

@@ -1,113 +1,148 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: metar-parser
-version: !ruby/object:Gem::Version
-  version: 0.9.9
+version: !ruby/object:Gem::Version 
+  hash: 47
   prerelease: 
+  segments: 
+  - 0
+  - 9
+  - 10
+  version: 0.9.10
 platform: ruby
-authors:
+authors: 
 - Joe Yates
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-12-08 00:00:00.000000000 +00:00
-default_executable: 
-dependencies:
-- !ruby/object:Gem::Dependency
+
+date: 2012-05-11 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  prerelease: false
   name: rake
-  requirement: &2156238740 !ruby/object:Gem::Requirement
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 49
+        segments: 
+        - 0
+        - 8
+        - 7
         version: 0.8.7
+  requirement: *id001
   type: :runtime
+- !ruby/object:Gem::Dependency 
   prerelease: false
-  version_requirements: *2156238740
-- !ruby/object:Gem::Dependency
   name: i18n
-  requirement: &2156237980 !ruby/object:Gem::Requirement
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 25
+        segments: 
+        - 0
+        - 3
+        - 5
         version: 0.3.5
+  requirement: *id002
   type: :runtime
+- !ruby/object:Gem::Dependency 
   prerelease: false
-  version_requirements: *2156237980
-- !ruby/object:Gem::Dependency
   name: aasm
-  requirement: &2156237220 !ruby/object:Gem::Requirement
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 1
+        segments: 
+        - 2
+        - 1
+        - 5
         version: 2.1.5
+  requirement: *id003
   type: :runtime
+- !ruby/object:Gem::Dependency 
   prerelease: false
-  version_requirements: *2156237220
-- !ruby/object:Gem::Dependency
   name: m9t
-  requirement: &2156236000 !ruby/object:Gem::Requirement
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
+    requirements: 
     - - ~>
-      - !ruby/object:Gem::Version
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 0
+        - 2
+        - 3
         version: 0.2.3
+  requirement: *id004
   type: :runtime
-  prerelease: false
-  version_requirements: *2156236000
-description: A Ruby library which handle METAR weather reports. Provides weather station
-  listings and info. Downloads and parses reports. Presents localized full text reports
+description: A Ruby library which handle METAR weather reports. Provides weather station listings and info. Downloads and parses reports. Presents localized full text reports
 email: joe.g.yates@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
-- README.rdoc
+
+files: 
+- README.md
 - COPYING
 - Rakefile
 - bin/download_raw.rb
 - bin/parse_raw.rb
+- lib/metar.rb
 - lib/metar/data.rb
+- lib/metar/station.rb
 - lib/metar/parser.rb
-- lib/metar/raw.rb
 - lib/metar/report.rb
-- lib/metar/station.rb
 - lib/metar/version.rb
-- lib/metar.rb
-- test/all_tests.rb
+- lib/metar/raw.rb
 - test/metar_test_helper.rb
 - test/unit/data_test.rb
 - test/unit/parser_test.rb
-- test/unit/raw_test.rb
 - test/unit/report_test.rb
 - test/unit/station_test.rb
-- locales/en.yml
+- test/unit/raw_test.rb
+- test/all_tests.rb
 - locales/it.yml
-has_rdoc: true
+- locales/en.yml
 homepage: http://github.com/joeyates/metar-parser
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: nowarning
-rubygems_version: 1.6.2
+rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: A Ruby library for METAR weather reports
-test_files:
+test_files: 
 - test/all_tests.rb