myra 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 66c47e80933981505a4ec2084b89b8f28f97f104
+  data.tar.gz: 323ee597703eecc3349a6d4fac6cab0f27ee92af
+SHA512:
+  metadata.gz: 93fca4f67114e0ec435ffef14bf1e70dcca0772946f970d06a4e924a7d03999e3c06205cbe7c1c549730379972c561efdab0763101fe9239a215651a9c55eeec
+  data.tar.gz: a8ea3004eff91e90330d11e4ec5e191065d25d1ad05f15000673fb7ada24e0bc925ce0e151d50e237267bdf71cb4ecb07e9776423f4cd2ff853d948c1446d388

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.gitlab-ci.yml

@@ -0,0 +1,29 @@
+cache:
+  paths:
+  - .bundler/
+
+stages:
+  - lint
+  - test
+
+rubocop:
+  stage: lint
+  before_script:
+    - gem install rubocop
+  script:
+    - ruby -v
+    - rubocop -v
+    - rubocop -c .rubocop.yml
+
+rspec:
+  stage: test
+  before_script:
+    - ruby -v
+    - which ruby
+    - gem install bundler --no-ri --no-rdoc
+    - bundle install --jobs $(nproc)  "${FLAGS[@]}" --path=.bundler
+  script:
+    - bundle exec rspec
+  artifacts:
+    paths:
+      - coverage/

data/.rubocop.yml

@@ -0,0 +1,70 @@
+AllCops:
+  TargetRubyVersion: 2.3
+  Exclude:
+    - '*.gemspec'
+    - 'Gemfile*'
+    - 'gems/**/*'
+    - 'test.rb'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: AllowUnusedKeywordArguments, IgnoreEmptyMethods.
+Lint/UnusedMethodArgument:
+  Exclude:
+
+# Offense count: 6
+# Configuration parameters: CountComments.
+Metrics/MethodLength:
+  Max: 18
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+# SupportedStyles: with_first_parameter, with_fixed_indentation
+Style/AlignParameters:
+  Exclude:
+    - 'bin/rspec'
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles.
+# SupportedStyles: always, conditionals
+Style/AndOr:
+  Exclude:
+    - 'bin/setup'
+    - 'bin/update'
+
+# Offense count: 17
+Style/Documentation:
+  Enabled: false
+
+# Offense count: 6
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, UseHashRocketsWithSymbolValues.
+# SupportedStyles: ruby19, ruby19_no_mixed_keys, hash_rockets
+Style/HashSyntax:
+  Enabled: false
+
+# Offense count: 3
+# Cop supports --auto-correct.
+# Configuration parameters: SupportedStyles.
+# SupportedStyles: call, braces
+Style/LambdaCall:
+  EnforcedStyle: braces
+
+# Offense count: 2
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, IndentationWidth.
+# SupportedStyles: aligned, indented
+Style/MultilineMethodCallIndentation:
+  Enabled: false
+
+# Offense count: 1
+# Cop supports --auto-correct.
+# Configuration parameters: EnforcedStyle, SupportedStyles, EnforcedStyleForEmptyBraces, SpaceBeforeBlockParameters.
+# SupportedStyles: space, no_space
+Style/SpaceInsideBlockBraces:
+  Enabled: false
+
+Style/RaiseArgs:
+  EnforcedStyle: compact

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.1
+before_install: gem install bundler -v 1.12.5

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+## Uncomment and set this to only include directories you want to watch
+# directories %w(app lib config test spec features) \
+#  .select{|d| Dir.exists?(d) ? d : UI.warning("Directory #{d} does not exist")}
+
+## Note: if you are using the `directories` clause above and you are not
+## watching the project directory ('.'), then you will want to move
+## the Guardfile to a watched dir and symlink it back, e.g.
+#
+#  $ mkdir config
+#  $ mv Guardfile config/
+#  $ ln -s config/Guardfile .
+#
+# and, you'll have to watch "config/Guardfile" instead of "Guardfile"
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separately)
+#  * 'just' rspec: 'rspec'
+
+guard :rspec, cmd: 'bundle exec rspec' do
+  require 'guard/rspec/dsl'
+  dsl = Guard::RSpec::Dsl.new(self)
+
+  # Feel free to open issues for suggestions and improvements
+
+  # RSpec files
+  rspec = dsl.rspec
+  watch(rspec.spec_helper) { rspec.spec_dir }
+  watch(rspec.spec_support) { rspec.spec_dir }
+  watch(rspec.spec_files)
+
+  # Ruby files
+  ruby = dsl.ruby
+  dsl.watch_spec_files_for(ruby.lib_files)
+end
+
+guard :rubocop do
+  watch(/.+\.rb$/)
+  watch(%r{(?:.+/)?\.rubocop\.yml$}) { |m| File.dirname(m[0]) }
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Kloeckner-i GmbH
+
+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,167 @@
+# Myra
+
+This gem allows for interaction with [MyraClouds](https://myracloud.com) API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'myra'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install myra
+
+## Usage
+
+### API Key and API secret
+
+**Note:** Both can be obtained by contacting the MyraCloud support.
+
+The gem assumes that you store the keys in your environment:
+
+```
+ENV['MYRACLOUD_API_KEY']
+ENV['MYRACLOUD_API_SECRET']
+```
+
+However, if you wish to use something different, you can configure these values yourself:
+
+```ruby
+Myra.configure do |config|
+  config.api_key = 'your-key-here'
+  config.api_secret = 'your-secret-here'
+end
+```
+### Domains
+
+A domain is the top level entity available. They cannot easily be edited, as only the `autoUpdate` can be set via API. Removing them will affect all the DNS records attached to that domain, so be extra careful.
+
+#### List
+
+```ruby
+list = Myra::Domains.list
+# => [Domain, Domain, Domain, ...]
+
+domain[0].name
+# => 'my-awesome-name.com'
+```
+#### Create
+
+```ruby
+domain = Myra::Domain.new
+domain.name = "www.kloeckner-i.com"
+puts domain.id
+# => nil
+# [...]
+domain = Myra::Domains.create(domain)
+puts domain.id
+```
+
+#### Update
+
+Updating can only change the `autoUpdate` flag on a domain, if you need more extended editing, remove and recreate the domain (this is a limitation of the API)
+
+```ruby
+list = Myra::Domains.list
+# => [Domain, Domain, Domain, ...]
+
+domain_to_update = domains.first
+domain_to_update.auto_update = !domain_to_update.auto_update
+Myra::Domains.update(domain_to_update)
+```
+
+#### Delete
+
+:warning: Deleting a domain is *dangerous*, as it will remove _all_ associated DNS records and other settings as well. 
+
+```ruby
+# if you don't know the id, just fetch them first
+domain = Myra::Domain.new(id: 1234)
+Myra::Domains.delete domain
+```
+
+### DNS Records
+
+A DNS record comes in the form of `Myra::DnsRecord` and always belongs to a domain.
+
+#### List
+
+```ruby
+domain = Myra::Domain.new id: 1
+records = Myra::DnsRecords.list(domain)
+# => [Myra::DnsRecord, Myra::DnsRecord, ...]
+```
+
+#### Create
+
+```ruby
+domain = Myra::Domain.new id: 1
+record = Myra::DnsRecord.new
+record.name = 'foo' # full name will be infered from the domain you are creating it for
+record.value = 'foo-bar-com.zep.ag'
+record.type = Myra::DnsRecord::Type::CNAME # defaults to 'A'
+Myra::DnsRecords.create(record, domain)
+```
+
+#### Update
+
+```ruby
+# get a domain, etc.
+record = Myra::DnsRecords.list(domain).first
+record.name = 'foo' # full name will be infered from the domain you are creating it for
+record.value = 'foo-bar-com-2.zep.ag'
+Myra::DnsRecords.update(record, domain)
+```
+
+#### Delete
+
+```ruby
+# get a domain, etc.
+record = Myra::DnsRecords.list(domain).first
+Myra::DnsRecords.delete(record, domain)
+```
+
+### Errors
+
+All actions will raise proper errors when the API responds with an error. All violations will be presented as a `Myra::Violation` attached to the error. 
+
+#### Wrong credentials
+
+If the API cannot be authenticated against, a `Myra::APIAuthError` will be thrown. Check your credentials of you encounter this error.
+
+#### Failed API action
+
+If an action against the API fails, a `Myra::APIActionError` will be thrown. 
+
+```ruby
+domain = Myra::Domain.new
+domain.name = '.ff..'
+begin
+  Myra::Domain.create(domain)
+rescue Myra::APIActionError => e
+  puts e.message
+  puts e.violations # => [Myra::Violation, Myra::Violation, ...]
+end
+```
+
+## Supported version for the MyraCloud API
+
+The currently supported version for the API is *1.4*.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'myra'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/myra.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+require 'myra/version'
+require 'myra/configuration'
+require 'myra/request'
+
+# shared actions
+require 'myra/actions/shared/request_handler'
+require 'myra/actions/shared/domain_handler'
+
+# actions which can be performed
+require 'myra/actions/domains'
+require 'myra/actions/dns_records'
+
+# objects which can be retrieved
+require 'myra/objects/domain'
+require 'myra/objects/dns_record'
+
+# possible errors
+require 'myra/objects/errors'
+
+# and their violations
+require 'myra/objects/violation'
+
+# Myra is the top level module for this gem
+module Myra
+  BASE_URL = 'https://api.myracloud.com'
+  PATH = '/en/rapi'
+end

data/lib/myra/actions/dns_records.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+module Myra
+  module DnsRecords
+    extend RequestHandler
+    extend DomainHandler
+    PATH = '/dnsRecords/{domain}'
+
+    def self.list(domain)
+      values = handle Request.new(path: path(domain))
+      values['list'].map { |record| DnsRecord.from_hash(record) }
+    end
+
+    def self.create(record, domain)
+      record = normalize_domain_name(record, domain)
+      request = Request.new(path: path(domain), type: :put)
+      request.payload = Oj.dump(record.to_hash)
+      value = handle request
+      DnsRecord.from_hash(value['targetObject'].first)
+    end
+
+    def self.update(domain, record)
+      record = normalize_domain_name(record, domain)
+      request = Request.new(path: path(domain), type: :post)
+      request.payload = Oj.dump(record.to_hash)
+      value = handle request
+      DnsRecord.from_hash(value['targetObject'].first)
+    end
+
+    def self.delete(domain, record)
+      r = normalize_domain_name(record, domain)
+      request = Request.new(path: path(domain), type: :delete)
+      keys = %w(modified id)
+      request.payload = Oj.dump(r.to_hash.select { |k, _| keys.include? k })
+      value = handle request
+      deleted_record = DnsRecord.from_hash(value['targetObject'].first)
+      deleted_record.deleted = true
+      deleted_record
+    end
+  end
+end

data/lib/myra/actions/domains.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+require 'oj'
+
+module Myra
+  module Domains
+    extend RequestHandler
+    PATH = '/domains'
+
+    def self.list
+      values = handle Request.new(path: PATH)
+      values['list'].map { |domain| Domain.from_hash(domain) }
+    end
+
+    def self.create(domain)
+      request = Request.new(path: PATH, type: :put)
+      request.payload = Oj.dump(domain.to_hash)
+      value = handle request
+      Domain.from_hash(value['targetObject'].first)
+    end
+
+    def self.delete(domain)
+      request = Request.new(path: PATH, type: :delete)
+      payload = domain.to_hash.select { |k, _| %w(id modified).include?(k) }
+      request.payload = Oj.dump(payload)
+      value = handle request
+      Domain.from_hash(value['targetObject'].first)
+    end
+
+    def self.update(domain)
+      request = Request.new path: PATH, type: :post
+      payload = domain.to_hash.select do |k, _|
+        %w(id modified autoUpdate).include? k
+      end
+      request.payload = Oj.dump(payload)
+      value = handle request
+      Domain.from_hash(value['targetObject'].first)
+    end
+  end
+end

data/lib/myra/actions/shared/domain_handler.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+module Myra
+  module DomainHandler
+    def path(domain)
+      const_get('PATH').gsub('{domain}', domain.name)
+    end
+
+    def normalize_domain_name(record, domain)
+      return record if record.name.nil?
+      return record if record.name.include?(domain.name)
+      record.name = "#{record.name}.#{domain.name}"
+      record
+    end
+  end
+end

data/lib/myra/actions/shared/request_handler.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+module Myra
+  module RequestHandler
+    def handle(request)
+      response = request.do
+      raise APIAuthError if response.status == 403
+      values = Oj.load(response.body)
+      errors values
+    end
+
+    def errors(values)
+      return values unless values['error']
+      violations = values['violationList'].map do |v|
+        Myra::Violation.from_hash v
+      end
+      raise APIActionError.new(violations)
+    end
+  end
+end

data/lib/myra/configuration.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+module Myra
+  class << self
+    attr_writer :configuration
+
+    def configure
+      yield(configuration)
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+
+  # Configuration provides the API credentials to MyraCloud
+  class Configuration
+    attr_accessor :api_key, :api_secret
+
+    def initialize
+      @api_key = ENV['MYRACLOUD_API_KEY']
+      @api_secret = ENV['MYRACLOUD_API_SECRET']
+    end
+  end
+end

data/lib/myra/objects/dns_record.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+module Myra
+  class DnsRecord
+    PATH = '/dnsRecords'
+
+    # Record types
+    class Type
+      CNAME = 'CNAME'
+      A = 'A'
+    end
+
+    attr_reader :id
+    attr_accessor :name, :value, :ttl, :type, :alternative_cname,
+                  :active, :modified, :created
+    attr_writer :deleted
+
+    alias active? active
+
+    MAP = {
+      # response field => target field
+      'name' => 'name',
+      'value' => 'value',
+      'ttl' => 'ttl',
+      'alternativeCname' => 'alternative_cname',
+      'active' => 'active',
+      'recordType' => 'type'
+    }.freeze
+
+    def initialize(id: nil)
+      @id = id
+      @active = true
+      @type = Type::A
+      @ttl = 300
+      @deleted = false
+    end
+
+    def self.from_hash(hash)
+      domain = new(id: hash['id'])
+      hash.each do |k, v|
+        next unless MAP.key? k
+        domain.send "#{MAP[k]}=", v
+      end
+      domain.modified = DateTime.parse(hash['modified'])
+      domain.created = DateTime.parse(hash['created'])
+      domain
+    end
+
+    def to_hash
+      return new_record_hash if id.nil?
+      record_hash
+    end
+
+    def deleted?
+      @deleted
+    end
+
+    private
+
+    def new_record_hash
+      Hash[MAP.map { |k, v| [k, send(v)] }].reject { |_, v| v.nil? }
+    end
+
+    def record_hash
+      hash = new_record_hash
+      hash['id'] = id
+      hash['modified'] = modified.to_s
+      hash['created'] = created.to_s
+      hash
+    end
+  end
+end

data/lib/myra/objects/domain.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+require 'date'
+module Myra
+  class Domain
+    PATH = '/domains'
+
+    attr_reader :id
+    attr_accessor :modified, :created, :name, :auto_update, :maintenance,
+                  :paused, :owned, :reversed, :auto_dns, :paused_until
+
+    %w(auto_update maintenance owned paused reversed auto_dns).each do |boolean|
+      alias_method "#{boolean}?", boolean
+    end
+
+    MAP = {
+      # response field => target field
+      'name' => 'name',
+      'autoUpdate' => 'auto_update',
+      'maintenance' => 'maintenance',
+      'owned' => 'owned',
+      'reversed' => 'reversed',
+      'paused' => 'paused',
+      'autoDns' => 'auto_dns'
+    }.freeze
+
+    def initialize(id: nil)
+      @id = id
+      %w(maintenance auto_update auto_dns paused owned reversed).each do |field|
+        send("#{field}=", false)
+      end
+    end
+
+    def self.from_hash(hash)
+      domain = new(id: hash['id'])
+      %w(modified created).each do |date_field|
+        domain.send "#{date_field}=", DateTime.parse(hash[date_field])
+      end
+      MAP.each do |k, v|
+        domain.send "#{v}=", hash[k] if hash.key?(k)
+      end
+      domain
+    end
+
+    def to_hash
+      return new_domain_hash if id.nil?
+      domain_hash
+    end
+
+    private
+
+    def new_domain_hash
+      Hash[MAP.map { |k, v| [k, send(v)] }]
+    end
+
+    def domain_hash
+      hash = new_domain_hash
+      hash['id'] = id
+      hash['modified'] = modified.to_s
+      hash['created'] = created.to_s
+      hash
+    end
+  end
+end

data/lib/myra/objects/errors.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module Myra
+  class APIAuthError < StandardError
+    def message
+      'Could not authenticate with the API, check your credentials'
+    end
+  end
+
+  class APIActionError < StandardError
+    attr_reader :violations
+
+    def initialize(
+      violations,
+      message = 'An error occured while processing your request'
+    )
+      super(message)
+      @violations = violations
+    end
+  end
+
+  class InvalidRequestTypeError < StandardError
+  end
+end

data/lib/myra/objects/violation.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+module Myra
+  class Violation
+    attr_reader :property, :message
+
+    def initialize(property, message)
+      @property = property
+      @message = message
+    end
+
+    def self.from_hash(violation)
+      new(violation['propertyPath'], violation['message'])
+    end
+  end
+end

data/lib/myra/request.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+require 'myra/request/signature'
+require 'myra/request/http'
+require 'date'
+
+module Myra
+  class Request
+    attr_reader :date, :api_key, :api_secret, :path
+    attr_accessor :type, :payload
+
+    ALLOWED_TYPES = [
+      :get,
+      :post,
+      :put,
+      :options,
+      :head,
+      :delete
+    ].freeze
+
+    def initialize(path:, type: :get)
+      @date = DateTime.now.to_s
+      @api_key = Myra.configuration.api_key
+      @api_secret = Myra.configuration.api_secret
+      @type = type
+      @path = path
+    end
+
+    def signing_string
+      [
+        md5.(payload),
+        verb,
+        "#{Myra::PATH}#{path}",
+        content_type,
+        date
+      ].join '#'
+    end
+
+    def type=(type)
+      raise InvalidRequestTypeError unless ALLOWED_TYPES.include?(type)
+      @type = type
+    end
+
+    def do
+      HTTP.new(self).response
+    end
+
+    def content_type
+      'application/json'
+    end
+
+    def uri
+      "#{Myra::BASE_URL}#{Myra::PATH}#{path}"
+    end
+
+    def payload
+      return '' unless with_payload?
+      @payload
+    end
+
+    def with_payload?
+      [:post, :put, :delete].include?(type)
+    end
+
+    private
+
+    def md5
+      Digest::MD5.method(:hexdigest)
+    end
+
+    def verb
+      type.to_s.upcase
+    end
+  end
+end

data/lib/myra/request/http.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+require 'faraday'
+require 'oj'
+
+module Myra
+  class Request
+    class HTTP
+      def initialize(request)
+        @request = request
+        @signature = Signature.new(
+          secret: Myra.configuration.api_secret,
+          date: request.date
+        )
+      end
+
+      def response
+        @response ||= perform_request
+      end
+
+      private
+
+      def perform_request
+        conn.send(@request.type) do |req|
+          req.headers['Content-Type'] = @request.content_type
+          req.headers['Date'] = @request.date.to_s
+          req.headers['Authorization'] = auth_header
+          req.body = @request.payload if @request.with_payload?
+        end
+      end
+
+      def conn
+        Faraday.new(url: @request.uri)
+      end
+
+      def api_key
+        @request.api_key
+      end
+
+      def auth_signature
+        @signature.for @request.signing_string
+      end
+
+      def auth_header
+        "MYRA #{api_key}:#{auth_signature}"
+      end
+    end
+  end
+end

data/lib/myra/request/signature.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+require 'base64'
+require 'openssl'
+
+module Myra
+  class Request
+    class Signature
+      REQUEST_STRING = 'myra-api-request'
+      attr_reader :secret, :date, :base
+
+      def initialize(secret:, date:, base: 'MYRA')
+        @secret = secret
+        @date = date
+        @base = base
+      end
+
+      def date_key
+        method.(digest, "#{base}#{secret}", date)
+      end
+
+      def signing_key
+        method.(digest, date_key, REQUEST_STRING)
+      end
+
+      def for(signing_string)
+        base64.(hmac_method.(digest('sha512'), signing_key, signing_string))
+      end
+
+      private
+
+      def digest(type = 'sha256')
+        OpenSSL::Digest.new(type)
+      end
+
+      def method
+        OpenSSL::HMAC.method(:hexdigest)
+      end
+
+      def hmac_method
+        OpenSSL::HMAC.method(:digest)
+      end
+
+      def base64
+        Base64.method(:strict_encode64)
+      end
+    end
+  end
+end

data/lib/myra/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module Myra
+  VERSION = '0.1.1'
+end

data/myra.gemspec

@@ -0,0 +1,42 @@
+# coding: utf-8
+# frozen_string_literal: true
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'myra/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'myra'
+  spec.version       = Myra::VERSION
+  spec.authors       = ['Florian Kraft']
+  spec.email         = ['florian.kraft@kloeckner.com']
+
+  spec.summary       = 'Gem for interacting with the MyraCloud API'
+  spec.description   = %(
+    This gem allows for interacting with the MyraCloud
+    API to manipulate website and their DNS entries, etc.
+    It should take care of hasing requests to meet all of the
+    requirements set in place by the API. See myracloud.com
+    for more.
+  )
+  spec.homepage      = 'https://github.com/kloeckner-i/myra'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'rubocop', '~> 0.41.1'
+  spec.add_development_dependency 'guard-rspec', '~> 4.7'
+  spec.add_development_dependency 'guard-rubocop', '~> 1.0'
+  spec.add_development_dependency 'webmock', '~> 2.1'
+  spec.add_development_dependency 'simplecov', '~> 0.12'
+
+  spec.add_dependency 'faraday', '~> 0.8.11'
+  spec.add_dependency 'oj', '~> 2.16'
+end

data/test.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+require 'openssl'
+require 'base64'
+require 'pry'
+require 'faraday'
+
+API_KEY = ENV['MYRACLOUD_API_KEY'].freeze
+API_SECRET = ENV['MYRACLOUD_API_SECRET'].freeze
+API_URL = 'https://api.myracloud.com'
+$date = DateTime.now.to_s
+
+def uri
+  '/en/rapi/domains'
+end
+
+def signing_string
+  [
+    'd41d8cd98f00b204e9800998ecf8427e',
+    'GET',
+    uri,
+    'application/json',
+    $date
+  ].join('#')
+end
+
+def signing_key
+  intermediate = OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), "MYRA#{API_SECRET}", $date)
+  OpenSSL::HMAC.hexdigest(OpenSSL::Digest.new('sha256'), intermediate, 'myra-api-request')
+end
+
+def signature
+  Base64.strict_encode64(OpenSSL::HMAC.digest(OpenSSL::Digest.new('sha512'), signing_key, signing_string))
+end
+
+conn = Faraday.new(url: API_URL)
+
+response = conn.get(uri) do |req|
+  req.headers['Authorization'] = "MYRA #{API_KEY}:#{signature}"
+  req.headers['Content-Type'] = 'application/json'
+  req.headers['Date'] = $date
+end
+
+p response.body

metadata

@@ -0,0 +1,214 @@
+--- !ruby/object:Gem::Specification
+name: myra
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Florian Kraft
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-07-26 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !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: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.41.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.41.1
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: guard-rubocop
+  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: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.8.11
+- !ruby/object:Gem::Dependency
+  name: oj
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+description: "\n    This gem allows for interacting with the MyraCloud\n    API to
+  manipulate website and their DNS entries, etc.\n    It should take care of hasing
+  requests to meet all of the\n    requirements set in place by the API. See myracloud.com\n
+  \   for more.\n  "
+email:
+- florian.kraft@kloeckner.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".gitlab-ci.yml"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- lib/myra.rb
+- lib/myra/actions/dns_records.rb
+- lib/myra/actions/domains.rb
+- lib/myra/actions/shared/domain_handler.rb
+- lib/myra/actions/shared/request_handler.rb
+- lib/myra/configuration.rb
+- lib/myra/objects/dns_record.rb
+- lib/myra/objects/domain.rb
+- lib/myra/objects/errors.rb
+- lib/myra/objects/violation.rb
+- lib/myra/request.rb
+- lib/myra/request/http.rb
+- lib/myra/request/signature.rb
+- lib/myra/version.rb
+- myra.gemspec
+- test.rb
+homepage: https://github.com/kloeckner-i/myra
+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.6.6
+signing_key: 
+specification_version: 4
+summary: Gem for interacting with the MyraCloud API
+test_files: []