diplomat 0.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6993773f2f540cc308337c3a47845e08201dcd93
+  data.tar.gz: 238df4c5465672f23f182c68d1e5a87ecc1b7928
+SHA512:
+  metadata.gz: a1f2fd67dcdc5feb723c3ad660c2a971f5587726744007a10f7990d0682a4fbb33a6ce7f1ff1780798ad3b8254364e185ab500c8b9c603003468d9fa33fad4e9
+  data.tar.gz: 8619604f40bda32375f708a2b994c9a4f3590f480305f563ec376dc36b6ab84a90633511616234fb4789cfd6f0dccd386b46618e52e61a61542e0f0119db19f3

data/.gitignore

@@ -0,0 +1,34 @@
+*.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

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in roundel.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    diplomat (0.0.3)
+      faraday (~> 0.9.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coderay (1.1.0)
+    diff-lcs (1.2.5)
+    fakes (1.1.4)
+    fakes-rspec (1.0.5)
+      fakes
+    faraday (0.9.0)
+      multipart-post (>= 1.2, < 3)
+    json (1.8.1)
+    method_source (0.8.2)
+    multipart-post (2.0.0)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rake (10.3.1)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.8)
+    rspec-expectations (2.14.5)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.6)
+    slop (3.4.7)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  diplomat!
+  fakes-rspec
+  json
+  pry
+  rake
+  rspec

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2014, Diplomat project contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Ruby FFI project nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,85 @@
+# Diplomat
+
+### A HTTP Ruby API for [Consul](http://www.consul.io/)
+
+![Diplomacy Boad Game](http://i.imgur.com/Nkuy4b7.jpg)
+
+
+## FAQ
+
+#### What's Diplomat for?
+
+Diplomat allows any ruby application to interact with [Consul's](http://www.consul.io/) distributed key value store, and also receive information about services currently available in the Consol cluster.
+
+#### Does it work in rails?
+
+Yup! In fact, we're using it in all of our rails production apps instead of any previous case where it'd be right to use environment variables according to [12Factor configuration principals](http://12factor.net/config). This gives us the ability to scale up without making any changes to the actual project codebase, and to move applications around the cluster with ease.
+
+Here's what a production database.yml file might look like:
+
+```erb
+<% if Rails.env.production? %>
+production:
+  adapter:            postgresql
+  encoding:           unicode
+  host:               <%= Diplomat::Service.get('postgres').Address %>
+  database:           <%= Diplomat.get('project/db/name') %>
+  pool:               5
+  username:           <%= Diplomat.get('project/db/user') %>
+  password:           <%= Diplomat.get('project/db/pass') %>
+  port:               <%= Diplomat::Service.get('postgres').ServicePort %>
+<% end %>
+```
+
+#### Why would I use Consol over ZooKeeper, Doozerd, etcd, Nagios, Sensu, SmartStack, SkyDNS, Chef, Puppet, Ansible, etc?
+
+[Read up what makes Consul different here](http://www.consul.io/intro/vs/index.html)
+
+#### How do I install Consul?
+
+[See here](http://www.consul.io/intro/). I managed to roll it out on my production machines with the help of [Ansible](http://www.ansible.com/) in one working day.
+
+## Usage
+
+### Key Values
+
+#### Getting
+
+Getting the value of a key in the key-value store is as simple as using one of the following:
+
+```ruby
+foo = Diplomat.get('foo')
+# => "bar"
+```
+
+#### Setting
+
+Setting the value of a key is just as easy:
+
+```ruby
+foo = Diplomat.put('foo', 'bar')
+# => "bar"
+```
+
+### Services
+
+#### Getting
+
+Looking up a service is easy as pie:
+
+```ruby
+foo_service = Diplomat::Service.get('foo')
+# => #<OpenStruct Node="hotel", Address="1.2.3.4", ServiceID="hotel_postgres", ServiceName="hotel_postgres", ServiceTags=["postgres"], ServicePort=5432> 
+```
+
+### Todo
+
+ - Deleting Keys
+ - Listing available Services, PUTting and DELETEing services
+ - Health
+ - Members
+ - Status
+
+## Enjoy!
+
+![Photo Copyright "merlinmann". All rights reserved.](http://i.imgur.com/3mBwzR9.jpg Photo Copyright "merlinmann" https://www.flickr.com/photos/merlin/. All rights reserved.)

data/diplomat.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'diplomat/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "diplomat"
+  spec.version       = Diplomat::VERSION
+  spec.authors       = ["John Hamelink"]
+  spec.email         = ["john@johnhamelink.com"]
+  spec.description   = %q{Diplomat is a simple wrapper for Consul}
+  spec.summary       = %q{Diplomat is a simple wrapper for Consul}
+  spec.homepage      = "https://github.com/johnhamelink/diplomat"
+  spec.license       = "BSD"
+
+  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 = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake", "~> 10.3"
+  spec.add_development_dependency "pry", "~> 0.9"
+  spec.add_development_dependency "rspec", "~> 2.14"
+  spec.add_development_dependency "fakes-rspec", "~> 1.0"
+  spec.add_development_dependency "json", "~> 1.8"
+  spec.add_dependency "faraday", "~> 0.9"
+end

data/lib/diplomat.rb

@@ -0,0 +1,40 @@
+module Diplomat
+
+  class << self
+
+    attr_accessor :root_path
+    attr_accessor :lib_path
+    attr_accessor :url
+
+    # Internal: Requires internal Faraday libraries.
+    #
+    # *libs - One or more relative String names to Faraday classes.
+    #
+    # Returns nothing.
+    def require_libs(*libs)
+      libs.each do |lib|
+        require "#{lib_path}/#{lib}"
+      end
+    end
+
+    alias require_lib require_libs
+
+    private
+
+    def method_missing(name, *args, &block)
+      Diplomat::Kv.new.send(name, *args, &block)
+    end
+
+  end
+
+  self.root_path = File.expand_path "..", __FILE__
+  self.lib_path = File.expand_path "../diplomat", __FILE__
+
+  # TODO: Make this configurable and overridable
+  self.url = "http://localhost:8500"
+
+
+
+  require_libs "rest_client", "kv", "service"
+
+end

data/lib/diplomat/kv.rb

@@ -0,0 +1,45 @@
+require 'base64'
+require 'faraday'
+
+module Diplomat
+  class Kv < Diplomat::RestClient
+
+    attr_reader :key, :value, :raw
+
+    def get key
+      @key   = key
+      @raw   = @conn.get "/v1/kv/#{@key}"
+      @raw   = JSON.parse(@raw.body).first
+      @value = Base64.decode64(@raw["Value"])
+      return @value
+    end
+
+    def put key, value
+      @raw   = @conn.put "/v1/kv/#{@key}", @value
+      @raw   = JSON.parse(@raw.body).first
+      @key   = @raw["Key"]
+      @value = Base64.decode64(@raw["Value"])
+      return @value
+    end
+
+    def delete key
+      @raw = @conn.delete "/v1/kv/#{@key}"
+      @key   = nil
+      @value = nil
+    end
+
+    def self.get *args
+      Diplomat::Kv.new.get *args
+    end
+
+    def self.put *args
+      Diplomat::Kv.new.put *args
+    end
+
+    def self.delete *args
+      Diplomat::Kv.new.delete *args
+    end
+
+
+  end
+end

data/lib/diplomat/rest_client.rb

@@ -0,0 +1,23 @@
+require 'faraday'
+require 'json'
+
+module Diplomat
+  class RestClient
+
+    def initialize api_client=nil
+      start_connection api_client
+    end
+
+    private
+
+    def start_connection api_client=nil
+      @conn = api_client ||= Faraday.new(:url => Diplomat::url) do |faraday|
+        faraday.request  :url_encoded
+        faraday.response :logger
+        faraday.adapter  Faraday.default_adapter
+        faraday.use      Faraday::Response::RaiseError
+      end
+    end
+
+  end
+end

data/lib/diplomat/service.rb

@@ -0,0 +1,17 @@
+require 'base64'
+require 'faraday'
+
+module Diplomat
+  class Service < Diplomat::RestClient
+
+    def get key
+      ret = @conn.get "/v1/catalog/service/#{key}"
+      return OpenStruct.new JSON.parse(ret.body).first
+    end
+
+    def self.get *args
+      Diplomat::Service.new.get *args
+    end
+
+  end
+end

data/lib/diplomat/version.rb

@@ -0,0 +1,3 @@
+module Diplomat
+  VERSION = "0.1.3"
+end

data/spec/kv_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+require 'json'
+require 'base64'
+
+describe Diplomat::Kv do
+
+  let(:faraday) { fake }
+
+  context "keys" do
+    let(:key) { "key" }
+    let(:key_url) { "/v1/kv/#{key}" }
+    let(:key_params) { "toast" }
+
+    it "GET" do
+      json = JSON.generate({
+        "Key"   => key,
+        "Value" => Base64.encode64(key_params),
+        "Flags" => 0
+      })
+
+      faraday.stub(:get).and_return(json)
+      kv = Diplomat::Kv.new(faraday)
+
+      expect(kv.get("key")).to eq("toast")
+    end
+
+    it "PUT" do
+
+      json = JSON.generate({
+        "Key"   => key,
+        "Value" => Base64.encode64(key_params),
+        "Flags" => 0
+      })
+
+      faraday.stub(:get).and_return(json)
+      faraday.stub(:put).and_return(json)
+      kv = Diplomat::Kv.new(faraday)
+
+      expect(kv.put(key, key_params)).to eq(key_params)
+    end
+
+    it "namespaces" do
+      json = JSON.generate({
+        "Key"   => key,
+        "Value" => Base64.encode64(key_params),
+        "Flags" => 0
+      })
+
+      faraday.stub(:get).and_return(json)
+      faraday.stub(:put).and_return(json)
+      kv = Diplomat::Kv.new(faraday)
+
+      expect(kv.put("toast/#{key}", key_params)).to eq(key_params)
+    end
+
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require "bundler/setup"
+Bundler.setup
+
+require 'diplomat'
+require 'fakes-rspec'
+
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: diplomat
+version: !ruby/object:Gem::Version
+  version: 0.1.3
+platform: ruby
+authors:
+- John Hamelink
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-04-19 00:00:00.000000000 Z
+dependencies:
+- !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: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: fakes-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Diplomat is a simple wrapper for Consul
+email:
+- john@johnhamelink.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- diplomat.gemspec
+- lib/diplomat.rb
+- lib/diplomat/kv.rb
+- lib/diplomat/rest_client.rb
+- lib/diplomat/service.rb
+- lib/diplomat/version.rb
+- spec/kv_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/johnhamelink/diplomat
+licenses:
+- BSD
+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.2.1
+signing_key: 
+specification_version: 4
+summary: Diplomat is a simple wrapper for Consul
+test_files:
+- spec/kv_spec.rb
+- spec/spec_helper.rb
+has_rdoc: