virtengine_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c47461d442d1b7cf2300107ff10bc1ce1b78a77e
+  data.tar.gz: 2a20eb725ec3c8672e61f50f059d7d405a268fe2
+SHA512:
+  metadata.gz: 2561146139a21ea97dbe03a2ba3a7d2ac0e2bae04b6804058077e50b7692f4f3fd3915611c6db35c0cdefbba5cfb935b733b264e0f308b75ddb58deed69cc2bc
+  data.tar.gz: 18a266404ff29c17e812697324d8874c46976db0161f8cf84ccc9b9bbf2a0009baaba24008db2f3bff9bdd8353755d2265bba4bd04cb05955a86cb2352cb0b9e

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.project
+.config
+coverage
+Gemfile.lock
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.c9/*
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/.travis.yml

@@ -0,0 +1,11 @@
+language: ruby
+
+notifications:
+    email:
+    recipients:
+      - info@megam.io
+
+rvm:
+  - 2.3.1
+
+script: bundle exec rake

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2013-2016 Megam Systems. https://www.megam.io
+
+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,27 @@
+Ruby API for Vertice
+=====================
+
+[![Gem Version](https://badge.fury.io/rb/megam_api.svg)](http://badge.fury.io/rb/megam_api)
+
+This is a Ruby SDK API for Vertice.
+
+
+Usage
+-----
+
+```shell
+
+gem install megam_api
+
+```
+
+For more implementation details [see nilavu](http://github.com/megamsys/nilavu.git)
+
+
+# License
+
+MIT
+
+# Author
+
+Refer [https://rubygems.org/gems/megam_api](https://rubygems.org/gems/megam_api)

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+
+task :default => :test
+
+Rake::TestTask.new do |task|
+  task.name = :test
+  task.test_files = FileList['test/test*.rb']
+end

data/lib/megam/api.rb

@@ -0,0 +1,329 @@
+require 'base64'
+require 'time'
+require 'excon'
+require 'uri'
+require 'zlib'
+require 'openssl'
+
+__LIB_DIR__ = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+$LOAD_PATH.unshift(__LIB_DIR__) unless $LOAD_PATH.include?(__LIB_DIR__)
+
+require 'megam/api/accounts'
+require 'megam/api/assemblies'
+require 'megam/api/assembly'
+require 'megam/api/balances'
+require 'megam/api/credits'
+require 'megam/api/billedhistories'
+require 'megam/api/billingtransactions'
+require 'megam/api/components'
+require 'megam/api/domains'
+require 'megam/api/errors'
+require 'megam/api/marketplaces'
+require 'megam/api/organizations'
+require 'megam/api/promos'
+require 'megam/api/requests'
+require 'megam/api/sensors'
+require 'megam/api/sshkeys'
+require 'megam/api/eventsall'
+require 'megam/api/eventsvm'
+require 'megam/api/eventsmarketplace'
+require 'megam/api/license'
+require 'megam/api/flavors'
+require 'megam/api/eventscontainer'
+require 'megam/api/eventsbilling'
+require 'megam/api/eventsstorage'
+require 'megam/api/snapshots'
+require 'megam/api/backups'
+require 'megam/api/reports'
+require 'megam/api/quotas'
+require 'megam/api/rawimages'
+require 'megam/api/disks'
+require 'megam/api/subscriptions'
+require 'megam/api/addons'
+require 'megam/api/version'
+
+
+require 'megam/mixins/assemblies'
+require 'megam/mixins/assembly'
+require 'megam/mixins/common_deployable'
+require 'megam/mixins/components'
+require 'megam/mixins/megam_attributes'
+require 'megam/mixins/outputs'
+require 'megam/mixins/policies'
+
+require 'megam/core/rest_adapter'
+require 'megam/core/stuff'
+require 'megam/core/text'
+require 'megam/core/log'
+require 'megam/core/json_compat'
+require 'megam/core/error'
+require 'megam/core/account'
+require 'megam/core/account_collection'
+require 'megam/core/request'
+require 'megam/core/request_collection'
+require 'megam/core/license'
+require 'megam/core/license_collection'
+require 'megam/core/flavors'
+require 'megam/core/flavors_collection'
+require 'megam/core/sshkey'
+require 'megam/core/sshkey_collection'
+require 'megam/core/eventsall'
+require 'megam/core/eventsall_collection'
+require 'megam/core/eventsvm'
+require 'megam/core/eventsvm_collection'
+require 'megam/core/eventsmarketplace'
+require 'megam/core/eventsmarketplace_collection'
+require 'megam/core/eventscontainer'
+require 'megam/core/eventscontainer_collection'
+require 'megam/core/eventsbilling'
+require 'megam/core/eventsbilling_collection'
+require 'megam/core/eventsstorage'
+require 'megam/core/eventsstorage_collection'
+require 'megam/core/marketplace'
+require 'megam/core/marketplace_collection'
+require 'megam/core/organizations'
+require 'megam/core/organizations_collection'
+require 'megam/core/domains'
+require 'megam/core/domain_collection'
+require 'megam/core/assemblies'
+require 'megam/core/assemblies_collection'
+require 'megam/core/konipai'
+require 'megam/core/assembly'
+require 'megam/core/assembly_collection'
+require 'megam/core/components'
+require 'megam/core/components_collection'
+require 'megam/core/sensors'
+require 'megam/core/sensors_collection'
+require 'megam/core/snapshots'
+require 'megam/core/snapshots_collection'
+require 'megam/core/backups'
+require 'megam/core/backups_collection'
+require 'megam/core/reports'
+require 'megam/core/reports_collection'
+require 'megam/core/quotas'
+require 'megam/core/quotas_collection'
+require 'megam/core/rawimages'
+require 'megam/core/rawimages_collection'
+require 'megam/core/disks'
+require 'megam/core/disks_collection'
+require 'megam/core/balances_collection'
+require 'megam/core/balances'
+require 'megam/core/credits_collection'
+require 'megam/core/credits'
+require 'megam/core/billedhistories_collection'
+require 'megam/core/billedhistories'
+require 'megam/core/billingtransactions_collection'
+require 'megam/core/billingtransactions'
+require 'megam/core/subscriptions_collection'
+require 'megam/core/subscriptions'
+require 'megam/core/addons_collection'
+require 'megam/core/addons'
+require 'megam/core/promos'
+
+module Megam
+    class API
+        attr_accessor :text
+        attr_accessor :email, :api_key, :password_hash, :org_id
+        attr_accessor :api_url, :api_version
+        attr_accessor :master_key
+        attr_reader   :last_response
+
+        API_VERSION2      = '/v2'.freeze
+
+        X_Megam_DATE      = 'X-Megam-DATE'.freeze
+        X_Megam_HMAC      = 'X-Megam-HMAC'.freeze
+        X_Megam_OTTAI     = 'X-Megam-OTTAI'.freeze
+        X_Megam_ORG       = 'X-Megam-ORG'.freeze
+        X_Megam_PUTTUSAVI = 'X-Megam-PUTTUSAVI'.freeze
+        X_Megam_MASTERKEY = 'X-Megam-MASTERKEY'.freeze
+
+        HEADERS = {
+            'Accept'          => 'application/json',
+            'Accept-Encoding' => 'gzip',
+            'User-Agent'      => "megam-api/#{Megam::API::VERSION}",
+            'X-Ruby-Version'  => RUBY_VERSION,
+            'X-Ruby-Platform' => RUBY_PLATFORM
+        }
+
+        OPTIONS = {
+            headers: {},
+            nonblock: false
+        }
+
+        def initialize(options = {})
+            @options = OPTIONS.merge(options)
+
+            assign_credentials
+
+            ensure_host_is_flattened
+
+            turn_off_ssl_verify
+        end
+
+
+        def text
+            @text ||= Megam::Text.new(STDOUT, STDERR, STDIN, {})
+        end
+
+        def request(params, &block)
+            just_color_debug("#{@options[:path]}")
+            start = Time.now
+            Megam::Log.debug('START')
+
+            ensure_authkeys unless is_passthru?
+
+            begin
+                response = connection.request(params, &block)
+            rescue Excon::Errors::HTTPStatusError => error
+                klass = case error.response.status
+
+                when 401 then Megam::API::Errors::Unauthorized
+                when 403 then Megam::API::Errors::Forbidden
+                when 404 then Megam::API::Errors::NotFound
+                when 408 then Megam::API::Errors::Timeout
+                when 422 then Megam::API::Errors::RequestFailed
+                when 423 then Megam::API::Errors::Locked
+                when /50./ then Megam::API::Errors::RequestFailed
+                else Megam::API::Errors::ErrorWithResponse
+                end
+                reerror = klass.new(error.message, error.response)
+                reerror.set_backtrace(error.backtrace)
+                reerror.response.body = Megam::JSONCompat.from_json(reerror.response.body.chomp)
+                raise(reerror)
+            end
+
+            @last_response = response
+
+            if response.body && !response.body.empty?
+                if response.headers['Content-Encoding'] == 'gzip'
+                    response.body = Zlib::GzipReader.new(StringIO.new(response.body)).read
+                end
+
+                begin
+                    unless response.headers[X_Megam_OTTAI]
+                        response.body = Megam::JSONCompat.from_json(response.body.chomp)
+                    else
+                        response.body = Megam::KoniPai.new.koni(response.body.chomp)
+                    end
+                rescue Exception => jsonerr
+                    raise(jsonerr)
+                end
+            end
+
+            Megam::Log.debug("END(#{(Time.now - start)}s)")
+
+            @connection.reset
+            response
+        end
+
+        private
+
+        def assign_credentials
+            @api_key       = @options.delete(:api_key) || ENV['VERTICE_API_KEY']
+            @email         = @options.delete(:email)   || ENV['VERTICE_EMAIL']
+            @password_hash = @options.delete(:password_hash)
+            @org_id        = @options.delete(:org_id)
+            @master_key    = @options.delete(:master_key) || ENV['VERTICE_MASTER_KEY']
+        end
+
+        def ensure_host_is_flattened
+
+            uri          = URI(@options.delete(:host)) if @options.has_key?(:host)
+
+            scheme       = (uri && uri.scheme) ? uri.scheme : 'http'
+
+            host         = (uri && uri.host)   ? uri.host : 'localhost'
+
+            port         = (uri && uri.port)   ? uri.port.to_s : '9000'
+
+            @api_version = (uri && uri.path)   ? uri.path :  API_VERSION2
+
+            @api_url     =  scheme +  "://" + host  + ":" + port + @api_version
+        end
+
+        def is_passthru?
+            @options[:passthru]
+        end
+
+        def ensure_authkeys
+            if !api_combo_missing? && !pw_combo_missing? && !masterkey_combo_missing?
+                fail Megam::API::Errors::AuthKeysMissing
+            end
+        end
+
+        def api_combo_missing?
+            (!@email.nil? && !@api_key.nil?)
+        end
+
+        def pw_combo_missing?
+            (!@email.nil? && !@password_hash.nil?)
+        end
+
+        def masterkey_combo_missing?
+            (!@email.nil? && !@master_key.nil?)
+        end
+
+        def turn_off_ssl_verify
+           Excon.defaults[:ssl_verify_peer] = false   unless @api_url.include?("https")
+        end
+
+        def just_color_debug(path)
+            text.msg "--> #{text.color("(#{path})", :cyan, :bold)}"
+        end
+
+        def connection
+            @options[:path] = @api_version + @options[:path]
+
+            build_headers
+
+            @connection = Excon.new(@api_url, @options)
+        end
+
+
+        def build_headers
+            encoded = encode_header
+
+            @options[:headers] = HEADERS.merge(X_Megam_HMAC => encoded[:hmac],
+                                        X_Megam_DATE => encoded[:date],
+                                        X_Megam_ORG => @org_id).merge(@options[:headers])
+
+
+            build_header_puttusavi
+
+            build_header_masterkey
+        end
+
+        def encode_header
+            body_base64 = Base64.urlsafe_encode64(OpenSSL::Digest::MD5.digest(@options[:body]))
+            current_date = Time.now.strftime('%Y-%m-%d %H:%M')
+
+            movingFactor = "#{current_date}" + "\n" + "#{@options[:path]}" + "\n" + "#{body_base64}"
+
+            digest  = OpenSSL::Digest.new('sha256')
+
+            if pw_combo_missing? && !is_passthru?
+                hash = OpenSSL::HMAC.hexdigest(digest, Base64.strict_decode64(@password_hash), movingFactor)
+            elsif api_combo_missing?
+                hash = OpenSSL::HMAC.hexdigest(digest, @api_key, movingFactor)
+            elsif masterkey_combo_missing?
+                hash = OpenSSL::HMAC.hexdigest(digest, @master_key, movingFactor)
+            else
+                hash = ""
+            end
+            { hmac: (@email + ':' + hash), date: current_date }
+        end
+
+        def build_header_puttusavi
+          if pw_combo_missing? && !is_passthru?
+               @options[:headers] = @options[:headers].merge(X_Megam_PUTTUSAVI => "true")
+          end
+        end
+
+        def build_header_masterkey
+          if masterkey_combo_missing? && !is_passthru?
+               @options[:headers] = @options[:headers].merge(X_Megam_MASTERKEY => "true")
+          end
+        end
+
+    end
+end

data/lib/megam/api/accounts.rb

@@ -0,0 +1,96 @@
+module Megam
+  class API
+    # GET /accounts
+    def get_accounts(email)
+      @options = {:path => "/accounts/#{email}",
+        :body => ''}.merge(@options)
+
+      request(
+        :expects  => 200,
+        :method   => :get,
+        :body     => @options[:body]
+      )
+    end
+
+    # The body content needs to be a json.
+    def login(new_account)
+      @options = {:path => '/accounts/login',
+      :body => Megam::JSONCompat.to_json(new_account)}.merge(@options)
+
+      request(
+        :expects  => 302,
+        :method   => :post,
+        :body     => @options[:body]
+        )
+    end
+
+    # The body content needs to be a json.
+    def post_accounts(new_account)
+      @options = {path: '/accounts/content',
+                  body:  Megam::JSONCompat.to_json(new_account)}.merge(@options)
+
+      request(
+        :expects  => 201,
+        :method   => :post,
+        :body     => @options[:body]
+        )
+    end
+
+    def update_accounts(update_account)
+      @options = {path: '/accounts/update', passthru: true,
+                  body: Megam::JSONCompat.to_json(update_account)}.merge(@options)
+
+      request(
+      :expects => 201,
+      :method => :post,
+      :body => @options[:body]
+      )
+    end
+
+    def forgot(account)
+      @options = { path:  "/accounts/forgot/#{account["email"]}", passthru: true,
+                   body: ''}.merge(@options)
+
+      request(
+      :expects => 201,
+      :method => :get,
+      :body => @options[:body]
+      )
+    end
+
+    def delete_accounts(delete_account)
+      @options = {path: "/admin/accounts/#{delete_account["user_email"]}",
+                  :body => ''}.merge(@options)
+
+       request(
+       :expects  => 200,
+       :method   => :delete,
+       :body     => @options[:body]
+       )
+    end
+
+    def password_reset(account)
+      @options = {:path => "/accounts/password_reset", passthru: true,
+                  body: Megam::JSONCompat.to_json(account)}.merge(@options)
+
+      request(
+      :expects => 201,
+      :method => :post,
+      :body => @options[:body]
+      )
+    end
+
+    # ADMIN: LIST /accounts
+    def list_accounts
+      @options = {:path => "/admin/accounts",
+        :body => ''}.merge(@options)
+
+      request(
+        :expects  => 200,
+        :method   => :get,
+        :body     => @options[:body]
+      )
+    end
+
+  end
+end