erforscher 1.0.0.pre0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f81b9781cb741624366f9c8dfa9bf16aea4732ad
+  data.tar.gz: dadbf7c5d3ff00598569d819ccb9ec119ca566e5
+SHA512:
+  metadata.gz: cd64bb14f561e9407d536c35f1891f12d9f1b23defd37f6286c8b9e14076a4904cf995a84d216dbb644cf19044ff55d59b77c0416dad22d6354d6018d44b3d3a
+  data.tar.gz: 2e5a3a567b4f3352f6ce2e8a61eb69f2111008790c6bb594209588c323c11e9eb77657a0d03d62ac9517553f7efe1392a9aa791b5b3b8ebd1828d0daa7cfafc7

data/README.md

@@ -0,0 +1,44 @@
+# Erforscher
+
+Erforscher is a poor man's service discovery tool that uses the AWS EC2 APIs to
+(optionally) filter instance from a configured set of `tags` and writes
+hostnames (derived from a configured `name` tag) and private IP address mappings
+to `/etc/hosts` (or any file of your choosing).
+
+By default, Erforscher will look for a configuration file in the following
+places (and in the given order);
+
+* $HOME/.erforscher.yml
+* /etc/erforscher.yml
+
+As indicated below it's also possible to give the path to a configuration file
+using the `-c|--config` option, and in that case the given path will be used.
+
+Otherwise, Erforscher will use the first file that exists, and will not attempt
+to merge settings if there should be files in the above mentioned places.
+
+## Installation
+
+No, not currently, but it will be available as a `gem` and as `omnibus`
+packages, whenever it's ready for releasing out into the wild.
+
+## Usage
+
+```bash
+erforscher --help
+erforscher -T|--tags <K1=V1,K2=V2>
+erforscher -N|--name <TAG>
+erforscher -c|--config <PATH>
+```
+
+The configuration file is a simple YAML file, with the following structure:
+
+```yaml
+name_tag: 'Name'
+region: 'us-east-1'
+tags:
+  - environment: 'test'
+    service: 'web'
+  - environment: 'production'
+    service: 'database'
+```

data/bin/erforscher

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$: << File.expand_path('../../lib', __FILE__)
+
+require 'erforscher'
+
+exit(Erforscher::Cli.run(ARGV, $stderr))

data/lib/erforscher/cli.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+module Erforscher
+  class Cli
+    def self.run(argv, io)
+      new.run(argv, io)
+    end
+
+    def run(argv, io)
+      config = parse_options(argv)
+      if config['print_usage']
+        io.puts(@parser)
+        2
+      else
+        Runner.run(config)
+      end
+    rescue => e
+      io.puts(%(#{e.message} (#{e.class.name})))
+      io.puts(@parser)
+      1
+    end
+
+    private
+
+    def parse_options(argv, cli={})
+      @parser = OptionParser.new do |parser|
+        parser.on('-c', '--config=PATH', 'Path to configuration file') do |config_path|
+          cli['config_path'] = config_path
+        end
+
+        parser.on('-T', '--tags=LIST', Array, 'List of `tag` key-value pairs') do |tags|
+          cli['tags'] = [parse_tags(tags)]
+        end
+
+        parser.on('-N', '--name=TAG', '"Name" `tag`') do |name_tag|
+          cli['name_tag'] = name_tag
+        end
+
+        parser.on('-h', '--help', 'You\'re looking at it') do
+          cli['print_usage'] = true
+        end
+      end
+      @parser.parse(argv)
+      Configuration.new(cli).get
+    end
+
+    def parse_tags(keys_values)
+      if keys_values.any? { |kv| kv.include?('=') }
+        Hash[keys_values.map { |kv| kv.split('=') }]
+      end
+    end
+  end
+end

data/lib/erforscher/configuration.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+module Erforscher
+  ConfigurationError = Class.new(ErforscherError)
+
+  class Configuration
+    def initialize(cli, file=File)
+      @cli = cli
+      @file = file
+    end
+
+    def get
+      if (path = @cli.delete('config_path'))
+        unless @file.exist?(path)
+          raise ConfigurationError, 'Could not find any configuration file'
+        end
+        config = load_config(path)
+      elsif @file.exist?(home_path)
+        config = load_config(home_path)
+      elsif @file.exist?(etc_path)
+        config = load_config(etc_path)
+      else
+        config = {}
+      end
+
+      defaults.merge(config).merge(@cli)
+    end
+
+    private
+
+    def load_config(path)
+      YAML.load(@file.read(path))
+    end
+
+    def home_path
+      File.join(ENV['HOME'], '.erforscher.yml')
+    end
+
+    def etc_path
+      '/etc/erforscher.yml'
+    end
+
+    def defaults
+      {
+        'name_tag' => 'Name',
+        'hostsfile_path' => '/etc/hosts',
+        'tags' => []
+      }
+    end
+  end
+end

data/lib/erforscher/explorer.rb

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+module Erforscher
+  class Explorer
+    def initialize(instances)
+      @instances = instances
+    end
+
+    def discover(tag_combos)
+      if tag_combos.empty?
+        @instances.all
+      else
+        tag_combos.flat_map do |tags|
+          @instances.with_tags(tags)
+        end
+      end
+    end
+  end
+end

data/lib/erforscher/formatter.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+module Erforscher
+  class Formatter
+    def initialize(name_tag, fallback_to_private_dns=true)
+      @name_tag = name_tag
+      @fallback_to_private_dns = fallback_to_private_dns
+    end
+
+    def format(instance)
+      [hostname(instance), instance.private_ip_address].join("\t")
+    end
+
+    private
+
+    def hostname(instance)
+      if (name = find_name(instance.tags))
+        strip_domain(name)
+      elsif @fallback_to_private_dns
+        instance.private_dns_name
+      end
+    end
+
+    def find_name(tags)
+      tag = tags.find { |tag| tag[:key] == @name_tag }
+      tag.value if tag
+    end
+
+    def strip_domain(name)
+      name.split('.').first
+    end
+  end
+end

data/lib/erforscher/hostsfile.rb

@@ -0,0 +1,94 @@
+# encoding: utf-8
+
+module Erforscher
+  class Hostsfile
+    def initialize(current_file, new_file, options={})
+      @current_file = current_file
+      @new_file = new_file
+      @fileutils = options[:fileutils] || FileUtils
+      @previously_written = false
+    end
+
+    def write(entries)
+      copy_until_header
+      write_header
+      write_body(entries)
+      write_footer
+      discard_old_entries
+      copy_after_footer
+    end
+
+    def switchero
+      @new_file.close
+      @fileutils.mv(current_path, current_prev_path)
+      @fileutils.mv(new_path, current_path)
+    end
+
+    private
+
+    def new_path
+      @new_file.path
+    end
+
+    def current_path
+      absolute_path(@current_file)
+    end
+
+    def current_prev_path
+      %(#{absolute_path(@current_file)}.prev)
+    end
+
+    def absolute_path(f)
+      File.absolute_path(f)
+    end
+
+    def header
+      '# ERFORSCHER START'
+    end
+
+    def footer
+      '# ERFORSCHER END'
+    end
+
+    def copy_until_header
+      while (line = @current_file.gets)
+        if line.match(header)
+          @previously_written = true
+          break
+        else
+          @new_file.write(line)
+        end
+      end
+    end
+
+    def write_header
+      @new_file.puts(header)
+    end
+
+    def write_body(entries)
+      entries.each do |entry|
+        @new_file.puts(entry)
+      end
+    end
+
+    def write_footer
+      @new_file.puts(footer)
+    end
+
+    def discard_old_entries
+      if @previously_written
+        while (line = @current_file.gets)
+          if line.match(footer)
+            break
+          end
+        end
+      end
+    end
+
+    def copy_after_footer
+      while (line = @current_file.gets)
+        @new_file.write(line)
+      end
+    end
+  end
+end

data/lib/erforscher/instances.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+module Erforscher
+  class Instances
+    def initialize(ec2)
+      @ec2 = ec2
+    end
+
+    def all
+      instances_from(@ec2.describe_instances)
+    end
+
+    def with_tags(tags)
+      filters = tags.map { |key, value| {name: %(tag:#{key}), values: [value]} }
+      instances_from(@ec2.describe_instances(filters: filters))
+    end
+
+    private
+
+    def instances_from(response)
+      response.flat_map(&:reservations).flat_map(&:instances)
+    end
+  end
+end

data/lib/erforscher/runner.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+
+module Erforscher
+  class Runner
+    def initialize(config)
+      @config = config
+    end
+
+    def self.run(config)
+      new(config).run
+    end
+
+    def run
+      explored = explorer.discover(@config['tags'])
+      entries = explored.sort.map { |ex| formatter.format(ex) }
+      hostsfile.write(entries)
+      hostsfile.switchero
+    end
+
+    private
+
+    def formatter
+      @formatter ||= Formatter.new(@config['name_tag'])
+    end
+
+    def current_hostsfile
+      @current_hostsfile ||= File.open(@config['hostsfile_path'])
+    end
+
+    def working_file
+      @working_file ||= Tempfile.new(%(erforscher-#{Time.now.to_i}))
+    end
+
+    def hostsfile
+      @hostsfile ||= Hostsfile.new(current_hostsfile, working_file)
+    end
+
+    def explorer
+      @explorer ||= Explorer.new(instances)
+    end
+
+    def instances
+      @instances ||= Instances.new(ec2)
+    end
+
+    def ec2
+      @ec2 ||= Aws::EC2.new(region: @config['region'])
+    end
+  end
+end

data/lib/erforscher/version.rb

@@ -0,0 +1,5 @@
+# encoding: utf-8
+
+module Erforscher
+  VERSION = '1.0.0.pre0'.freeze
+end

data/lib/erforscher.rb

@@ -0,0 +1,20 @@
+# encoding: utf-8
+
+require 'aws-sdk-core'
+require 'fileutils'
+require 'tempfile'
+require 'yaml'
+require 'optparse'
+
+
+module Erforscher
+  ErforscherError = Class.new(StandardError)
+end
+
+require 'erforscher/cli'
+require 'erforscher/configuration'
+require 'erforscher/explorer'
+require 'erforscher/formatter'
+require 'erforscher/hostsfile'
+require 'erforscher/instances'
+require 'erforscher/runner'

data/spec/acceptance/cli_spec.rb

@@ -0,0 +1,141 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe 'bin/erforscher' do
+  let :io do
+    StringIO.new
+  end
+
+  let :ec2 do
+    FakeEc2.new(Resource.instances)
+  end
+
+  let :config do
+    {'hostsfile_path' => hostsfile.path}
+  end
+
+  let :hostsfile do
+    Tempfile.new('etc-hosts')
+  end
+
+  let :config_file do
+    Tempfile.new('config.yml')
+  end
+
+  before do
+    Aws::EC2.stub(:new).and_return(ec2)
+  end
+
+  let :new_hostsfile do
+    File.read(config['hostsfile_path'])
+  end
+
+  let :argv do
+    []
+  end
+
+  let :run_command do
+    Erforscher::Cli.run(%W[--config #{config_file.path}] + argv, io)
+  end
+
+  let :code do
+    run_command
+  end
+
+  before do
+    config_file.puts(YAML.dump(config))
+    config_file.rewind
+  end
+
+  after do
+    hostsfile.delete
+    config_file.delete
+  end
+
+  context 'when given --help or -h' do
+    it 'returns 2 and prints usage' do
+      code = Erforscher::Cli.run(%w[-h], io)
+      expect(code).to eq(2)
+      expect(io.string).to include 'Usage:'
+
+      io.rewind
+
+      code = Erforscher::Cli.run(%w[--help], io)
+      expect(code).to eq(2)
+      expect(io.string).to include 'Usage:'
+    end
+  end
+
+  context 'when given --config' do
+    context 'and configuration file exists' do
+      let :config do
+        {
+          'hostsfile_path' => hostsfile.path,
+          'tags' => [{
+            'Environment' => 'test',
+            'Created-By' => 'no-one'
+          }]
+        }
+      end
+
+      before do
+        run_command
+      end
+
+      it 'returns 0' do
+        expect(code).to eq(0)
+      end
+
+      it 'prints nothing' do
+        expect(io.string).to be_empty
+      end
+
+      it 'uses configuration from given path' do
+        expect(new_hostsfile).to include("instance-001\t10.0.0.1")
+      end
+    end
+
+    context 'and configuration file does not exist' do
+      it 'returns 1' do
+        code = Erforscher::Cli.run(%w[--config non-existing-file.yml], io)
+        expect(code).to eq(1)
+      end
+
+      it 'prints an error message and usage' do
+        Erforscher::Cli.run(%w[--config non-existing-file.yml], io)
+
+        expect(io.string).to include('Could not find any configuration file')
+        expect(io.string).to include('Usage:')
+      end
+    end
+  end
+
+  context 'when given -T or --tags' do
+    let :argv do
+      %w[-T Environment=Cli]
+    end
+
+    before do
+      run_command
+    end
+
+    it 'filters using given tags' do
+      expect(new_hostsfile).to include("instance-003\t10.0.0.3")
+    end
+  end
+
+  context 'when given -N or --name' do
+    let :argv do
+      %w[-T Environment=other -N NameTag]
+    end
+
+    before do
+      run_command
+    end
+
+    it 'uses given `tag` for parsing hostnames' do
+      expect(new_hostsfile).to include("instance-004\t10.0.0.4")
+    end
+  end
+end

data/spec/erforscher/configuration_spec.rb

@@ -0,0 +1,113 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+module Erforscher
+  describe Configuration do
+    let :configuration do
+      described_class.new(cli_options, file)
+    end
+
+    let :file do
+      double(:file)
+    end
+
+    let :cli_options do
+      {}
+    end
+
+    before do
+      @home = ENV['HOME']
+      ENV['HOME'] = '/fake/home'
+    end
+
+    before do
+      file.stub(:exist?)
+    end
+
+    after do
+      ENV['HOME'] = @home
+    end
+
+    describe '#get' do
+      context 'when given path to a configuration file' do
+        context 'that exist' do
+          let :config do
+            {'name_tag' => 'ConfigFileName'}
+          end
+
+          let :cli_options do
+            {'config_path' => 'this-is-a-config.yml'}
+          end
+
+          before do
+            file.stub(:exist?).with('this-is-a-config.yml').and_return(true)
+            file.stub(:read).with('this-is-a-config.yml').and_return(YAML.dump(config))
+          end
+
+          it 'uses configuration from path' do
+            conf = configuration.get
+            expect(conf['name_tag']).to eq('ConfigFileName')
+          end
+        end
+
+        context 'that does not exist' do
+          let :cli_options do
+            {'config_path' => 'this-should-not-exist.yml'}
+          end
+
+          it 'raises an error' do
+            expect { configuration.get }.to raise_error
+          end
+        end
+      end
+
+      context 'when not given path to a configuration file' do
+        context 'and $HOME/.erforscher.yml exist' do
+          let :config do
+            {'name_tag' => 'HomeName'}
+          end
+
+          before do
+            file.stub(:exist?).with('/fake/home/.erforscher.yml').and_return(true)
+            file.stub(:read).with('/fake/home/.erforscher.yml').and_return(YAML.dump(config))
+          end
+
+          it 'uses it' do
+            conf = configuration.get
+            expect(conf['name_tag']).to eq('HomeName')
+          end
+        end
+
+        context 'and $HOME/.erforscher.yml does not exist' do
+          context 'and /etc/erforscher.yml exist' do
+            let :config do
+              {'name_tag' => 'EtcName'}
+            end
+
+            before do
+              file.stub(:exist?).with('/etc/erforscher.yml').and_return(true)
+              file.stub(:read).with('/etc/erforscher.yml').and_return(YAML.dump(config))
+            end
+
+            it 'uses it' do
+              conf = configuration.get
+              expect(conf['name_tag']).to eq('EtcName')
+            end
+          end
+
+          context 'and /etc/erforscher.yml does not exist' do
+            it 'uses default configuration' do
+              conf = configuration.get
+              expect(conf).to eq({
+                'name_tag' => 'Name',
+                'hostsfile_path' => '/etc/hosts',
+                'tags' => []
+              })
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/erforscher/explorer_spec.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+module Erforscher
+  describe Explorer do
+    let :explorer do
+      described_class.new(instances)
+    end
+
+    let :instances do
+      Instances.new(FakeEc2.new(Resource.instances))
+    end
+
+    let :filtered do
+      explorer.discover(tags)
+    end
+
+    describe '#discover' do
+      context 'with a single tag' do
+        let :tags do
+          [{'Environment' => 'test'}]
+        end
+
+        it 'filters instances by given tag' do
+          expect(filtered).to have(2).items
+        end
+      end
+
+      context 'with multiple tags' do
+        let :tags do
+          [{'Environment' => 'test', 'Group' => 'Some group'}]
+        end
+
+        it 'filters instances by given tags' do
+          expect(filtered).to have(1).item
+        end
+      end
+
+      context 'with multiple tag combinations' do
+        let :tags do
+          [{'Environment' => 'test', 'Group' => 'Some group'}, {'Environment' => 'test2'}]
+        end
+
+        it 'concats filtered instances' do
+          expect(filtered).to have(2).items
+        end
+      end
+
+      context 'when given an empty list of tag combinations' do
+        let :tags do
+          []
+        end
+
+        it 'returns all instances' do
+          expect(filtered).to have(5).items
+        end
+      end
+    end
+  end
+end

data/spec/erforscher/formatter_spec.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+module Erforscher
+  describe Formatter do
+    let :formatter do
+      described_class.new(name_tag)
+    end
+
+    let :name_tag do
+      'Name'
+    end
+
+    let :instance do
+      OpenStruct.new({
+        tags: [
+          OpenStruct.new({key: 'Name', value: 'hello-world-001.domain.com'})
+        ],
+        private_ip_address: '10.0.0.1',
+        private_dns_name: 'private-dns-name',
+      })
+    end
+
+    let :formatted do
+      formatter.format(instance)
+    end
+
+    context 'when instance does have a \'name tag\'' do
+      it 'parses hostname from name tag' do
+        expect(formatted).to include('hello-world-001')
+      end
+
+      it 'returns a tab separated string with hostname and IP address' do
+        expect(formatted).to eq("hello-world-001\t10.0.0.1")
+      end
+    end
+
+    context 'when instance does not have a \'name tag\'' do
+      let :name_tag do
+        'name'
+      end
+
+      it 'uses private DNS name instead' do
+        expect(formatted).to eq("private-dns-name\t10.0.0.1")
+      end
+    end
+  end
+end

data/spec/erforscher/hostsfile_spec.rb

@@ -0,0 +1,137 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+module Erforscher
+  describe Hostsfile do
+    let :hostsfile do
+      described_class.new(current_file, new_file, fileutils: fileutils)
+    end
+
+    let :new_file do
+      StringIO.new
+    end
+
+    let :fileutils do
+      double(:fileutils).as_null_object
+    end
+
+    let :entries do
+      3.times.map { |i| %(host-00#{i}\t10.0.0.#{i}) }
+    end
+
+    def next_line
+      (line = new_file.gets) && line.strip
+    end
+
+    describe '#write' do
+      before do
+        hostsfile.write(entries)
+        new_file.rewind
+      end
+
+      context 'a pristine file' do
+        let :current_file do
+          StringIO.new.tap do |io|
+            io.puts %(# Comment at the start of file)
+            io.puts %(127.0.0.1\tno-place-like.home)
+            io.rewind
+          end
+        end
+
+        it 'copies everything until header to new file' do
+          expect(next_line).to eq(%(# Comment at the start of file))
+          expect(next_line).to eq(%(127.0.0.1\tno-place-like.home))
+        end
+
+        it 'writes entries to new file' do
+          3.times { next_line }
+          expect(next_line).to eq("host-000\t10.0.0.0")
+          expect(next_line).to eq("host-001\t10.0.0.1")
+          expect(next_line).to eq("host-002\t10.0.0.2")
+        end
+
+        it 'writes a footer' do
+          6.times { next_line }
+          expect(next_line).to eq('# ERFORSCHER END')
+        end
+
+        it 'copies everything after footer to new file' do
+          7.times { next_line }
+          expect(next_line).to be_nil
+        end
+      end
+
+      context 'a file that has been written before' do
+        let :current_file do
+          StringIO.new.tap do |io|
+            io.puts %(# Comment at the start of file)
+            io.puts %(127.0.0.1\tno-place-like.home)
+            io.puts %(# ERFORSCHER START)
+            io.puts %(host-000\t10.0.0.0)
+            io.puts %(# ERFORSCHER END)
+            io.puts %(# Something after footer)
+            io.rewind
+          end
+        end
+
+        it 'copies everything until header to new file' do
+          expect(next_line).to eq(%(# Comment at the start of file))
+          expect(next_line).to eq(%(127.0.0.1\tno-place-like.home))
+        end
+
+        it 'writes entries to new file' do
+          3.times { next_line }
+          expect(next_line).to eq("host-000\t10.0.0.0")
+          expect(next_line).to eq("host-001\t10.0.0.1")
+          expect(next_line).to eq("host-002\t10.0.0.2")
+        end
+
+        it 'writes footer once' do
+          6.times { next_line }
+          expect(next_line).to eq('# ERFORSCHER END')
+        end
+
+        it 'does not keep old entries around' do
+          7.times { next_line }
+          expect(next_line).to eq('# Something after footer')
+          expect(next_line).to be_nil
+        end
+      end
+    end
+
+    describe '#switchero' do
+      let :new_file do
+        Tempfile.new('new_file')
+      end
+
+      let :current_file do
+        Tempfile.new('current_file')
+      end
+
+      let :absolute_current_path do
+        File.absolute_path(current_file)
+      end
+
+      let :absolute_new_path do
+        File.absolute_path(new_file)
+      end
+
+      before do
+        hostsfile.switchero
+      end
+
+      it 'closes the new file' do
+        new_file.should be_closed
+      end
+
+      it 'backups the previous file' do
+        fileutils.should have_received(:mv).with(absolute_current_path, %(#{absolute_current_path}.prev))
+      end
+
+      it 'renames the new file' do
+        fileutils.should have_received(:mv).with(absolute_new_path, absolute_current_path)
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require 'json'
+require 'ostruct'
+
+require 'support/fake_ec2'
+require 'support/resource'
+
+require 'simplecov'
+
+SimpleCov.start do
+  add_group 'Source', 'lib'
+  add_group 'Unit tests', 'spec/erforscher'
+  add_group 'Acceptance tests', 'spec/acceptance'
+end
+
+require 'erforscher'

data/spec/support/fake_ec2.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+class FakeEc2
+  def initialize(instances)
+    @instances = instances.map do |instance|
+      tags = instance.delete(:tags)
+      tags = tags.map { |tag| OpenStruct.new(tag) }
+      instance[:tags] = tags
+      OpenStruct.new(instance)
+    end
+  end
+
+  def describe_instances(opts={})
+    filters = opts.fetch(:filters, []).dup
+    instances = @instances.dup
+
+    while filters.any? do
+      filter = filters.shift
+      key = filter[:name].split(':').last
+      value = filter[:values].first
+
+      instances = instances.select do |instance|
+        instance.tags.any? do |tag|
+          tag[:key] == key && tag[:value] == value
+        end
+      end
+    end
+
+    [FakeResponse.new(instances)]
+  end
+
+  private
+
+  class FakeResponse
+    def initialize(instances)
+      @instances = instances
+    end
+
+    def reservations
+      @instances.map { |instance| FakeReservation.new(instance) }
+    end
+  end
+
+  class FakeReservation
+    def initialize(instance)
+      @instance = instance
+    end
+
+    def instances
+      [@instance]
+    end
+  end
+end

data/spec/support/resource.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+class Resource
+  def self.instances
+    @instances ||= begin
+      path = File.expand_path(%(../../resources/instances.json), __FILE__)
+      JSON.parse(File.read(path), symbolize_names: true)
+    end
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: erforscher
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre0
+platform: ruby
+authors:
+- Mathias Söderberg
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-06-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk-core
+  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'
+description: Poor man's service discovery tool using AWS EC2 APIs
+email:
+- mths@sdrbrg.se
+executables:
+- erforscher
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/erforscher
+- lib/erforscher.rb
+- lib/erforscher/cli.rb
+- lib/erforscher/configuration.rb
+- lib/erforscher/explorer.rb
+- lib/erforscher/formatter.rb
+- lib/erforscher/hostsfile.rb
+- lib/erforscher/instances.rb
+- lib/erforscher/runner.rb
+- lib/erforscher/version.rb
+- spec/acceptance/cli_spec.rb
+- spec/erforscher/configuration_spec.rb
+- spec/erforscher/explorer_spec.rb
+- spec/erforscher/formatter_spec.rb
+- spec/erforscher/hostsfile_spec.rb
+- spec/spec_helper.rb
+- spec/support/fake_ec2.rb
+- spec/support/resource.rb
+homepage: https://github.com/mthssdrbrg/erforscher
+licenses:
+- Apache License 2.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: AWS EC2 API service discovery tool
+test_files:
+- spec/acceptance/cli_spec.rb
+- spec/erforscher/configuration_spec.rb
+- spec/erforscher/explorer_spec.rb
+- spec/erforscher/formatter_spec.rb
+- spec/erforscher/hostsfile_spec.rb
+- spec/spec_helper.rb
+- spec/support/fake_ec2.rb
+- spec/support/resource.rb