smartling 0.5.1

data/LICENSE

@@ -0,0 +1,14 @@
+Copyright 2012 Smartling, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

data/README.md

@@ -0,0 +1,62 @@
+[Smartling Translation API](http://docs.smartling.com)
+=================
+
+This repository contains the Ruby SDK for accessing the Smartling Translation API.
+
+The Smartling Translation API lets developers to internationalize their website or app by automating the translation and integration of their site content.
+Developers can upload resource files and download the translated files in a language of their choosing. There are options to allow for professional translation, community translation and machine translation.
+
+For a full description of the Smartling Translation API, please read the docs at: http://docs.smartling.com
+
+
+Quick start
+-----------
+
+Install latest gem package from RubyGems
+
+`gem install smartling`
+
+Follow the [sample code](https://github.com/Smartling/api-sdk-ruby/tree/master/samples) to upload and manage your files.
+
+
+Bug tracker
+-----------
+
+Have a bug? Please create an issue here on GitHub!
+
+https://github.com/Smartling/api-sdk-ruby/issues
+
+
+Hacking
+-------
+
+To get source code, clone the repo:
+
+`git clone git@github.com:Smartling/api-sdk-ruby.git`
+
+To contribute, fork it and follow [general GitHub guidelines](http://help.github.com/fork-a-repo/) with pull request.
+
+
+Authors
+-------
+
+* [Pavel Ivashkov](https://github.com/paiv)
+
+
+Copyright and license
+---------------------
+
+Copyright 2012 Smartling, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+

data/lib/smartling/api.rb

@@ -0,0 +1,108 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'rest-client'
+require 'multi_json'
+require 'smartling/uri'
+
+module Smartling
+
+  module Endpoints
+    V1 = 'https://api.smartling.com/v1/'
+    SANDBOX_V1 = 'https://sandbox-api.smartling.com/v1/'
+    CURRENT = V1
+    SANDBOX = SANDBOX_V1
+  end
+
+  class Api
+    attr_accessor :apiKey, :projectId, :baseUrl
+
+    def initialize(args = {})
+      @apiKey = args[:apiKey]
+      @projectId = args[:projectId]
+      @baseUrl = args[:baseUrl] || Endpoints::CURRENT
+    end
+
+    def self.sandbox(args = {})
+      new(args.merge(:baseUrl => Endpoints::SANDBOX))
+    end
+
+    def uri(path, params1 = nil, params2 = nil)
+      uri = Uri.new(@baseUrl, path)
+      params = { :apiKey => @apiKey, :projectId => @projectId }
+      params.merge!(params1) if params1
+      params.merge!(params2) if params2
+      uri.params = params
+      uri.require(:apiKey, :projectId)
+      return uri
+    end
+
+    def check_response(res)
+      return if res.code == 200
+      raise format_api_error(res.body)
+    end
+
+    def process(res)
+      check_response(res)
+      body = MultiJson.decode(res.body)
+      body = body['response']
+      raise format_api_error(res.body) unless body && body['code'] == 'SUCCESS'
+      return body['data']
+    end
+
+    def format_api_error(res)
+      begin
+        body = MultiJson.decode(res.body)
+      rescue
+      end
+      body = body['response'] if body
+      code = body['code'] if body
+      msg = body['messages'] if body
+      msg = msg.join(' -- ') if msg.is_a?(Array)
+      return "API error: #{code} #{msg}" if code
+      return res.description
+    end
+
+    def get(uri)
+      RestClient.get(uri) {|res, _, _|
+        process(res)
+      }
+    end
+    def get_raw(uri)
+      RestClient.get(uri) {|res, _, _|
+        check_response(res)
+        res.body
+      }
+    end
+    def post(uri, params = nil)
+      RestClient.post(uri, params) {|res, _, _|
+        process(res)
+      }
+    end
+    def delete(uri)
+      RestClient.delete(uri) {|res, _, _|
+        process(res)
+      }
+    end
+
+    def log=(v)
+      RestClient.log = v
+    end
+    def proxy=(v)
+      RestClient.proxy = v
+    end
+  end
+
+end
+

data/lib/smartling/fileapi.rb

@@ -0,0 +1,69 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'smartling/api'
+
+module Smartling
+
+  module Services
+    FILE_LIST = 'file/list'
+    FILE_STATUS = 'file/status'
+    FILE_GET = 'file/get'
+    FILE_UPLOAD = 'file/upload'
+    FILE_RENAME = 'file/rename'
+    FILE_DELETE = 'file/delete'
+  end
+
+  class File < Api
+    alias :api_delete :delete
+
+    def list(params = nil)
+      uri = uri(Services::FILE_LIST, params)
+      return get(uri.to_s)
+    end
+
+    def status(name, params)
+      keys = { :fileUri => name }
+      uri = uri(Services::FILE_STATUS, keys, params).require(:fileUri, :locale)
+      return get(uri.to_s)
+    end
+
+    def download(name, params = nil)
+      keys = { :fileUri => name }
+      uri = uri(Services::FILE_GET, keys, params).require(:fileUri)
+      return get_raw(uri.to_s)
+    end
+
+    def upload(file, name, type, params = nil)
+      keys = { :fileUri => name, :fileType => type }
+      uri = uri(Services::FILE_UPLOAD, keys, params).require(:fileUri, :fileType)
+      file = ::File.open(file, 'rb') if file.is_a?(String)
+      return post(uri.to_s, :file => file)
+    end
+
+    def rename(name, newname, params = nil)
+      keys = { :fileUri => name, :newFileUri => newname }
+      uri = uri(Services::FILE_RENAME, keys, params).require(:fileUri, :newFileUri)
+      return post(uri.to_s)
+    end
+
+    def delete(name, params = nil)
+      keys = { :fileUri => name }
+      uri = uri(Services::FILE_DELETE, keys, params).require(:fileUri)
+      return api_delete(uri.to_s)
+    end
+  end
+
+end
+

data/lib/smartling/uri.rb

@@ -0,0 +1,74 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Smartling
+  class Uri
+    attr_accessor :base,  :path, :params, :required
+
+    def initialize(base, path = nil)
+      @base = base
+      @path = path
+      @required = []
+    end
+
+    def require(*args)
+      @required += args
+      return self
+    end
+
+    def to_uri
+      params = @params || {}
+      required = @required || []
+      params.delete_if {|k,v| v.nil? || v.to_s.size <= 0 }
+      missing = required - params.keys
+      raise ArgumentError, "Missing parameters: " + missing.inspect if missing.size > 0
+
+      uri = URI.parse(@base)
+      uri.merge!(@path) if @path
+      if params.size > 0
+        uri.query = format_query(params)
+      end
+      return uri
+    end
+
+    def to_s
+      to_uri.to_s
+    end
+
+    def format_query(params)
+    # TODO: UTF-8 encode keys and values
+    # URI.encode_www_form(params)
+      params.map {|k,v|
+        if v.respond_to?(:to_ary)
+          v.to_ary.map {|w|
+            k.to_s + '=' + format_value(w)
+          }.join('&')
+        else
+          k.to_s + '=' + format_value(v)
+        end
+      }.join('&')
+    end
+
+    def format_value(v)
+      v.is_a?(Time) ? format_time(v) :
+        URI.escape(v.to_s)
+    end
+
+    def format_time(t)
+      t.utc.strftime('%Y-%m-%dT%H:%M:%S')
+    end
+
+  end
+end
+

data/lib/smartling/version.rb

@@ -0,0 +1,19 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module Smartling
+  # This follows Semantic Versioning http://semver.org/
+  VERSION = '0.5.1'
+end
+

data/lib/smartling.rb

@@ -0,0 +1,17 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'smartling/version'
+require 'smartling/fileapi'
+

data/samples/file_api.rb

@@ -0,0 +1,99 @@
+#!/usr/bin/ruby
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'rubygems'
+require 'smartling'
+
+API_KEY = 'YOUR_APIKEY'
+PROJECT_ID = 'YOUR_PROJECTID'
+
+puts 'Smartling Ruby client ' + Smartling::VERSION
+
+
+# Initialize client to sandbox
+sl = Smartling::File.sandbox(:apiKey => API_KEY, :projectId => PROJECT_ID)
+
+# Initialize client for production File API
+#sl = Smartling::File.new(:apiKey => API_KEY, :projectId => PROJECT_ID)
+
+# Upload YAML file
+res = sl.upload('source_file.yaml', 'name.yaml', 'YAML')
+p res
+
+# Get list of uploaded files
+res = sl.list()
+p res
+
+name = 'path/file_name.yaml'
+lang = 'es-ES'
+
+# Request translation status of the file
+res = sl.status(name, :locale => lang)
+p res
+
+# Download translated file in specified language
+data = sl.download(name, :locale => lang)
+puts data
+
+# Rename file
+newname = 'path/newname.yaml'
+sl.rename(name, newname)
+
+# Delete file
+sl.delete(name)
+
+# Extended parameters
+
+# Upload with callback URL
+res = sl.upload('source_file.yaml', 'name.yaml', 'YAML', :callbackUrl => 'http://yourdomain/someservice')
+p res
+
+# Upload with approved flag
+res = sl.upload('source_file.yaml', 'name.yaml', 'YAML', :approved => true)
+p res
+
+# Filter list by mask
+res = sl.list(:uriMask => '%.yaml')
+p res
+
+# Filter list by file type
+res = sl.list(:fileTypes => ['yaml', 'ios'])
+p res
+
+# Order list by attribute
+res = sl.list(:orderBy => ['fileUri', 'wordCount_desc'])
+p res
+
+# Page by page list
+page, size = 2, 10
+res = sl.list(:offset => (page - 1) * size, :limit => size)
+p res
+
+# Filter list by upload date
+res = sl.list(:lastUploadedAfter => Time.utc(2012, 04, 05))
+p res
+
+# Filter list by upload date range
+res = sl.list(:lastUploadedAfter => Time.utc(2012, 04, 01), :lastUploadedBefore => Time.utc(2012, 05, 01))
+p res
+
+# Filter by translation status
+res = sl.list(:conditions => ['haveAllTranslated', 'haveAtLeastOneUnapproved'])
+p res
+
+# Combine multiple filter parameters in a single query
+res = sl.list(:fileTypes => 'yaml', :orderBy => 'fileUri', :offset => 20, :limit => 10)
+p res
+

data/tests/api_test.rb

@@ -0,0 +1,83 @@
+#!/usr/bin/ruby
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$:.unshift File.expand_path('../', __FILE__)
+require 'test_helper'
+
+module SmartlingTests
+  class SmartlingApiTest < Test::Unit::TestCase
+
+    def stub_response(code, body)
+      status = Net::HTTPResponse.new('', code, '')
+      RestClient::Response.create(body, status, {})
+    end
+
+    def test_endpoints
+      sl = Smartling::Api.new()
+      assert_equal(Smartling::Endpoints::CURRENT, sl.baseUrl)
+
+      sl = Smartling::Api.new(:baseUrl => Smartling::Endpoints::V1)
+      assert_equal(Smartling::Endpoints::V1, sl.baseUrl)
+
+      sl = Smartling::Api.new(:baseUrl => Smartling::Endpoints::SANDBOX)
+      assert_equal(Smartling::Endpoints::SANDBOX, sl.baseUrl)
+
+      sl = Smartling::Api.sandbox()
+      assert_equal(Smartling::Endpoints::SANDBOX, sl.baseUrl)
+
+      sl = Smartling::Api.new(:baseUrl => 'custom')
+      assert_equal('custom', sl.baseUrl)
+    end
+
+    def test_response_format
+      sl = Smartling::Api.new()
+
+      res = stub_response(200, '{"response":{"code":"SUCCESS", "data":"foo"}}')
+      assert_equal('foo', sl.process(res))
+
+      res = stub_response(200, '{"response":{"code":"SUCCESS", "data":null}}')
+      res = sl.process(res)
+      assert(res.nil?)
+
+    end
+
+    def test_error_response
+      sl = Smartling::Api.new()
+
+      res = stub_response(200, '{"response":{"code":"SUCCESS", "data":"foo"}}')
+      assert_equal('foo', sl.process(res))
+
+      res = stub_response(200, '{"response":{"code":"ERROR", "messages":[]}}')
+      assert_raise RuntimeError do sl.process(res) end
+
+      res = stub_response(500, '{"response":{"code":"ERROR", "messages":[]}}')
+      assert_raise RuntimeError do sl.process(res) end
+
+      res = stub_response(500, '{"response":{"code":"ERROR"}}')
+      assert_raise RuntimeError do sl.process(res) end
+
+      res = stub_response(500, '{"response":null}')
+      assert_raise RuntimeError do sl.process(res) end
+
+      res = stub_response(500, '{}')
+      assert_raise RuntimeError do sl.process(res) end
+
+      res = stub_response(200, '{}')
+      assert_raise RuntimeError do sl.process(res) end
+    end
+
+  end
+end
+

data/tests/config.sample

@@ -0,0 +1,6 @@
+loglevel: 2  # DEBUG = 0, WARN = 2
+server:
+  baseUrl: https://sandbox-api.smartling.com/v1/
+  apiKey: key
+  projectId: id
+

data/tests/srv_fileapi_test.rb

@@ -0,0 +1,175 @@
+#!/usr/bin/ruby
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$:.unshift File.expand_path('../', __FILE__)
+require 'test_helper'
+require 'iconv'
+
+module SmartlingTests
+  class SmartlingFileApiTest < Test::Unit::TestCase
+
+    TEST_FILE_YAML = 'tests/upload.yaml'
+    TEST_FILE_UTF16 = 'tests/utf16.yaml'
+
+    def setup
+      @config = SmartlingTests.server_config
+      @log = SmartlingTests.logger
+    end
+
+    def yaml_file(encoding = nil)
+      data = <<-EOL
+hello: world
+we have: cookies
+      EOL
+      data = Iconv.conv(encoding, 'US-ASCII', data) if encoding
+      f = Tempfile.new('smartling_tests')
+      f.write(data)
+      f.flush
+      f.pos = 0
+      return f
+    end
+
+    def test_1_list
+      @log.debug '<- FileAPI:list'
+      sl = Smartling::File.new(@config)
+      res = nil
+      assert_nothing_raised do res = sl.list end
+      @log.debug res.inspect
+    end
+
+    def test_2_upload
+      @log.debug '<- FileAPI:upload'
+      sl = Smartling::File.new(@config)
+      
+      res = nil
+      assert_nothing_raised do
+        res = sl.upload(yaml_file, TEST_FILE_YAML, 'YAML')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_3_status
+      @log.debug '<- FileAPI:status'
+      sl = Smartling::File.new(@config)
+      
+      res = nil
+      assert_nothing_raised do
+        res = sl.status(TEST_FILE_YAML, :locale => 'en-US')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_4_download_en
+      @log.debug '-> FileAPI:download EN'
+      sl = Smartling::File.new(@config)
+      
+      res = nil
+      assert_nothing_raised do
+        res = sl.download(TEST_FILE_YAML, :locale => 'en-US')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_5_download_ru
+      @log.debug '-> FileAPI:download RU'
+      sl = Smartling::File.new(@config)
+      
+      res = nil
+      assert_nothing_raised do
+        res = sl.download(TEST_FILE_YAML, :locale => 'ru-RU')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_6_utf16
+      @log.debug '<- FileAPI UTF-16 upload'
+      sl = Smartling::File.new(@config)
+
+      file = yaml_file('UTF-16')
+      data = file.read
+      file.pos = 0
+
+      res = nil
+      assert_nothing_raised do
+        res = sl.upload(file, TEST_FILE_UTF16, 'YAML')
+      end
+      @log.debug res.inspect
+
+      @log.debug '-> FileAPI UTF-16 download EN'
+      assert_nothing_raised do
+        res = sl.download(TEST_FILE_UTF16, :locale => 'en-US')
+      end
+      @log.debug res.inspect
+
+      assert_equal(YAML.load(data), YAML.load(res))
+
+      @log.debug '-> FileAPI UTF-16 download RU'
+      assert_nothing_raised do
+        res = sl.download(TEST_FILE_UTF16, :locale => 'ru-RU')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_7_filter
+      @log.debug '-> FileAPI full filter test'
+      sl = Smartling::File.new(@config)
+      res = nil
+      assert_nothing_raised do
+        res = sl.list(:locale => 'ru-RU', :uriMask => '%.yaml', :fileTypes => [:ios, :yaml],
+              :lastUploadedAfter => Time.now - 3600, :lastUploadedBefore => Time.now + 24*3600,
+              :offset => 0, :limit => 2)
+      end
+      @log.debug res.inspect
+      # FIXME: when sandbox adds support for filter parameters
+      assert(res['fileCount'] <= 2) unless sl.baseUrl == Smartling::Endpoints::SANDBOX
+    end
+
+    def test_8_rename
+      @log.debug '-> FileAPI rename file'
+      sl = Smartling::File.new(@config)
+      res = nil
+      assert_nothing_raised do
+        res = sl.rename(TEST_FILE_YAML, 'foo/foo/foo')
+        res = sl.rename('foo/foo/foo', TEST_FILE_YAML)
+      end
+      @log.debug res.inspect
+    end
+
+    def test_9_callbackurl
+      @log.debug '-> FileAPI upload with callback URL'
+      sl = Smartling::File.new(@config)
+      res = nil
+      assert_nothing_raised do
+        res = sl.upload(yaml_file, TEST_FILE_YAML, 'YAML', :callbackUrl => 'http://google.com/?q=hello')
+      end
+      @log.debug res.inspect
+    end
+
+    def test_99_delete
+      # NOTE: might break the tests following this and uploading with the same name
+      # until server actually deletes the file.
+      @log.debug '<- FileAPI:delete'
+      sl = Smartling::File.new(@config)
+      
+      res = nil
+      assert_nothing_raised do
+        res = sl.delete(TEST_FILE_YAML)
+      end
+      @log.debug res.inspect
+    end
+
+  end
+end
+

data/tests/test_helper.rb

@@ -0,0 +1,60 @@
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$:.unshift File.expand_path('../../lib', __FILE__)
+require 'rubygems'
+require 'logger'
+require 'smartling'
+require 'test/unit'
+require 'yaml'
+
+class Hash
+  def keysym!
+    keys.each {|key|
+      self[(key.to_sym rescue key) || key] = delete(key)
+    }
+    self
+  end
+end
+
+module SmartlingTests
+  CONFIG = 'tests/config'
+
+  class << self
+
+  def config
+    return @config if @config
+    return unless File.exists?(CONFIG)
+    h = YAML.load_file(CONFIG)
+    @config = h.keysym!
+  end
+
+  def server_config
+    cfg = config() or raise 'Missing config file for server tests'
+    h = cfg[:server]
+    h.keysym!
+  end
+
+  def logger
+    l = Logger.new($stderr)
+    l.level = config[:loglevel]
+    l.formatter = proc {|sev, dt, prg, msg|
+      "#{sev}: #{msg}\n"
+    }
+    return l
+  end
+
+  end
+end
+

data/tests/uri_test.rb

@@ -0,0 +1,92 @@
+#!/usr/bin/ruby
+# Copyright 2012 Smartling, Inc.
+# 
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# 
+#    http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+$:.unshift File.expand_path('../', __FILE__)
+require 'test_helper'
+
+module SmartlingTests
+  class SmartlingUriTest < Test::Unit::TestCase
+
+    def test_base
+      uri = Smartling::Uri.new('http://hello.wo/')
+      assert_equal('http://hello.wo/', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/', 'foo/bar')
+      assert_equal('http://hello.wo/foo/bar', uri.to_s)
+    end
+
+    def test_params
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => 'x'}
+      assert_equal('http://hello.wo/?foo=x', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => 18}
+      assert_equal('http://hello.wo/?foo=18', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => true}
+      assert_equal('http://hello.wo/?foo=true', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => Time.utc(2012, 04, 05, 11, 19, 59)}
+      assert_equal('http://hello.wo/?foo=2012-04-05T11:19:59', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => Time.utc(2012, 04, 05, 11, 49, 17).localtime}
+      assert_equal('http://hello.wo/?foo=2012-04-05T11:49:17', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => ['hello']}
+      assert_equal('http://hello.wo/?foo=hello', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => ['hello', 'world']}
+      assert_equal('http://hello.wo/?foo=hello&foo=world', uri.to_s)
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => ['hello', 'world', 'of', Time.utc(2012)]}
+      assert_equal('http://hello.wo/?foo=hello&foo=world&foo=of&foo=2012-01-01T00:00:00', uri.to_s)
+    end
+
+    def test_require
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.require(:foo, :bar)
+      assert_raise ArgumentError do uri.to_s end
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => 'x', :bar => 'y'}
+      uri.require(:foo, :bar)
+      assert_nothing_raised do uri.to_s end
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:foo => 'x', :baz => 'z'}
+      uri.require(:foo, :bar)
+      assert_raise ArgumentError do uri.to_s end
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.params = {:bar => 'y', :baz => 'z', :foo => 'x'}
+      uri.require(:foo, :baz)
+      assert_nothing_raised do uri.to_s end
+
+      uri = Smartling::Uri.new('http://hello.wo/')
+      uri.require()
+      assert_nothing_raised do uri.to_s end
+      assert_equal('http://hello.wo/', uri.to_s)
+    end
+
+  end
+end
+

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: smartling
+version: !ruby/object:Gem::Version
+  version: 0.5.1
+  prerelease:
+platform: ruby
+authors:
+- Pavel Ivashkov
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2013-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+    none: false
+  prerelease: false
+  type: :runtime
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    none: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+    none: false
+  prerelease: false
+  type: :runtime
+description: A Ruby library to utilize Smartling services
+email:
+- hi@smartling.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- LICENSE
+- lib/smartling.rb
+- lib/smartling/api.rb
+- lib/smartling/fileapi.rb
+- lib/smartling/uri.rb
+- lib/smartling/version.rb
+- samples/file_api.rb
+- tests/api_test.rb
+- tests/config.sample
+- tests/srv_fileapi_test.rb
+- tests/test_helper.rb
+- tests/uri_test.rb
+homepage: https://docs.smartling.com
+licenses:
+- LICENSE
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.8.6
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: !binary |-
+        MA==
+  none: false
+requirements: []
+rubyforge_project:
+rubygems_version: 1.8.24
+signing_key:
+specification_version: 3
+summary: Smartling SDK
+test_files:
+- tests/api_test.rb
+- tests/config.sample
+- tests/srv_fileapi_test.rb
+- tests/test_helper.rb
+- tests/uri_test.rb