gce-metadata 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 27f28122ea5e757ba54cdb09284ce4239dc52ae0
+  data.tar.gz: d63f87fd7de36b51b1f7c269aa7d0a75947ba5e9
+SHA512:
+  metadata.gz: 5bbf27f6fffd59010a3d287b8187e565a15a0f538dda9426d18825929f817f4c703d54acedd66d21ac901bae9716762b4fc0e7277988204c47d93367da187606
+  data.tar.gz: 5935c97005443167ccacf3f1c06a3fca275e6250f1549f5c3e9da05b20650cd96b87600185cf1c887a3474536446a30a33123dcf7d50a0a26dde359391f29cc9

data/.gitignore

@@ -0,0 +1,35 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+.ruby-version
+.ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+*.iml

data/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Builds all packages" fullCmd="build" taksId="build" /><RakeTask description="Spawns an Interactive Ruby Console" fullCmd="console" taksId="console" /><RakeTask description="Installs all built gem packages" fullCmd="install" taksId="install" /><RakeTask description="Performs a release" fullCmd="release" taksId="release" /><RakeTask description="Run RSpec code examples" fullCmd="spec" taksId="spec" /><RakeGroup description="" fullCmd="" taksId="build"><RakeTask description="" fullCmd="build:gce_metadata" taksId="gce_metadata" /><RakeTask description="" fullCmd="build:gem" taksId="gem" /><RakeGroup description="" fullCmd="" taksId="gem"><RakeTask description="" fullCmd="build:gem:gce_metadata" taksId="gce_metadata" /></RakeGroup></RakeGroup><RakeGroup description="" fullCmd="" taksId="console"><RakeTask description="" fullCmd="console:gce_metadata" taksId="gce_metadata" /></RakeGroup><RakeTask description="" fullCmd="default" taksId="default" /><RakeTask description="" fullCmd="gem" taksId="gem" /><RakeGroup description="" fullCmd="" taksId="install"><RakeTask description="" fullCmd="install:gce_metadata" taksId="gce_metadata" /></RakeGroup><RakeTask description="" fullCmd="install_gem" taksId="install_gem" /><RakeTask description="" fullCmd="package" taksId="package" /><RakeTask description="" fullCmd="pkg" taksId="pkg" /><RakeTask description="" fullCmd="pkg/gce_metadata-0.1.0.gem" taksId="pkg/gce_metadata-0.1.0.gem" /><RakeTask description="" fullCmd="publish" taksId="publish" /><RakeTask description="" fullCmd="push" taksId="push" /><RakeGroup description="" fullCmd="" taksId="push"><RakeTask description="" fullCmd="push:gce_metadata" taksId="gce_metadata" /></RakeGroup><RakeGroup description="" fullCmd="" taksId="scm"><RakeTask description="" fullCmd="scm:push" taksId="push" /><RakeTask description="" fullCmd="scm:status" taksId="status" /><RakeTask description="" fullCmd="scm:tag" taksId="tag" /></RakeGroup><RakeTask description="" fullCmd="test" taksId="test" /><RakeTask description="" fullCmd="validate" taksId="validate" /></RakeGroup></Settings>

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2

data/ChangeLog.md

@@ -0,0 +1,4 @@
+### 0.1.0 / 2016-02-03
+
+* Initial release:
+

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org' do
+
+	gemspec
+
+end

data/Gemfile.lock

@@ -0,0 +1,41 @@
+PATH
+  remote: .
+  specs:
+    gce-metadata (0.1.1)
+      awesome_print
+      ec2-metadata (~> 0.2, >= 0.2.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    awesome_print (1.6.1)
+    diff-lcs (1.2.5)
+    ec2-metadata (0.2.2)
+    rake (10.5.0)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.2)
+      rspec-support (~> 3.4.0)
+    rspec-expectations (3.4.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-mocks (3.4.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.1)
+    rubygems-tasks (0.2.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.10)!
+  gce-metadata!
+  rake (~> 10.0)!
+  rspec (~> 3.0)!
+  rubygems-tasks (~> 0.2)!
+
+BUNDLED WITH
+   1.11.2

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2015, DLD Internet, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,61 @@
+# gce-metadata
+
+## Install
+ $ [sudo] gem install gce-metadata
+
+## As ruby library
+gce-metadata provides a way to access meta-data and user-data on GCE instance. 
+
+ GCEMetadata[:instance_id]
+ GCEMetadata['instance_id']
+ GCEMetadata[:'instance-id']
+ GCEMetadata['instance-id']
+
+If you want to specify API version, you can get data like this:
+ GCEMetadata['1.0'][:instance_id]
+
+If you can also get it like this:
+ GCEMetadata['1.0']['meta-data'][:instance_id]
+
+For more detail, see also:
+http://github.com/akm/gce-metadata/blob/master/spec/introduction_spec.rb
+
+
+## As a command
+gce-metadata shows various meta-data and user-data
+ $ gce-metadata
+
+For more detail, type 
+ $ gce-metadata -h
+
+
+## Dummy YAML
+If you want to access meta-data or user-data not on GCE Instance like on it,
+make one of these files
+ ./config/gce_metadata.yml
+ ./gce_metadata.yml
+ ~/gce_metadata.yml
+ /etc/gce_metadata.yml
+
+Dummy YAML file must be like output of gce-metadata on GCE instance.
+You can export it on GCE instance like this:
+ $ gce-medatata > gce_metadata.yml
+ $ cp gce_metadata.yml /path/to/dir/for/non/gce/instance
+
+Or if you don't have GCE instance, you can get an example by
+ $ gce-metadata -d
+
+
+## Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Copyright
+
+Copyright (c) 2015 DLD Internet, Inc. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'rubygems'
+
+begin
+  require 'bundler/setup'
+rescue LoadError => e
+  abort e.message
+end
+
+require 'rake'
+
+
+require 'rubygems/tasks'
+Gem::Tasks.new
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+
+task :test    => :spec
+task :default => :spec

data/gce_metadata.gemspec

@@ -0,0 +1,39 @@
+# -*- encoding: utf-8 -*-
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gce_metadata/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "gce-metadata"
+  gem.version       = GCEMetadata::VERSION
+  gem.summary       = %q{gce-metadata provides access to GCE instance metadata}
+  gem.description   = %q{gce-metadata provides access to GCE instance metadata.}
+  gem.license       = "MIT"
+  gem.authors       = ["Christo De Lange"]
+  gem.email         = "rubygems@dldinternet.com"
+  gem.homepage      = "http://github.com/dldinternet/gce-metadata"
+
+  gem.files         = `git ls-files`.split($/)
+
+  `git submodule --quiet foreach --recursive pwd`.split($/).each do |submodule|
+    submodule.sub!("#{Dir.pwd}/",'')
+
+    Dir.chdir(submodule) do
+      `git ls-files`.split($/).map do |subpath|
+        gem.files << File.join(submodule,subpath)
+      end
+    end
+  end
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_dependency 							'ec2-metadata', '~> 0.2', '>= 0.2.2'
+	gem.add_dependency              'awesome_print'                       #, '~> 1.2'
+
+  gem.add_development_dependency 	'bundler', '~> 1.10'
+  gem.add_development_dependency 	'rake', '~> 10.0'
+  gem.add_development_dependency 	'rspec', '~> 3.0'
+  gem.add_development_dependency 	'rubygems-tasks', '~> 0.2'
+end

data/lib/gce_metadata/base.rb

@@ -0,0 +1,140 @@
+require 'gce_metadata'
+
+module GCEMetadata
+  class Base
+
+    attr_reader :path
+    attr_reader :default_child_key
+    
+    def initialize(path, default_child_key = nil)
+      @path = path
+      @default_child_key = default_child_key
+    end
+
+    def children
+      @children ||= {}
+    end
+    
+    def child_keys
+      unless defined?(@child_keys)
+        lines = GCEMetadata.get("#{path}").split(/$/).map(&:strip).select{|l| not (l.nil? or l.empty?)} # .map{|l| l.gsub!(%r'/$','')}
+				leaves = lines.select{|line| line =~ %r'[^/]$'}
+				@child_keys = lines
+        if leaves.size > 0
+          @child_names = {}
+          leaves.each do |key|
+						name = get(key)
+						name = name.match(/^\[.*?\]$/) ? (eval name rescue name) : name
+            @child_names[key] = name
+          end
+        end
+      end
+      @child_keys
+    end
+    alias_method :keys, :child_keys
+
+    def get(child_key)
+      logging("#{self.class.name}.get(#{child_key.inspect})") do
+        child_key = GCEMetadata.formalize_key(child_key)
+        if children.has_key?(child_key)
+          result = children[child_key]
+        else
+          if is_child_key?(child_key)
+            result = is_struct?(child_key) ?
+              new_child(child_key) :
+              GCEMetadata.get("#{path}#{child_key}")
+						unless result
+							if is_child_key?("#{child_key}/")
+								child_key = "#{child_key}/"
+								result = is_struct?(child_key) ?
+										new_child(child_key) :
+										GCEMetadata.get("#{path}#{child_key}")
+							end
+						end
+          else
+            raise NotFoundError, "#{path}#{child_key} not found as default key" if @getting_default_child
+            raise NotFoundError, "#{path}#{child_key} not found" unless default_child
+            result = default_child.get(child_key)
+          end
+          children[child_key] = result
+        end
+        result
+      end
+    end
+    alias_method :[], :get
+
+    def is_child_key?(key)
+      exp = /^#{key.gsub(%r'([^/])$', '\1/')}?$/
+      child_keys.any?{|child_key| child_key =~ exp}
+    end
+
+    def is_struct?(child_key)
+      k = GCEMetadata.formalize_key(child_key)
+      #k << '/' unless k.match(%r'/$')
+      k.match(%r'/$') || (defined?(@child_names) && @child_names.keys.include?(child_key))
+    end
+
+    def new_child(child_key)
+      if defined?(@child_names) && (name = @child_names[child_key])
+        grandchild = Base.new("#{path}#{child_key}/")
+        child = Base.new("#{path}#{child_key}/")
+        child.instance_variable_set(:@children, {name => grandchild})
+        child.instance_variable_set(:@child_keys, [name])
+        child
+      else
+        Base.new("#{path}#{child_key}")
+      end
+    end
+
+    alias_method :[], :get
+
+    def default_child
+      return @default_child if @default_child
+      logging("default_child") do
+        if default_child_key
+          @getting_default_child = true
+          begin
+            @default_child = get(default_child_key) 
+          ensure
+            @getting_default_child = false
+          end
+        end
+      end
+    end
+
+    def to_hash
+      keys.inject({}) do |dest, key|
+        value = get(key)
+        key = key.sub(/\/$/, '')
+        dest[key] = value.respond_to?(:to_hash) ? value.to_hash : value
+        dest
+      end
+    end
+
+    def from_hash(hash)
+      hash = hash.inject({}){|d, (k, v)| d[GCEMetadata.formalize_key(k)] = v; d}
+      @child_keys = hash.keys
+      @children = {}
+      hash.each do |key, value|
+        if value.is_a?(Array)
+          idx = 0
+          value = value.inject({}){|d, v| d[idx] = v; idx += 1; d}
+        end
+        if value.is_a?(Hash)
+          child = new_child(key)
+          @children[key] = child
+          child.from_hash(value)
+        else
+          @children[key] = value
+        end
+      end
+    end
+
+
+    private
+    def logging(msg, &block)
+      GCEMetadata.logging(msg, &block)
+    end
+
+  end
+end

data/lib/gce_metadata/command.rb

@@ -0,0 +1,79 @@
+# -*- coding: utf-8 -*-
+require 'ec2_metadata'
+require 'hash_key_orderable'
+require 'yaml'
+require 'awesome_print'
+
+module GCEMetadata
+  module Command
+    class << self
+      DATA_KEY_ORDER = %w(instance project)
+      META_DATA_KEY_ORDER =
+        %w( attributes
+            cpu-platform
+            description
+            disks
+            hostname
+            id
+            image
+            licenses
+            machine-type
+            maintenance-event
+            network-interfaces
+            scheduling
+            service-accounts
+            tags
+            virtual-clock
+            zone
+            )
+
+      def show(api_version = 'v1')
+        timeout do
+          v = (api_version || '').strip
+          keys = GCEMetadata.instance.keys
+          unless keys.include?(v.gsub(%r'([^/])$', '\1/'))
+						puts("#{self.class.name}.instance.keys\n#{keys.ai}")
+            raise ArgumentError, "API version must be one of #{GCEMetadata.instance.keys.inspect} but was #{api_version.inspect}"
+          end
+          show_yaml_path_if_loaded
+          data = GCEMetadata.instance.to_hash
+          data = data[v]
+          data.extend(HashKeyOrderable)
+          data.key_order = DATA_KEY_ORDER
+          meta_data = data['instance']
+          meta_data.extend(HashKeyOrderable)
+          meta_data.key_order = META_DATA_KEY_ORDER
+          puts YAML.dump(data)
+        end
+      end
+
+      def show_api_versions
+        timeout do
+          show_yaml_path_if_loaded
+          puts GCEMetadata.instance.keys
+        end
+      end
+
+      def show_dummy_yaml
+        show_yaml_path_if_loaded
+        puts IO.read(File.expand_path(File.join(File.dirname(__FILE__), 'dummy.yml')))
+      end
+
+      private
+      def timeout
+        begin
+          yield
+        rescue Timeout::Error, SystemCallError => error
+          puts "HTTP request timed out. You can use dummy YAML for non GCE Instance. #{Dummy.yaml_paths.inspect}"
+        end
+      end
+
+      def show_yaml_path_if_loaded
+        if path = GCEMetadata::Dummy.loaded_yaml_path
+          puts "Actually these data is based on a DUMMY yaml file: #{path}"
+        end
+      end
+    
+    end
+  end
+end

data/lib/gce_metadata/dummy.rb

@@ -0,0 +1,41 @@
+require 'erb'
+require 'yaml'
+
+module GCEMetadata
+  module Dummy
+		YAML_FILENAME = 'gce_metadata.yml'.freeze
+		YAML_SEARCH_DIRS = ['./config', '.', '~', '/etc'].freeze
+		ENV_SPECIFIED_PATH = "GCE_METADATA_DUMMY_YAML".freeze
+
+		class << self
+			def yaml_paths
+				dirs = YAML_SEARCH_DIRS.dup
+				if Module.constants.include?('RAILS_ROOT')
+					dirs.unshift(File.join(Module.const_get('RAILS_ROOT'), 'config'))
+				end
+				result = dirs.map{|d| File.join(d, YAML_FILENAME)}
+				if (specified_path = ENV[ENV_SPECIFIED_PATH])
+					result.unshift(specified_path)
+				end
+				result
+			end
+
+			def search_and_load_yaml
+				paths = Dir.glob(yaml_paths.map{|path| File.expand_path(path) rescue nil}.compact)
+				load_yaml(paths.first) unless paths.empty?
+			end
+
+			def load_yaml(path)
+				erb = ERB.new(IO.read(path))
+				erb.filename = path
+				text = erb.result
+				GCEMetadata.from_hash(YAML.load(text))
+				@loaded_yaml_path = path
+			end
+
+			def loaded_yaml_path
+				@loaded_yaml_path
+			end
+		end
+	end
+end

data/lib/gce_metadata/dummy.yml

@@ -0,0 +1,34 @@
+--- 
+meta-data: 
+  ami-id: ami-6966372c
+  ami-launch-index: "0"
+  ami-manifest-path: akm2000-us-west-1/dev-20100406-01.manifest.xml
+  ancestor-ami-ids: ami-c32e7f86
+  instance-id: i-3de0f678
+  instance-type: m1.small
+  instance-action: none
+  security-groups: |-
+    ruby-dev
+    default
+  hostname: ip-10-160-115-246.us-west-1.compute.internal
+  public-hostname: ec2-204-236-178-101.us-west-1.compute.amazonaws.com
+  public-ipv4: 204.236.178.101
+  local-hostname: ip-10-160-115-246.us-west-1.compute.internal
+  local-ipv4: 10.160.115.246
+  kernel-id: aki-773c6d32
+  ramdisk-id: ari-c12e7f84
+  reservation-id: r-b76769f2
+  block-device-mapping: 
+    root: /dev/sda1
+    ami: sda1
+    swap: sda3
+    ephemeral0: sda2
+  public-keys: 
+    "0": 
+      west-dev01: 
+        openssh-key: |
+          ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC3on58pV0jEdOukPJMi3zaI90Vg5n+vTaWVNBC2pDfaFX5yVIwcT/LQn9CqvcFsayvRaLfrVT8+wz7BnvQwldUAoIC5wCb5MXhhdr+3dk3ey/t8t3rS0lO6pxYc1jchkH23C/RQz+gOzFDuuzxX4zngRRkajYt1hKEVOPLVv9tqBawalCF0d3iALu/XBguj6fUogaqHgNgZZpZXTXDyfmLtWnXErB0/hqmuV6iIXjclB+K94lZCcJaOQSm/+9C6R0jCKwJNteJInvD553IzyTzBgc5Os3ukNuYv+Ub6aP717ikmI5fa5P0pBL+684kkPKvpGoADJveACoL1+uKpk0j west-dev01
+
+  placement: 
+    availability-zone: us-west-1b
+user-data: 

data/lib/gce_metadata/http_client.rb

@@ -0,0 +1,29 @@
+require 'gce_metadata'
+
+module GCEMetadata
+  module HttpClient
+    def self.extended(obj)
+      obj.open_timeout_sec ||= DEFAULT_OPEN_TIMEOUT
+      obj.read_timeout_sec ||= DEFAULT_READ_TIMEOUT
+    end
+
+    DEFAULT_OPEN_TIMEOUT = 5
+    DEFAULT_READ_TIMEOUT = 10
+
+    attr_accessor :open_timeout_sec
+    attr_accessor :read_timeout_sec
+    
+    def get(path)
+      logging("GCEMetadata.get(#{path.inspect})") do
+        http = Net::HTTP.new(DEFAULT_HOST)
+        http.open_timeout = self.open_timeout_sec
+        http.read_timeout = self.read_timeout_sec
+        http.start do |http|
+          res = http.get(path, 'Metadata-Flavor' => 'Google')
+          res.is_a?(Net::HTTPSuccess) ? res.body : nil
+        end
+      end
+    end
+
+  end
+end

data/lib/gce_metadata/revision.rb

@@ -0,0 +1,23 @@
+require 'gce_metadata'
+
+module GCEMetadata
+  class Revision < Base
+    def initialize(path)
+      @path = path
+      @default_child_key = 'v1/'
+    end
+
+    def new_child(child_key)
+      logging("new_child(#{child_key.inspect})") do
+        child_path = "#{path}#{child_key}"
+        child_path << '/' if (is_struct?(child_key) and not child_key.match(%r'/$'))
+        Base.new(child_path)
+      end
+    end
+
+    def is_struct?(child_key)
+      child_key =~ /\/$/
+    end
+    
+  end
+end

data/lib/gce_metadata/root.rb

@@ -0,0 +1,21 @@
+require 'ec2_metadata'
+
+module GCEMetadata
+  class Root < Base
+    def initialize(path = '/')
+      @path = path
+      @default_child_key = 'v1'
+    end
+
+    def new_child(child_key)
+      logging("new_child(#{child_key.inspect})") do
+        Revision.new("#{path}#{child_key}/")
+      end
+    end
+
+    def is_struct?(child_key)
+      true
+    end
+    
+  end
+end

data/lib/gce_metadata/version.rb

@@ -0,0 +1,4 @@
+module GCEMetadata
+  # gce-metadata version
+  VERSION = '0.1.1'
+end

data/lib/gce_metadata.rb

@@ -0,0 +1,73 @@
+require 'gce_metadata/version'
+require 'net/http'
+Net::HTTP.version_1_2
+require 'ec2_metadata'
+
+module GCEMetadata
+	DEFAULT_HOST = "metadata.google.internal".freeze
+	DEFAULT_REVISION = 'v1'
+
+	autoload :HttpClient, 'gce_metadata/http_client'
+	autoload :Base, 'gce_metadata/base'
+	autoload :Root, 'gce_metadata/root'
+	autoload :Revision, 'gce_metadata/revision'
+	autoload :Dummy, 'gce_metadata/dummy'
+	autoload :Command, 'gce_metadata/command'
+
+	# include Ec2Metadata
+	extend HttpClient
+
+	class << self
+		def instance
+			@instance ||= Root.new['computeMetadata']
+		end
+
+		def clear_instance
+			@instance = nil
+		end
+
+		def [](key)
+			instance[key]
+		end
+
+		def to_hash(revision = DEFAULT_REVISION)
+			self[revision].to_hash
+		end
+
+		def from_hash(hash, revision = DEFAULT_REVISION)
+			# hash = {revision => hash}
+			# instance.from_hash(hash)
+			rev_obj = instance.new_child(revision)
+			instance.instance_variable_set(:@children, {revision => rev_obj})
+			instance.instance_variable_set(:@child_keys, [revision])
+			rev_obj.from_hash(hash)
+		end
+
+		def formalize_key(key)
+			#key.to_s.gsub(/_/, '-')
+			key
+		end
+
+		def logging(msg)
+			@indent ||= 0
+			disp = (" " * @indent) << msg
+			# puts(disp)
+			@indent += 2
+			begin
+				result = yield
+			ensure
+				@indent -= 2
+			end
+			# puts "#{disp} => #{result.inspect}"
+			result
+		end
+	end
+
+	class NotFoundError < StandardError
+	end
+
+end
+
+unless ENV['GCE_METADATA_DUMMY_DISABLED'] =~ /yes|true|on/i
+	GCEMetadata::Dummy.search_and_load_yaml
+end

data/spec/gce-metadata.rb

@@ -0,0 +1,4 @@
+require 'gce_metadata'
+require 'awesome_print'
+
+ap GCEMetadata['v1']['instance']

data/spec/gce_metadata_spec.rb

@@ -0,0 +1,8 @@
+require 'spec_helper'
+require 'gce_metadata'
+
+describe GCEMetadata do
+  it "should have a VERSION constant" do
+    expect(subject.const_get('VERSION')).to_not be_empty
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rspec'
+require 'gce_metadata/version'
+
+include GCEMetadata

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: gce-metadata
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Christo De Lange
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-02-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ec2-metadata
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.2.2
+- !ruby/object:Gem::Dependency
+  name: awesome_print
+  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.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: rubygems-tasks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: gce-metadata provides access to GCE instance metadata.
+email: rubygems@dldinternet.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rakeTasks"
+- ".rspec"
+- ".travis.yml"
+- ChangeLog.md
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- gce_metadata.gemspec
+- lib/gce_metadata.rb
+- lib/gce_metadata/base.rb
+- lib/gce_metadata/command.rb
+- lib/gce_metadata/dummy.rb
+- lib/gce_metadata/dummy.yml
+- lib/gce_metadata/http_client.rb
+- lib/gce_metadata/revision.rb
+- lib/gce_metadata/root.rb
+- lib/gce_metadata/version.rb
+- spec/gce-metadata.rb
+- spec/gce_metadata_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/dldinternet/gce-metadata
+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.4.8
+signing_key: 
+specification_version: 4
+summary: gce-metadata provides access to GCE instance metadata
+test_files:
+- spec/gce-metadata.rb
+- spec/gce_metadata_spec.rb
+- spec/spec_helper.rb