aws-data 0.0.0 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 27e8ce1b196c30054d66b267351e0eddaf1ad653
-  data.tar.gz: 10731dd7bc8e8e2edc1898d15ccc45c2f60d8e4e
+  metadata.gz: 5e475268b6b72f7eb862131e4cd37243a283d0d4
+  data.tar.gz: 8ff49f8b175a99cdd0717c6b44b0188871eb690b
 SHA512:
-  metadata.gz: 396378fe485c201d3d836367c7a0baf4da0f5b54920acbacc4ec89689198be920633a180b04e25bedb85405e566d5916b2ae77eb3c91af85389a77a5a2c56a10
-  data.tar.gz: f4ceb355dffe3e9325c9eb7a72a50600060f5b94c8bb9eee565b6cab73000a90ea4cbb944c9d4cc7f6796fe1e3f65a37eb3c16a675b4a6d06722f95fbcd96d91
+  metadata.gz: b27ad408bbe7ae779fe4a7a7e219f8fce2641e4d4069739b41b26ed6ec64bf8e914766330122afbf5b76c782f08a54403ab11dc9503e3505e4e1b1464e3ee658
+  data.tar.gz: 3b8c305c5c372d637142f27d18870ea149b96dd6b04abeb18bb2bbab7ef1f5ea51e2d430e2dd800299fdbafe704c2a0fc284573c6461ce76a766922f572ba38e

data/README.md

@@ -3,4 +3,53 @@ aws-data
 
 A rubygem for fetching data from AWS's user and metadata endpoints from ec2.
 
+### API
+
+```ruby
+
+data = AWSData::Metadata.new
+
+=begin
+
+The constructor reaches out to the network to enumerate all the endpoints.
+It'll block for a bit and then throw exceptions if you're not on EC2, or better
+still do random undefined things if someone's chosen  to make 169.254/24
+routable on your network
+
+=end
+
+data.instance-id #=> i-xxxxxxx
+
+data.methods #=>
+# ...
+# 'ami_id',
+# 'ami_launch_index',
+# 'ami_manifest_path',
+# 'block_device_mapping',
+# 'hostname',
+# 'instance_action',
+# 'instance_id',
+# 'instance_type',
+# 'kernel_id',
+# 'local_hostname',
+# 'local_ipv4',
+# 'mac',
+# 'metrics',
+# 'network',
+# 'placement',
+# 'profile',
+# 'public_hostname',
+# 'public_ipv4',
+# 'public_keys',
+# 'reservation_id',
+# ...
+
+=begin
+
+Note that some of these will return a new Transport object, eg network, which has finder methods for it's keys
+
+=end
+```
+
+
 See: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AESDG-chapter-instancedata.html

data/aws-data.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = "aws-data"
-  s.version     = "0.0.0"
+  s.version     = "0.1.0"
   s.authors     = ["Richo Healey"]
   s.email       = ["richo@psych0tik.net"]
   s.homepage    = "http://github.com/richo/aws-data"

data/lib/aws-data.rb

@@ -1,5 +1,7 @@
 %w[
   aws-data/transport
+
+  aws-data/base
   aws-data/metadata
 ].each do |f|
   require File.expand_path("../#{f}", __FILE__)

data/lib/aws-data/base.rb

@@ -0,0 +1,72 @@
+module AWSData
+
+  Record = Struct.new("Record", :name, :finder)
+
+  class Base
+
+    class << self
+      @base_path = nil
+      def base_path(path)
+        @base_path = path
+      end
+
+      def _base_path
+        @base_path
+      end
+    end
+
+    def initialize
+      # Setup the finders, or throw an exception if their IP isn't routable
+      unless self.class._base_path
+        raise "Can't instanciate without a base_path"
+      end
+
+      methods = parse_endpoint_data(transport.get(self.class._base_path))
+
+      methods.each do |m|
+        method_name = m.name.gsub(/-/, "_").to_sym
+        if m.finder
+          eigenclass.send(:define_method, method_name) do
+            Finder.new("#{self.class._base_path}/#{m.name}/")
+          end
+        else
+          eigenclass.send(:define_method, method_name) do
+            transport.get("#{self.class._base_path}/#{m.name}")
+          end
+        end
+      end
+    end
+
+    def transport
+      @transport ||= Transport.new
+    end
+
+    def parse_endpoint_data(data)
+      ret = []
+      data.split("\n").each do |el|
+        if el.end_with? "/"
+          el.gsub!(/\/$/, "")
+          ret << Record.new(el, true)
+        else
+          ret << Record.new(el, false)
+        end
+      end
+      return ret
+    end
+
+    def eigenclass
+      class << self
+        self
+      end
+    end
+
+  end
+
+  class Finder
+    def self.new(path)
+      Class.new(Base) do
+        base_path(path)
+      end.new
+    end
+  end
+end

data/lib/aws-data/metadata.rb

@@ -1,12 +1,7 @@
 module AWSData
-  class Metadata
+  class Metadata < Base
 
-    def latest
-      transport.get("/latest/meta-data")
-    end
+    base_path "/latest/meta-data/"
 
-    def transport
-      @transport ||= Transport.new
-    end
   end
 end

data/lib/aws-data/transport.rb

@@ -1,15 +1,20 @@
 require 'net/http'
 
 module AWSData
+  class EndpointUnavailable < Exception
+  end
+
   class Transport
 
+    ENDPOINT_IP = "169.254.169.254"
+
     def get(path)
       uri = uri_for(path)
       res = Net::HTTP.get_response(uri)
       if res.is_a?(Net::HTTPSuccess)
-        return JSON.parse(res.body)
+        return res.body
       else
-        raise "oops"
+        raise EndpointUnavailable
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-data
 version: !ruby/object:Gem::Version
-  version: 0.0.0
+  version: 0.1.0
 platform: ruby
 authors:
 - Richo Healey
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-05 00:00:00.000000000 Z
+date: 2013-12-06 00:00:00.000000000 Z
 dependencies: []
 description: Fetch instance data from AWS
 email:
@@ -20,6 +20,7 @@ files:
 - README.md
 - aws-data.gemspec
 - lib/aws-data.rb
+- lib/aws-data/base.rb
 - lib/aws-data/metadata.rb
 - lib/aws-data/transport.rb
 homepage: http://github.com/richo/aws-data