glare 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d34218aa3655c0e7e2ab1605e3ee6ad339d9850a
+  data.tar.gz: 9bd27535c1e035d47310393ab00ef2bf779525a2
+SHA512:
+  metadata.gz: 4672e678f5f30e202b77aa962459b2c8a7fd2161a82368e878d0abbf9a992bbfefb64a3e3be7f06fa7bcfda8f964b0c666498e6cc9b2002a3a84daec4a6950a3
+  data.tar.gz: 7233ef28109e26dd0ed213249b2b6998fa6baf91f64bd6695f7d1946e4de3381886622a27def3a1fcc18c2d6d337f962a80a34e50bea3388e174c5f88d0da1b5

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.envrc
+/spec/examples.txt

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format doc
+--require spec_helper

data/Gemfile

@@ -0,0 +1,8 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cf.gemspec
+gemspec
+
+group :test do
+  gem 'coveralls', require: false
+end

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Flywire
+
+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,46 @@
+# Glare
+
+Ruby gem to interact with CloudFlare API v4
+
+## Build Status
+
+[![Build Status](https://travis-ci.org/peertransfer/glare.svg?branch=master)](https://travis-ci.org/peertransfer/glare)
+[![Coverage Status](https://coveralls.io/repos/github/peertransfer/glare/badge.svg?branch=master)](https://coveralls.io/github/peertransfer/glare?branch=master)
+[![Code Climate](https://codeclimate.com/github/peertransfer/glare/badges/gpa.svg)](https://codeclimate.com/github/peertransfer/glare)
+[![Dependency Status](https://gemnasium.com/peertransfer/glare.svg)](https://gemnasium.com/peertransfer/glare)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'glare'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install glare
+
+## Usage
+
+### Create/update DNS record
+
+### Delete DNS record
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+1. Fork it ( https://github.com/peertransfer/glare/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/glare.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'glare/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'glare'
+  spec.version       = Glare::VERSION
+  spec.authors       = ['Jose Luis Salas', 'Omar Lopez']
+  spec.email         = ['josacar@users.noreply.github.com', 'olopez@users.noreply.github.com']
+
+  spec.summary       = 'API client for CloudFlare v4 API'
+  spec.homepage      = 'https://github.com/peertransfer/cf'
+  spec.license       = 'MIT'
+
+  files = Dir['lib/**/*.rb']
+  rootfiles = ['Gemfile', 'glare.gemspec', 'README.md', 'LICENSE']
+  dotfiles = ['.gitignore', '.rspec']
+
+  spec.files = files + rootfiles + dotfiles
+  spec.test_files = Dir['spec/**/*.{rb,json}']
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.9'
+  spec.add_development_dependency 'rake', '~> 11.0'
+  spec.add_development_dependency 'rspec', '~> 3.4'
+
+  spec.add_dependency 'public_suffix'
+  spec.add_dependency 'httpclient'
+end

data/lib/glare.rb

@@ -0,0 +1,47 @@
+require 'public_suffix'
+require 'glare/version'
+require 'glare/credentials'
+require 'glare/client'
+require 'glare/domain'
+require 'glare/result'
+require 'glare/dns_record'
+require 'glare/dns_records'
+
+module Glare
+  class << self
+    def register(fqdn, destination, type)
+      client = build_client
+      Domain.new(client).register(fqdn, destination, type)
+    end
+
+    def resolve(fqdn, type)
+      client = build_client
+      Domain.new(client).resolve(fqdn, type)
+    end
+
+    def deregister(fqdn, type)
+      client = build_client
+      Domain.new(client).deregister(fqdn, type)
+    end
+
+    private
+
+    CF_EMAIL = 'CF_EMAIL'.freeze
+    CF_AUTH_KEY = 'CF_AUTH_KEY'.freeze
+
+    def client(credentials)
+      Glare::Client.new(credentials.email, credentials.auth_key)
+    end
+
+    def default_credentials
+      email = ENV[CF_EMAIL]
+      auth_key = ENV[CF_AUTH_KEY]
+      Credentials.new(email, auth_key)
+    end
+
+    def build_client
+      credentials = default_credentials
+      client(credentials)
+    end
+  end
+end

data/lib/glare/client.rb

@@ -0,0 +1,33 @@
+require 'jsonclient'
+
+module Glare
+  class Client
+    BASE_URL = 'https://api.cloudflare.com/client/v4'.freeze
+
+    def initialize(email, auth_key)
+      @headers = {
+        'Content-Type' => 'application/json',
+        'X-Auth-Email' => email,
+        'X-Auth-Key' => auth_key
+      }
+      @http = JSONClient.new
+      @http.debug_dev = STDERR if ENV['CF_DEBUG']
+    end
+
+    def get(query, params)
+      @http.get(BASE_URL + query, params, @headers)
+    end
+
+    def post(query, data)
+      @http.post(BASE_URL + query, data, @headers)
+    end
+
+    def put(query, data)
+      @http.put(BASE_URL + query, data, @headers)
+    end
+
+    def delete(query, params=nil)
+      @http.delete(BASE_URL + query, params, @headers)
+    end
+  end
+end

data/lib/glare/credentials.rb

@@ -0,0 +1,10 @@
+module Glare
+  class Credentials
+    def initialize(email, auth_key)
+      @email = email
+      @auth_key = auth_key
+    end
+
+    attr_reader :email, :auth_key
+  end
+end

data/lib/glare/dns_record.rb

@@ -0,0 +1,19 @@
+module Glare
+  class DnsRecord
+    def initialize(name:, type:, content:)
+      @name = name
+      @type = type
+      @content = content
+    end
+
+    def to_h
+      {
+        type: @type,
+        name: @name,
+        content: @content
+      }
+    end
+    attr_reader :content, :type
+  end
+  private_constant :DnsRecord
+end

data/lib/glare/dns_records.rb

@@ -0,0 +1,56 @@
+module Glare
+  class CfDnsRecord
+    def initialize(id:, name:, type:, content:)
+      @id = id
+      @name = name
+      @type = type
+      @content = content
+    end
+    attr_reader :id, :name, :type, :content
+  end
+
+  class DnsRecords < Result
+    def initialize(result)
+      super(result)
+      @records = records
+    end
+
+    def records_to_update(desired_records)
+      @records.reject do |record|
+        desired_records.any? { |r| r.content == record.content }
+      end
+    end
+
+    def count
+      @records.count
+    end
+
+    def each
+      @records.each { |record| yield(record) }
+    end
+
+    def records_to_delete(targer_number)
+      records_to_delete = count - targer_number
+      return [] if records_to_delete < 0
+
+      @records.pop(records_to_delete)
+    end
+
+    def records_to_create(desired_records)
+      desired_records.drop(count)
+    end
+
+    private
+
+    def records
+      result['result'].map do |item|
+        CfDnsRecord.new(
+          id: item['id'],
+          name: item['name'],
+          type: item['type'],
+          content: item['content']
+        )
+      end
+    end
+  end
+end

data/lib/glare/domain.rb

@@ -0,0 +1,115 @@
+module Glare
+  class Domain
+    class Zone
+      def initialize(client, fqdn)
+        @client = client
+        @fqdn = fqdn
+      end
+
+      def records(type)
+        records = record_search(type)
+        DnsRecords.new(records)
+      end
+
+      def id
+        return @id if @id
+        zone_search = @client.get('/zones', name: registered_domain)
+        @id = Result.new(zone_search).first_result_id
+      end
+
+      private
+
+      def registered_domain
+        PublicSuffix.parse(@fqdn).domain
+      end
+
+      def record_search(type)
+        @client.get("/zones/#{id}/dns_records", name: @fqdn, type: type)
+      end
+    end
+
+    class Record
+      class << self
+        def register(client, zone, dns_records)
+          @client = client
+          existing_records = zone.records(dns_records.first.type)
+          zone_id = zone.id
+
+          update(zone_id, dns_records, existing_records)
+        end
+
+        def deregister(client, zone, dns_records)
+          @client = client
+          zone_id = zone.id
+
+          delete(zone_id, dns_records)
+        end
+
+        private
+
+        def delete(zone_id, dns_records)
+          dns_records.each do |record|
+            @client.delete("/zones/#{zone_id}/dns_records/#{record.id}")
+          end
+        end
+
+        def update(zone_id, dns_records, existing_records)
+          update_current_records(zone_id, dns_records, existing_records)
+          delete_uneeded_records(zone_id, dns_records, existing_records)
+          create_new_records(zone_id, dns_records, existing_records)
+        end
+
+        def update_current_records(zone_id, dns_records, existing_records)
+          records_to_update = existing_records.records_to_update(dns_records)
+          updates = records_to_update.zip(dns_records)
+          updates.each do |existing_record, dns_record|
+            @client.put("/zones/#{zone_id}/dns_records/#{existing_record.id}", dns_record.to_h)
+          end
+        end
+
+        def delete_uneeded_records(zone_id, dns_records, existing_records)
+          records_to_delete = existing_records.records_to_delete(dns_records.count)
+          records_to_delete.each do |record|
+            @client.delete("/zones/#{zone_id}/dns_records/#{record.id}")
+          end
+        end
+
+        def create_new_records(zone_id, dns_records, existing_records)
+          records_to_create = existing_records.records_to_create(dns_records)
+          create(zone_id, records_to_create)
+        end
+
+        def create(zone_id, dns_records)
+          dns_records.each do |dns_record|
+            @client.post("/zones/#{zone_id}/dns_records", dns_record.to_h)
+          end
+        end
+      end
+    end
+
+    def initialize(client)
+      @client = client
+    end
+
+    def register(fqdn, destinations, type)
+      dns_records = Array(destinations).map do |destination|
+        DnsRecord.new(type: type, name: fqdn, content: destination)
+      end
+
+      zone = Zone.new(@client, fqdn)
+      Record.register(@client, zone, dns_records)
+    end
+
+    def resolve(fqdn, type)
+      zone = Zone.new(@client, fqdn)
+      result = zone.records(type)
+      result.contents
+    end
+
+    def deregister(fqdn, type)
+      zone = Zone.new(@client, fqdn)
+      dns_records = zone.records(type)
+      Record.deregister(@client, zone, dns_records)
+    end
+  end
+end

data/lib/glare/result.rb

@@ -0,0 +1,26 @@
+module Glare
+  class Result
+    def initialize(result)
+      @result = result
+    end
+
+    def ocurrences
+      result['result_info']['count'].to_i
+    end
+
+    def first_result_id
+      result['result'].first['id']
+    end
+
+    def contents
+      Array(result['result']).map { |item| item['content'] }
+    end
+
+    private
+
+    def result
+      @result.content
+    end
+  end
+  private_constant :Result
+end

data/lib/glare/version.rb

@@ -0,0 +1,3 @@
+module Glare
+  VERSION = "0.1.0"
+end

data/spec/delete_domain_spec.rb

@@ -0,0 +1,30 @@
+require 'glare'
+
+RSpec.describe 'delete domain' do
+  context 'when a domain is registered' do
+    let(:domain) { 'a.flywire.cc' }
+    let(:type) { 'A' }
+    let(:destination) { ['1.2.3.5', '6.7.8.9'] }
+    before do
+      register_domain(domain, destination)
+    end
+
+    it 'deletes all records with given type' do
+      expect(resolve(domain)).to eq(destination)
+      delete(domain)
+      expect(resolve(domain)).to eq([])
+    end
+  end
+
+  def delete(domain)
+    Glare.deregister(domain, type)
+  end
+
+  def resolve(domain)
+    Glare.resolve(domain, type)
+  end
+
+  def register_domain(domain, destination)
+    Glare.register(domain, destination, type)
+  end
+end

data/spec/fixtures/empty_result.json

@@ -0,0 +1,13 @@
+{
+  "errors": [],
+  "messages": [],
+  "result": [],
+  "result_info": {
+    "count": 0,
+    "page": 1,
+    "per_page": 20,
+    "total_count": 0,
+    "total_pages": 0
+  },
+  "success": true
+}

data/spec/fixtures/list_zone.json

@@ -0,0 +1,82 @@
+{
+	"errors": [],
+  "messages": [],
+  "result": [
+    {
+      "checked_on": "2016-05-12T10:20:14.209689Z",
+      "created_on": "2016-05-12T10:15:06.531372Z",
+      "development_mode": 0,
+      "id": "9de4eb694c380d79845d35cd939cc7a7",
+      "meta": {
+        "custom_certificate_quota": 0,
+        "multiple_railguns_allowed": false,
+        "page_rule_quota": 3,
+        "phishing_detected": false,
+        "step": 4,
+        "wildcard_proxiable": false
+      },
+      "modified_on": "2016-05-12T10:19:14.185994Z",
+      "name": "example.com",
+      "name_servers": [
+        "coco.ns.cloudflare.com",
+        "jeff.ns.cloudflare.com"
+      ],
+      "original_dnshost": null,
+      "original_name_servers": [
+        "ns-11.awsdns-15.com",
+        "ns-288.awsdns-33.org",
+        "ns-32.awsdns-62.co.uk",
+        "ns-74.awsdns-27.net"
+      ],
+      "original_registrar": null,
+      "owner": {
+        "email": "user@example.com",
+        "id": "dbaf2b4d4317b92cbc3b1820a5eaf6d3",
+        "type": "user"
+      },
+      "paused": false,
+      "permissions": [
+        "#analytics:read",
+        "#billing:edit",
+        "#billing:read",
+        "#cache_purge:edit",
+        "#dns_records:edit",
+        "#dns_records:read",
+        "#lb:edit",
+        "#lb:read",
+        "#logs:read",
+        "#organization:edit",
+        "#organization:read",
+        "#ssl:edit",
+        "#ssl:read",
+        "#waf:edit",
+        "#waf:read",
+        "#zone:edit",
+        "#zone:read",
+        "#zone_settings:edit",
+        "#zone_settings:read"
+      ],
+      "plan": {
+        "can_subscribe": true,
+        "currency": "USD",
+        "externally_managed": false,
+        "frequency": "",
+        "id": "0feeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+        "is_subscribed": true,
+        "legacy_id": "free",
+        "name": "Free Website",
+        "price": 0
+      },
+      "status": "pending",
+      "type": "full"
+    }
+  ],
+  "result_info": {
+    "count": 1,
+    "page": 1,
+    "per_page": 20,
+    "total_count": 1,
+    "total_pages": 1
+  },
+  "success": true
+}

data/spec/fixtures/wadus_records.json

@@ -0,0 +1,48 @@
+{
+  "errors": [],
+  "messages": [],
+  "result": [
+    {
+      "content": "destination.com",
+      "created_on": "2016-05-12T11:53:49.233342Z",
+      "id": "a1f984afe5544840505494298f54c33e",
+      "locked": false,
+      "meta": {
+        "auto_added": false
+      },
+      "modified_on": "2016-05-12T11:53:49.233342Z",
+      "name": "wadus.example.com",
+      "proxiable": true,
+      "proxied": false,
+      "ttl": 1,
+      "type": "CNAME",
+      "zone_id": "9de4eb694c380d79845d35cd939cc7a7",
+      "zone_name": "example.com"
+    },
+    {
+      "content": "another_destination.com",
+      "created_on": "2016-05-12T11:53:49.233342Z",
+      "id": "b3142498230989gsd0f88h80998908fc",
+      "locked": false,
+      "meta": {
+        "auto_added": false
+      },
+      "modified_on": "2016-05-12T11:53:49.233342Z",
+      "name": "wadus.example.com",
+      "proxiable": true,
+      "proxied": false,
+      "ttl": 1,
+      "type": "CNAME",
+      "zone_id": "9de4eb694c380d79845d35cd939cc7a7",
+      "zone_name": "example.com"
+    }
+  ],
+  "result_info": {
+    "count": 2,
+    "page": 1,
+    "per_page": 20,
+    "total_count": 1,
+    "total_pages": 1
+  },
+  "success": true
+}

data/spec/resolve_domain_spec.rb

@@ -0,0 +1,56 @@
+require 'glare'
+
+RSpec.describe 'Resolve domain' do
+  context 'when a domain is registered' do
+    let(:domain) { 'cname.flywire.cc' }
+    let(:destination) { ['peertransfer.me'] }
+    let(:type) { 'CNAME' }
+    before do
+      register_domain(domain, destination)
+    end
+
+    it 'resolves to right destination' do
+      expect(resolve(domain)).to eq(destination)
+    end
+  end
+
+  context 'when a domain contains more than one destination' do
+    let(:domain) { 'a.flywire.cc' }
+    let(:type) { 'A' }
+    before do
+      register_domain(domain, destination)
+    end
+
+    context 'two new records' do
+      let(:destination) { ['1.2.3.4', '5.6.7.8'] }
+
+      it 'resolves to right destination' do
+        expect(resolve(domain)).to eq(destination)
+      end
+    end
+
+    context 'deletes one record' do
+      let(:destination) { ['1.2.3.9'] }
+
+      it 'resolves to right destination' do
+        expect(resolve(domain)).to eq(destination)
+      end
+    end
+
+    context 'adds one record' do
+      let(:destination) { ['1.2.3.5', '6.7.8.9'] }
+
+      it 'resolves to right destination' do
+        expect(resolve(domain)).to eq(destination)
+      end
+    end
+  end
+
+  def register_domain(domain, destination)
+    Glare.register(domain, destination, type)
+  end
+
+  def resolve(domain)
+    Glare.resolve(domain, type)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,97 @@
+require 'coveralls'
+Coveralls.wear!
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # The settings below are suggested to provide a good initial experience
+  # with RSpec, but feel free to customize to your heart's content.
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = 'spec/examples.txt'
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  # config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end

data/spec/units/cf_spec.rb

@@ -0,0 +1,229 @@
+require 'glare'
+
+RSpec.describe Glare do
+  before do
+    allow(ENV).to receive(:[]).with('CF_EMAIL').and_return('an_email')
+    allow(ENV).to receive(:[]).with('CF_AUTH_KEY').and_return('an_auth_key')
+
+    allow(Glare::Client).to receive(:new).and_return(client)
+  end
+  let(:client) { spy(Glare::Client) }
+  let(:zone_list) { load_fixture('list_zone') }
+  let(:empty_result) { load_fixture('empty_result') }
+  let(:wadus_records) { load_fixture('wadus_records') }
+
+  describe '.resolve' do
+    it 'resolves a fqdn' do
+      allow(client).to receive(:get).
+        with('/zones', name: 'example.com').
+        and_return(zone_list)
+
+      allow(client).to receive(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'wadus.example.com', type: 'CNAME'
+      ).and_return(wadus_records)
+
+      destination = Glare.resolve('wadus.example.com', 'CNAME')
+      expect(destination).to eq(['destination.com', 'another_destination.com'])
+    end
+  end
+
+  describe '.register' do
+    before do
+      allow(client).to receive(:get).
+        with('/zones', name: 'example.com').
+        and_return(zone_list)
+
+      allow(client).to receive(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'example.com', type: 'CNAME'
+      ).and_return(empty_result)
+    end
+
+    it 'uses default credentials' do
+      Glare.register('example.com', :a_destination, 'CNAME')
+
+      expect(Glare::Client).to have_received(:new).with('an_email', 'an_auth_key')
+    end
+
+    it 'uses the registration endpoint' do
+      Glare.register('example.com', :a_destination, 'CNAME')
+
+      expect(client).to have_received(:post) do |*args|
+        expect(args.first).to match(%r{/zones/.*/dns_records})
+      end
+    end
+
+    it 'retrieves zone id for a given domain name' do
+      Glare.register('example.com', :a_destination, 'CNAME')
+
+      expect(client).to have_received(:get).
+        with('/zones', name: 'example.com')
+
+      expect(client).to have_received(:post) do |*args|
+        expect(args.first).to eq('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records')
+      end
+    end
+
+    it 'retrieves record to check if exists' do
+      Glare.register('example.com', :a_destination, 'CNAME')
+
+      expect(client).to have_received(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'example.com', type: 'CNAME'
+      )
+    end
+
+    it 'sends registration data to creation endpoint when record does not exist' do
+      allow(client).to receive(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'not-exist.example.com', type: 'CNAME'
+      ).and_return(empty_result)
+
+      Glare.register('not-exist.example.com', :a_destination, 'CNAME')
+
+      expect(client).not_to have_received(:put).
+        with('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records', any_args)
+
+      expect(client).to have_received(:post).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        type: 'CNAME', name: 'not-exist.example.com', content: :a_destination
+      )
+    end
+
+    it 'sends registration data to creation endpoint when record does not exist with multiple records' do
+      allow(client).to receive(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'not-exist.example.com', type: 'CNAME'
+      ).and_return(empty_result)
+
+      Glare.register('not-exist.example.com', [:a_destination, :another_destination], 'CNAME')
+
+      expect(client).not_to have_received(:put).
+        with('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records', any_args)
+
+      expect(client).to have_received(:post).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        type: 'CNAME', name: 'not-exist.example.com', content: :a_destination
+      )
+
+      expect(client).to have_received(:post).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        type: 'CNAME', name: 'not-exist.example.com', content: :another_destination
+      )
+    end
+
+    context 'when records exist' do
+      before do
+        allow(client).to receive(:get).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+          name: 'wadus.example.com', type: 'CNAME'
+        ).and_return(wadus_records)
+      end
+
+      context 'same number of records to update' do
+        context 'records contents are different' do
+          it 'sends registration data to update endpoint' do
+            Glare.register('wadus.example.com', ['a_destination.com', 'yet_another_destination.com'], 'CNAME')
+
+            expect(client).not_to have_received(:post).
+              with('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records', any_args)
+
+            expect(client).to have_received(:put).with(
+              '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/a1f984afe5544840505494298f54c33e',
+              type: 'CNAME', name: 'wadus.example.com', content: 'a_destination.com'
+            )
+
+            expect(client).to have_received(:put).with(
+              '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/b3142498230989gsd0f88h80998908fc',
+              type: 'CNAME', name: 'wadus.example.com', content: 'yet_another_destination.com'
+            )
+          end
+        end
+
+        context 'records contents are the same' do
+          it 'sends registration data to update endpoint' do
+            Glare.register('wadus.example.com', ['destination.com', 'another_destination.com'], 'CNAME')
+
+            expect(client).not_to have_received(:post).
+              with('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records', any_args)
+
+            expect(client).not_to have_received(:put).with(
+              '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/a1f984afe5544840505494298f54c33e',
+              any_args
+            )
+
+            expect(client).not_to have_received(:put).with(
+              '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/b3142498230989gsd0f88h80998908fc',
+              any_args
+            )
+          end
+        end
+      end
+
+      it 'updates different records and deletes extra ones' do
+        Glare.register('wadus.example.com', ['a_destination.com'], 'CNAME')
+
+        expect(client).not_to have_received(:post).
+          with('/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records', any_args)
+
+        expect(client).to have_received(:put).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/a1f984afe5544840505494298f54c33e',
+          any_args
+        )
+
+        expect(client).to have_received(:delete).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/b3142498230989gsd0f88h80998908fc'
+        )
+      end
+
+      it 'updates different records and creates new ones' do
+        Glare.register('wadus.example.com', ['destination.com', 'another_destination.com', 'a_third_destination.com'], 'CNAME')
+
+        expect(client).not_to have_received(:put).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/a1f984afe5544840505494298f54c33e',
+          any_args
+        )
+
+        expect(client).not_to have_received(:put).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/b3142498230989gsd0f88h80998908fc',
+          any_args
+        )
+
+        expect(client).to have_received(:post).with(
+          '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+          type: 'CNAME', name: 'wadus.example.com', content: 'a_third_destination.com'
+        )
+      end
+    end
+  end
+
+  describe '.delete' do
+    it 'deletes all records for a fqdn' do
+      allow(client).to receive(:get).
+        with('/zones', name: 'example.com').
+        and_return(zone_list)
+
+      allow(client).to receive(:get).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records',
+        name: 'wadus.example.com', type: 'CNAME'
+      ).and_return(wadus_records)
+
+      Glare.deregister('wadus.example.com', 'CNAME')
+
+      expect(client).to have_received(:delete).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/a1f984afe5544840505494298f54c33e'
+      )
+
+      expect(client).to have_received(:delete).with(
+        '/zones/9de4eb694c380d79845d35cd939cc7a7/dns_records/b3142498230989gsd0f88h80998908fc'
+      )
+    end
+  end
+
+  def load_fixture(fixture)
+    fixture_dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'fixtures'))
+    json = IO.read(File.join(fixture_dir, "#{fixture}.json"))
+    ::HTTP::Message.new_response(JSON.parse(json))
+  end
+end

metadata

@@ -0,0 +1,144 @@
+--- !ruby/object:Gem::Specification
+name: glare
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jose Luis Salas
+- Omar Lopez
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-06-20 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: '11.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: public_suffix
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: httpclient
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: 
+email:
+- josacar@users.noreply.github.com
+- olopez@users.noreply.github.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE
+- README.md
+- glare.gemspec
+- lib/glare.rb
+- lib/glare/client.rb
+- lib/glare/credentials.rb
+- lib/glare/dns_record.rb
+- lib/glare/dns_records.rb
+- lib/glare/domain.rb
+- lib/glare/result.rb
+- lib/glare/version.rb
+- spec/delete_domain_spec.rb
+- spec/fixtures/empty_result.json
+- spec/fixtures/list_zone.json
+- spec/fixtures/wadus_records.json
+- spec/resolve_domain_spec.rb
+- spec/spec_helper.rb
+- spec/units/cf_spec.rb
+homepage: https://github.com/peertransfer/cf
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5
+signing_key: 
+specification_version: 4
+summary: API client for CloudFlare v4 API
+test_files:
+- spec/delete_domain_spec.rb
+- spec/resolve_domain_spec.rb
+- spec/spec_helper.rb
+- spec/units/cf_spec.rb
+- spec/fixtures/empty_result.json
+- spec/fixtures/list_zone.json
+- spec/fixtures/wadus_records.json