idcf-dns 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 68baeccea7effe030408dc1ad51a675f778979f5
+  data.tar.gz: 8a6863b8098f8a54d95374ed3b3d1fb9250f8058
+SHA512:
+  metadata.gz: e000d440c35b0abdb1fe6d3430e0d283f5d176aa526633df82e73c44a77c807273e9b336e4490f524523b1dfee2fed853018b4748095f38a5166585a66e840bc
+  data.tar.gz: 106b2809bec9a87613013a2cabb9f821d67ea4b1b3f4638a2e8ac6e5111b96f4371b0c94a90ae2fb35c51416323817dc97f8ab3c87ffe40582246047fd0dc5ae

data/.gitignore

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

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 2.0
+  - 2.1
+  - 2.2

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 nownabe
+
+MIT License
+
+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,136 @@
+# Idcf::Dns
+
+A Ruby client for IDCF Cloud DNS service.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'idcf-dns'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install idcf-dns
+
+## Usage
+### Basic usage
+#### Client
+```ruby
+require "idcf/dns"
+
+client =
+  Idcf::Dns::Client.new(
+    api_key: ENV["IDCF_API_KEY"],
+    secret_key: ENV["IDCF_SECRET_KEY"]
+  )
+
+response = client.get("zones")
+response.success? #=> true
+response.body     #=> [zone1, zone2, ...]
+response.body[0]  #=> zone1
+response[0]       #=> zone1
+response.status   #=> 200
+```
+
+#### Zones
+##### Create new zone
+```ruby
+response =
+  client.create_zone(
+    name: "foobar.example.com",
+    email: "foobar@example.com",
+    description: "description",
+    default_ttl: 600
+  )
+
+response.uuid #=> UUID of new zone
+```
+
+##### Get zones
+```ruby
+# Get all zones
+zones = client.list_zones.body
+zones[0]["name"] #=> "foobar.example.com"
+
+# Get a zone
+zone = client.get_zone(zone_uuid).body
+zone["name"]         #=> "foobar.example.com"
+zone["records"].size #=> 3
+```
+
+##### Update zone
+```ruby
+client.update_zone(zone_uuid, description: "Updated")
+```
+
+##### Delete zone
+```ruby
+client.delete_zone(zone_uuid)
+```
+
+#### Records
+##### Create new record
+```ruby
+response =
+  client.create_record(
+    zone_uuid,
+    name: "baz.foobar.example.com",
+    type: "A",
+    content: "8.8.8.8",
+    ttl: 600
+  )
+
+response.uuid #=> UUID of new record
+```
+
+##### Get records
+```ruby
+# Get all records of a zone
+records = client.list_records(zone_uuid).body
+records[0]["name"] #=> "baz.foobar.example.com"
+
+# Get a record
+record = client.get_record(record_uuid, zone_uuid).body
+record["name"] #=> "baz.foobar.example.com"
+```
+
+##### Update record
+```ruby
+client.update_record(record_uuid, zone_uuid, content: "210.140.158.1")
+```
+
+##### Delete record
+```ruby
+client.delete_record(record_uuid, zone_uuid)
+```
+
+### Advanced usage
+#### Custom expiration of requests 
+```ruby
+expiration = Time.now.to_i + 10
+
+client.list_zones("X-IDCF-Expires": expiration).success?
+#=> true
+
+# wait for 10 seconds ...
+
+client.list_zones("X-IDCF-Expires": expiration)
+#=> Idcf::Dns::ApiError: HTTP status code: 403, Error message: This api request is expired., Reference: http://docs.idcf.jp/cloud/dns
+```
+
+### API reference
+URL
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/idcf-dns/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

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

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "idcf/dns"
+
+# 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,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/idcf-dns.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'idcf/dns/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "idcf-dns"
+  spec.version       = Idcf::Dns::VERSION
+  spec.authors       = ["nownabe"]
+  spec.email         = ["nownabe@gmail.com"]
+
+  spec.summary       = %q{A Ruby client for IDCF Cloud DNS Service.}
+  spec.homepage      = "https://github.com/idcf/idcf-dns-ruby"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.9"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "simplecov"
+
+  spec.add_dependency "activesupport", "~> 4.2.3"
+  spec.add_dependency "faraday", "~> 0.9.1"
+  spec.add_dependency "faraday_middleware", "~> 0.10.0"
+end

data/lib/idcf/dns.rb

@@ -0,0 +1,14 @@
+require "idcf/dns/errors"
+
+# IDCF Cloud SDK
+module Idcf
+  # @author nownabe
+  module Dns
+    autoload :Client          , "idcf/dns/client"
+    autoload :ClientExtensions, "idcf/dns/client_extensions"
+    autoload :Request         , "idcf/dns/request"
+    autoload :Resources       , "idcf/dns/resources"
+    autoload :Response        , "idcf/dns/response"
+    autoload :Validators      , "idcf/dns/validators"
+  end
+end

data/lib/idcf/dns/client.rb

@@ -0,0 +1,149 @@
+require "faraday"
+require "faraday_middleware"
+
+module Idcf
+  module Dns
+    # Client for IDCF DNS service
+    class Client
+      include ClientExtensions::Record
+      include ClientExtensions::Zone
+
+      attr_reader :api_key, :secret_key, :host, :endpoint
+
+      # The constructor of Dns::Client uses keyword arguments.
+      #
+      # @param [String] api_key API key for IDCF Cloud
+      # @param [String] secret_key Secret key for IDCF Cloud
+      def initialize(api_key:,
+                     secret_key:,
+                     host: "dns.idcfcloud.com",
+                     endpoint: "/api/v1",
+                     verify_ssl: true
+                    )
+
+        @api_key    = api_key
+        @secret_key = secret_key
+        @host       = host
+        @endpoint   = endpoint
+        @verify_ssl = verify_ssl
+      end
+
+      # @private
+      def connection
+        @connection ||=
+          Faraday.new(url: url_prefix, ssl: ssl_options) do |connection|
+            connection.request :json
+            connection.response :json
+            connection.adapter Faraday.default_adapter
+          end
+      end
+
+      # Send DELETE request.
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def delete(resource, parameters = {}, headers = {})
+        send(:delete, resource, parameters, headers)
+      end
+
+      # Send DELETE request with handling error
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def delete!(resource, parameters = {}, headers = {})
+        send_with_handling_error(:delete, resource, parameters, headers)
+      end
+
+      # Send GET request
+      #
+      # @param resource [String] Resource name
+      # @param parameters [Hash] Parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def get(resource, parameters = {}, headers = {})
+        send(:get, resource, parameters, headers)
+      end
+
+      # Send GET request with handling error
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def get!(resource, parameters = {}, headers = {})
+        send_with_handling_error(:get, resource, parameters, headers)
+      end
+
+      # Send POST request
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def post(resource, parameters = {}, headers = {})
+        send(:post, resource, parameters, headers)
+      end
+
+      # Send POST request with handling error
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def post!(resource, parameters = {}, headers = {})
+        send_with_handling_error(:post, resource, parameters, headers)
+      end
+
+      # Send PUT request
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def put(resource, parameters = {}, headers = {})
+        send(:put, resource, parameters, headers)
+      end
+
+      # Send PUT request with handling error
+      #
+      # @param resource [String] resource name
+      # @param parameters [Hash] request parameters
+      # @param headers [Hash] HTTP request headers
+      # @return [Response] Response object
+      def put!(resource, parameters = {}, headers = {})
+        send_with_handling_error(:put, resource, parameters, headers)
+      end
+
+      private
+
+      def send(method, resource, parameters = {}, headers = {})
+        Request.new(self, method, resource, parameters, headers).send
+      end
+
+      def send_with_handling_error(method, resource, parameters = {}, headers = {})
+        response = send(method, resource, parameters, headers)
+        unless response.success?
+          fail(
+            ApiError,
+            "HTTP status code: #{response.status}, " \
+            "Error message: #{response.message}, " \
+            "Reference: #{response.reference}"
+          )
+        end
+        response
+      end
+
+      def ssl_options
+        { verify: @verify_ssl }
+      end
+
+      def url_prefix
+        "https://#{host}"
+      end
+    end
+  end
+end

data/lib/idcf/dns/client_extensions.rb

@@ -0,0 +1,11 @@
+module Idcf
+  module Dns
+    # This module includes SDK API methods for Client.
+    module ClientExtensions
+    end
+  end
+end
+
+require "idcf/dns/client_extensions/record"
+require "idcf/dns/client_extensions/template"
+require "idcf/dns/client_extensions/zone"

data/lib/idcf/dns/client_extensions/record.rb

@@ -0,0 +1,90 @@
+module Idcf
+  module Dns
+    module ClientExtensions
+      # SDK APIs for record resource
+      module Record
+        # Create a new record.
+        #
+        # @param zone_uuid [String] UUID of zone
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :name name of record
+        # @option attributes [String] :type type of record
+        #   (A, AAAA, CNAME, MX, TXT or SRV)
+        # @option attributes [String] :content content of record
+        # @option attributes [Integer] :ttl TTL
+        # @option attributes [Integer] :priority priority of record
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def create_record(zone_uuid, attributes, headers = {})
+          Validators::Record.validate_attributes!(attributes, :create)
+          post!("zones/#{zone_uuid}/records", attributes, headers)
+        end
+
+        # Delete a record.
+        #
+        # @param uuid [String] UUID of record
+        # @param zone_uuid [String] UUID of zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def delete_record(uuid, zone_uuid, headers = {})
+          delete!("zones/#{zone_uuid}/records/#{uuid}", {}, headers)
+        end
+
+        # Get a record.
+        #
+        # @param uuid [String] UUID of record
+        # @param zone_uuid [String] UUID of zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def get_record(uuid, zone_uuid, headers = {})
+          get!("zones/#{zone_uuid}/records/#{uuid}", {}, headers)
+        end
+
+        # Get list of records.
+        #
+        # @param zone_uuid [String] UUID of zone
+        # @return [Response] HTTP response object
+        def list_records(zone_uuid, headers = {})
+          get!("zones/#{zone_uuid}/records", {}, headers)
+        end
+
+        # Update a record.
+        #
+        # @param uuid [String] UUID of record
+        # @param zone_uuid [String] UUID of zone
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :name name of record
+        # @option attributes [String] :type type of record
+        #   (A, AAAA, CNAME, MX, TXT or SRV)
+        # @option attributes [String] :content content of record
+        # @option attributes [Integer] :ttl TTL
+        # @option attributes [Integer] :priority priority of record
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def update_record(uuid, zone_uuid, attributes, headers = {})
+          Validators::Record.validate_attributes!(attributes, :update)
+          put!("zones/#{zone_uuid}/records/#{uuid}", attributes, headers)
+        end
+
+        # Get a record object.
+        #
+        # @param uuid [String] UUID of record
+        # @param zone_uuid [String] UUID of zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Resources::Record] a record object
+        def record(uuid, zone_uuid, headers = {})
+          Resources::Record.new(self, get_record(uuid, zone_uuid, headers).body)
+        end
+
+        # Get an array of existing record objects.
+        #
+        # @param zone_uuid [String] UUID of zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Array<Resource::Record>] an array of record objects
+        def records(zone_uuid, headers = {})
+          zone(zone_uuid).records
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/client_extensions/template.rb

@@ -0,0 +1,59 @@
+module Idcf
+  module Dns
+    module ClientExtensions
+      # SDK APIs for template resource
+      module Template
+        # Create a new template.
+        #
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :name unique name of template (required)
+        # @option attributes [String] :description description
+        # @option attributes [Integer] :default_ttl default TTL (required)
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def create_template(attributes, headers = {})
+          Validators::Template.validate_attributes!(attributes, :create)
+          post!("templates", attributes, headers)
+        end
+
+        # Delete a template.
+        #
+        # @param uuid [String] UUID of the target template
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def delete_template(uuid, headers = {})
+          delete!("templates/#{uuid}", {}, headers)
+        end
+
+        # Get a template.
+        #
+        # @param uuid [String] UUID of the target template
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def get_template(uuid, headers = {})
+          get!("templates/#{uuid}", {}, headers)
+        end
+
+        # Get list of existing templates.
+        #
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def list_templates(headers = {})
+          get!("templates", {}, headers)
+        end
+
+        # Update a template.
+        #
+        # @param uuid [String] UUID of the target template
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :description
+        # @option attributes [Integer] :default_ttl default TTL
+        # @return [Reponse] HTTP response object
+        def update_template(uuid, attributes, headers = {})
+          Validators::Template.validate_attributes!(attributes, :update)
+          put!("templates/#{uuid}", attributes, headers)
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/client_extensions/zone.rb

@@ -0,0 +1,80 @@
+module Idcf
+  module Dns
+    module ClientExtensions
+      # SDK APIs for zone resource
+      module Zone
+        # Create a new zone.
+        #
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :name unique name of zone (required)
+        # @option attributes [String] :email e-mail address (required)
+        # @option attributes [String] :description description
+        # @option attributes [Integer] :default_ttl default TTL (required)
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def create_zone(attributes, headers = {})
+          Validators::Zone.validate_attributes!(attributes, :create)
+          post!("zones", attributes, headers)
+        end
+
+        # Delete a zone.
+        #
+        # @param uuid [String] UUID of target zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def delete_zone(uuid, headers = {})
+          delete!("zones/#{uuid}", {}, headers)
+        end
+
+        # Get a zone.
+        #
+        # @param uuid [String] UUID of target zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def get_zone(uuid, headers = {})
+          get!("zones/#{uuid}", {}, headers)
+        end
+
+        # Get list of existing zones
+        #
+        # @param headers [Hash] HTTP request headers
+        # @return [Response] HTTP response object
+        def list_zones(headers = {})
+          get!("zones", {}, headers)
+        end
+
+        # Update a zone.
+        #
+        # @param uuid [String] UUID of target zone
+        # @param attributes [Hash] request attributes
+        # @option attributes [String] :email e-mail address
+        # @option attributes [String] :description description
+        # @option attributes [Integer] :default_ttl default TTL
+        # @return [Response] HTTP response object
+        def update_zone(uuid, attributes, headers = {})
+          Validators::Zone.validate_attributes!(attributes, :update)
+          put!("zones/#{uuid}", attributes, headers)
+        end
+
+        # Get a zone object.
+        #
+        # @param uuid [String] UUID of target zone
+        # @param headers [Hash] HTTP request headers
+        # @return [Resources::Zone] a zone object
+        def zone(uuid, headers = {})
+          Resources::Zone.new(self, get_zone(uuid, headers).body)
+        end
+
+        # Get an array of existing zone objects.
+        #
+        # @param headers [Hash] HTTP request headers
+        # @return [Array<Resources::Zone>] An array of zone objects
+        def zones(headers = {})
+          list_zones(headers).resources.map do |zone|
+            Resources::Zone.new(self, zone)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/errors.rb

@@ -0,0 +1,10 @@
+module Idcf
+  module Dns
+    Error = Class.new(StandardError)
+    ApiError = Class.new(Error)
+    InvalidAttributeName = Class.new(Error)
+    InvalidAttributeType = Class.new(Error)
+    MissingAttribute = Class.new(Error)
+    UnnecessaryAttribute = Class.new(Error)
+  end
+end

data/lib/idcf/dns/request.rb

@@ -0,0 +1,97 @@
+require "base64"
+require "openssl"
+
+module Idcf
+  module Dns
+    # - Send HTTP request
+    # - Generate signatures
+    # - Set default expires
+    class Request
+      attr_reader :client, :method, :resource
+      attr_reader :parameters
+
+      # @private
+      def initialize(client, method, resource, parameters, headers)
+        @client       = client
+        @method       = method
+        @resource     = resource
+        @parameters   = parameters
+        @headers      = headers
+      end
+
+      # @private
+      def send
+        Response.new(
+          client.connection.send(
+            method,
+            path,
+            parameters,
+            headers
+          )
+        )
+      end
+
+      # @private
+      def headers
+        auth_headers.merge(
+          @headers.reject { |key, _| key.to_s == "X-IDCF-Expires" }
+        )
+      end
+
+      private
+
+      def api_key
+        client.api_key
+      end
+
+      def auth_headers
+        {
+          "X-IDCF-Signature" => signature,
+          "X-IDCF-APIKEY" => api_key,
+          "X-IDCF-Expires" => expires
+        }
+      end
+
+      def body
+        if method == :post || method == :put
+          parameters.to_json
+        else
+          ""
+        end
+      end
+
+      def expires
+        @expires ||=
+          (@headers["X-IDCF-Expires"] || @headers[:"X-IDCF-Expires"] || Time.now.to_i + 600).to_s
+      end
+
+      def path
+        "#{client.endpoint}/#{resource}"
+      end
+
+      def secret_key
+        client.secret_key
+      end
+
+      def signature
+        Base64.encode64(
+          OpenSSL::HMAC.digest(
+            OpenSSL::Digest::SHA256.new,
+            secret_key,
+            signature_seed
+          )
+        ).chomp
+      end
+
+      def signature_seed
+        [
+          method.to_s.upcase,
+          path,
+          api_key,
+          expires,
+          ""
+        ].join("\n")
+      end
+    end
+  end
+end

data/lib/idcf/dns/resources.rb

@@ -0,0 +1,11 @@
+module Idcf
+  module Dns
+    # DNS resources module
+    module Resources
+    end
+  end
+end
+
+require "idcf/dns/resources/base"
+require "idcf/dns/resources/record"
+require "idcf/dns/resources/zone"

data/lib/idcf/dns/resources/base.rb

@@ -0,0 +1,60 @@
+require "active_support/core_ext/string/inflections"
+
+module Idcf
+  module Dns
+    module Resources
+      # Base resource class
+      class Base
+        attr_reader :client
+
+        class << self
+          # @private
+          def inherited(subclass)
+            subclass.send(:generate_readers)
+          end
+
+          # @private
+          def class_name
+            to_s.gsub(/^#<Class|>$/, "").split(/::/).last
+          end
+
+          # @private
+          def generate_readers
+            validator_class.valid_attributes.each do |name, properties|
+              next if properties[:reader] == false
+              attr_reader name
+            end
+          end
+
+          # @private
+          def validator_class
+            "Idcf::Dns::Validators::#{class_name}".constantize
+          end
+        end
+
+        # Constructor
+        #
+        # @param client [Client] client object
+        # @param attributes [Hash] attributes for resource
+        def initialize(client, attributes = {})
+          @client = client
+          self.attributes = attributes
+        end
+
+        # Inspect this class
+        def inspect
+          "#<#{self.class}:0x%014x @name=#{name} @uuid=#{uuid}>" % [object_id]
+        end
+
+        private
+
+        def attributes=(attributes)
+          self.class.validator_class.validate_attributes!(attributes)
+          attributes.each do |name, value|
+            instance_variable_set(:"@#{name}", value)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/resources/record.rb

@@ -0,0 +1,9 @@
+module Idcf
+  module Dns
+    module Resources
+      # Record resource class
+      class Record < Base
+      end
+    end
+  end
+end

data/lib/idcf/dns/resources/zone.rb

@@ -0,0 +1,23 @@
+module Idcf
+  module Dns
+    module Resources
+      # Zone resource class
+      class Zone < Base
+        # @return [Array<Record>] an array of records
+        def records
+          return @record_objects if @record_objects
+          refresh
+          @record_objects = @records.map { |record| Record.new(client, record) }
+        end
+
+        # Refresh this zone
+        #
+        # @return [Zone] self object
+        def refresh
+          self.attributes = client.get_zone(uuid).body
+          self
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/response.rb

@@ -0,0 +1,88 @@
+require "forwardable"
+
+module Idcf
+  module Dns
+    # HTTP response
+    class Response
+      extend Forwardable
+
+      # @!attribute [r] body
+      #   @return [Hash, Array, nil] response body as a hash,
+      #     an array of hashes or nil.
+      # @!attribute [r] headers
+      #   @return [Hash] HTTP response headers
+      # @!attribute [r] status
+      #   @return [Integer] HTTP status code
+      attr_reader :body, :headers, :status
+
+      # @param faraday_response [Faraday::Response]
+      def initialize(faraday_response)
+        @body    = faraday_response.body
+        @headers = faraday_response.headers
+        @status  = faraday_response.status
+      end
+
+      def_delegator :@body, :[]
+
+      # Returns the number of resources.
+      #
+      # @return [Fixnum] count of resources.
+      def count
+        case body
+        when Array
+          body.size
+        when Hash
+          if body.key?("uuid")
+            1
+          else
+            0
+          end
+        else
+          0
+        end
+      end
+      alias_method :size, :count
+
+      # Returns error message.
+      # When request succeed, this returns nil.
+      #
+      # @return [String] API error message
+      def message
+        if success?
+          nil
+        else
+          body ? self["message"] : "Resource not found."
+        end
+      end
+
+      # Returns error reference.
+      # When request succeed, this returns nil.
+      #
+      # @return [String] API error reference
+      def reference
+        if success?
+          nil
+        else
+          body ? self["reference"] : "No reference"
+        end
+      end
+
+      # Returns an array of resource hashes.
+      #
+      # @return [Array<Hash>] an array of resource hashes
+      def resources
+        body && [*body]
+      end
+
+      # @return [Boolean] request success?
+      def success?
+        status < 400
+      end
+
+      # @return [String] UUID of a resource
+      def uuid
+        body.is_a?(Hash) && body.key?("uuid") ? self["uuid"] : nil
+      end
+    end
+  end
+end

data/lib/idcf/dns/validators.rb

@@ -0,0 +1,12 @@
+module Idcf
+  module Dns
+    # Validators for request attributes.
+    module Validators
+    end
+  end
+end
+
+require "idcf/dns/validators/base"
+require "idcf/dns/validators/record"
+require "idcf/dns/validators/template"
+require "idcf/dns/validators/zone"

data/lib/idcf/dns/validators/base.rb

@@ -0,0 +1,82 @@
+require "active_support/core_ext/class/attribute"
+
+module Idcf
+  module Dns
+    module Validators
+      # Base validator class
+      class Base
+        class_attribute :valid_attributes
+
+        class << self
+          # Validate requeste attributes.
+          # If there are invalid attributes, error occurs.
+          #
+          # @param attributes [Hash] request attributes
+          # @param action [Symbol] request method
+          def validate_attributes!(attributes, action = nil)
+            required_attributes(action).each do |name|
+              unless attributes.key?(name)
+                fail(
+                  MissingAttribute,
+                  "`#{name}` is required in #{action} action"
+                )
+              end
+            end
+            attributes.each do |name, value|
+              if action &&
+                  (!valid_attributes[name] || !valid_attributes[name][action])
+                fail(
+                  UnnecessaryAttribute,
+                  "`#{name}` is unnecessary in #{action} action"
+                )
+              end
+              validate_attribute_name!(name)
+              validate_attribute_type!(name, value)
+            end
+          end
+
+          private
+
+          def required_attributes(action)
+            return [] unless action
+            valid_attributes.select do |_, validator|
+              validator[action] == :required
+            end.keys
+          end
+
+          def valid_attribute?(value, valid_type)
+            case valid_type
+            when Array
+              valid_type.any? { |t| valid_attribute?(value, t) }
+            when Regexp
+              if value.is_a?(String)
+                valid_type =~ value
+              else
+                false
+              end
+            else
+              value.is_a?(valid_type)
+            end
+          end
+
+          def validate_attribute_name!(name)
+            return true if valid_attributes.key?(name.to_sym)
+            fail(
+              InvalidAttributeName,
+              "`#{name}` is invalid attribute name"
+            )
+          end
+
+          def validate_attribute_type!(name, value)
+            valid_type = valid_attributes[name.to_sym][:type]
+            return true if valid_attribute?(value, valid_type)
+            fail(
+              InvalidAttributeType,
+              "`#{name}` is required to be a #{valid_type}"
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/idcf/dns/validators/record.rb

@@ -0,0 +1,19 @@
+module Idcf
+  module Dns
+    module Validators
+      # Record validator class
+      class Record < Base
+        self.valid_attributes = {
+          uuid:        { type: String },
+          name:        { type: String, create: :required, update: :optional },
+          type:        { type: /^(A|CNAME|AAAA|MX|TXT|SRV|NS|SOA)$/, create: :required, update: :optional },
+          content:     { type: [String, Hash], create: :required, update: :optional },
+          ttl:         { type: Integer, create: :required, update: :optional },
+          priority:    { type: [Integer, NilClass], create: :optional },
+          created_at:  { type: String },
+          updated_at:  { type: String }
+        }
+      end
+    end
+  end
+end

data/lib/idcf/dns/validators/template.rb

@@ -0,0 +1,18 @@
+module Idcf
+  module Dns
+    module Validators
+      # Template validator class
+      class Template < Base
+        self.valid_attributes = {
+          uuid:        { type: String },
+          name:        { type: String, create: :required },
+          description: { type: String, create: :optional, update: :optional },
+          default_ttl: { type: Integer, create: :required, update: :optional },
+          created_at:  { type: String },
+          updated_at:  { type: String },
+          records:     { type: Array, reader: false }
+        }
+      end
+    end
+  end
+end

data/lib/idcf/dns/validators/zone.rb

@@ -0,0 +1,20 @@
+module Idcf
+  module Dns
+    module Validators
+      # Zone validator class
+      class Zone < Base
+        self.valid_attributes = {
+          uuid:          { type: String },
+          name:          { type: String, create: :required },
+          email:         { type: String, create: :required, update: :optional },
+          description:   { type: String, create: :optional, update: :optional },
+          default_ttl:   { type: Integer, create: :required, update: :optional },
+          template_uuid: { type: String, create: :optional },
+          created_at:    { type: String },
+          updated_at:    { type: String },
+          records:       { type: Array, reader: false }
+        }
+      end
+    end
+  end
+end

data/lib/idcf/dns/version.rb

@@ -0,0 +1,5 @@
+module Idcf
+  module Dns
+    VERSION = "0.0.2"
+  end
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: idcf-dns
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- nownabe
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-08-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.9'
+- !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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  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'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.2.3
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.1
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.0
+description: 
+email:
+- nownabe@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- idcf-dns.gemspec
+- lib/idcf/dns.rb
+- lib/idcf/dns/client.rb
+- lib/idcf/dns/client_extensions.rb
+- lib/idcf/dns/client_extensions/record.rb
+- lib/idcf/dns/client_extensions/template.rb
+- lib/idcf/dns/client_extensions/zone.rb
+- lib/idcf/dns/errors.rb
+- lib/idcf/dns/request.rb
+- lib/idcf/dns/resources.rb
+- lib/idcf/dns/resources/base.rb
+- lib/idcf/dns/resources/record.rb
+- lib/idcf/dns/resources/zone.rb
+- lib/idcf/dns/response.rb
+- lib/idcf/dns/validators.rb
+- lib/idcf/dns/validators/base.rb
+- lib/idcf/dns/validators/record.rb
+- lib/idcf/dns/validators/template.rb
+- lib/idcf/dns/validators/zone.rb
+- lib/idcf/dns/version.rb
+homepage: https://github.com/idcf/idcf-dns-ruby
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: A Ruby client for IDCF Cloud DNS Service.
+test_files: []