aws-instmd 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: edc15ee2fa3f841c42e33bc67f8319bf61ea9b9a
+  data.tar.gz: 4cbf4b6966c05600ec4cc54b4ffb5288f6bbc8a4
+SHA512:
+  metadata.gz: 9e90c96d4a01b4ed270fe373efe4f75668454042112902c61182203ebe9fbf4ec8f76f23c2994ca7f8911b438091c9f58851b72110b1db8c3a906daf08f52631
+  data.tar.gz: 602a47c9c23936765fa905cb0155ca4b801d7456913099f15ee0c0d2913960db413783d6fff4c9446b43f123fe68cfc51f7a9f7c0ce2d93c49203f6ec8a3b4e3

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,49 @@
+# AWS::InstMD
+
+AWS::InstMD exposes the instance metadata information through a Ruby API.
+
+## Why?
+
+169.254.169.254 does not offer a simple view of the whole instance metadata,
+and querying the whole tree can be a bit quirky.
+
+We wanted to solve that problem once and for all, expose it in a straightforward
+and maintainable way.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'aws-instmd'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install aws-instmd
+
+## Usage
+
+### Command-line utility
+
+`awsinstmd` will dump the metadata in JSON.
+
+### Ruby API
+
+The Ruby gem should be easy to use (feedback is obviously welcome).
+
+Documentation should be improved; in the meantime, here is a simple example:
+
+    require 'aws/instmd'
+    puts AWS::InstMD.meta_data.instance_id
+    puts AWS::InstMD.meta_data.instance_type
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs = %w[lib test]
+  t.test_files = FileList['test/**/test*.rb']
+end
+
+desc 'Run tests'
+task :default => :test

data/aws-instmd.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path '../lib', __FILE__
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include? lib
+
+require 'aws/instmd/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'aws-instmd'
+  spec.version       = AWS::InstMD::VERSION
+  spec.authors       = ['Pierre Carrier']
+  spec.email         = ['pierre@gcarrier.fr']
+  spec.description   = 'AWS instance metadata client'
+  spec.summary       = 'Query the entire 169.254.169.254 tree in seconds'
+  spec.homepage      = 'https://github.com/airbnb/gem-aws-instmd'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split $/
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename f }
+  spec.test_files    = spec.files.grep %r{^(test|spec|features)/}
+  spec.require_paths = %w[lib]
+
+  spec.add_dependency 'json'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'rake'
+end

data/bin/awsinstmd

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'aws/instmd'
+require 'json'
+
+puts JSON::pretty_generate AWS::InstMD.to_hash

data/lib/aws/instmd.rb

@@ -0,0 +1,71 @@
+require 'net/http'
+
+module AWS
+  class InstMD
+    def self.method_missing name, *args, &block
+      @@root ||= InstMD.new
+      @@root.method(name).call(*args, &block)
+    end
+
+    # Can't be the first one to make that pun.
+    # Still proud.
+    class Hashish < Hash
+      def method_missing name
+        self[name.to_s.gsub('_', '-')]
+      end
+    end
+
+    class Treeish < Hashish
+      private
+      def initialize http, prefix
+        entries = InstMD.query http, prefix
+        entries.lines.each do |l|
+          l.chomp!
+          if l.end_with? '/'
+            self[l[0..-2]] = Treeish.new http, "#{prefix}#{l}"
+          # meta-data/public-keys/ entries have a '0=foo' format
+          elsif l =~ /(\d+)=(.*)/
+            number, name = $1, $2
+            self[name] = Treeish.new http, "#{prefix}#{number}/"
+          else
+            self[l] = InstMD.query http, "#{prefix}#{l}"
+          end
+        end
+      end
+    end
+
+    attr_accessor :user_data, :meta_data, :dynamic
+
+    # Amazon, Y U NO trailing slash entries
+    # in /, /$version and /$version/dynamic/??
+    # There is waaay too much code here.
+    def initialize version='latest', host='169.254.169.254', port='80'
+      http = Net::HTTP.new host, port
+      @meta_data = Treeish.new http, "/#{version}/meta-data/"
+      @user_data = InstMD.query http, "/#{version}/user-data"
+      @dynamic = Hashish.new
+
+      begin
+        dynamic_stuff = InstMD.query(http, "/#{version}/dynamic/").lines
+      rescue
+        dynamic_stuff = []
+      end
+      dynamic_stuff.each do |e|
+        e = e.chomp.chomp '/'
+        @dynamic[e] = Treeish.new http, "/#{version}/dynamic/#{e}/"
+      end
+    end
+
+    def self.query http, path
+      rep = http.request Net::HTTP::Get.new path
+      unless Net::HTTPOK === rep
+        raise Net::HTTPBadResponse, "#{rep.code} #{path}"
+      end
+      rep.body
+    end
+
+    def to_hash
+      {:meta_data => @meta_data, :user_data => @user_data, :dynamic => @dynamic}
+    end
+  end
+end

data/lib/aws/instmd/version.rb

@@ -0,0 +1,5 @@
+module AWS
+  class InstMD
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: aws-instmd
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Pierre Carrier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  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'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: AWS instance metadata client
+email:
+- pierre@gcarrier.fr
+executables:
+- awsinstmd
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- README.md
+- Rakefile
+- aws-instmd.gemspec
+- bin/awsinstmd
+- lib/aws/instmd.rb
+- lib/aws/instmd/version.rb
+homepage: https://github.com/airbnb/gem-aws-instmd
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: Query the entire 169.254.169.254 tree in seconds
+test_files: []
+has_rdoc: