acquia-cloud 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 76d413a96d61a55b3bdd919b882bb1c2a51344e7
+  data.tar.gz: a4d6543e4d1c4036c00b5fb9cbde78e2af438929
+SHA512:
+  metadata.gz: 70a6e0594f9248b8ba6348bce0c041a0c2ad0e4df6a1bd60493c4ed844d8a9564f06aee35e741194405d52ad665b68eba826f34cf75f3752755c18ea7a247e37
+  data.tar.gz: 43c45cbc34be2a07f6745b9e2f40628b313645b2a8c8f66e1d9f12aa4da05ce98c2b188fdef947b34c9b8d11a1bd462944fc1c0a87aa392fd02de775bfc77dd5

data/.gitignore

@@ -0,0 +1 @@
+/pkg

data/.ruby-version

@@ -0,0 +1 @@
+2.2

data/.travis.yml

@@ -0,0 +1,20 @@
+language: ruby
+rvm:
+- 2.1
+- 2.2
+
+install:
+- bundle install --deployment
+script:
+- bundle exec rake ci
+
+cache:
+  directories:
+  - vendor
+
+branches:
+  only:
+    - master
+
+notifications:
+  email: false

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec name: 'acquia-cloud'

data/Gemfile.lock

@@ -0,0 +1,98 @@
+PATH
+  remote: .
+  specs:
+    acquia-cloud (0.1.0.pre)
+      faraday (~> 0.9)
+      websocket (~> 1.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    abstract_type (0.0.7)
+    adamantium (0.2.0)
+      ice_nine (~> 0.11.0)
+      memoizable (~> 0.4.0)
+    anima (0.3.0)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2)
+      equalizer (~> 0.0.11)
+    ast (2.1.0)
+    concord (0.1.5)
+      adamantium (~> 0.2.0)
+      equalizer (~> 0.0.9)
+    diff-lcs (1.2.5)
+    equalizer (0.0.11)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    ice_nine (0.11.1)
+    memoizable (0.4.2)
+      thread_safe (~> 0.3, >= 0.3.1)
+    morpher (0.2.5)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2.0)
+      anima (~> 0.3.0)
+      ast (~> 2.1.0)
+      concord (~> 0.1.5)
+      equalizer (~> 0.0.9)
+      ice_nine (~> 0.11.0)
+      procto (~> 0.0.2)
+    multipart-post (2.0.0)
+    mutant (0.8.8)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2.0)
+      anima (~> 0.3.0)
+      ast (~> 2.1)
+      concord (~> 0.1.5)
+      diff-lcs (~> 1.2)
+      equalizer (~> 0.0.9)
+      ice_nine (~> 0.11.1)
+      memoizable (~> 0.4.2)
+      morpher (~> 0.2.5)
+      parallel (~> 1.3)
+      parser (~> 2.2.2)
+      procto (~> 0.0.2)
+      unparser (~> 0.2.4)
+    mutant-rspec (0.8.8)
+      mutant (~> 0.8.8)
+      rspec-core (>= 3.2.0, < 3.5.0)
+    parallel (1.6.1)
+    parser (2.2.3.0)
+      ast (>= 1.1, < 3.0)
+    procto (0.0.2)
+    rake (10.4.2)
+    rspec (3.4.0)
+      rspec-core (~> 3.4.0)
+      rspec-expectations (~> 3.4.0)
+      rspec-mocks (~> 3.4.0)
+    rspec-core (3.4.0)
+      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.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.4.0)
+    rspec-support (3.4.0)
+    thread_safe (0.3.5)
+    unparser (0.2.4)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2.0)
+      concord (~> 0.1.5)
+      diff-lcs (~> 1.2.5)
+      equalizer (~> 0.0.9)
+      parser (~> 2.2.2)
+      procto (~> 0.0.2)
+    websocket (1.2.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  acquia-cloud!
+  mutant (~> 0.8)
+  mutant-rspec (~> 0.8)
+  rake (~> 10.4)
+  rspec (~> 3.3)
+
+BUNDLED WITH
+   1.10.6

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Matthew Scharley
+
+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,32 @@
+# acquia-cloud
+
+[![Build Status](https://travis-ci.org/Equiem/acquia-cloud.svg)](https://travis-ci.org/Equiem/acquia-cloud)
+[![Dependency Status](https://gemnasium.com/Equiem/acquia-cloud.svg)](https://gemnasium.com/Equiem/acquia-cloud)
+
+**Source:** [https://github.com/Equiem/acquia-cloud](https://github.com/Equiem/acquia-cloud)  
+**Author:** [Equiem](http://equiem.com.au/)  
+**Contributors:** [See contributors on GitHub][gh-contrib]  
+**Bugs/Support:** [Github Issues][gh-issues]  
+**Copyright:** 2015  
+**License:** [MIT license][license]  
+**Status:** Active
+
+## Synopsis
+
+`acquia-cloud` is a Ruby binding for the Acquia Cloud API. 
+
+## Installation
+
+    $ gem install acquia-cloud
+    
+Or add `gem 'acquia-cloud'` to your Gemfile and update your bundle.
+
+## Usage
+
+> TODO: Write this.
+
+See also [the Cloud API documentation](https://cloudapi.acquia.com/).
+
+  [gh-contrib]: https://github.com/Equiem/acquia-cloud/graphs/contributors
+  [gh-issues]: https://github.com/Equiem/acquia-cloud/issues
+  [license]: https://github.com/Equiem/acquia-cloud/blob/master/LICENSE

data/Rakefile

@@ -0,0 +1,66 @@
+$:.push File.join(__FILE__, '../lib')
+require 'acquia/cloud/version'
+
+def current_gems
+  Dir["pkg/acquia-cloud-#{Acquia::Cloud::VERSION}.gem"]
+end
+
+namespace :gem do
+  desc 'Build gem'
+  task :build => [:clean] do
+    mkdir 'pkg' unless File.exist? 'pkg'
+    sh *%w{gem build acquia-cloud.gemspec}
+    Dir['*.gem'].each do |gem|
+      mv gem, "pkg/#{gem}"
+    end
+  end
+
+  desc 'Install gem'
+  task :install => ['gem:build'] do
+    sh *%W{gem install pkg/usmu-#{Acquia::Cloud::VERSION}.gem}
+  end
+
+  desc 'Deploy gems to rubygems'
+  task :deploy => ['gem:build'] do
+    current_gems.each do |gem|
+      sh *%W{gem push #{gem}}
+    end
+    if File.exist? '.git'
+      sh *%W{git tag #{Acquia::Cloud::VERSION}}
+      sh *%W{git push origin tag #{Acquia::Cloud::VERSION}}
+    end
+  end
+end
+
+task :clean
+
+desc 'Run CI tasks.'
+task :ci => [:rspec]
+
+desc 'Run all RSpec tests.'
+task :rspec do
+  sh 'bundle', 'exec', 'rspec'
+end
+
+desc 'Run mutation tests'
+task :mutant, [:target] do |t,args|
+  sh 'bundle', 'exec', 'mutant',
+     '--include', 'lib',
+     '--require', 'acquia/cloud',
+     '--use', 'rspec',
+     # Interfaces and documentation classes
+     # '--ignore-subject', 'Usmu::Deployment::RemoteFileInterface*',
+     args[:target] || 'Acquia::Cloud*'
+end
+
+desc 'Run a console with our gems available'
+task :console do
+  sh 'bundle', 'exec', 'irb', '-r', 'acquia/cloud'
+end
+
+namespace :git do
+  desc 'Cleanup (delete) all local branches that have already been merged into master (locally)'
+  task :cleanup do
+    `git branch --merged master`.lines.map(&:chomp).select {|i| i != '  master' && i[0,2] != '* ' }.each {|b| sh "git branch -d #{b.strip}" }
+  end
+end

data/acquia-cloud.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+
+$:.push File.join(__FILE__, '../lib')
+require 'acquia/cloud/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'acquia-cloud'
+  spec.version       = Acquia::Cloud::VERSION
+  spec.authors       = ['Equiem']
+  spec.email         = ['sysadmin@equiem.com.au']
+  spec.summary       = %q{Bindings to the Acquia Cloud API.}
+  spec.description   = ''
+  spec.homepage      = 'https://github.com/Equiem/BOTS'
+  spec.licenses      = ['MIT']
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^spec/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = Gem::Requirement.new('~> 2.1')
+
+  spec.add_dependency 'faraday', '~> 0.9'
+  spec.add_dependency 'websocket', '~> 1.2'
+
+  # Dev stuff.
+  spec.add_development_dependency 'rake', '~> 10.4'
+  spec.add_development_dependency 'rspec', '~> 3.3'
+  spec.add_development_dependency 'mutant', '~> 0.8'
+  spec.add_development_dependency 'mutant-rspec', '~> 0.8'
+end

data/lib/acquia/cloud.rb

@@ -0,0 +1,41 @@
+require 'faraday'
+require 'json'
+
+module Acquia
+  # @see https://cloudapi.acquia.com/
+  class Cloud
+    attr_reader :api
+
+    def initialize(args = {})
+      @api = Api.new args
+    end
+
+    def sites
+      @sites ||= @api.get('/sites').map do |site|
+        Site.new(self, site)
+      end
+    end
+
+    # @return [Acquia::Cloud::Site]
+    def site(name)
+      Site.new(self, name).refresh
+    end
+
+    def drushrc
+      @api.get '/me/drushrc'
+    end
+  end
+end
+
+%w{
+  version
+  errors
+  api
+  database
+  environment
+  server
+  site
+  task
+  logs/source
+  logs/streamer
+}.each {|p| require "acquia/cloud/#{p}" }

data/lib/acquia/cloud/api.rb

@@ -0,0 +1,56 @@
+
+module Acquia
+  class Cloud
+    class Api
+      API_VERSION = 'v1'
+      BASE_URL = 'https://cloudapi.acquia.com'
+
+      def initialize(args = {})
+        @acquia = Faraday.new(:url => 'https://cloudapi.acquia.com') do |client|
+          client.request :url_encoded
+          client.adapter Faraday.default_adapter
+
+          # Log request and response to STDOUT.
+          # client.use Faraday::Response::Logger
+
+          # Raise errors on HTTP error codes.
+          client.use Faraday::Response::RaiseError
+        end
+
+        if args[:credentials].nil?
+          if ENV['ACQUIA_CLOUD_CREDENTIALS'].nil?
+            raise 'Unable to detect your credentials. Please populate ACQUIA_CLOUD_CREDENTIALS with your username and API key.'
+          end
+
+          args[:credentials] = ENV['ACQUIA_CLOUD_CREDENTIALS']
+        end
+
+        credentials = args[:credentials].split(':', 2)
+        if credentials.length < 2
+          raise 'You must specify both username and API key in credentials.'
+        end
+        @acquia.basic_auth *credentials
+      end
+
+      def get(url = nil, params = nil, headers = nil, &block)
+        request :get, url, params, headers, &block
+      end
+
+
+      def post(url = nil, body = nil, headers = nil, &block)
+        request :post, url, body.nil? ? body : body.to_json, headers, &block
+      end
+
+      def delete(url = nil, params = nil, headers = nil, &block)
+        request :delete, url, params, headers, &block
+      end
+
+      protected
+
+      def request(method, url = nil, arg2 = nil, headers = nil, &block)
+        response = @acquia.method(method).call "/#{API_VERSION}#{url}.json", arg2, headers, &block
+        JSON.load(response.body)
+      end
+    end
+  end
+end

data/lib/acquia/cloud/database.rb

@@ -0,0 +1,22 @@
+require 'acquia/cloud/entity'
+
+module Acquia
+  class Cloud
+    class Database < Entity
+      def initialize(cloud, site, database)
+        @cloud = cloud
+        @site = site
+        @data = database
+        @url = "/sites/#{@site}/dbs/#{@data['name']}"
+      end
+
+      def name
+        data['name']
+      end
+
+      def backup_on(environment)
+        @cloud.site(@site).environment(environment).backup_database(name)
+      end
+    end
+  end
+end

data/lib/acquia/cloud/entity.rb

@@ -0,0 +1,19 @@
+
+module Acquia
+  class Cloud
+    class Entity
+      attr_accessor :url
+
+      def refresh
+        @data = @cloud.api.get url
+        self
+      end
+
+      protected
+
+      def data
+        @data || (refresh && @data)
+      end
+    end
+  end
+end

data/lib/acquia/cloud/environment.rb

@@ -0,0 +1,80 @@
+require 'acquia/cloud/entity'
+
+module Acquia
+  class Cloud
+    class Environment < Entity
+      def initialize(cloud, site, environment)
+        @cloud = cloud
+        @site = site
+        @data = environment
+        @url = "/sites/#{@site}/envs/#{@data['name']}"
+      end
+
+      def name
+        data['name']
+      end
+
+      def vcs_path
+        data['vcs_path']
+      end
+
+      def ssh_host
+        data['ssh_host']
+      end
+
+      def db_clusters
+        data['db_clusters']
+      end
+
+      def default_domain
+        data['default_domain']
+      end
+
+      def unix_username
+        data['unix_username']
+      end
+
+      # new_vcs_path should start with 'tags/' or 'heads/' to distinguish
+      # between tags or branches.
+      def deploy_path(new_vcs_path)
+        task = @cloud.api.post("#{@url}/code-deploy") do |response|
+          response.params['path'] = new_vcs_path
+        end
+
+        Task.new(@cloud, @site, task)
+      end
+
+      def backup_database(database_name)
+        task = @cloud.api.post("#{@url}/dbs/#{database_name}/backups")
+        Task.new @cloud, @site, task
+      end
+
+      def logstream
+        response = @cloud.api.get("#{@url}/logstream")
+        Logs::Streamer.new(response['url'], JSON.parse(response['msg']))
+      end
+
+      def servers
+        @cloud.api.get("#{url}/servers").map do |server|
+          Server.new(@cloud, @site, name, server)
+        end
+      end
+
+      def server(server)
+        Server.new(@cloud, @site, name, {'name' => server}).refresh
+      end
+
+      def database_servers
+        servers.select &:database?
+      end
+
+      def varnish_servers
+        servers.select &:varnish?
+      end
+
+      def web_servers
+        servers.select &:web?
+      end
+    end
+  end
+end

data/lib/acquia/cloud/errors.rb

@@ -0,0 +1,8 @@
+module Acquia
+  class Cloud
+    class StreamerError < ::RuntimeError; end
+    class StreamerConnectionError < StreamerError; end
+    class StreamerRemoteError < StreamerError; end
+    class StreamerUnrecognisedCommandError < StreamerError; end
+  end
+end

data/lib/acquia/cloud/logs/source.rb

@@ -0,0 +1,17 @@
+module Acquia
+  class Cloud
+    module Logs
+      class Source
+        attr_reader :server
+        attr_reader :type
+        attr_reader :display_type
+
+        def initialize(server, type, display_type)
+          @server = server
+          @type = type
+          @display_type = display_type
+        end
+      end
+    end
+  end
+end

data/lib/acquia/cloud/logs/streamer.rb

@@ -0,0 +1,147 @@
+require 'socket'
+require 'websocket'
+require 'json'
+require 'uri'
+
+module Acquia
+  class Cloud
+    module Logs
+      # https://github.com/acquia/logstream/blob/master/README.md
+      class Streamer
+        # Try to retrieve 16KB blocks from the socket.
+        RECV_LENGTH = 16 * 1024
+
+        attr_reader :remote_server
+
+        def initialize(url, message)
+          @url = url
+          @message = message
+          @logs = []
+          @available = []
+          @enabled_types = []
+        end
+
+        def debug
+          @debug = true
+        end
+
+        def connect
+          raise StreamerConnectionError, 'Already connected.' unless @socket.nil?
+
+          @handshake = ::WebSocket::Handshake::Client.new url: @url
+          uri = ::URI.parse @url
+          @socket = TCPSocket.new uri.host, uri.port || 80
+          @socket.print @handshake.to_s
+
+          until @handshake.finished?
+            @handshake << @socket.gets
+          end
+          raise StreamerConnectionError, "Couldn't get a valid response while connecting to the remote server: #{@url}" unless @handshake.valid?
+          @incoming = WebSocket::Frame::Incoming::Client.new(version: @handshake.version)
+
+          # Initial authentication
+          send @message
+        end
+
+        def close
+          @socket.close
+        end
+
+        def sources
+          update
+          @available.clone
+        end
+
+        def enable(opts = {})
+          if opts[:source]
+            opts[:server] = opts[:source].server
+            opts[:type] = opts[:source].type
+          end
+
+          send({
+            cmd: 'enable',
+            server: opts[:server],
+            type: opts[:type],
+          })
+        end
+
+        def enable_type(type)
+          @available.each do |source|
+            enable source: source
+          end
+          @enabled_types << type
+        end
+
+        def disable(opts = {})
+          if opts[:source]
+            opts[:server] = opts[:source].server
+            opts[:type] = opts[:source].type
+          end
+
+          send({
+            cmd: 'disable',
+            server: opts[:server],
+            type: opts[:type],
+          })
+        end
+
+        def disable_type(type)
+          @available.each do |source|
+            disable source: source
+          end
+          @enabled_types.delete type
+        end
+
+        def each_log
+          update
+          until @logs.empty?
+            yield @logs.shift
+          end
+        end
+
+        protected
+
+        def send(message)
+          message = message.to_json
+          STDERR.puts "-> #{message}" if @debug
+          frame = ::WebSocket::Frame::Outgoing::Client.new(version: @handshake.version, type: 'text', data: message)
+          @socket.print frame.to_s
+        end
+
+        def update
+          # Read as much as possible
+          @incoming << @socket.read_nonblock(RECV_LENGTH) while true
+        rescue ::IO::WaitReadable
+          loop do
+            msg = @incoming.next
+            break unless msg
+            STDERR.puts "<- #{msg}" if @debug
+
+            msg = JSON.parse(msg.data)
+            case msg['cmd']
+              when 'connected'
+                @remote_server = msg['server'] if msg['server'].start_with? 'logstream-api'
+              when 'success'
+                # Congratulations!
+              when 'error'
+                raise StreamerRemoteError, "#{msg['code']}: #{msg['description']} during #{msg['during'].inspect}"
+              when 'available'
+                source = Source.new(msg['server'], msg['type'], msg['display_type'])
+                @available << source
+                enable source: source if @enabled_types.include? source.type
+              when 'line'
+                @logs << msg
+              else
+                if @debug
+                  STDERR.puts "Received unknown command: #{msg['cmd']}"
+                  STDERR.puts msg.inspect
+                else
+                  raise StreamerUnrecognisedCommandError, "Unrecognised command: #{msg['cmd']}\n#{msg.inspect}"
+                end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/acquia/cloud/server.rb

@@ -0,0 +1,62 @@
+require 'acquia/cloud/entity'
+
+module Acquia
+  class Cloud
+    class Server < Entity
+      def initialize(cloud, site, env, server)
+        @cloud = cloud
+        @site = site
+        @env = env
+        @data = server
+        @url = "/sites/#{@site}/envs/#{env}/servers/#{@data['name']}"
+      end
+
+      def name
+        data['name']
+      end
+
+      def fqdn
+        data['fqdn']
+      end
+
+      def ami_type
+        data['ami_type']
+      end
+
+      def ec2_region
+        data['ec2_region']
+      end
+
+      def ec2_availability_zone
+        data['ec2_availability_zone']
+      end
+
+      def services
+        data['services']
+      end
+
+      def varnish?
+        services.has_key? 'varnish'
+      end
+
+      def web?
+        services.has_key? 'web'
+      end
+
+      def database?
+        services.has_key? 'database'
+      end
+
+      def php_procs(memory_limit, apc_shm)
+        return nil unless web?
+
+        values = @cloud.api.get("#{url}/php-procs") do |response|
+          response.params['memory_limits[]'] = memory_limit
+          response.params['apc_shm[]'] = apc_shm
+        end
+
+        values['memory_limit'][memory_limit]['apc_shm'][apc_shm]['php_procs']
+      end
+    end
+  end
+end

data/lib/acquia/cloud/site.rb

@@ -0,0 +1,73 @@
+require 'acquia/cloud/entity'
+
+module Acquia
+  class Cloud
+    class Site < Entity
+      attr_reader :name
+
+      def initialize(cloud, name)
+        @cloud = cloud
+        @name = name
+        @url = "/sites/#{name}"
+      end
+
+      def name
+        data['name']
+      end
+
+      def vcs_type
+        data['vcs_type'].to_sym
+      end
+
+      def vcs_url
+        data['vcs_url']
+      end
+
+      def production_mode
+        data['production_mode'].to_i != 0
+      end
+
+      def unix_username
+        data['unix_username']
+      end
+
+      def title
+        data['title']
+      end
+
+      def uuid
+        data['uuid']
+      end
+
+      def environments
+        @cloud.api.get("#{@url}/envs").map do |environment|
+          Environment.new(@cloud, @name, environment)
+        end
+      end
+
+      def environment(name)
+        Environment.new(@cloud, @name, {'name' => name}).refresh
+      end
+
+      def databases
+        @cloud.api.get("#{@url}/dbs").map do |db|
+          Database.new(@cloud, @name, db)
+        end
+      end
+
+      def database(name)
+        Database.new(@cloud, @name, {'name' => name}).refresh
+      end
+
+      def tasks
+        @cloud.api.get("#{@url}/tasks").map do |task|
+          Task.new(@cloud, @name, task)
+        end
+      end
+
+      def task(id)
+        Task.new(@cloud, @name, {'id' => id}).refresh
+      end
+    end
+  end
+end

data/lib/acquia/cloud/task.rb

@@ -0,0 +1,62 @@
+require 'acquia/cloud/entity'
+
+module Acquia
+  class Cloud
+    class Task < Entity
+      def initialize(cloud, site, task)
+        @cloud = cloud
+        @site = site
+        @data = task
+        @url = "/sites/#{@site}/tasks/#{@data['id']}"
+      end
+
+      def id
+        data['id']
+      end
+
+      def queue
+        data['queue']
+      end
+
+      def state
+        data['state'].to_sym
+      end
+
+      def description
+        data['description']
+      end
+
+      def created
+        Time.at(data['created'].to_i)
+      end
+
+      def started
+        Time.at(data['started'].to_i)
+      end
+
+      def completed
+        Time.at(data['completed'].to_i)
+      end
+
+      def logs
+        data['logs']
+      end
+
+      def wait_for_completion(message = nil)
+        print message if message
+        loop do
+          # This will take several minutes, don't spam Acquia too hard while waiting.
+          sleep 15
+          print '.' if message
+          refresh
+          unless [:started].include? state
+            puts if message
+            break
+          end
+        end
+
+        self
+      end
+    end
+  end
+end

data/lib/acquia/cloud/version.rb

@@ -0,0 +1,5 @@
+module Acquia
+  class Cloud
+    VERSION = '0.1.0'
+  end
+end

metadata

@@ -0,0 +1,149 @@
+--- !ruby/object:Gem::Specification
+name: acquia-cloud
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Equiem
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-24 00:00:00.000000000 Z
+dependencies:
+- !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'
+- !ruby/object:Gem::Dependency
+  name: websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.4'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: mutant
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: mutant-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+description: ''
+email:
+- sysadmin@equiem.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- acquia-cloud.gemspec
+- lib/acquia/cloud.rb
+- lib/acquia/cloud/api.rb
+- lib/acquia/cloud/database.rb
+- lib/acquia/cloud/entity.rb
+- lib/acquia/cloud/environment.rb
+- lib/acquia/cloud/errors.rb
+- lib/acquia/cloud/logs/source.rb
+- lib/acquia/cloud/logs/streamer.rb
+- lib/acquia/cloud/server.rb
+- lib/acquia/cloud/site.rb
+- lib/acquia/cloud/task.rb
+- lib/acquia/cloud/version.rb
+homepage: https://github.com/Equiem/BOTS
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Bindings to the Acquia Cloud API.
+test_files: []