flightstats-flex 0.1.0

data/lib/flightstats/flight_durations.rb

@@ -0,0 +1,9 @@
+module FlightStats
+  class FlightDurations < Resource
+    attr_accessor :scheduled_block_minutes,
+                  :scheduled_air_minutes,
+                  :scheduled_taxi_out_minutes,
+                  :taxi_out_minutes,
+                  :scheduled_taxi_in_minutes
+  end
+end

data/lib/flightstats/flight_equipment.rb

@@ -0,0 +1,6 @@
+module FlightStats
+  class FlightEquipment < Resource
+    attr_accessor :scheduled_equipment_iata_code,
+                  :actual_equipment_iata_code
+  end
+end

data/lib/flightstats/flight_id.rb

@@ -0,0 +1,6 @@
+module FlightStats
+  class FlightId < Resource
+    attr_accessor :requested,
+                  :interpreted
+  end
+end

data/lib/flightstats/flight_leg.rb

@@ -0,0 +1,25 @@
+module FlightStats
+  class FlightLeg < Resource
+    attr_accessor :departure_airport_fs_code,
+                  :arrival_airport_fs_code,
+                  :departure_time,
+                  :arrival_time,
+                  :departure_date_adjustment,
+                  :arrival_date_adjustment,
+                  :departure_terminal,
+                  :arrival_terminal,
+                  :flight_number,
+                  :codeshare,
+                  :equipment_codes,
+                  :distance_miles,
+                  :flight_duration_minutes,
+                  :layover_duration_minutes,
+                  :operator,
+                  :carrier_fs_code,
+                  :wetlease_info
+
+    def to_s
+      "#{operator ? operator.carrier_fs_code : carrier_fs_code}#{flight_number}: #{departure_airport_fs_code} at #{departure_time} - #{arrival_airport_fs_code} at #{arrival_time} (+#{arrival_date_adjustment}) #{distance_miles} miles"
+    end
+  end
+end

data/lib/flightstats/flight_plan_planned_arrival.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class FlightPlanPlannedArrival < AbstractDate
+  end
+end

data/lib/flightstats/flight_plan_planned_departure.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class FlightPlanPlannedDeparture < AbstractDate
+  end
+end

data/lib/flightstats/flight_status.rb

@@ -0,0 +1,50 @@
+module FlightStats
+  class FlightStatus < Resource
+    attr_accessor :flight_id,
+                  :carrier_fs_code,
+                  :flight_number,
+                  :departure_airport_fs_code,
+                  :arrival_airport_fs_code,
+                  :departure_date,
+                  :arrival_date,
+                  :status,
+                  :schedule,
+                  :operational_times,
+                  :codeshares,
+                  :flight_durations,
+                  :airport_resources,
+                  :flight_equipment
+
+    @@base_path = "/flex/flightstatus/rest/v2/json"
+
+    class << self
+      def by_flight_id(flight_id, options = {})
+        from_response API.get("#{base_path}/flight/status/#{flight_id}", {}, options), 'flightStatus'
+      end
+
+      def departing_on(carrier, flight_number, year, month, day, options = {})
+        from_response API.get("#{base_path}/flight/status/#{carrier}/#{flight_number}/dep/#{year}/#{month}/#{day}", {}, options), 'flightStatuses'
+      end
+
+      def arriving_on(carrier, flight_number, year, month, day, options = {})
+        from_response API.get("#{base_path}/flight/status/#{carrier}/#{flight_number}/arr/#{year}/#{month}/#{day}", {}, options), 'flightStatuses'
+      end
+
+      def track_by_flight_id(flight_id, options = {})
+        from_response API.get("#{base_path}/flight/track/#{flight_id}", {}, options), 'flightTrack'
+      end
+
+      def track_arriving_on(carrier, flight_number, year, month, day, options = {})
+        from_response API.get("#{base_path}/flight/tracks/#{carrier}/#{flight_number}/arr/#{year}/#{month}/#{day}", {}, options), 'flightTracks'
+      end
+
+      def track_departing_on(carrier, flight_number, year, month, day, options = {})
+        from_response API.get("#{base_path}/flight/tracks/#{carrier}/#{flight_number}/dep/#{year}/#{month}/#{day}", {}, options), 'flightTracks'
+      end
+
+      def base_path
+        @@base_path
+      end
+    end
+  end
+end

data/lib/flightstats/helper.rb

@@ -0,0 +1,52 @@
+module FlightStats
+  module Helper
+    def camelize underscored_word
+      underscored_word.to_s.gsub(/(?:^|_)(.)/) { $1.upcase }
+    end
+
+    def classify value
+      camelize value.to_s.sub(/.*\./, '')
+    end
+
+    def demodulize class_name_in_module
+      class_name_in_module.to_s.sub(/^.*::/, '')
+    end
+
+    def pluralize word
+      word.to_s.sub(/([^s])$/, '\1s')
+    end
+
+    def singularize word
+      if word.to_s =~ /ses$/
+        word.to_s.sub(/es$/, '')
+      else
+        word.to_s.sub(/s$/, '').sub(/ie$/, 'y')
+      end
+    end
+
+    def underscore camel_cased_word
+      word = camel_cased_word.to_s.dup
+      word.gsub!(/::/, '/')
+      word.gsub!(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+      word.gsub!(/([a-z\d])([A-Z])/, '\1_\2')
+      word.tr! "-", "_"
+      word.downcase!
+      word
+    end
+
+    def hash_with_indifferent_read_access base = {}
+      indifferent = Hash.new { |hash, key| hash[key.to_s] if key.is_a? Symbol }
+      base.each_pair { |key, value| indifferent[key.to_s] = value }
+      indifferent
+    end
+
+    def stringify_keys! hash
+      hash.keys.each do |key|
+        stringify_keys! hash[key] if hash[key].is_a? Hash
+        hash[key.to_s] = hash.delete key if key.is_a? Symbol
+      end
+    end
+
+    extend self
+  end
+end

data/lib/flightstats/operational_times.rb

@@ -0,0 +1,16 @@
+module FlightStats
+  class OperationalTimes < Resource
+    attr_accessor :published_departure,
+                  :published_arrival,
+                  :scheduled_gate_departure,
+                  :estimated_gate_departure,
+                  :actual_gate_departure,
+                  :flight_plan_planned_departure,
+                  :estimated_runway_departure,
+                  :actual_runway_departure,
+                  :scheduled_gate_arrival,
+                  :estimated_gate_arrival,
+                  :flight_plan_planned_arrival,
+                  :estimated_runway_arrival
+  end
+end

data/lib/flightstats/operator.rb

@@ -0,0 +1,5 @@
+module FlightStats
+  class Operator < Resource
+    attr_accessor :carrier_fs_code
+  end
+end

data/lib/flightstats/published_arrival.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class PublishedArrival < AbstractDate
+  end
+end

data/lib/flightstats/published_departure.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class PublishedDeparture < AbstractDate
+  end
+end

data/lib/flightstats/resource.rb

@@ -0,0 +1,108 @@
+require 'date'
+require 'json'
+
+module FlightStats
+  class Resource
+    class << self
+      # Instantiates a record from an HTTP response.
+      #
+      # @return [Resource]
+      # @param response [Net::HTTPResponse]
+      # @param response_key [String]
+      def from_response response, response_key=nil
+        record = from_json response.body, response_key
+        record.instance_eval { @etag, @response = response['ETag'], response }
+        record
+      end
+
+      # Instantiates a record from a JSON blob.
+      #
+      # @return [Resource]
+      # @param json [String]
+      # @param response_key [String]
+      # @see from_response
+      def from_json json, response_key
+        model = nil
+        raw = JSON.parse(json)
+        response_key ? from_parsed_json(raw[response_key], response_key) : raw
+      end
+
+      # Given a string (key in the response json), find the right model.
+      #
+      # @return [Resource] class corresponding to the string, nil if no model is associated with it
+      # @param model_string [String]
+      # @see from_response
+      def string_to_model(model_string)
+        return nil if model_string.nil?
+        begin
+          class_name = Helper.classify(model_string)
+          FlightStats.const_get(class_name)
+        rescue NameError => e
+          # FlightStats.logger.warn e
+          nil
+        end
+      end
+
+      def from_parsed_json(json, model_string)
+        if json.is_a? Array
+          value = []
+          json.each do |one_value|
+            value << from_parsed_json(one_value, model_string)
+          end
+          value
+        else
+          model = nil
+          # See if it's a series of objects (e.g. schedules)
+          model = string_to_model(Helper.singularize(model_string))
+          model = string_to_model(model_string) if model.nil?
+
+          if !model.nil? and !json.is_a? Hash
+            json
+          else
+            model.nil? ? json : model.send("new", json)
+          end
+        end
+      end
+    end
+
+    # @return [Hash] The raw hash of record attributes.
+    attr_reader :attributes
+
+    # @return [Net::HTTPResponse, nil] The most recent response object for the record.
+    attr_reader :response
+
+    # @return [String, nil] An ETag for the current record.
+    attr_reader :etag
+
+    # @return [String, nil] A writer to override the URI the record saves to.
+    attr_writer :uri
+
+    # @return [Resource] A new resource instance.
+    # @param attributes [Hash] A hash of attributes.
+    def initialize attributes = {}
+      if instance_of? Resource
+        raise Error, "#{self.class} is an abstract class and cannot be instantiated"
+      end
+
+      @attributes, @uri, @href = {}, false, false
+      self.attributes = attributes
+      yield self if block_given?
+    end
+
+    # Apply a given hash of attributes to an object.
+    #
+    # @return [Hash]
+    # @param attributes [Hash] A hash of attributes.
+    def attributes= attributes = {}
+      return if attributes.nil?
+      attributes.each_pair { |k, v|
+        value = FlightStats::Resource.from_parsed_json(v, k)
+        respond_to?(name = "#{Helper.underscore k}=") and send(name, value)
+      }
+    end
+
+    def to_param
+      self[self.class.param_name]
+    end
+  end
+end

data/lib/flightstats/schedule.rb

@@ -0,0 +1,7 @@
+module FlightStats
+  class Schedule < Resource
+    attr_accessor :flight_type,
+                  :service_classes,
+                  :restrictions
+  end
+end

data/lib/flightstats/scheduled_gate_arrival.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class ScheduledGateArrival < AbstractDate
+  end
+end

data/lib/flightstats/scheduled_gate_departure.rb

@@ -0,0 +1,4 @@
+module FlightStats
+  class ScheduledGateDeparture < AbstractDate
+  end
+end

data/lib/flightstats/version.rb

@@ -0,0 +1,17 @@
+module FlightStats
+  module Version
+    MAJOR   = 0
+    MINOR   = 1
+    PATCH   = 0
+    PRE     = nil
+
+    VERSION = [MAJOR, MINOR, PATCH, PRE].compact.join('.').freeze
+
+    class << self
+      def inspect
+        VERSION.dup
+      end
+      alias to_s inspect
+    end
+  end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: flightstats-flex
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- DidItClear
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.12.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.6
+description: ! 'An API client library for FlightStats Flex: http://flightstats.com'
+email: didyourupgradeclear@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README.md
+files:
+- lib/flightstats/abstract_date.rb
+- lib/flightstats/actual_gate_departure.rb
+- lib/flightstats/actual_runway_departure.rb
+- lib/flightstats/airline.rb
+- lib/flightstats/airport.rb
+- lib/flightstats/airport_resources.rb
+- lib/flightstats/api/errors.rb
+- lib/flightstats/api/net_http_adapter.rb
+- lib/flightstats/api.rb
+- lib/flightstats/appendix.rb
+- lib/flightstats/arrival_date.rb
+- lib/flightstats/codeshare.rb
+- lib/flightstats/departure_date.rb
+- lib/flightstats/equipment.rb
+- lib/flightstats/estimated_gate_arrival.rb
+- lib/flightstats/estimated_gate_departure.rb
+- lib/flightstats/estimated_runway_arrival.rb
+- lib/flightstats/estimated_runway_departure.rb
+- lib/flightstats/extended_options.rb
+- lib/flightstats/flight.rb
+- lib/flightstats/flight_durations.rb
+- lib/flightstats/flight_equipment.rb
+- lib/flightstats/flight_id.rb
+- lib/flightstats/flight_leg.rb
+- lib/flightstats/flight_plan_planned_arrival.rb
+- lib/flightstats/flight_plan_planned_departure.rb
+- lib/flightstats/flight_status.rb
+- lib/flightstats/helper.rb
+- lib/flightstats/operational_times.rb
+- lib/flightstats/operator.rb
+- lib/flightstats/published_arrival.rb
+- lib/flightstats/published_departure.rb
+- lib/flightstats/resource.rb
+- lib/flightstats/schedule.rb
+- lib/flightstats/scheduled_gate_arrival.rb
+- lib/flightstats/scheduled_gate_departure.rb
+- lib/flightstats/version.rb
+- lib/flightstats.rb
+- README.md
+homepage: https://github.com/diditclear/flightstats-client-ruby
+licenses:
+- MIT
+post_install_message: 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -872591453760459958
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -872591453760459958
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: FlightStats Flex API Client
+test_files: []