podio 0.1.0 → 0.2.0

data/README.md

@@ -3,6 +3,38 @@ Podio
 
 Ruby wrapper for the Podio API.
 
+Install
+-------
+
+Podio is packaged as a gem:
+
+    $ gem install podio
+
+
+Example
+-------
+
+    require 'rubygems'
+    require 'podio'
+
+    Podio.configure do |config|
+      config.api_key = 'YOUR_API_KEY'
+      config.api_secret = 'YOUR_API_SECRET'
+      config.debug = false
+    end
+
+    podio = Podio::Client.new
+    podio.get_access_token('YOUR_PODIO_ACCOUNT', 'YOUR_PODIO_PASSWORD')
+
+    # simple GET request
+    my_orgs = podio.connection.get('/org/').body
+
+    my_orgs.each do |org|
+      puts org.name
+      puts org.url
+    end
+
+
 Meta
 ----
 

data/Rakefile

@@ -5,7 +5,19 @@ Bundler::GemHelper.install_tasks
 
 desc 'Run tests'
 Rake::TestTask.new(:test) do |t|
-  t.libs << 'lib'
   t.pattern = 'test/**/*_test.rb'
   t.verbose = true
 end
+
+desc 'Record responses'
+task :record do
+  ENV['ENABLE_RECORD'] = 'true'
+
+  Dir['test/**/*_test.rb'].each do |f|
+    ruby('-Ilib', f)
+
+    folder_name = f.match(/test\/(.+)_test.rb/)[1]
+    FileUtils.mkdir_p("test/fixtures/#{folder_name}")
+    FileUtils.mv(Dir.glob('*.rack'), "test/fixtures/#{folder_name}")
+  end
+end

data/lib/podio.rb

@@ -1,4 +1,13 @@
 require 'faraday'
+require 'active_support/core_ext'
+
+require 'podio/middleware/date_conversion'
+require 'podio/middleware/logger'
+require 'podio/middleware/oauth2'
+require 'podio/middleware/podio_api'
+require 'podio/middleware/yajl_response'
+require 'podio/middleware/error_response'
+require 'podio/middleware/response_recorder'
 
 module Podio
   class << self
@@ -11,6 +20,18 @@ module Podio
       yield self
       true
     end
+
+    def client
+      Thread.current[:podio_client] ||= Podio::Client.new
+    end
+
+    def client=(new_client)
+      Thread.current[:podio_client] = new_client
+    end
+
+    def connection
+      client.connection
+    end
   end
 
   class OAuthToken < Struct.new(:access_token, :refresh_token, :expires_at)
@@ -21,14 +42,22 @@ module Podio
     end
   end
 
-  module Error
-    class TokenExpired < StandardError; end
-    class AuthorizationError < StandardError; end
-    class BadRequestError < StandardError; end
-    class ServerError < StandardError; end
-    class NotFoundError < StandardError; end
-    class GoneError < StandardError; end
-  end
-end
+  autoload :Client,          'podio/client'
+  autoload :Error,           'podio/error'
+  autoload :ResponseWrapper, 'podio/response_wrapper'
 
-require 'podio/client'
+  autoload :Application,        'podio/areas/application'
+  autoload :Category,           'podio/areas/app_store'
+  autoload :Contact,            'podio/areas/contact'
+  autoload :File,               'podio/areas/file'
+  autoload :Form,               'podio/areas/form'
+  autoload :Item,               'podio/areas/item'
+  autoload :Organization,       'podio/areas/organization'
+  autoload :OrganizationMember, 'podio/areas/organization_member'
+  autoload :Search,             'podio/areas/search'
+  autoload :Space,              'podio/areas/space'
+  autoload :SpaceInvite,        'podio/areas/space'
+  autoload :User,               'podio/areas/user'
+  autoload :UserStatus,         'podio/areas/user_status'
+  autoload :Widget,             'podio/areas/widget'
+end

data/lib/podio/areas/app_store.rb

@@ -0,0 +1,45 @@
+module Podio
+  module Category
+    include Podio::ResponseWrapper
+    extend self
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/app_store/category/"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/app_store/category/#{id}"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def delete(id)
+      Podio.connection.delete("/app_store/category/#{id}").status
+    end
+
+    def find(id)
+      member Podio.connection.get("/app_store/category/#{id}").body
+    end
+
+    def find_all
+      collection Podio.connection.get("/app_store/category/").body
+    end
+
+  private
+
+    def self.collection(response)
+      return Struct.new(:functional, :vertical).new([], []) if response.blank?
+      functionals = response['functional'].map! { |cat| member(cat) }
+      verticals   = response['vertical'].map! { |cat| member(cat) }
+      Struct.new(:functional, :vertical).new(functionals, verticals)
+    end
+  end
+end

data/lib/podio/areas/application.rb

@@ -0,0 +1,19 @@
+module Podio
+  module Application
+    include Podio::ResponseWrapper
+    extend self
+    
+    def find(app_id)
+      member Podio.connection.get("/app/#{app_id}").body
+    end
+    
+    def find_all(options={})
+      options.assert_valid_keys(:external_id, :space_ids, :owner_id, :status, :type)
+
+      list Podio.connection.get { |req|
+        req.url("/app/", options)
+      }.body
+    end
+    
+  end
+end

data/lib/podio/areas/contact.rb

@@ -0,0 +1,36 @@
+module Podio
+  module Contact
+    include Podio::ResponseWrapper
+    extend self
+
+    def all(options={})
+      options.assert_valid_keys(:key, :value, :limit, :offset, :type, :order)
+
+      list Podio.connection.get { |req|
+        req.url("/contact/", options)
+      }.body
+    end
+
+    def find(user_id)
+      member Podio.connection.get("/contact/#{user_id}").body
+    end
+
+    def find_all_for_org(org_id, options={})
+      options.assert_valid_keys(:key, :value, :limit, :offset, :type, :order)
+      options[:type] ||= 'full'
+
+      list Podio.connection.get { |req|
+        req.url("/contact/org/#{org_id}", options)
+      }.body
+    end
+    
+    def find_for_org(org_id)
+      member Podio.connection.get("/org/#{org_id}/profile").body
+    end
+    
+    def totals_by_org
+      Podio.connection.get("/contact/totals/").body
+    end
+    
+  end
+end

data/lib/podio/areas/file.rb

@@ -0,0 +1,23 @@
+module Podio
+  module File
+    include Podio::ResponseWrapper
+    extend self
+
+    # Uploading a file is a two-step operation
+    # First, the file must be created to get a file id and the path to move it to
+    def create(name, content_type)
+      response = Podio.connection.post do |req|
+        req.url "/file/"
+        req.body = { :name => name, :mimetype => content_type }
+      end
+
+      response.body
+    end
+    
+    # Then, when the file has been moved, it must be marked as available
+    def set_available(file_id)
+      Podio.connection.post "/file/#{file_id}/available"
+    end
+    
+  end
+end

data/lib/podio/areas/form.rb

@@ -0,0 +1,11 @@
+module Podio
+  module Form
+    include Podio::ResponseWrapper
+    extend self
+    
+    def find(form_id)
+      member Podio.connection.get("/form/#{form_id}").body
+    end
+    
+  end
+end

data/lib/podio/areas/item.rb

@@ -0,0 +1,32 @@
+module Podio
+  module Item
+    include Podio::ResponseWrapper
+    extend self
+
+    def find(id)
+      member Podio.connection.get("/item/#{id}").body
+    end
+
+    def find_all_by_external_id(app_id, external_id)
+      collection Podio.connection.get("/item/app/#{app_id}/v2/?external_id=#{external_id}").body
+    end
+
+    def find_all(app_id, options={})
+      options.assert_valid_keys(:key, :limit, :offset, :sort_by, :sort_desc)
+
+      collection Podio.connection.get { |req|
+        req.url("/item/app/#{app_id}/", options)
+      }.body
+    end
+
+    
+    def create(app_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/item/app/#{app_id}/"
+        req.body = attributes
+      end
+
+      response.body['item_id']
+    end    
+  end
+end

data/lib/podio/areas/organization.rb

@@ -0,0 +1,67 @@
+module Podio
+  module Organization
+    include Podio::ResponseWrapper
+    extend self
+    
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/org/#{id}"
+        req.body = attributes
+      end
+      response.status
+    end
+
+    def delete(id)
+      Podio.connection.delete("/org/#{id}").status
+    end
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url '/org/'
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def find(id)
+      member Podio.connection.get("/org/#{id}").body
+    end
+
+    def find_by_url(url)
+      member Podio.connection.get("/org/url?url=#{url}").body
+    end
+
+    def validate_url_label(url_label)
+      Podio.connection.post { |req|
+        req.url '/org/url/validate'
+        req.body = {:url_label => url_label}
+      }.body
+    end
+
+    def find_all
+      list Podio.connection.get("/org/").body
+    end
+    
+    def get_statistics(id)
+      Podio.connection.get("/org/#{id}/statistics").body
+    end
+    
+    def get_login_report(id, options = {})
+      options.assert_valid_keys(:limit, :offset)
+
+      Podio.connection.get { |req|
+        req.url("/org/#{id}/report/login/", options)
+      }.body
+    end
+    
+    def update_profile(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/org/#{id}/profile"
+        req.body = attributes
+      end
+      response.status
+    end
+    
+  end
+end

data/lib/podio/areas/organization_member.rb

@@ -0,0 +1,35 @@
+module Podio
+  module OrganizationMember
+    include Podio::ResponseWrapper
+    extend self
+
+    def find_all_for_org(org_id, options = {})
+      options.assert_valid_keys(:sort_by, :sort_desc, :limit, :offset)
+
+      list Podio.connection.get { |req|
+        req.url("/org/#{org_id}/member/", options)
+      }.body
+    end
+
+    def find(org_id, user_id)
+      member Podio.connection.get("/org/#{org_id}/member/#{user_id}").body
+    end
+    
+    def delete(org_id, user_id)
+      Podio.connection.delete("/org/#{org_id}/member/#{user_id}").status
+    end
+    
+    def make_admin(org_id, user_id)
+      response = Podio.connection.post do |req|
+        req.url "/org/#{org_id}/admin/"
+        req.body = { :user_id => user_id.to_i }
+      end
+      response.status
+    end
+
+    def remove_admin(org_id, user_id)
+      Podio.connection.delete("/org/#{org_id}/admin/#{user_id}").status
+    end
+    
+  end
+end

data/lib/podio/areas/search.rb

@@ -0,0 +1,15 @@
+module Podio
+  module Search
+    include Podio::ResponseWrapper
+    extend self
+
+    def in_org(org_id, words)
+      response = Podio.connection.post do |req|
+        req.url "/search/org/#{org_id}/"
+        req.body = words
+      end
+
+      list response.body
+    end
+  end
+end

data/lib/podio/areas/space.rb

@@ -0,0 +1,46 @@
+module Podio
+  module Space
+    include Podio::ResponseWrapper
+    extend self
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url '/space/'
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def find(id)
+      member Podio.connection.get("/space/#{id}").body
+    end
+
+    def find_all_for_org(org_id)
+      list Podio.connection.get("/org/#{org_id}/space/").body
+    end
+  end
+
+  module SpaceInvite
+    include Podio::ResponseWrapper
+    extend self
+
+    def create(space_id, role, attributes={})
+      response = Podio.connection.post do |req|
+        req.url "/space/#{space_id}/invite"
+        req.body = attributes.merge(:role => role)
+      end
+
+      response.body
+    end
+
+    def accept(invite_code)
+      response = Podio.connection.post do |req|
+        req.url '/space/invite/accept'
+        req.body = {:invite_code => invite_code}
+      end
+
+      response.body
+    end
+  end
+end