idcf-dns 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b861ba7b2191302c0ed3274701013ee502adf511
-  data.tar.gz: c28eb0197d213f6f3d68cabf592c385093800949
+  metadata.gz: 09205c0f89224e460fd1dccf2768a051bdd824fb
+  data.tar.gz: 32ca6b5153e6a497f04b7c758359dcb03e998d53
 SHA512:
-  metadata.gz: 5268d175b7674ccfc191b2c443a5415f04469710912c96324aa54b488cb6a230e2b5a928f5bddea479a2de5b2e308f5736050a55344739ab06d747705af8e553
-  data.tar.gz: d6da59613a8567de2e9c65569f4348424a32ac8ad1e5b6159c13ff99fdf38bf01886e19a0ffb7845d8a58030384f243d6c9f8f75d20c01fb544d86610c281c24
+  metadata.gz: 475670a05e091e75b3345c89343a1ab7857d88df8f0e5246b7d58f71ef884abdfea2e01fb25ed27903371f7eba63dff3128d1a597b62a9bf3f8f4b664d074be9
+  data.tar.gz: 2f5066946cf9f0551d88e4af1acf9537762e3074f8451c752536f4bd7ae04e3d9252aed396337bd2a36c5dffef1c1beb195d7e1d93f02cbfef3a23ceabb80a94

data/.gitignore

@@ -8,3 +8,4 @@
 /spec/reports/
 /tmp/
 /.env
+/.idea/

data/.rubocop.yml

@@ -0,0 +1,91 @@
+AllCops:
+  Exclude:
+    - "Gemfile"
+    - "*.gemspec"
+  DisplayCopNames: true
+
+Documentation:
+  Enabled: false
+
+Lint/AssignmentInCondition:
+  Enabled: false
+
+Lint/HandleExceptions:
+  Enabled: false
+
+Lint/UnderscorePrefixedVariableName:
+  Enabled: false
+
+Lint/UnusedBlockArgument:
+  Enabled: false
+
+Lint/UnusedMethodArgument:
+  Enabled: false
+
+Metrics/AbcSize:
+  Max: 20
+
+Metrics/CyclomaticComplexity:
+  Max: 6
+
+Metrics/LineLength:
+  Max: 100
+
+Metrics/MethodLength:
+  Max: 20
+
+Metrics/PerceivedComplexity:
+  Max: 7
+
+Style/AccessorMethodName:
+  Enabled: false
+
+Style/AsciiComments:
+  Enabled: false
+
+Style/Documentation:
+  Enabled: false
+
+Style/DoubleNegation:
+  Enabled: false
+
+Style/FormatString:
+  EnforcedStyle: percent
+
+Style/GuardClause:
+  MinBodyLength: 4
+
+Style/IfUnlessModifier:
+  Enabled: false
+
+Style/MultilineBlockChain:
+  Enabled: false
+
+Style/NumericLiterals:
+  MinDigits: 7
+
+Style/PredicateName:
+  NamePrefixBlacklist:
+    - "is_"
+    - "have_"
+
+Style/SignalException:
+  EnforcedStyle: only_raise
+
+Style/SingleLineBlockParams:
+  Enabled: false
+
+Style/SpaceAroundOperators:
+  MultiSpaceAllowedForOperators:
+    - "="
+    - "=>"
+    - "||="
+
+Style/SpaceBeforeComma:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/TrailingComma:
+  Enabled: false

data/.travis.yml

@@ -1,4 +1,12 @@
 language: ruby
 rvm:
-  - 2.1
-  - 2.2
+- 2.1
+- 2.2
+notifications:
+  slack:
+    secure: SLkfrjKn4L1J3sghg53QtvP9InoEvIgDpqsFBypxOH99EcI5XbonfBR/40Os66IFRzaLbGeSYY3/0ZEZiYnE7eEWr+q33uXomjGMSBSPdXKJ9GWFR1qou7vqu+K2TY6gzGK2VGpkp9YMRBrCDjxDgVilVAblH1N9Ba8DAAxggkaogm46UTkiy/37/uVSdvcqvLil6Stw/8jFR60ulJpC4hrIQzwqOQTWJNq6Czl3p4bWex+igNnQePZPg5/f/m6yG3KBptZZw2KryZNNMaEN8C6UDWf6l28oc2MFZecMTJvmBwjQlUzZcEy49/RHobSKhGG3V9yQ4fQoSrZjAT2wF4da4L7sCGGAyKFARySN2q0IRW2ES/c4VZTgB7ZW3HZvuJKbP65HQ+Sf775NtwOcepQ3dAr0dTOsHGEioDAeDdmMpx2eu5V+A3B/uz1mn07l5TfXC9V6mB176/gPBx/B9jnQWgKjCn4uquzxwTUBA+3LzZBl4vTN6c8slpJzbz2aPB36uy6HGqIV8KKxOyQ5zktBEXc2HxisE7QwV/Mq2HDsaqS98lzlbID/ClG4t7C66vZPIZmaXw8yvGQ2R9ic3Iv4u6BIAkBywZQdf/+V8yxLoeYbjYx83fsTUOwD5nnWP7PrVdeKXAF67fu11q7D5VmD60uHmuhCvOLqDyg4Ayk=
+env:
+  global:
+  - secure: gmihQQUbvRFS817ekFXDFOvWRXRIvK66BXBIBiArroRb3C+J/xJJXR96ieJhWfEwW0P3nVFRLcDBV20lzt2+eqsmOX6O9lJXMHrJP0yi0aHVuDH5xgqSBHM3NtRDNG2MACYGC8dK2Jk/TlNi60TB4P51hUrb+mLyelYvrb1WAmtrNWchvG+YqWx5YP/3ONOS5HR8U6NR3xSHT4Rxw0Y+sBB7qba4QIwMO2wgufc0IOMddlB0KkOZru6rmI8hZR/Ko+eGqkMlV3wzD+brKumnuY/MM1l4VWbU4Ol+VMM7swXDDJyWZ5Uxo5dpkccAZNn59hKqShr6kPR9+FHSjHbWx2bb997Gy5bgsJtSQYqbqurHSAmcI8UhTC0vyyp+gyZxTN93CL0AoyWRqFB4bfQHjhrl9mdIO9R3SrMe2tuyOmqLkPL0JZbaiSszkMya+C9VzuD21UJUTLyz4ldHOcng94S3TuLvfeoK9auQwJVBclW9KjwjvovNRdYjYa5pM37kHWmhzZB6tyZvsy8GrrenxJd2gBZ/w7g2zUoKutbC4DW1TNSzSL8e5UKRxFOyZaV0xNmqZ6SQVOHrUdbX+ouMsVZOXCQseBcCMXzcyyalMJLg8DecR8H4rrmdrBD6XSYofjIn6r2efiFs8OHrDMiM16KAmbvdaspceUfZi+SsVRY=
+  - secure: N3W1pF66bVNCOG5tLk0xPOGP48mODYcNHEiQ/n4yhlHi2Ckoj/R7DT4koqSI12o5ajm2lBdAcw0A0SRsPIORi7j4QIGvXhY3mY3HmP1kK4oUr/X5C+RRNSQ//+x6U+Xs4dNDpR/fIv1+jIOXFYXVejY8Mu8+OrXmJBdbsGr+xWN2qI9vi0vztLB0bqrQG58moAj3W7yEC0UTwsS683nvOnXWSQQN86MS/1aTTAScFbMwQDZRdzuu+Zh0ZfzM4BzsDCRYrc2cv5Foj8a6VxeB57TQwQ8mkSmsupr4AyTS5H2TqqaBxPuS9KloOIx3jLVr52Iq8mCHjcFCM4xCXiRIIFeuMPe83V5yTFq73pY5HpJsLCaXOguuVD6vov2iyBe3Ih06BSVytVpyRZJNflfBoqU8Z/iK5Rvsj4w+mxBI4jd0mLmDVm91K2MImOGf5Ghe7Y2eokAuJ3LXHFIFQbjI6AC5RYIlb8iYWtPPA0yuVWc+Z4jxcHwt1mDq2rlFz+/sQlgYvQkeL4UVQ9iRKRe0RQXrwFZi+Qb1rPJiu0lld9cNBy1Z52HfYO5WFYVvOZzQbzw51HhXqUzIttYlEOkY9ZCuZp+3eFSVBdej8/upbU/NaQ5jM4baXz6KgitXN3OqDQHPD7brinMbKxSwnc9kanj9ietMyowsCJVzrrsI62E=
+  - secure: nXMDbYg/8Fd2EEGqPitCrK544eZJ+u9liPPjkiHYyLB+zhD9bslV9XzrDpWi7sjiwtZcgF/E7jTC3nmInn85idt7exS81mBPCO3hMmZk8sBp/zefmVIIti/9PKfjfYihxdWQVJXiLPVyYEmuWvZv11wCyWG5/vyuP3LSQHdmnaiU82xPTVJBLMJobusoyae8voMIVjepNH4BHmZ2fC4SdZ/ajbFcxwy+o0GLRJDaypJTn7UejX0wAGykqDtRY4LVTpPfaSiMEjegL6HIOc6cTuuQ0/AhK9Aw1fuNecrom+LTZtNGUUmNUzDr1F2C71txQ3vc1OaifB0E0PBNiwG6nhh2QKPJhG7KlqUN5mspyfZDp93N+VvnqPIbxvpVIIDcQR6e6Mug1Wm0fvtcB6weNAbp3sNqMH8NUXSGZdZHrWsQPKSEUp7iKiTqSY5kLbLpxqI6dNfcDoJ7J36ExmIPkj7rlgfCllFBGFOEeR33ydTjUDDWWoDmB8NBV0Pf8RiTq9AcBE3r7nHcSDFYEzX0MOCLikqujLOd5uuQp4Us8HQOyMtIrQEMqlHpAfNu0Uu2Sdd04zo5ndgDx2eTEwZYRCqzDllBvNWzk/Wgbd1qW9xh67vKsD9Ixo/t8kS8ge15naaO392i+UrRTcXwQwOiLHaUDXY4R9DD2NKkZtIysS8=

data/README.md

@@ -1,6 +1,6 @@
 # Idcf::Dns
 [![Gem Version](https://badge.fury.io/rb/idcf-dns.svg)](http://badge.fury.io/rb/idcf-dns)
-[![Build Status](https://travis-ci.org/idcf/idcf-dns-ruby.svg)](https://travis-ci.org/idcf/idcf-dns-ruby)
+[![Build Status](https://travis-ci.org/idcf/idcf-dns-ruby.svg?branch=master)](https://travis-ci.org/idcf/idcf-dns-ruby)
 [![Code Climate](https://codeclimate.com/github/idcf/idcf-dns-ruby/badges/gpa.svg)](https://codeclimate.com/github/idcf/idcf-dns-ruby)
 [![Test Coverage](https://codeclimate.com/github/idcf/idcf-dns-ruby/badges/coverage.svg)](https://codeclimate.com/github/idcf/idcf-dns-ruby/coverage)
 
@@ -49,7 +49,7 @@ response[0]       #=> zone1
 ```
 
 #### Zones
-##### Create new zone
+##### Create a new zone
 ```ruby
 response =
   client.create_zone(
@@ -74,18 +74,18 @@ zone["name"]         #=> "foobar.example.com"
 zone["records"].size #=> 3
 ```
 
-##### Update zone
+##### Update a zone
 ```ruby
 client.update_zone(zone_uuid, description: "Updated")
 ```
 
-##### Delete zone
+##### Delete a zone
 ```ruby
 client.delete_zone(zone_uuid)
 ```
 
 #### Records
-##### Create new record
+##### Create a new record
 ```ruby
 response =
   client.create_record(
@@ -110,18 +110,18 @@ record = client.get_record(zone_uuid, record_uuid).body
 record["name"] #=> "baz.foobar.example.com"
 ```
 
-##### Update record
+##### Update a record
 ```ruby
 client.update_record(zone_uuid, record_uuid, content: "210.140.158.1")
 ```
 
-##### Delete record
+##### Delete a record
 ```ruby
 client.delete_record(zone_uuid, record_uuid)
 ```
 
 ### Advanced usage
-#### Custom expiration of requests 
+#### Custom expiration of requests
 In default, requests will expire in 600 seconds.
 You can use custom expirations for each request.
 

data/Rakefile

@@ -1,5 +1,13 @@
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
+require "rubocop/rake_task"
 
 RSpec::Core::RakeTask.new(:spec)
-task default: :spec
+task default: [:rubocop, :spec]
+
+desc "Run RuboCop on the lib directory"
+RuboCop::RakeTask.new(:rubocop) do |task|
+  task.patterns = ["lib/**/*.rb", "spec/**/*.rb"]
+  task.formatters = ["files"]
+  task.fail_on_error = true
+end

data/idcf-dns.gemspec

@@ -22,6 +22,7 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency "dotenv"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rubocop"
   spec.add_development_dependency "simplecov"
 
   spec.add_dependency "activesupport", "~> 4.2.3"

data/lib/idcf/dns/client.rb

@@ -127,7 +127,7 @@ module Idcf
       def send!(method, resource, parameters = {}, headers = {})
         response = send(method, resource, parameters, headers)
         unless response.success?
-          fail(
+          raise(
             ApiError,
             "HTTP status code: #{response.status}, " \
             "Error message: #{response.message}, " \

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

@@ -15,6 +15,27 @@ module Idcf
         # @option attributes [Integer] :priority priority of record
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.create_record(
+        #       "ddcd8dbf-8d99-4f49-9958-7dd9a0bfb67f",
+        #       name: "www.foobar.example.com",
+        #       type: "A",
+        #       content: "8.8.8.8",
+        #       ttl: 3600
+        #     )
+        #
+        #   response.body #=>
+        #     {"uuid"=>"40d5f26f-02bd-4fb1-b363-323675772289",
+        #      "name"=>"www.foobar.example.com",
+        #      "type"=>"A",
+        #      "content"=>"8.8.8.8",
+        #      "ttl"=>3600,
+        #      "created_at"=>"2015-11-09T11:43:50+09:00",
+        #      "updated_at"=>nil,
+        #      "priority"=>nil}
+        #
+        #   response.uuid #=> "40d5f26f-02bd-4fb1-b363-323675772289"
         def create_record(zone_uuid, attributes, headers = {})
           Validators::Record.validate_attributes!(attributes, :create)
           post!("zones/#{zone_uuid}/records", attributes, headers)
@@ -26,6 +47,16 @@ module Idcf
         # @param uuid [String] UUID of record
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.delete_record(
+        #       "ddcd8dbf-8d99-4f49-9958-7dd9a0bfb67f",
+        #       "d612aabb-3fea-471a-8712-586f1ac9c29c"
+        #     )
+        #
+        #   response.body #=> {}
+        #
+        #   response.status #=> 200
         def delete_record(zone_uuid, uuid, headers = {})
           delete!("zones/#{zone_uuid}/records/#{uuid}", {}, headers)
         end
@@ -36,6 +67,22 @@ module Idcf
         # @param uuid [String] UUID of record
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.get_record(
+        #       "ddcd8dbf-8d99-4f49-9958-7dd9a0bfb67f",
+        #       "d612aabb-3fea-471a-8712-586f1ac9c29c"
+        #     )
+        #
+        #   response.body #=>
+        #     {"uuid"=>"ecacc77f-e678-4f29-b6dd-6bec79c172a1",
+        #      "name"=>"www.foobar.example.com",
+        #      "type"=>"A",
+        #      "content"=>"8.8.8.8",
+        #      "ttl"=>3600,
+        #      "created_at"=>"2015-11-09T16:07:21+09:00",
+        #      "updated_at"=>nil,
+        #      "priority"=>nil}
         def get_record(zone_uuid, uuid, headers = {})
           get!("zones/#{zone_uuid}/records/#{uuid}", {}, headers)
         end
@@ -44,6 +91,58 @@ module Idcf
         #
         # @param zone_uuid [String] UUID of zone
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.list_records("ddcd8dbf-8d99-4f49-9958-7dd9a0bfb67f")
+        #
+        #   response.body #=>
+        #     [{"uuid"=>"9fae4a12-319c-4afc-ac33-4542ef79dd0b",
+        #       "name"=>"foobar.example.com",
+        #       "type"=>"SOA",
+        #       "content"=>
+        #        {"dns"=>"ns01.idcfcloud.com",
+        #         "email"=>"foobar.example.com.",
+        #         "serial"=>4,
+        #         "refresh"=>10800,
+        #         "retry"=>3600,
+        #         "expire"=>604800,
+        #         "ttl"=>3600},
+        #       "ttl"=>3600,
+        #       "created_at"=>"2015-11-09T13:24:58+09:00",
+        #       "updated_at"=>"2015-11-09T16:07:21+09:00",
+        #       "priority"=>nil},
+        #      {"uuid"=>"f61a75b7-8e9c-4e69-a91a-6e6aa90c2990",
+        #       "name"=>"foobar.example.com",
+        #       "type"=>"NS",
+        #       "content"=>"ns01.idcfcloud.com",
+        #       "ttl"=>3600,
+        #       "created_at"=>"2015-11-09T13:24:58+09:00",
+        #       "updated_at"=>nil,
+        #       "priority"=>nil},
+        #      {"uuid"=>"0195fe5d-7cff-4f94-8886-a13bb0f609b4",
+        #       "name"=>"foobar.example.com",
+        #       "type"=>"NS",
+        #       "content"=>"ns02.idcfcloud.com",
+        #       "ttl"=>3600,
+        #       "created_at"=>"2015-11-09T13:24:58+09:00",
+        #       "updated_at"=>nil,
+        #       "priority"=>nil},
+        #      {"uuid"=>"0bdc7d49-b1aa-4455-903f-35dc3c4338be",
+        #       "name"=>"foobar.example.com",
+        #       "type"=>"NS",
+        #       "content"=>"ns03.idcfcloud.com",
+        #       "ttl"=>3600,
+        #       "created_at"=>"2015-11-09T13:24:58+09:00",
+        #       "updated_at"=>nil,
+        #       "priority"=>nil},
+        #      {"uuid"=>"ecacc77f-e678-4f29-b6dd-6bec79c172a1",
+        #       "name"=>"www.foobar.example.com",
+        #       "type"=>"A",
+        #       "content"=>"8.8.8.8",
+        #       "ttl"=>3600,
+        #       "created_at"=>"2015-11-09T16:07:21+09:00",
+        #       "updated_at"=>nil,
+        #       "priority"=>nil}]
         def list_records(zone_uuid, headers = {})
           get!("zones/#{zone_uuid}/records", {}, headers)
         end
@@ -61,6 +160,23 @@ module Idcf
         # @option attributes [Integer] :priority priority of record
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.update_record(
+        #       "ddcd8dbf-8d99-4f49-9958-7dd9a0bfb67f",
+        #       "d612aabb-3fea-471a-8712-586f1ac9c29c",
+        #       content: "6.6.6.6"
+        #     )
+        #
+        #   response.body #=>
+        #     {"uuid"=>"ecacc77f-e678-4f29-b6dd-6bec79c172a1",
+        #      "name"=>"www.foobar.example.com",
+        #      "type"=>"A",
+        #      "content"=>"6.6.6.6",
+        #      "ttl"=>3600,
+        #      "created_at"=>"2015-11-09T16:07:21+09:00",
+        #      "updated_at"=>"2015-11-09T16:22:17+09:00",
+        #      "priority"=>nil}
         def update_record(zone_uuid, uuid, attributes, headers = {})
           Validators::Record.validate_attributes!(attributes, :update)
           put!("zones/#{zone_uuid}/records/#{uuid}", attributes, headers)

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

@@ -12,6 +12,65 @@ module Idcf
         # @option attributes [Integer] :default_ttl default TTL (required)
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.create_zone(
+        #       name: "foobar.example.com",
+        #       email: "foobar@example.com",
+        #       description: "",
+        #       default_ttl: 600
+        #     )
+        #
+        #   response.body #=>
+        #     {"uuid"=>"384178f5-58a5-4f3c-9607-5e189ab2990d",
+        #      "name"=>"foobar.example.com",
+        #      "default_ttl"=>600,
+        #      "created_at"=>"2015-11-09T11:43:49+09:00",
+        #      "updated_at"=>nil,
+        #      "records"=>
+        #       [{"uuid"=>"6aba1170-83b9-4324-b331-8c2b8dcb5162",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"SOA",
+        #         "content"=>
+        #          {"dns"=>"ns01.idcfcloud.com",
+        #           "email"=>"foobar.example.com.",
+        #           "serial"=>1,
+        #           "refresh"=>10800,
+        #           "retry"=>3600,
+        #           "expire"=>604800,
+        #           "ttl"=>3600},
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"0b18679d-dd47-46fe-8812-d20c284001ac",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns01.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"a5a9ab9c-b19f-4411-880e-842ffd53027c",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns02.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"2756ed66-2b69-4ae2-8065-69ac2b12b71d",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns03.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil}],
+        #      "description"=>"",
+        #      "authenticated"=>false}
+        #
+        #   response.uuid #=> "384178f5-58a5-4f3c-9607-5e189ab2990d"
         def create_zone(attributes, headers = {})
           Validators::Zone.validate_attributes!(attributes, :create)
           post!("zones", attributes, headers)
@@ -22,6 +81,13 @@ module Idcf
         # @param uuid [String] UUID of target zone
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.delete_zone("83f55e72-e3fa-4961-89b3-99ee43617b93")
+        #
+        #   response.body #=> {}
+        #
+        #   response.status #=> 200
         def delete_zone(uuid, headers = {})
           delete!("zones/#{uuid}", {}, headers)
         end
@@ -31,6 +97,66 @@ module Idcf
         # @param uuid [String] UUID of target zone
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.get_zone("b19e8211-e492-425d-b66a-7642dc2ff8fb")
+        #
+        #   response.body #=>
+        #     {"uuid"=>"b19e8211-e492-425d-b66a-7642dc2ff8fb",
+        #      "name"=>"foobar.example.com",
+        #      "default_ttl"=>600,
+        #      "created_at"=>"2015-11-09T11:43:49+09:00",
+        #      "updated_at"=>nil,
+        #      "records"=>
+        #       [{"uuid"=>"1f30afd1-9b5e-45df-b03e-d07779a90e1c",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"SOA",
+        #         "content"=>
+        #          {"dns"=>"ns01.idcfcloud.com",
+        #           "email"=>"foobar.example.com.",
+        #           "serial"=>2,
+        #           "refresh"=>10800,
+        #           "retry"=>3600,
+        #           "expire"=>604800,
+        #           "ttl"=>3600},
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>"2015-11-09T11:43:50+09:00",
+        #         "priority"=>nil},
+        #        {"uuid"=>"b5322649-625d-4b50-8cd3-7542f64912fa",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns01.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"1fb4d44c-160a-45cd-835c-eb47fe1edb27",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns02.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"765f8426-70b8-46c6-a45b-836c5dd57a7d",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns03.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"ea81d8c0-8c6d-47e7-bca7-33656888a293",
+        #         "name"=>"www.foobar.example.com",
+        #         "type"=>"A",
+        #         "content"=>"8.8.8.8",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:50+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil}],
+        #      "description"=>"",
+        #      "authenticated"=>false}
         def get_zone(uuid, headers = {})
           get!("zones/#{uuid}", {}, headers)
         end
@@ -39,6 +165,18 @@ module Idcf
         #
         # @param headers [Hash] HTTP request headers
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.list_zones
+        #
+        #   response.body #=>
+        #     [{"uuid"=>"384178f5-58a5-4f3c-9607-5e189ab2990d",
+        #       "name"=>"foobar.example.com",
+        #       "default_ttl"=>600,
+        #       "created_at"=>"2015-11-09T11:43:49+09:00",
+        #       "updated_at"=>nil,
+        #       "description"=>"",
+        #       "authenticated"=>false}]
         def list_zones(headers = {})
           get!("zones", {}, headers)
         end
@@ -51,6 +189,70 @@ module Idcf
         # @option attributes [String] :description description
         # @option attributes [Integer] :default_ttl default TTL
         # @return [Response] HTTP response object
+        # @example
+        #   response =
+        #     client.update_zone(
+        #       "384178f5-58a5-4f3c-9607-5e189ab2990d",
+        #       description: "Change description",
+        #       default_ttl: 3600
+        #     )
+        #
+        #   response.body #=>
+        #     {"uuid"=>"384178f5-58a5-4f3c-9607-5e189ab2990d",
+        #      "name"=>"foobar.example.com",
+        #      "default_ttl"=>3600,
+        #      "created_at"=>"2015-11-09T11:43:49+09:00",
+        #      "updated_at"=>"2015-11-09T11:43:50+09:00",
+        #      "records"=>
+        #       [{"uuid"=>"6aba1170-83b9-4324-b331-8c2b8dcb5162",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"SOA",
+        #         "content"=>
+        #          {"dns"=>"ns01.idcfcloud.com",
+        #           "email"=>"foobar.example.com.",
+        #           "serial"=>2,
+        #           "refresh"=>10800,
+        #           "retry"=>3600,
+        #           "expire"=>604800,
+        #           "ttl"=>3600},
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>"2015-11-09T11:43:50+09:00",
+        #         "priority"=>nil},
+        #        {"uuid"=>"0b18679d-dd47-46fe-8812-d20c284001ac",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns01.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"a5a9ab9c-b19f-4411-880e-842ffd53027c",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns02.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"2756ed66-2b69-4ae2-8065-69ac2b12b71d",
+        #         "name"=>"foobar.example.com",
+        #         "type"=>"NS",
+        #         "content"=>"ns03.idcfcloud.com",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:49+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil},
+        #        {"uuid"=>"40d5f26f-02bd-4fb1-b363-323675772289",
+        #         "name"=>"www.foobar.example.com",
+        #         "type"=>"A",
+        #         "content"=>"8.8.8.8",
+        #         "ttl"=>3600,
+        #         "created_at"=>"2015-11-09T11:43:50+09:00",
+        #         "updated_at"=>nil,
+        #         "priority"=>nil}],
+        #      "description"=>"Change description",
+        #      "authenticated"=>false}
         def update_zone(uuid, attributes, headers = {})
           Validators::Zone.validate_attributes!(attributes, :update)
           put!("zones/#{uuid}", attributes, headers)

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

@@ -46,14 +46,13 @@ module Idcf
           end
 
           def validate_absence!(attributes, action)
+            return unless action
             attributes.each do |name, value|
-              if action &&
-                  (!valid_attributes[name] || !valid_attributes[name][action])
-                fail(
-                  UnnecessaryAttribute,
-                  "`#{name}` is unnecessary in #{action} action"
-                )
-              end
+              next unless !valid_attributes[name] || !valid_attributes[name][action]
+              raise(
+                UnnecessaryAttribute,
+                "`#{name}` is unnecessary in #{action} action"
+              )
             end
           end
 
@@ -64,7 +63,7 @@ module Idcf
 
           def validate_attribute_name!(name)
             return true if valid_attributes.key?(name.to_sym)
-            fail(
+            raise(
               InvalidAttributeName,
               "`#{name}` is invalid attribute name"
             )
@@ -73,7 +72,7 @@ module Idcf
           def validate_attribute_type!(name, value)
             valid_type = valid_attributes[name.to_sym][:type]
             return true if valid_attribute?(value, valid_type)
-            fail(
+            raise(
               InvalidAttributeType,
               "`#{name}` is required to be a #{valid_type}"
             )
@@ -81,12 +80,11 @@ module Idcf
 
           def validate_presence!(attributes, action)
             required_attributes(action).each do |name|
-              unless attributes.key?(name)
-                fail(
-                  MissingAttribute,
-                  "`#{name}` is required in #{action} action"
-                )
-              end
+              next if attributes.key?(name)
+              raise(
+                MissingAttribute,
+                "`#{name}` is required in #{action} action"
+              )
             end
           end
         end

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

@@ -3,10 +3,11 @@ module Idcf
     module Validators
       # Record validator class
       class Record < Base
+        RECORD_TYPES = /^(A|CNAME|AAAA|MX|TXT|SRV|NS|SOA)$/
         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 },
+          type:        { type: RECORD_TYPES, 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 },

data/lib/idcf/dns/version.rb

@@ -1,5 +1,5 @@
 module Idcf
   module Dns
-    VERSION = "0.0.6"
+    VERSION = "0.0.7"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idcf-dns
 version: !ruby/object:Gem::Version
-  version: 0.0.6
+  version: 0.0.7
 platform: ruby
 authors:
 - nownabe
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-02 00:00:00.000000000 Z
+date: 2015-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,6 +80,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  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
@@ -145,6 +159,7 @@ extra_rdoc_files: []
 files:
 - ".gitignore"
 - ".rspec"
+- ".rubocop.yml"
 - ".travis.yml"
 - Gemfile
 - LICENSE.txt
@@ -196,3 +211,4 @@ signing_key:
 specification_version: 4
 summary: A Ruby client for IDCF Cloud DNS Service.
 test_files: []
+has_rdoc: