zedkit 1.1.3

data/lib/zedkit/client/configuration.rb

@@ -0,0 +1,53 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class Configuration
+    attr_accessor :project_key, :locales_key, :ssl, :exceptions, :api_host, :api_port
+
+    API_HOSTNAME = 'api.zedapi.com'
+    API_PORT = 80
+    PROJECT_KEY_LENGTH = 18
+    LOCALES_KEY_LENGTH = 18
+
+    def initialize
+      @project_key, @locales_key = nil, nil
+      @ssl = false
+      @exceptions = false
+      @api_host = API_HOSTNAME
+      @api_port = API_PORT
+    end
+
+    def has_project_key?
+      (not project_key.nil?) && project_key.is_a?(String) && project_key.length == PROJECT_KEY_LENGTH
+    end
+    def has_locales_key?
+      (not locales_key.nil?) && locales_key.is_a?(String) && locales_key.length == LOCALES_KEY_LENGTH
+    end
+
+    def ssl?
+      ssl
+    end
+    def exceptions?
+      exceptions
+    end
+    
+    def api_url
+      ssl? ? "https://#{api_host}:#{api_port}" : "http://#{api_host}:#{api_port}"
+    end
+  end
+end

data/lib/zedkit/client/exceptions.rb

@@ -0,0 +1,67 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class ZedkitError < StandardError
+  end
+
+  module Client
+    class ClientError < ZedkitError
+      attr_reader :http_code, :api_code, :message, :errors
+
+      def initialize(info = {})
+        @http_code = info[:http_code] || 0
+        @api_code  = info[:api_code]  || nil
+        @message   = info[:message]   || nil
+        @errors    = info[:errors]    || nil
+      end
+
+      def to_s
+        rs  = "\nZedkit API Error Response.\n" \
+           << "  HTTP Code => #{http_code}. #{http_string(http_code)}\n"
+        rs << "  API Status Code => #{api_code}.\n" unless api_code.nil?
+        rs << "  API Response Message => #{message}.\n" unless message.nil?
+        rs << "  API Error Attribute Details => #{@errors['attributes'].map {|k,v| "#{k} => #{v}" }}.\n" unless errors.nil?
+        rs << "\n"
+      end
+
+      private
+      def http_string(code)
+        case code.to_i
+        when 200
+          "OK."
+        when 401
+          "Unauthorized."
+        when 403
+          "Forbidden."
+        when 404
+          "Does Not Exist."
+        else
+          "Undefined." end
+      end
+    end
+
+    class UnauthorizedAccess < ClientError
+    end
+    class UnauthorizedAccess < ClientError
+    end
+    class ResourceNotFound < ClientError
+    end
+    class DataValidationError < ClientError
+    end
+  end
+end

data/lib/zedkit/ext/hash.rb

@@ -0,0 +1,51 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+##
+# We want to transform something like this:
+#   { :user => { :email => "whatever@zedkit.com", :password => "pwd", :first_name => "Fred", :surname => "Flintstone" } }
+#
+# Into something like this for submission to the ZedAPI:
+#   { 
+#     "user[email]" => "whatever@zedkit.com",
+#     "user[password]" => "pwd", "user[first_name]" => "Fred", "user[surname]" => "Flintstone"
+#   }
+#
+# The API only ever uses a single level, never something like [user][project][name]. If more than a single level is 
+# submitted we don't bother to try and sort it out here, as it will not work anyway. Let the caller figure that out and
+# resolve it on their end.
+#
+# FYI, the API's backend controllers do NOT use mass assignment for attributes submitted, EVER. Submitting anything other
+# than documented object data items for each API method has no negative impact. Inapplicable attributes, or nefarious
+# submissions on update, such as user[uuid], are simply ignored.
+##
+
+class Hash
+  def flatten_zedkit_params!                      ## The implementation of this did not require a staging hash until
+    tmph = {}                                     ## 1.9.2: RuntimeError: can't add a new key into hash during iteration
+    each do |k,v|
+      if v.is_a?(Hash)                                          # self.each do |k,v|
+        v.each {|vk,vv| tmph["#{k}[#{vk}]"] = vv }              #   if v.is_a?(Hash)
+        delete(k)                                               #     v.each {|vk,vv| merge!({ "#{k}[#{vk}]" => vv }) }
+      end                                                       #     self.delete(k)
+    end                                                         #   end
+    merge!(tmph)                                                # end
+  end
+  def zdelete_keys!(zedkeys = [])
+    delete_if {|k| zedkeys.include?(k.to_s) }
+  end
+end

data/lib/zedkit/instances/instance.rb

@@ -0,0 +1,50 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class Instance < Hash
+    attr_accessor :user_key, :locale
+    alias_method :uk, :user_key
+    alias_method :lc, :locale
+
+    def initialize(api = {})
+      @user_key = api[:user_key] || nil
+      @locale   = api[:locale]   || :en
+      if api.has_key?(:owner) && api.has_key?(:uuid)
+        set_with_owner_and_uuid(api[:owner], api[:uuid]) && respond_to?(:set_with_owner_and_uuid)
+      elsif api.has_key?(:uuid) && respond_to?(:uuid)
+        set_with_uuid(api[:uuid]) end
+    end
+
+    def set_with_hash(hh)
+      replace hh
+    end
+
+    def method_missing(kk)
+      return self[kk.to_s] if self.has_key? kk.to_s
+      super
+    end
+
+    protected
+    def time(i)
+      Time.at(i).to_date
+    end
+    def dashes(length = 128)
+      Array.new(length, '-').join << "\n"
+    end
+  end
+end

data/lib/zedkit/instances/project.rb

@@ -0,0 +1,43 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class Project < Zedkit::Instance
+    def to_s
+         "\n" \
+      << "Zedkit Project:\n" \
+      << "  Name          : #{name}\n" \
+      << "  UUID          : #{uuid}\n" \
+      << "  Location      : #{location}\n" \
+      << "  Locales\n" \
+      << "    Default     : #{locales['default']}\n" \
+      << "    Development : #{locales['development']}\n" \
+      << "    Production  : #{locales['production']}\n" \
+      << "  Shelves       : []\n" \
+      << "  Blogs         : []\n" \
+      << "  Version       : #{version}\n" \
+      << "  Created       : #{time(created_at)}\n" \
+      << "  Updated       : #{time(updated_at)}\n" \
+      << dashes(20) << "\n"
+    end
+
+    protected
+    def set_with_uuid(uuid_to_use)
+      replace Zedkit::Projects.get(:user_key => uk, :locale => lc, :uuid => uuid_to_use)
+    end
+  end
+end

data/lib/zedkit/resources/projects.rb

@@ -0,0 +1,77 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class Projects
+    class << self
+      def verify(type, key = nil, &block)
+        rs = nil
+        case type.to_sym
+        when :project
+          rs = Zedkit::Client.get('projects/verify', nil)
+        when :locales
+          rs = Zedkit::Client.get('projects/verify/locales', nil, { :locales_key => key })
+        end
+        yield(rs) if rs && block_given?
+        rs
+      end
+
+      def get(zks = {}, &block)                                           ## This avoids /projects/[nil] which is a
+        zks[:uuid] = 'uuid' if zks[:uuid].nil?                            ## valid resource to list a user's projects.
+        Zedkit::Client.crud(:get, "projects/#{zks[:uuid]}", zks, [], &block)
+      end
+
+      def create(zks = {}, &block)
+      end
+
+      def update(zks = {}, &block)
+      end
+      
+      def delete(zks = {}, &block)
+      end
+    end
+
+    class Users
+      class << self
+        def get(zks = {}, &block)
+          Zedkit::Client.crud(:get, "projects/#{zks[:project][:uuid]}/users", zks, %w(project), &block)
+        end
+
+        def create(zks = {}, &block)
+          Zedkit::Client.crud(:create, "projects/#{zks[:project][:uuid]}/users", zks, %w(project), &block)
+        end
+
+        def update(zks = {}, &block)
+          Zedkit::Client.crud(:update,
+                              "projects/#{zks[:project][:uuid]}/users/#{zks[:user][:uuid]}", zks, %w(project), &block)
+        end
+
+        def delete(zks = {}, &block)
+          Zedkit::Client.crud(:delete, "projects/#{zks[:project][:uuid]}/users/#{zks[:user][:uuid]}", zks, [], &block)
+        end
+      end
+    end
+
+    class Emails
+      class << self
+        def get(zks = {}, &block)
+          Zedkit::Client.crud(:get, 'emails', zks, [], &block)
+        end
+      end
+    end
+  end
+end

data/lib/zedkit/resources/users.rb

@@ -0,0 +1,44 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+module Zedkit
+  class Users
+    class << self
+      def verify(zks = {}, &block)
+        rs = Zedkit::Client.verify(zks[:username], zks[:password])
+        yield(rs) if rs && block_given?
+        rs
+      end
+
+      def get(zks = {}, &block)
+        Zedkit::Client.crud(:get, "users/#{zks[:uuid]}", zks, [], &block)
+      end
+
+      def create(zks = {}, &block)
+        Zedkit::Client.crud(:create, 'users', zks, [], &block)
+      end
+    end
+
+    class Projects
+      class << self
+        def get(zks = {}, &block)
+          Zedkit::Client.crud(:get, 'projects', zks, [], &block)
+        end
+      end
+    end
+  end
+end

data/lib/zedkit.rb

@@ -0,0 +1,71 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+require 'rubygems'
+require 'json'
+require 'nestful'
+
+Dir["#{File.dirname(__FILE__)}/zedkit/ext/*.rb"].each {|ci| require ci }
+
+module Zedkit
+  class << self
+    def countries(user_key)
+      rs = Zedkit::Client.get('entities/countries', user_key)
+      if rs && block_given?
+        rs.is_a?(Array) ? rs.each {|i| yield(i) } : yield(rs)
+      end
+      rs
+    end
+    def regions(user_key, zks = {})
+      rs = Zedkit::Client.get('entities/regions', user_key, zks)
+      if rs && block_given?
+        rs.is_a?(Array) ? rs.each {|i| yield(i) } : yield(rs)
+      end
+      rs
+    end
+
+    def entities(user_key)
+      rs = Zedkit::Client.get('entities/zedkit', user_key)
+      if rs && block_given?
+        rs.is_a?(Array) ? rs.each {|i| yield(i) } : yield(rs)
+      end
+      rs
+    end
+
+    #
+    # == Configuration
+    #
+    # Call the configure method within an application configuration initializer to set your project key,
+    # and other goodies:
+    #   Zedkit.configure do |zb|
+    #     zb.project_key = 'from.zedkit.com.members.area'
+    #     zb.ssl = true
+    #   end
+    #
+
+    attr_accessor :configuration
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration)
+    end
+  end
+end
+
+Dir["#{File.dirname(__FILE__)}/zedkit/client/*.rb"].each {|ci| require ci }
+Dir["#{File.dirname(__FILE__)}/zedkit/cli/*.rb"].each {|ci| require ci }
+Dir["#{File.dirname(__FILE__)}/zedkit/instances/*.rb"].each {|ci| require ci }
+Dir["#{File.dirname(__FILE__)}/zedkit/resources/*.rb"].each {|ci| require ci }

data/test/helper.rb

@@ -0,0 +1,41 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+require 'test/unit'
+require 'rubygems'
+require 'zedkit'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+
+class Test::Unit::TestCase
+  TEST_GEMS_PROJECT_KEY = 'BE1OZog8gJogtQTosh'
+  TEST_GEMS_LOCALES_KEY = '6yca7DsnBvaDVupKEZ'
+  TEST_GEMS_LOGIN = 'gems@zedkit.com'
+  TEST_GEMS_LACKY = 'gems_lacky@zedkit.com'
+  TEST_GEMS_TEMP  = 'temp@zedkit.com'
+  TEST_GEMS_PASSWORD = 'NGIaDhr5vDlXo1tDs6bW3Gd'
+
+  def setup
+    Zedkit.configure do |zk|
+      zk.project_key = TEST_GEMS_PROJECT_KEY
+      # zk.api_host = '0.0.0.0'
+      # zk.api_port = 5010
+    end
+    @uu = Zedkit::Users.verify(:username => TEST_GEMS_LOGIN, :password => TEST_GEMS_PASSWORD)
+  end
+end

data/test/test_emails.rb

@@ -0,0 +1,21 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+require 'helper'
+
+class TestEmails < Test::Unit::TestCase
+end

data/test/test_entities.rb

@@ -0,0 +1,64 @@
+##
+# Copyright (c) Zedkit.
+#
+# 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.
+##
+
+require 'helper'
+
+class TestEntities < Test::Unit::TestCase
+  def test_entities
+    zkes = Zedkit.entities(@uu['user_key'])
+  end
+  def test_entities_with_block
+    Zedkit.entities(@uu['user_key']) do |zkes|
+    end
+  end
+
+  def test_countries
+    cnts = Zedkit.countries(@uu['user_key'])
+    assert cnts.is_a? Array
+    assert cnts.length >= 2
+  end
+  def test_countries_with_block
+    Zedkit.countries(@uu['user_key']) do |cnts|
+      assert_not_nil cnts['code']
+      assert_not_nil cnts['name']
+      assert_not_nil cnts['locale']
+    end
+  end
+
+  def test_regions
+    rgss = Zedkit.regions(@uu['user_key'])
+    assert rgss.is_a? Array
+    assert_not_nil rgss.detect {|region| region['code'] == 'WA' }
+    assert_not_nil rgss.detect {|region| region['code'] == 'BC' }
+  end
+  def test_regions_with_block
+    Zedkit.regions(@uu['user_key']) do |rgss|
+      assert_not_nil rgss['code']
+      assert_not_nil rgss['name']
+    end
+  end
+  def test_states_for_usa
+    rgss = Zedkit.regions(@uu['user_key'], :country => { :code => 'US' })
+    assert rgss.is_a? Array
+    assert_nil rgss.detect {|region| region['code'] == 'BC' }
+  end
+  def test_provinces_for_canada
+    rgss = Zedkit.regions(@uu['user_key'], :country => { :code => 'CA' })
+    assert rgss.is_a? Array
+    assert_nil rgss.detect {|region| region['code'] == 'WA' }
+  end
+end