podio 0.4.1 → 0.5.0

data/lib/podio/models/space.rb

@@ -0,0 +1,45 @@
+class Podio::Space < ActivePodio::Base
+  property :space_id, :integer
+  property :name, :string
+  property :url, :string
+  property :url_label, :string
+  property :org_id, :integer
+  property :contact_count, :integer
+  property :members, :integer
+  property :role, :string
+  property :rights, :array
+  
+  has_one :created_by, :class => 'ByLine'
+
+  alias_method :id, :space_id
+  
+  def create
+    response = Space.create(:org_id => org_id, :name => name)
+    self.url = response['url']
+    self.space_id = response['space_id']
+  end
+  
+  class << 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_by_url(url)
+      member Podio.connection.get("/space/url?url=#{ERB::Util.url_encode(url)}").body
+    end
+    
+    def find_all_for_org(org_id)
+      list Podio.connection.get("/org/#{org_id}/space/").body
+    end
+  end
+end
+

data/lib/podio/models/space_contact.rb

@@ -0,0 +1,23 @@
+class Podio::SpaceContact < Podio::Profile
+  include ActivePodio::Updatable
+
+  property :space_id, :integer
+  property :organization, :string
+  property :avatar, :integer
+
+  alias_method :id, :profile_id
+
+  def create
+    self.profile_id = self.class.create_space_contact(self.space_id, self.attributes)['profile_id']
+  end
+
+  def update
+    self.class.update_contact(self.profile_id, self.attributes)
+  end
+
+  def destroy
+    self.class.delete_contact(self.profile_id)
+  end
+
+  handle_api_errors_for :create, :update # Call must be made after the methods to handle have been defined
+end

data/lib/podio/models/space_invite.rb

@@ -0,0 +1,57 @@
+class Podio::SpaceInvite < ActivePodio::Base
+  include ActivePodio::Updatable
+  
+  property :space_id, :integer
+  property :role, :string
+  property :subject, :string
+  property :message, :string
+  property :notify, :boolean
+  property :users, :array
+  property :mails, :array
+  property :profiles, :array
+  property :activation_code, :integer
+
+  def save
+    self.class.create(self.space_id, self.role, self.attributes.except(:contacts))
+  end
+
+  def accept(invite_code)
+    self.class.accept(invite_code)
+  end
+  
+  handle_api_errors_for :save, :accept # Call must be made after the methods to handle have been defined
+  
+  class << 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
+
+    def decline(invite_code)
+      response = Podio.connection.post do |req|
+        req.url '/space/invite/decline'
+        req.body = {:invite_code => invite_code}
+      end
+
+      response.body
+    end
+
+    def find(invite_code)
+      member Podio.connection.get("/space/invite/status?invite_code=#{ERB::Util.url_encode(invite_code)}").body
+    end
+    
+  end
+end

data/lib/podio/models/space_member.rb

@@ -0,0 +1,32 @@
+# Encapsulates a user's membership of a space.
+class Podio::SpaceMember < ActivePodio::Base
+  property :role, :string
+  property :invited_on, :datetime
+  property :started_on, :datetime
+
+  has_one :user, :class => 'User'
+
+  delegate :user_id, :name, :to => :user
+
+  alias_method :id, :user_id
+  
+  class << self
+    def find_all_for_role(space_id, role)
+      list Podio.connection.get { |req|
+        req.url("/space/#{space_id}/member/#{role}/")
+      }.body
+    end
+
+    def update_role(space_id, user_id, role)
+      response = Podio.connection.put do |req|
+        req.url "/space/#{space_id}/member/#{user_id}"
+        req.body = { :role => role.to_s }
+      end
+      response.status
+    end
+
+    def end_membership(space_id, user_id)
+      Podio.connection.delete("/space/#{space_id}/member/#{user_id}").status
+    end
+  end
+end

data/lib/podio/models/status.rb

@@ -0,0 +1,35 @@
+class Podio::Status < ActivePodio::Base
+  property :status_id, :integer
+  property :value, :string
+  property :link, :string
+  property :created_on, :datetime
+  property :alerts, :array
+  property :ratings, :hash
+  property :subscribed, :boolean
+  property :user_ratings, :hash
+
+  has_one :created_by, :class => 'Contact'
+  has_one :created_via, :class => 'Via'
+  has_many :comments, :class => 'Comment'
+  has_many :conversations, :class => 'Conversation'
+  has_many :tasks, :class => 'Task'
+  has_many :shares, :class => 'AppStoreShare'
+  has_many :files, :class => 'FileAttachment'
+  
+  alias_method :id, :status_id
+  
+  class << self
+    def find(id)
+      member Podio.connection.get("/status/#{id}").body
+    end
+
+    def create(space_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/status/space/#{space_id}/"
+        req.body = attributes
+      end
+
+      response.body['status_id']
+    end
+  end
+end

data/lib/podio/{areas → models}/subscription.rb

@@ -1,8 +1,9 @@
-module Podio
-  module Subscription
-    include Podio::ResponseWrapper
-    extend self
-
+class Podio::Subscription < ActivePodio::Base
+  property :started_on, :datetime
+  property :notifications, :integer
+  property :ref, :hash
+  
+  class << self
     def find(id)
       member Podio.connection.get("/subscription/#{id}").body
     end
@@ -21,6 +22,6 @@ module Podio
 
     def delete_by_reference(ref_type, ref_id)
       Podio.connection.delete("/subscription/#{ref_type}/#{ref_id}")
-    end
+    end    
   end
-end
+end

data/lib/podio/{areas → models}/tag.rb

@@ -1,8 +1,8 @@
-module Podio
-  module Tag
-    include Podio::ResponseWrapper
-    extend self
-
+class Podio::Tag < ActivePodio::Base
+  property :count, :integer
+  property :text, :string
+  
+  class << self
     def create(tagable_type, tagable_id, attributes)
       response = Podio.connection.post do |req|
         req.url "/tag/#{tagable_type}/#{tagable_id}/"
@@ -12,6 +12,15 @@ module Podio
       response.body
     end
 
+    def update(tagable_type, tagable_id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/tag/#{tagable_type}/#{tagable_id}/"
+        req.body = attributes
+      end
+
+      response.body
+    end
+
     def find_by_app(app_id, limit, text)
       list Podio.connection.get("/tag/app/#{app_id}/?limit=#{limit}&text=#{text}").body
     end
@@ -19,7 +28,5 @@ module Podio
     def find_top_by_app(app_id, limit, text)
       Podio.connection.get("/tag/app/#{app_id}/top/?limit=#{limit}&text=#{text}").body
     end
-
   end
-
 end

data/lib/podio/models/task.rb

@@ -0,0 +1,153 @@
+class Podio::Task < ActivePodio::Base
+  include ActivePodio::Updatable
+
+  property :task_id, :integer
+  property :status, :string
+  property :group, :string
+  property :text, :string
+  property :description, :string
+  property :private, :boolean
+  property :due_date, :date
+  property :responsible, :hash
+  property :space_id, :integer
+  property :link, :string
+  property :created_on, :datetime
+  property :completed_on, :datetime
+  property :file_ids, :array # when inputting tasks
+  property :label_ids, :array # when inputting tasks
+  property :labels, :array # when outputting tasks
+
+  # old references
+  property :ref_type, :string
+  property :ref_id, :integer
+  property :ref_title, :string
+  property :ref_link, :string
+
+  # new reference
+  property :ref, :hash
+
+  has_one :created_by, :class => 'User'
+  has_one :completed_by, :class => 'User'
+  has_one :created_via, :class => 'Via'
+  has_one :deleted_via, :class => 'Via'
+  has_one :completed_via, :class => 'Via'
+  has_one :assignee, :class => 'User', :property => :responsible
+  has_many :label_list, :class => 'TaskLabel', :property => :labels 
+  has_many :files, :class => 'FileAttachment'
+  has_many :comments, :class => 'Comment'
+
+  alias_method :id, :task_id
+  
+  def create
+    compacted_attributes = remove_nil_values(self.attributes)
+    if(self.ref_type.present? && self.ref_id.present?)
+      self.task_id = self.class.create_with_ref(self.ref_type, self.ref_id, compacted_attributes)
+    else
+      self.task_id = self.class.create(compacted_attributes)
+    end
+  end
+  
+  def destroy
+    self.class.delete(self.id)
+  end
+
+  def update_reference(ref_type, ref_id)
+    self.class.update_reference(self.id, ref_type, ref_id)
+  end
+
+  def update_labels(label_ids)
+    self.class.update_labels(self.id, label_ids)
+  end
+
+  def complete
+    self.class.complete(self.id)
+  end
+
+  def uncomplete
+    self.class.incomplete(self.id)
+  end
+
+  def rank(previous_task, next_task)
+    self.class.rank(self.id, previous_task && previous_task.to_i, next_task && next_task.to_i)
+  end
+
+  handle_api_errors_for :create, :destroy, :complete, :uncomplete, :update_reference # Call must be made after the methods to handle have been defined
+
+  class << self
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/task/"
+        req.body = attributes
+      end
+
+      response.body['task_id']
+    end
+
+    def create_with_ref(ref_type, ref_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/task/#{ref_type}/#{ref_id}/"
+        req.body = attributes
+      end
+
+      response.body['task_id']
+    end
+
+    def update_description(id, description)
+      Podio.connection.put("/task/#{id}/description", {:description => description}).status
+    end
+
+    def update_text(id, text)
+      Podio.connection.put("/task/#{id}/text", {:text => text}).status
+    end
+
+    def update_private(id, private_flag)
+      Podio.connection.put("/task/#{id}/private", {:private => private_flag}).status
+    end
+
+    def update_due_date(id, due_date)
+      Podio.connection.put("/task/#{id}/due_date", {:due_date => due_date}).status
+    end
+
+    def update_assignee(id, user_id)
+      Podio.connection.post("/task/#{id}/assign", {:responsible => user_id}).status
+    end
+
+    def update_reference(id, ref_type, ref_id)
+      Podio.connection.put("/task/#{id}/ref", {:ref_type => ref_type, :ref_id => ref_id}).status
+    end
+    
+    def update_labels(id, label_ids)
+      Podio.connection.put("/task/#{id}/label/", label_ids).status
+    end
+
+    def delete(id)
+      Podio.connection.delete("/task/#{id}").status
+    end
+
+    def complete(id)
+      Podio.connection.post("/task/#{id}/complete").body
+    end
+
+    def incomplete(id)
+      Podio.connection.post("/task/#{id}/incomplete").body
+    end
+
+    def rank(id, before_task_id, after_task_id)
+      Podio.connection.post("/task/#{id}/rank", {:before => before_task_id, :after => after_task_id}).body
+    end
+
+    def find(id)
+      member Podio.connection.get("/task/#{id}").body
+    end
+
+    def find_for_reference(ref_type, ref_id)
+      list Podio.connection.get("/task/#{ref_type}/#{ref_id}/").body
+    end
+
+    def find_all(options={})
+      list Podio.connection.get { |req|
+        req.url('/task/', options)
+      }.body
+    end
+  end
+end

data/lib/podio/models/task_label.rb

@@ -0,0 +1,50 @@
+class Podio::TaskLabel < ActivePodio::Base
+  include ActivePodio::Updatable
+
+  property :label_id, :integer
+  property :text, :string
+  property :color, :string
+
+  DEFAULT_COLOR_FOR_NEW_LABELS = 'E9E9E9'
+
+  def create
+    if self.color.nil? || self.color.empty?
+      self.color = DEFAULT_COLOR_FOR_NEW_LABELS
+    end
+    
+    self.label_id = self.class.create(self.attributes)
+  end
+
+  def destroy
+    self.class.delete(self.label_id)
+  end
+
+  def update
+    self.class.update(self.label_id, self.attributes)
+  end
+  
+  class << self
+    def find_all_labels
+      list Podio.connection.get { |req|
+        req.url("/task/label/")
+      }.body
+    end
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/task/label/"
+        req.body = attributes
+      end
+
+      response.body['label_id']
+    end
+
+    def delete(label_id)
+      Podio.connection.delete("/task/label/#{label_id}").status
+    end
+
+    def update(label_id, attributes)
+      Podio.connection.put("/task/label/#{label_id}", attributes).status
+    end
+  end
+end

data/lib/podio/models/user.rb

@@ -0,0 +1,66 @@
+class Podio::User < ActivePodio::Base
+  property :user_id, :integer
+  property :mail, :string
+  property :status, :string
+  property :locale, :string
+  property :timezone, :string
+  property :flags, :array
+  property :created_on, :datetime
+  property :last_active_on, :datetime
+  property :name, :string
+  property :link, :string
+  property :avatar, :integer
+  property :profile_id, :integer  
+  property :type, :string
+  
+  # Only settable on creation
+  property :landing, :string
+  property :referrer, :string
+  property :initial, :hash
+  
+  alias_method :id, :user_id
+  
+  class << self
+    def current
+      member Podio.connection.get("/user/").body
+    end
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url '/user/'
+        req.body = attributes
+      end
+
+      response.body['user_id']
+    end
+
+    def activate(attributes)
+      response = Podio.connection.post do |req|
+        req.url '/user/activate_user'
+        req.body = attributes
+      end
+
+      response.body['user_id']
+    end
+
+    def find_all_admins_for_org(org_id)
+      list Podio.connection.get("/org/#{org_id}/admin/").body
+    end
+
+    def get_property(name)
+      Podio.connection.get("/user/property/#{name}").body['value']
+    end
+    
+    def set_property(name, value)
+      Podio.connection.put("/user/property/#{name}", {:value => value}).status
+    end
+
+    def remove_property(name)
+      Podio.connection.delete("/user/property/#{name}", {}).status
+    end
+    
+    def delete
+      Podio.connection.delete("/user/").status
+    end    
+  end
+end

data/lib/podio/models/user_status.rb

@@ -0,0 +1,18 @@
+class Podio::UserStatus < ActivePodio::Base
+  property :user, :hash
+  property :profile, :hash
+  property :properties, :hash
+  property :inbox_new, :integer
+  property :calendar_code, :string
+  property :task_mail, :string
+  property :mailbox, :string
+
+  has_one :user, :class => 'User'
+  has_one :contact, :class => 'Contact', :property => :profile
+  
+  class << self
+    def current
+      member Podio.connection.get("/user/status").body
+    end
+  end
+end

data/lib/podio/models/via.rb

@@ -0,0 +1,7 @@
+# Wraps common via hashes.
+class Podio::Via < ActivePodio::Base
+  property :id, :integer
+  property :name, :string
+  property :url, :string
+  property :display, :boolean
+end

data/lib/podio/{areas → models}/widget.rb

@@ -1,8 +1,12 @@
-module Podio
-  module Widget
-    include Podio::ResponseWrapper
-    extend self
-
+class Podio::Widget < ActivePodio::Base
+  property :widget_id, :integer
+  property :ref_type, :string
+  property :ref_id, :integer
+  property :type, :string
+  property :title, :string
+  property :config, :string
+  
+  class << self
     def create(ref_type, ref_id, attributes)
       response = Podio.connection.post do |req|
         req.url "/widget/#{ref_type}/#{ref_id}/"

data/lib/podio/version.rb

@@ -1,3 +1,3 @@
 module Podio
-  VERSION = '0.4.1'
+  VERSION = '0.5.0'
 end