amara 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 39b648a9d9d4ec8b3d696a4e3a74e3d299a4ad6e
+  data.tar.gz: 29c2865c646fdd2614d652c9cd53c8f24b2b07ad
+SHA512:
+  metadata.gz: 6dd1b533b9c6eae14e2eeb194b01be2b3594b2c9d51c2f7e4d3e178901029b982b4d4f3df93c840f32ea50fbc4bff4637ee5b1db117b358a3504e9a58532d475
+  data.tar.gz: 81a23ab2d4a75b472a3ada63f86c25bb61306da07af21fafd852a393a506037b9179b1ff9fab038f6ab3c69759d1f7cbeb1639f470f3cbafa5d6e1065deb70d7

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Andrew Kuklewicz
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,38 @@
+# Amara
+
+Ruby gem to access the Amara API.
+
+http://www.amara.org/
+http://amara.readthedocs.org/en/latest/api.html
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'amara'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install amara
+
+## Usage
+
+You need a user account and API key to use the API.
+Some capabilities (e.g. creating a team) are only enabled for enterprise customers.
+
+```ruby
+amara = Amara::Client.new(api_username: 'amara_api_username', api_key: 'amara_api_key')
+amara.videos
+```
+
+## Contributing
+
+1. Fork it
+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 new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Rake::TestTask.new do |t|
+  t.libs.push 'lib'
+  t.libs.push 'test'
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+task :default => :test

data/amara.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'amara/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "amara"
+  gem.version       = Amara::VERSION
+  gem.authors       = ["Andrew Kuklewicz"]
+  gem.email         = ["andrew@prx.org"]
+  gem.description   = %q{Access the amara.org API}
+  gem.summary       = %q{Works with API v1.2, http://amara.readthedocs.org/en/latest/api.html}
+  gem.homepage      = "https://github.com/PRX/amara"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_runtime_dependency('faraday')
+  gem.add_runtime_dependency('faraday_middleware')
+  gem.add_runtime_dependency('multi_json')
+  gem.add_runtime_dependency('excon')
+  gem.add_runtime_dependency('hashie')
+  gem.add_runtime_dependency('activesupport')
+
+  gem.add_development_dependency('rake')
+  gem.add_development_dependency('minitest')
+  gem.add_development_dependency('webmock')
+end

data/lib/amara.rb

@@ -0,0 +1,45 @@
+# -*- encoding: utf-8 -*-
+
+require 'rubygems'
+require 'active_support/all'
+
+require 'amara/version'
+require 'amara/configuration'
+require 'amara/connection'
+require 'amara/response'
+require 'amara/api'
+require 'amara/api_factory'
+require 'amara/languages'
+require 'amara/teams'
+require 'amara/teams/members'
+require 'amara/teams/projects'
+require 'amara/videos'
+require 'amara/videos/languages'
+require 'amara/videos/languages/subtitles'
+require 'amara/videos/urls'
+require 'amara/client'
+
+module Amara
+  extend Configuration
+
+  HEADERS = {
+    :api_key      => 'X-apikey',
+    :api_username => 'X-api-username'
+  }
+
+  TEAM_POLICIES = {
+    :open           => 'Open',
+    :apply          => 'Application',
+    :invite         => 'Invitation by any team member',
+    :manager_invite => 'Invitation by manager',
+    :admin_invite   => 'Invitation by admin'
+  }
+
+  POLICIES = {
+    :anyone   => 'Anyone',
+    :member   => 'Any team member',
+    :managers => 'Managers and admins',
+    :admins   => 'Admins only'
+  }
+
+end

data/lib/amara/api.rb

@@ -0,0 +1,103 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class API
+
+    include Connection
+
+    attr_reader *Amara::Configuration.keys
+
+    attr_accessor :current_options
+
+    class_eval do
+      Amara::Configuration.keys.each do |key|
+        define_method "#{key}=" do |arg|
+          self.instance_variable_set("@#{key}", arg)
+          self.current_options.merge!({:"#{key}" => arg})
+        end
+      end
+    end
+
+    def initialize(options={}, &block)
+      apply_options(options)
+      yield(self) if block_given?
+    end
+
+    def apply_options(options={})
+      self.current_options ||= ActiveSupport::HashWithIndifferentAccess.new(Amara.options)
+      self.current_options = current_options.merge(args_to_options(options))
+      Configuration.keys.each do |key|
+        send("#{key}=", current_options[key])
+      end
+    end
+
+    def request(method, path, params={}) # :nodoc:
+      unless (method && [:get, :post, :put, :patch, :delete].include?(method))
+        raise ArgumentError, "whoops, that isn't a valid http method: #{method}"
+      end
+
+      conn = connection((params[:options] || {}).merge(current_options))
+      request_path = (conn.path_prefix + '/' + path + '/').gsub(/\/+/, '/') 
+
+      response = conn.send(method) do |request|
+        case method.to_sym
+        when :get, :delete
+          request.url(request_path, params)
+        when :post, :put
+          request.path = request_path
+          request.body = params[:data] unless params.empty?
+        end
+      end
+      Amara::Response.new(response, {api: self, method: method, path: path, params: params})
+    end
+
+    def base_path
+      parts = self.class.name.split("::").inject([]){|a, c|
+        if c != 'Amara'
+          base = c.downcase.underscore
+          a << base
+          a << current_options["#{base.singularize}_id"] if current_options["#{base.singularize}_id"]
+        end
+        a
+      }
+      parts.join('/')
+    end
+
+    def paginate(params={})
+      {limit: 20, offset: 0}.merge(params)
+    end
+
+    def list(params={})
+      self.current_options = current_options.merge(args_to_options(params))
+      request(:get, base_path, paginate(params))
+    end
+
+    def get(params={})
+      self.current_options = current_options.merge(args_to_options(params))
+      request(:get, base_path)
+    end
+
+    def create(params={})
+      self.current_options = current_options.merge(args_to_options(params))
+      request(:post, base_path, {data: params})
+    end
+
+    def update(params={})
+      self.current_options = current_options.merge(args_to_options(params))
+      request(:put, base_path, {data: params})
+    end
+
+    def delete(params={})
+      self.current_options = current_options.merge(args_to_options(params))
+      request(:delete, base_path)
+    end
+
+    def args_to_options(args)
+      params =  if args.is_a?(String) || args.is_a?(Symbol)
+        {"#{self.class.name.demodulize.downcase.singularize}_id" => args}
+      elsif args.is_a?(Hash)
+        args
+      end
+    end
+  end
+end

data/lib/amara/api_factory.rb

@@ -0,0 +1,13 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class ApiFactory
+
+    def self.api(name, parent, options={}, &block)
+      api = name.constantize.new(parent.current_options)
+      api.apply_options(options)
+      yield(api) if block_given?
+      api
+    end
+  end
+end

data/lib/amara/client.rb

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Client < API
+
+    def teams(params={}, &block)
+      @teams ||= ApiFactory.api('Amara::Teams', self, params, &block)
+    end
+
+    # def videos(params={}, &block)
+    #   @videos ||= Videos.new(current_options.merge(args_to_options(params)), &block)
+    # end
+
+    def languages(params={}, &block)
+      @languages ||= ApiFactory.api('Amara::Languages', self, params, &block)
+    end
+
+  end
+end

data/lib/amara/configuration.rb

@@ -0,0 +1,61 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  module Configuration
+
+    VALID_OPTIONS_KEYS = [
+      :api_username,
+      :api_key,
+      :adapter,
+      :endpoint,
+      :user_agent
+    ].freeze
+
+    # this you need to get from amara - go register!
+    DEFAULT_API_USERNAME = nil
+    DEFAULT_API_KEY = nil
+
+    # Adapters are whatever Faraday supports - I like excon alot, so I'm defaulting it
+    DEFAULT_ADAPTER = :excon
+
+    # The api endpoint to get REST
+    DEFAULT_ENDPOINT = 'https://www.amara.org/api2/partners'.freeze
+
+    # The value sent in the http header for 'User-Agent' if none is set
+    DEFAULT_USER_AGENT = "Amara Ruby Gem #{Amara::VERSION}".freeze
+
+    attr_accessor *VALID_OPTIONS_KEYS
+
+    # Convenience method to allow for global setting of configuration options
+    def configure
+      yield self
+    end
+
+    def self.extended(base)
+      base.reset!
+    end
+
+    class << self
+      def keys
+        VALID_OPTIONS_KEYS
+      end
+    end
+
+    def options
+      options = {}
+      VALID_OPTIONS_KEYS.each { |k| options[k] = send(k) }
+      options
+    end
+
+    # Reset configuration options to their defaults
+    def reset!
+      self.api_username = DEFAULT_API_USERNAME
+      self.api_key      = DEFAULT_API_KEY
+      self.adapter      = DEFAULT_ADAPTER
+      self.endpoint     = DEFAULT_ENDPOINT
+      self.user_agent   = DEFAULT_USER_AGENT
+      self
+    end
+
+  end
+end

data/lib/amara/connection.rb

@@ -0,0 +1,46 @@
+# -*- encoding: utf-8 -*-
+
+require 'faraday_middleware'
+
+module Amara
+  module Connection
+
+    ALLOWED_OPTIONS = [
+      :headers,
+      :url,
+      :params,
+      :request,
+      :ssl
+    ].freeze
+
+    def merge_default_options(opts={})
+      headers = opts.delete(:headers) || {}
+      options = {
+        :headers => {
+          'User-Agent'   => user_agent,
+          'Accept'       => "application/json",
+          'Content-Type' => "application/json"
+        },
+        :ssl => {:verify => false},
+        :url => endpoint
+      }.merge(opts)
+      options[:headers] = options[:headers].merge(headers)
+      Amara::HEADERS.each{|k,v| options[:headers][v] = options.delete(k) if options.key?(k)}      
+      options
+    end
+
+    def connection(options={})
+      opts = merge_default_options(options)
+      Faraday::Connection.new(opts) do |connection|
+        connection.request  :url_encoded
+
+        connection.response :mashify
+        connection.response :logger if ENV['DEBUG']
+        connection.response :json
+
+        connection.adapter(adapter)
+      end
+
+    end
+  end
+end

data/lib/amara/languages.rb

@@ -0,0 +1,6 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Languages < API
+  end
+end

data/lib/amara/response.rb

@@ -0,0 +1,112 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Response
+    attr_accessor :raw, :request
+
+    def object
+      if objects.size == 0
+        nil
+      elsif objects.size == 1
+        objects.first
+      elsif objects.size > 1
+        objects
+      end
+    end
+
+    def initialize(response, request={})
+      @raw     = response
+      @request = request
+
+      check_for_error(response)
+    end
+
+    def check_for_error(response)
+      status_code_type = response.status.to_s[0]
+      case status_code_type
+      when "2"
+        # puts "all is well, status: #{response.status}"
+      when "4", "5"
+        raise "Whoops, error back from Amara: #{response.status}"
+      else
+        raise "Unrecongized status code: #{response.status}"
+      end
+    end
+
+    def body
+      self.raw.body
+    end
+
+    def object
+      body.objects.nil? ? body : body.objects
+    end
+
+    def objects
+      Array(self.object)
+    end
+
+    def [](key)
+      if self.object.is_a?(Array)
+        self.object[key]
+      else
+        self.object.send(:"#{key}")
+      end
+    end
+
+    def has_key?(key)
+      self.object.is_a?(Hash) && self.object.has_key?(key)
+    end
+
+    # Coerce any method calls for body attributes
+    #
+    def method_missing(method_name, *args, &block)
+      if self.has_key?(method_name.to_s)
+        self.[](method_name, &block)
+      elsif self.objects.respond_to?(method_name)
+        self.objects.send(method_name, *args, &block)
+      elsif self.request[:api].respond_to?(method_name)
+        self.request[:api].send(method_name, *args, &block)
+      else
+        super
+      end
+    end
+
+    def offset
+      return 0 unless self.body.meta
+      self.body.meta.offset.to_i
+    end
+
+    def total_count
+      return 0 unless self.body.meta
+      self.body.meta.total_count.to_i
+    end
+
+    def limit
+      return 0 unless self.body.meta
+      self.body.meta.limit.to_i
+    end
+
+    def has_next_page?
+      (offset + limit) < total_count
+    end
+
+    def has_previous_page?
+      offset > 0
+    end
+
+    def next_page
+      return nil unless has_next_page?
+      new_offset = [(offset + limit), total_count].min
+      new_response = request[:api].request(request[:method], request[:path], request[:params].merge({offset: new_offset, limit: limit}))
+      self.raw = new_response.raw
+    end
+
+    def previous_page
+      return nil unless has_previous_page?
+      new_offset = [(offset - limit), 0].max
+      new_response = request[:api].request(request[:method], request[:path], request[:params].merge({offset: new_offset, limit: limit}))
+      self.raw = new_response.raw
+    end
+
+  end
+end

data/lib/amara/teams.rb

@@ -0,0 +1,15 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Teams < API
+
+    def members(options={}, &block)
+      @members ||= Teams::Members.new(current_options.merge(args_to_options(options)), &block)
+    end
+
+    def projects(options={}, &block)
+      @projects ||= Teams::Projects.new(current_options.merge(args_to_options(options)), &block)
+    end
+
+  end
+end

data/lib/amara/teams/members.rb

@@ -0,0 +1,6 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Teams::Members < API
+  end
+end

data/lib/amara/teams/projects.rb

@@ -0,0 +1,6 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Teams::Projects < API
+  end
+end

data/lib/amara/version.rb

@@ -0,0 +1,5 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  VERSION = "0.0.1"
+end

data/lib/amara/videos.rb

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Videos < API
+
+    VIDEO_ATTRIBUTES    = [:all_urls, :created, :description, :duration, :id, :languages, :original_language, :project, :resource_uri, :site_url, :team, :thumbnail, :title]
+    VIDEO_CREATE_PARAMS = [:duration, :primary_audio_language_code, :title, :video_url]
+    VIDEO_LIST_PARAMS   = [:order_by, :project, :team, :video_url]
+    VIDEO_ORDERING      = [:created, :title]
+
+    def languages(options={}, &block)
+      @languages ||= Videos::Languages.new(current_options.merge(args_to_options(options)), &block)
+    end
+
+    def urls(options={}, &block)
+      @urls ||= Videos::Urls.new(current_options.merge(args_to_options(options)), &block)
+    end
+
+  end
+end

data/lib/amara/videos/languages.rb

@@ -0,0 +1,11 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Videos::Languages < API
+
+    def subtitles(options={}, &block)
+      @subtitles ||= Videos::Languages::Subtitles.new(current_options.merge(args_to_options(options)), &block)
+    end
+
+  end
+end

data/lib/amara/videos/languages/subtitles.rb

@@ -0,0 +1,6 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Videos::Languages::Subtitles < API
+  end
+end

data/lib/amara/videos/urls.rb

@@ -0,0 +1,6 @@
+# -*- encoding: utf-8 -*-
+
+module Amara
+  class Videos::Urls < API
+  end
+end

data/test/api_test.rb

@@ -0,0 +1,73 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+# create dummy class based on the API
+class TestApi < ::Amara::API
+end
+
+describe Amara::API do
+
+  before {
+    @amara_api_username = ENV['AMARA_API_USERNAME'] || "testuser"
+    @amara_api_key      = ENV['AMARA_API_KEY']      || "thisisatestkeyonly"
+  }
+
+  it "is initialized with defaults" do
+    oc = TestApi.new
+    oc.current_options.wont_be_nil
+    oc.current_options.must_equal HashWithIndifferentAccess.new(Amara.options)
+  end
+
+  it "is initialized with specific values" do
+    oc = TestApi.new(api_key: @amara_api_key, api_username: @amara_api_username)
+    oc.current_options.wont_be_nil
+    oc.current_options.wont_equal Amara.options
+
+    oc.current_options[:api_key].must_equal @amara_api_key
+    oc.api_key.must_equal @amara_api_key
+
+    oc.current_options[:api_username].must_equal @amara_api_username
+    oc.api_username.must_equal @amara_api_username
+  end
+
+  it "returns a list and paginates through it" do
+    first_response = '{"meta": {"limit": 2, "next": "/api2/partners/api/?limit=2&offset=2", "offset": 0, "previous": null, "total_count": 5}, "objects": [{"id": 1}, {"id": 2}]}'
+    stub_request(:get, 'https://www.amara.org/api2/partners/api/?limit=2&offset=0').
+       to_return(body: first_response)
+
+    api = Amara::API.new(api_key: 'thisisakey', api_username: 'test_user')
+    # puts teams.list.raw.inspect
+
+    response = api.list(limit: 2)
+    response.objects.must_equal response.object
+
+    response.offset.must_equal 0
+    response.limit.must_equal 2
+    response.size.must_equal 2
+    response.first.id.must_equal 1
+    
+    second_response = '{"meta": {"limit": 2, "next": "/api2/partners/api/?limit=2&offset=4", "offset": 2, "previous":"/api2/partners/api/?limit=2&offset=0", "total_count": 5}, "objects": [{"id": 3}, {"id": 4}]}'
+    stub_request(:get, 'https://www.amara.org/api2/partners/api/?limit=2&offset=2').
+       to_return(body: second_response)
+
+    response.must_be :has_next_page?
+    response.next_page
+    response.offset.must_equal 2
+    response.limit.must_equal 2
+    response.first.id.must_equal 3
+
+    third_response = '{"meta": {"limit": 2, "next": null, "offset": 4, "previous":"/api2/partners/api/?limit=2&offset=2", "total_count": 5}, "objects": [{"id": 5}]}'
+    stub_request(:get, 'https://www.amara.org/api2/partners/api/?limit=2&offset=4').
+       to_return(body: third_response)
+
+    response.must_be :has_next_page?
+    response.next_page
+    response.offset.must_equal 4
+    response.limit.must_equal 2
+    response.first.id.must_equal 5
+
+    response.wont_be :has_next_page?
+  end
+
+end

data/test/client_test.rb

@@ -0,0 +1,12 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+describe Amara::Client do
+
+  it "returns a teams api object" do
+    amara = Amara::Client.new
+    amara.teams.wont_be_nil
+  end
+
+end

data/test/teams/projects_test.rb

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + '/../test_helper')
+
+require 'amara/api'
+require 'amara/teams'
+require 'amara/teams/projects'
+
+require 'webmock/minitest'
+
+describe Amara::Teams::Projects do
+
+  it "gets the base path for this subclass of API" do
+    teams = Amara::Teams::Projects.new(team_id: 'test-team')
+    teams.base_path.must_equal 'teams/test-team/projects'
+
+    teams = Amara::Teams::Projects.new(team_id: 'test-team', project_id: 'test-project')
+    teams.base_path.must_equal 'teams/test-team/projects/test-project'
+  end
+
+  it "gets a list of projects for a team" do
+
+    first_response = '{"meta": {"limit": 2, "next": "/api2/partners/teams/test-team/projects/?limit=2&offset=2", "offset": 0, "previous": null, "total_count": 5}, "objects": [{"created": "2013-02-14T07:29:55"}, {"created": "2011-03-01T11:38:16"}]}'
+
+    stub_request(:get, "https://www.amara.org/api2/partners/teams/test-team/projects/?limit=2&offset=0").
+      with(:headers => {'Accept'=>'application/json', 'Content-Type'=>'application/json', 'Host'=>'www.amara.org:443', 'User-Agent'=>'Amara Ruby Gem 0.0.1'}).
+      to_return(:status => 200, :body => "", :headers => {})
+
+    amara = Amara::Client.new
+    response = amara.teams('test-team').projects.list(limit: 2)
+  end
+
+end

data/test/teams_test.rb

@@ -0,0 +1,57 @@
+# -*- encoding: utf-8 -*-
+
+require File.expand_path(File.dirname(__FILE__) + '/test_helper')
+
+require 'amara/api'
+require 'amara/teams'
+
+require 'webmock/minitest'
+
+describe Amara::Client do
+
+  it "gets the base path for this subclass of API" do
+    teams = Amara::Teams.new
+    teams.base_path.must_equal 'teams'
+  end
+
+  it "returns a list of teams" do
+    first_response = '{"meta": {"limit": 2, "next": "/api2/partners/team/?limit=2&offset=2", "offset": 0, "previous": null, "total_count": 5}, "objects": [{"created": "2013-02-14T07:29:55", "deleted": false, "description": "", "header_html_text": "", "is_moderated": false, "is_visible": true, "logo": null, "max_tasks_per_member": null, "membership_policy": "Open", "name": "", "projects_enabled": false, "resource_uri": "/api2/partners/teams/tedx-import/", "slug": "tedx-import", "subtitle_policy": "Anyone", "task_assign_policy": "Any team member", "task_expiration": null, "translate_policy": "Anyone", "video_policy": "Any team member", "workflow_enabled": false}, {"created": "2011-03-01T11:38:16", "deleted": false, "description": "", "header_html_text": "<style>\r\n#custom_header {\r\nbackground: transparent url(http://blog.universalsubtitles.org/wp-content/uploads/2011/03/aljazeera_header_bg.png) 0 0 no-repeat;\r\nwidth: 943px;\r\nheight: 237px;\r\nposition: relative;\r\n}\r\n\r\n.team-detail {\r\ndisplay: none;\r\n}\r\n\r\n#team_video_policy {\r\ndisplay: none;\r\n}\r\n\r\n#team_detail_managers {\r\ndisplay: none;\r\n}\r\n\r\n#team_member_policy {\r\ndisplay: none;\r\n}\r\n\r\n#team_volunteer_detail {\r\ndisplay: block;\r\n}\r\n\r\n#custom_header {\r\nmargin-bottom: 15px;\r\n}\r\n\r\n#team_title {\r\ndisplay: none;\r\n}\r\n\r\n#custom_header a#logo_link {\r\nwidth: 450px;\r\nheight: 91px;\r\ndisplay: block;\r\nposition: absolute;\r\ntop: 88px;\r\nleft: 95px;\r\ntext-indent: -99999px;\r\n}\r\n\r\n#custom_header #sidecol {\r\nwidth: 290px;\r\nheight: 200px;\r\nfloat: right;\r\nmargin: 30px 12px 0 0;\r\n}\r\n\r\n#custom_header #sidecol h1 {\r\nfont-size: 18px;\r\nfont-weight: bold;\r\ntext-shadow: 0 -1px 0 #f97f00;\r\ncolor: #FFF;\r\nmargin: 0 0 15px 0;\r\n}\r\n#custom_header #sidecol p {\r\nfont-size: 15px;\r\nline-height: 25px;\r\ntext-shadow: 0 -1px 0 #f97f00;\r\ncolor: #FFF;\r\nwidth: 280px;\r\n}\r\n</style>\r\n<div id=\"custom_header\">\r\n<a id=\"logo_link\" href=\"http://english.aljazeera.net\">Al Jazeera</a>\r\n<div id=\"sidecol\">\r\n<h1>Join the Translation Team</h1>\r\n<p>These are some of the popular Al Jazeera videos in English and Arabic, as well as other videos that complement Al Jazeera\'s news output from around the globe.</p>\r\n</div><!-- // sidecol -->\r\n</div><!-- // custom_header -->", "is_moderated": false, "is_visible": true, "logo": "http://s3.amazonaws.com/s3.userdata.staging.amara.org/teams/logo/6f94ad51700869bc359bbb750f1420e0a05493f1.png", "max_tasks_per_member": null, "membership_policy": "Open", "name": "Al Jazeera", "projects_enabled": false, "resource_uri": "/api2/partners/teams/al-jazeera/", "slug": "al-jazeera", "subtitle_policy": "Anyone", "task_assign_policy": "Any team member", "task_expiration": null, "translate_policy": "Anyone", "video_policy": "Admins only", "workflow_enabled": false}]}'
+    stub_request(:get, 'https://www.amara.org/api2/partners/teams/?limit=2&offset=0').
+       to_return(body: first_response)
+
+    teams = Amara::Teams.new(api_key: 'thisisakey', api_username: 'test_user')
+    # puts teams.list.raw.inspect
+
+    response = teams.list(limit: 2)
+    response.objects.must_equal response.object
+
+    response.offset.must_equal 0
+    response.limit.must_equal 2
+    response.size.must_equal 2
+    response.first.slug.must_equal "tedx-import"
+  end
+
+  it "returns a team" do
+    response = '{"created": "2013-02-14T07:29:55", "deleted": false, "description": "", "header_html_text": "", "is_moderated": false, "is_visible": true, "logo": null, "max_tasks_per_member": null, "membership_policy": "Open", "name": "", "projects_enabled": false, "resource_uri": "/api2/partners/teams/tedx-import/", "slug": "tedx-import", "subtitle_policy": "Anyone", "task_assign_policy": "Any team member", "task_expiration": null, "translate_policy": "Anyone", "video_policy": "Any team member", "workflow_enabled": false}'
+    stub_request(:get, "https://www.amara.org/api2/partners/teams/tedx-import/").
+       to_return(body: response)
+
+    teams = Amara::Teams.new(api_key: 'thisisakey', api_username: 'test_user')
+    # puts teams.list.raw.inspect
+
+    response = teams.get("tedx-import")
+    response.object.wont_be_nil
+    team = response.object
+    team.slug.must_equal 'tedx-import'
+
+    response = teams.get(team_id: "tedx-import")
+    response.object.wont_be_nil
+    team = response.object
+    team.slug.must_equal 'tedx-import'
+  end
+
+  it "created a new team" do
+    create_response = '{"created": "2013-08-01T13:11:45.167206", "deleted": false, "description": "", "header_html_text": "", "is_moderated": false, "is_visible": true, "logo": null, "max_tasks_per_member": null, "membership_policy": "Open", "name": "prx test 1", "projects_enabled": false, "resource_uri": "/api2/partners/teams/prx-test-1/", "slug": "prx-test-1", "subtitle_policy": "Anyone", "task_assign_policy": "Any team member", "task_expiration": null, "translate_policy": "Anyone", "video_policy": "Any team member", "workflow_enabled": false}'
+  end
+
+end

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+# -*- encoding: utf-8 -*-
+
+require 'minitest'
+require 'minitest/autorun'
+require 'minitest/spec'
+require 'webmock/minitest'
+
+require 'amara'

metadata

@@ -0,0 +1,202 @@
+--- !ruby/object:Gem::Specification
+name: amara
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Andrew Kuklewicz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-12 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  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: faraday_middleware
+  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: multi_json
+  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: excon
+  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: hashie
+  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: activesupport
+  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: rake
+  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: minitest
+  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: webmock
+  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'
+description: Access the amara.org API
+email:
+- andrew@prx.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- amara.gemspec
+- lib/.DS_Store
+- lib/amara.rb
+- lib/amara/api.rb
+- lib/amara/api_factory.rb
+- lib/amara/client.rb
+- lib/amara/configuration.rb
+- lib/amara/connection.rb
+- lib/amara/languages.rb
+- lib/amara/response.rb
+- lib/amara/teams.rb
+- lib/amara/teams/members.rb
+- lib/amara/teams/projects.rb
+- lib/amara/version.rb
+- lib/amara/videos.rb
+- lib/amara/videos/languages.rb
+- lib/amara/videos/languages/subtitles.rb
+- lib/amara/videos/urls.rb
+- test/api_test.rb
+- test/client_test.rb
+- test/teams/projects_test.rb
+- test/teams_test.rb
+- test/test_helper.rb
+homepage: https://github.com/PRX/amara
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: Works with API v1.2, http://amara.readthedocs.org/en/latest/api.html
+test_files:
+- test/api_test.rb
+- test/client_test.rb
+- test/teams/projects_test.rb
+- test/teams_test.rb
+- test/test_helper.rb