gehirn_dns 1.0.0.pre

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 58c59e72437e8283188c2c51075d062b11e4b58a
+  data.tar.gz: 270c708b1baa5ea61359797db016b9318351e1b0
+SHA512:
+  metadata.gz: 1b6af906fe22e06b6aa6c7b04cf21c47e769cc1b274cc41d5192a5fadb4a54d87d2b4796e7de53ba553a28bbe9749b91d76550250d0b73adad9bb92fdb672171
+  data.tar.gz: 4ef110de89b2b7a047d84ac0480e0f9189d7e2e218e09bf4089bfdf26a308a1dc5b6d5cdac467028c3667579d11c7d0366a5976c72b1e978ca60741b2c3c8ca2

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,25 @@
+AsciiComments:
+  Enabled: false
+Documentation:
+  Enabled: false
+LineLength:
+  Enabled: false
+PercentLiteralDelimiters:
+  Enabled: false
+ClassLength:
+  Max: 200
+MethodLength:
+  Max: 20
+Metrics/AbcSize:
+  Enabled: false
+Style/ClassAndModuleChildren:
+  Enabled: false
+AllCops:
+  Exclude:
+    - 'Rakefile'
+    - 'bin/rake'
+    - 'vendor/**/*'
+    - 'doc/**/*'
+    - 'coverage/**/*'
+    - 'tmp/**/*'
+  TargetRubyVersion: 2.4

data/.travis.yml

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

data/Gemfile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in gehirn_dns.gemspec
+gemspec
+
+gem 'pry', require: false
+gem 'rubocop', require: false

data/LICENSE.md

@@ -0,0 +1,25 @@
+BSD 2-Clause License
+
+Copyright (c) 2017, kyontan
+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.
+
+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 THE COPYRIGHT HOLDER OR CONTRIBUTORS 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,151 @@
+# `gehirndns-ruby`
+
+An API Client of [Gehirn DNS](https://www.gehirn.jp/gis/dns.html) for Ruby
+
+## Installation
+
+Add this line to your application's Gemfile:
+(*This way can't use now, I'll publish this to rubygems on nearby 2017-08-01)
+
+```ruby
+gem 'gehirn_dns'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install gehirn_dns
+
+## Usage
+
+```ruby
+# Create client instance
+client = GehirnDns::Client.new(token: "nice_token", secret: "mikakunin")
+
+# Get all managing zones
+client.zones
+
+# Get specify zone
+zone = client.zone(name: "example.jp")
+
+# Get all record sets (A, AAAA, TXT, ...) of current version
+# zone.current_record_sets
+
+# Get all versions
+# zone.versions
+
+# Get current specify record set (name, type are optional)
+current_record_set = zone.current_record_set(name: "miku.example.jp.", type: :A)
+# => #<GehirnDns::RecordSet
+#  @alias_to=nil,
+#  @editable=false,
+#  @enable_alias=false,
+#  @id=...,
+#  @name="miku.example.jp.",
+#  @records=[#<GehirnDns::Record @address=... >],
+#  @ttl=3600,
+#  @type=:A,
+#  @version=...>
+
+current_record_set.records
+# => [#<GehirnDns::Record
+#   @address="10.39.39.39",
+#   @record_set=
+#    #<GehirnDns::RecordSet
+#     @alias_to=nil,
+#     @base_path=...,
+#     @client=...,
+#     @editable=false,
+#     @enable_alias=false,
+#     @id=...,
+#     @name="miku.example.jp.",
+#     @records=[...],
+#     @ttl=3600,
+#     @type=:A, ...>>,
+#   ...]
+
+# It's possible to edit DNS record directly! (if the record is editable: latest version or not migrated yet)
+# current_record_set.records.first.address = "10.0.0.22"
+
+
+# you can get all versions (already sorted by the time):
+# zone.versions
+
+# Let's begin add record set, and migrate!
+new_version = zone.current_version.clone(name: "Add A record to megu.example.jp.")
+
+# You can set :A, :AAAA, :CNAME, :MX, :NS, :SRV, :TXT, and following attributes are to be set to records
+# A, AAAA: address
+# CNAME: cname
+# MX: prio exchange
+# NS: nsdname
+# SRV: target port weight
+# TXT: data
+
+new_record_set = GehirnDns::RecordSet.new(name: "megu.example.jp.", ttl: 300, type: :A)
+# => #<GehirnDns::RecordSet
+#  @alias_to=nil,
+#  @editable=true,
+#  @enable_alias=false,
+#  @id=nil,
+#  @name="megu.example.jp.",
+#  @records=[],
+#  @ttl=300,
+#  @type=:A, ...>
+
+# of course, you can edit as:
+# new_record_set.name = "megu.example.jp."
+# new_record_set.ttl = 300
+# new_record_set.type = :A
+
+new_record_set << GehirnDns::Record.new(address: '10.22.39.22')
+
+# Add second record (DNS Round-robin)
+new_record_set << GehirnDns::Record.new(address: '10.22.39.23')
+
+# If you want to alias existing domain:
+# new_record_set.alias_to = "example.jp."
+
+# Add record set to new version
+new_version << new_record_set
+
+# Ship it!
+# (applied_at is to be enough later to gradually decrease TTL by Gehirn DNS, or denied)
+new_version.migrate(name: "Add megu.example.jp!", applied_at: Time.now + 600)
+# => #<GehirnDns::Preset:0x007fd7d73a2df0
+#   @applied_at=2017-07-24 14:xx:yy UTC,
+#   @completed_at=2017-07-24 14:xx:yy UTC,
+#   @created_at=2017-07-24 14:xx:yy UTC,
+#   @id=...,
+#   @is_completed=false,
+#   @name="Add megu.example.jp!",
+#   @next_version_id=nil,
+#   @prev_version_id=...>
+
+# Or you can apply just now!
+# new_version.migrate!
+
+# You can refer migrations by:
+migration = zone.migrations.last
+# migration.next_migration
+# migration.prev_migration
+```
+
+## Development
+
+From bundler auto generated doc:
+
+> 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`.
+
+## Contributing
+
+Any questions, bug reports, patches are welcome on GitHub at [kyontan/gehirndns_ruby](https://github.com/kyontan/gehirndns_ruby)
+
+## LICENCE
+
+Refer LICENCE.md.  Also, this library is licenced as [![SUSHI-WARE LICENSE](https://img.shields.io/badge/license-SUSHI--WARE%F0%9F%8D%A3-blue.svg)](https://github.com/MakeNowJust/sushi-ware)

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

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/gehirn_dns.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'gehirn_dns/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'gehirn_dns'
+  spec.version       = GehirnDns::VERSION
+  spec.authors       = ['kyontan']
+  spec.email         = ['kyontan@monora.me']
+
+  spec.summary       = 'The Gehirn DNS API client for Ruby'
+  spec.description   = 'The Gehirn DNS API client for Ruby'
+  spec.homepage      = 'https://github.com/kyontan/gehirn_dns'
+
+  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.14'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+  spec.add_development_dependency 'webmock'
+end

data/lib/gehirn_dns.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'gehirn_dns/client'
+require 'gehirn_dns/error'
+require 'gehirn_dns/version'
+
+module GehirnDns
+  DEFAULT_BASE_URL = 'https://api.gis.gehirn.jp/dns/v1/'
+end

data/lib/gehirn_dns/client.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+
+require 'gehirn_dns/resource'
+require 'gehirn_dns/resource/preset'
+require 'gehirn_dns/resource/record'
+require 'gehirn_dns/resource/record_set'
+require 'gehirn_dns/resource/version'
+require 'gehirn_dns/resource/zone'
+require 'gehirn_dns/version'
+
+module GehirnDns
+  class Client
+    attr_accessor :base_uri, :token, :secret
+
+    DEFAULT_USER_AGENT = "gehirndns-ruby/#{::GehirnDns::VERSION}"
+
+    def initialize(options = {})
+      @base_uri = ::URI.parse(options[:base_uri] || ENV.fetch('GEHIRN_DNS_BASE_URL', DEFAULT_BASE_URL))
+      @token = options[:token] || ENV.fetch('GEHIRN_DNS_API_TOKEN')
+      @secret = options[:secret] || ENV.fetch('GEHIRN_DNS_API_SECRET')
+      @user_agent = options[:user_agent] || ENV.fetch('GEHIRN_DNS_USER_AGENT', DEFAULT_USER_AGENT)
+    end
+
+    def get(path)
+      execute :get, path
+    end
+
+    def post(path, body)
+      execute :post, path, body
+    end
+
+    def put(path, body)
+      execute :put, path, body
+    end
+
+    def delete(path)
+      execute :delete, path
+    end
+
+    def base_uri=(base_uri)
+      @base_uri = ::URI.parse(base_uri)
+    end
+
+    def inspect
+      %Q(#<#{self.class}:#{object_id} @base_uri=#{@base_uri.inspect}, @secret=<HIDDEN>, @token=<HIDDEN>, @user_agent=#{@user_agent.inspect}>)
+    end
+
+    private
+
+    def execute(method, path, body = nil)
+      response = request(method, path, body)
+
+      body = if response.header['Content-Type']&.start_with? 'application/json'
+               JSON.parse(response.body, symbolize_names: true)
+             else
+               response.body
+             end
+
+      case response.code.to_i
+      when 200..299
+        body
+      when 401
+        raise UnauthorizedError, 'Expects API key has expired or not valid'
+      when 403
+        raise ForbiddenError, "Expects API key doesn't have a permission to request"
+      when 404
+        raise NotFoundError.new(path, body)
+      when 408
+        raise ReuqestTimeoutError.new(path, body)
+      when 500..599
+        raise RequestError.new(path, body)
+      else
+        raise RequestError.new(path, body)
+      end
+    end
+
+    def request_class_for(method)
+      case method.downcase.to_sym
+      when :get
+        ::Net::HTTP::Get
+      when :post
+        ::Net::HTTP::Post
+      when :put
+        ::Net::HTTP::Put
+      when :delete
+        ::Net::HTTP::Delete
+      else
+        raise ArgumentError, "method: #{method} isn't allowed."
+      end
+    end
+
+    def http
+      http = ::Net::HTTP.new(@base_uri.host, @base_uri.port)
+      http.use_ssl = true
+      http
+    end
+
+    def request(method, path, body = nil)
+      body = body.to_json if body.is_a? Hash
+
+      request_path = Pathname(@base_uri.path) + path.to_s
+
+      request = request_class_for(method).new(request_path.to_s)
+
+      if body
+        request.content_type = 'application/json'
+        request.body = body
+      end
+
+      request.basic_auth(@token, @secret)
+      http.request(request)
+    end
+  end
+end

data/lib/gehirn_dns/error.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class Error < StandardError
+  end
+
+  class ValidationError < Error
+  end
+
+  class UnrequestableError < Error
+  end
+
+  class RequestError < Error
+    attr_reader :path, :body
+
+    def initialize(path, body = nil)
+      @path = path
+      @body = body
+
+      message = "path: #{@path}"
+      message += ", response: #{@body}" if @body
+      super(message)
+    end
+  end
+
+  class UnauthorizedError < RequestError
+  end
+
+  class ForbiddenError < RequestError
+  end
+
+  class NotFoundError < RequestError
+  end
+
+  class RequestToDeletedError < RequestError
+  end
+
+  class RequestTimeoutError < RequestError
+  end
+end

data/lib/gehirn_dns/resource.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'time'
+require 'pathname'
+
+module GehirnDns
+  class Resource
+    attr_reader :client
+
+    def initialize(attrs = {}, client:, base_path: '')
+      attrs.each do |key, value|
+        if key.to_s.end_with? '_at'
+          # rubocop:disable Lint/HandleExceptions
+          begin
+            value = Time.parse(value)
+          rescue ArgumentError
+            # do nothing
+          end
+          # rubocop:enable Lint/HandleExceptions
+        end
+
+        instance_variable_set(:"@#{key}", value)
+      end
+
+      @client = client
+      @base_path = Pathname(base_path)
+    end
+
+    protected
+
+    def plulal_name
+      self.class.to_s.split('::').last.downcase + 's'
+    end
+
+    def resource_path
+      @base_path + plulal_name + @id.to_s
+    end
+
+    def http_get(*args)
+      execute(:get, *args)
+    end
+
+    def http_post(*args)
+      execute(:post, *args)
+    end
+
+    def http_put(*args)
+      execute(:put, *args)
+    end
+
+    def http_delete(*args)
+      response = execute(:delete, *args)
+      mark_as_deleted!
+      response
+    end
+
+    private
+
+    def mark_as_deleted!
+      @deleted = true
+    end
+
+    def execute(method, path, *args)
+      path = resource_path + path unless path.start_with? '/'
+
+      raise RequestToDeletedError, path if @deleted
+
+      @client.send(method, path, *args)
+    end
+  end
+end

data/lib/gehirn_dns/resource/preset.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class Preset < Resource
+    attr_reader :id, :name, :is_completed, :created_at, :applied_at, :completed_at, :next_version_id, :prev_version_id
+
+    def next_version
+      version = http_get "../../versions/#{@next_version_id}"
+      path = resource_path + '../../'
+      Version.new(version, client: @client, base_path: path)
+    end
+
+    def prev_version
+      version = http_get "../../versions/#{@prev_version_id}"
+      path = resource_path + '../../'
+      Version.new(version, client: @client, base_path: path)
+    end
+  end
+end

data/lib/gehirn_dns/resource/record.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class Record
+    attr_reader :id
+    attr_accessor :record_set
+
+    RECORD_TYPES = %i(A AAAA CNAME MX NS SRV TXT).freeze
+    RECORD_FIELDS = {
+      A:     %i(address),
+      AAAA:  %i(address),
+      CNAME: %i(cname),
+      MX:    %i(prio exchange),
+      NS:    %i(nsdname),
+      SRV:   %i(target port weight),
+      TXT:   %i(data),
+    }.freeze
+
+    def initialize(record, record_set: nil)
+      @record_set = record_set
+
+      attribute_names(type: record_set&.type).each do |key|
+        instance_variable_set(:"@#{key}", record[key])
+      end
+
+      redefine_attributes
+    end
+
+    def record_set=(record_set)
+      @record_set = record_set
+
+      redefine_attributes
+
+      @record_set << self if @record_set
+    end
+
+    def to_h
+      attributes
+    end
+
+    def attributes(type: @record_set&.type)
+      Hash[attribute_names(type: type).map{|attr| [attr, instance_variable_get(:"@#{attr}")] }]
+    end
+
+    def attribute_names(type: @record_set&.type)
+      return RECORD_FIELDS.values.flatten unless RECORD_FIELDS.has_key? type
+      RECORD_FIELDS[type]
+    end
+
+    def delete
+      @record_set.delete_record(self)
+    end
+
+    private
+
+    def all_attriubute_names
+      RECORD_FIELDS.values.flatten.uniq
+    end
+
+    def redefine_attributes(type: @record_set&.type)
+      required_attrs = attribute_names(type: type)
+
+      all_attriubute_names.each do |attr|
+        inst_var_sym = :"@#{attr}"
+        setter_sym = "#{attr}="
+
+        if required_attrs.include? attr
+          define_singleton_method(attr) { instance_variable_get(inst_var_sym) }
+
+          define_singleton_method(setter_sym) do |value|
+            instance_variable_set(inst_var_sym, value)
+            @record_set&.update
+          end
+        else
+          remove_instance_variable(inst_var_sym) if instance_variable_defined?(inst_var_sym)
+          singleton_class.class_eval do
+            undef_method attr, setter_sym if respond_to?(setter_sym)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/gehirn_dns/resource/record_set.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class RecordSet < Resource
+    attr_reader :id, :type, :enable_alias, :editable, :version
+    attr_accessor :name, :alias_to, :ttl, :records
+
+    include Enumerable
+
+    def initialize(record_set, editable: true, version: nil, client: nil, base_path: '')
+      @id = record_set[:id]
+      @name = record_set[:name]
+      @type = record_set[:type]&.upcase&.to_sym
+      @ttl = record_set[:ttl]
+      @enable_alias = record_set[:enable_alias] || false
+      @editable = editable # API can ignore it
+
+      singleton_class.class_eval { attr_writer :id, :type, :enable_alias } unless @id
+
+      @version = version
+
+      if @enable_alias
+        @alias_to = record_set[:alias_to]
+        @records = []
+      else
+        @alias_to = nil
+        @records = (record_set[:records] || []).map { |r| Record.new(r, record_set: self) }
+      end
+
+      super(client: client, base_path: base_path)
+    end
+
+    def each
+      @record_set.each { |r| yield r }
+    end
+
+    def name=(name)
+      @name = name
+      update
+    end
+
+    def alias_to=(alias_to)
+      @alias_to = alias_to
+      @enable_alias = true
+      @records = []
+      update
+    end
+
+    def ttl=(ttl)
+      raise StandardError, "alias record can't set ttl" if @enable_alias
+      @ttl = ttl
+      update
+    end
+
+    def version=(version)
+      raise StandardError, "Can't edit version already has" if @id
+
+      @version = version
+      @client = version.client
+      @base_path = version.resource_path
+
+      begin
+        response = http_post '../records', to_h
+        @id = response[:id]
+        @name = response[:name]
+      rescue => e # failed to add record set, revert
+        @version = nil
+        @client = nil
+        @base_path = nil
+        raise e
+      end
+
+      self
+    end
+
+    # append record
+    def <<(record)
+      return self if @records.include?(record) || self.equal?(record.record_set)
+
+      record =  case record
+                when Hash
+                  Record.new(record, record_set: self)
+                when Record
+                  if record.record_set.nil?
+                    record.record_set = self
+                  elsif record.record_set != self
+                    raise ArgumentError, "record is already member of a RecordSet"
+                  end
+
+                  record
+                else
+                  raise ArgumentError
+                end
+
+      @enable_alias = false
+      @alias_to = nil
+      @records << record
+
+      begin
+        update
+      rescue => e # failed to add record, revert
+        @records.delete(record)
+        record.record_set = nil
+        raise e
+      end
+    end
+
+    def records=(records)
+      @records = records.map { |r| Record.new(r, record_set: self) }
+      @enable_alias = false
+
+      update
+    end
+
+    def to_h
+      {
+        id: @id,
+        type: @type,
+        enable_alias: @enable_alias,
+        name: @name,
+        ttl: @ttl,
+        records: @enable_alias ? nil : @records.map(&:to_h),
+        alias_to: @enable_alias ? @alias_to : nil,
+      }.compact
+    end
+
+    def update
+      response = http_put '.', to_h if @client && @version
+      @name = response[:name]
+      self
+    end
+
+    def delete
+      raise UnrequestableError, "record set doen't have a version" unless @client && @version
+      http_delete '.'
+    end
+
+    def delete_record(record)
+      raise ArgumentError, "record isn't member of record set" unless @records.include? record || self.equal?(record.record_set)
+      raise ValidationError, "Can't delete only record of record set" if @records.size == 1
+      @records.delete(record)
+      update
+    end
+
+    protected
+
+    def plulal_name
+      'records'
+    end
+  end
+end

data/lib/gehirn_dns/resource/version.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class Version < Resource
+    attr_reader :id, :name, :editable, :created_at, :last_modified_at, :zone
+
+    def initialize(attrs = {}, zone:, client: nil, base_path: '')
+      @zone = zone
+
+      super(attrs, client: client, base_path: base_path)
+    end
+
+    # TODO: not fqdn matching
+    def record_sets(name: nil, type: nil)
+      type = type.upcase.to_sym if type
+
+      respnose = http_get 'records'
+      respnose \
+        .map { |record_set| RecordSet.new(record_set, editable: @editable, version: self, client: @client, base_path: resource_path) } \
+        .select { |record_set| (name.nil? || record_set.name == name) && (type.nil? || record_set.type == type) }
+    end
+
+    def record_set(id: nil, name: nil, type: nil)
+      raise ArgumentError, "passing both id and name is not allowed" if id && (name || type)
+      raise ArgumentError, "missing keyword: one of id, name, type is required" if !id && !(name || type)
+
+      if id
+        respnose = http_get "records/#{id}"
+        RecordSet.new(respnose, editable: @editable, version: self, client: @client, base_path: resource_path)
+      else
+        record_sets(name: name, type: type).first
+      end
+    end
+
+    def create(name:, base: nil)
+      response = http_post '../', { name: name, base: base }.compact
+      Version.new(response, client: @client, base_path: resource_path + '../../')
+    end
+
+    def clone(name:)
+      create(name: name, base: @id)
+    end
+
+    def delete
+      http_delete '.'
+    end
+
+    def activate!
+      migrate(name: nil, applied_at: nil)
+    end
+
+    def <<(record_set)
+      raise ArgumentError unless record_set.is_a? RecordSet
+      record_set.version = self
+    end
+
+    alias migrate! activate!
+
+    # if prev version is nil, the latest version will set
+    def migrate(name:, applied_at:)
+      payload = {
+        applied_at: applied_at ? applied_at.getutc.strftime('%FT%TZ') : nil,
+        name: name,
+        next_version_id: @id
+      }.compact
+
+      response = http_post '../../presets', payload
+      Preset.new(response, client: @client, base_path: resource_path + '../../')
+    end
+
+    alias create_migration migrate
+  end
+end

data/lib/gehirn_dns/resource/zone.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  class Client
+    def zones
+      response = get 'zones'
+      response.map { |zone| Zone.new(zone, client: self, base_path: '') }
+    end
+
+    def zone(id: nil, name: nil)
+      raise ArgumentError, "passing both id and name is not allowed" if id && name
+      raise ArgumentError, "missing keyword: id or name" if !id && !name
+
+      if id
+        response = get "zones/#{id}"
+        zone = Zone.new(response, client: self, base_path: '')
+      else
+        zone = zones.find { |z| z.name == name }
+      end
+
+      raise NotFoundError if zone.nil?
+
+      zone
+    end
+  end
+
+  class Zone < Resource
+    attr_reader :id, :name, :editable, :created_at, :current_version_id, :last_modified_at
+
+    def current_version
+      response = http_get "versions/#{current_version_id}"
+      Version.new(response, zone: self, client: @client, base_path: resource_path)
+    end
+
+    def current_record_sets(**args)
+      current_version.record_sets(**args)
+    end
+
+    def current_record_set(**args)
+      current_version.record_set(**args)
+    end
+
+    def versions
+      response = http_get 'versions'
+      response.map { |version| Version.new(version, zone: self, client: @client, base_path: resource_path) }.sort_by!(&:last_modified_at)
+    end
+
+    def version(id: nil, name: nil)
+      raise ArgumentError, "passing both id and name is not allowed" if id && name
+      raise ArgumentError, "missing keyword: id or name" if !id && !name
+
+      if id
+        response = http_get "versions/#{id}"
+        version = Version.new(response, zone: self, client: @client, base_path: resource_path)
+      else
+        version = versions.find { |v| v.name == name }
+      end
+
+      raise NotFoundError if version.nil?
+
+      version
+    end
+
+    def presets
+      response = http_get 'presets'
+      response.map { |preset| Preset.new(preset, client: @client, base_path: resource_path) }.sort_by!(&:applied_at)
+    end
+
+    alias migrations presets
+  end
+end

data/lib/gehirn_dns/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module GehirnDns
+  VERSION = '1.0.0.pre'
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: gehirn_dns
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre
+platform: ruby
+authors:
+- kyontan
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-11-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !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: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The Gehirn DNS API client for Ruby
+email:
+- kyontan@monora.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- LICENSE.md
+- README.md
+- Rakefile
+- bin/setup
+- gehirn_dns.gemspec
+- lib/gehirn_dns.rb
+- lib/gehirn_dns/client.rb
+- lib/gehirn_dns/error.rb
+- lib/gehirn_dns/resource.rb
+- lib/gehirn_dns/resource/preset.rb
+- lib/gehirn_dns/resource/record.rb
+- lib/gehirn_dns/resource/record_set.rb
+- lib/gehirn_dns/resource/version.rb
+- lib/gehirn_dns/resource/zone.rb
+- lib/gehirn_dns/version.rb
+homepage: https://github.com/kyontan/gehirn_dns
+licenses: []
+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: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: The Gehirn DNS API client for Ruby
+test_files: []