chute 0.0.2

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store

data/Gemfile

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

data/README

@@ -0,0 +1,125 @@
+Setup
+====
+
+1. Add to Gemfile
+
+  gem install chute
+
+2. Add configuration file 'config/chute.rb' with the following details:
+
+  API_URL = "ADD API URL HERE"
+  API_KEY = "ADD ACCESS TOKEN HERE"
+
+
+Key Concepts
+========
+
+## Client
+All Chute applications use OAuth and are referred to as 'Clients'
+
+## Chute
+A container for assets.  Chutes can be nested inside of each other.
+
+  #initialize
+  account= Chute::GCChute.new({:name => "Test chute"})
+
+  #create chute
+  #if successful, chute is created
+  #if unsuccessful account.errors contains the details
+  chute.create
+
+
+## Asset
+Any photo or video managed by Chute
+  
+  #Find assets for a chute
+  #Returns collection of GCAsset
+  chute.assets
+
+## Parcel
+A named collection of assets.  Whenever you upload assets, they are grouped into parcels.
+
+## Bundle
+An unnamed collection of assets.
+
+  #initialize a bundle
+  bundle = Chute::GCBundle.new
+
+  #prefix the asset_ids for the bundle
+  #string - array of asset_ids
+  bundle.prefix_options = '["34", "56"]'
+
+  #create the bundle
+  #if successful, returns the newly created bundle
+  #if unsuccessful, bundle.errors contains errors or raises an exception
+  bundle.save
+
+  bundle.id # id of the bundle
+  
+  #find a bundle
+  bundle = Chute::GCBundle.find_by_id(id)
+
+  #add assets to bundle
+  #bundle.add_assets(array_of_asset_ids)
+  #returns the new set of assets
+  bundle.add_assets(["11", "22", "45"])
+
+  #remove assets from bundle
+  #bundle.remove_assets(array_of_asset_ids)
+  #returns the new set of assets
+  bundle.remove_assets(["22", "3"])
+
+
+Basic Tasks
+=========
+
+## Uploading Assets
+
+## Displaying Assets
+
+## Organizing Assets
+
+## Associating Your Data with Assets
+
+## Bundling Assets
+  #find a bundle
+  bundle = Chute::GCBundle.find_by_id(id)
+
+  #add assets to bundle
+  #bundle.add_assets(array_of_asset_ids)
+  #returns the new set of assets
+  bundle.add_assets(["11", "22", "45"])
+
+  #remove assets from bundle
+  #bundle.remove_assets(array_of_asset_ids)
+  #returns the new set of assets
+  bundle.remove_assets(["22", "3"])
+
+
+Social Tasks
+==========
+
+## Hearting Assets
+
+  #heart
+    # id - Asset Identifier
+    Chute::GCAsset.heart(id) 
+
+  #unheart
+    Chute::GCAsset.unheart(id)
+
+## Commenting on Assets
+
+  #add a comment for an asset in a chute
+  #chute.add_comment(comment_text, asset_id)
+  
+  chute.add_comment("test comment 2", 37)
+
+  #find a comment
+  comments = chute.comments(37)
+  comment = comments.first
+  
+  #delete comment
+  comment.destroy
+  
+  

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+require 'rake/testtask'
+
+Bundler::GemHelper.install_tasks
+
+Rake::TestTask.new do |t|
+ t.libs << 'test'
+end
+
+desc "Run tests"
+task :default => :test

data/chute.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "chute/version"
+require "httparty"
+
+Gem::Specification.new do |s|
+  s.name        = "chute"
+  s.version     = Chute::VERSION
+  s.authors     = ["Payal Gupta"]
+  s.email       = ["payal@getchute.com"]
+  s.homepage    = ""
+  s.summary     = %q{Chute API Integration}
+  s.description = %q{This gem allows to map your models with a chute.}
+
+  s.rubyforge_project = "chute"
+
+  s.files         = `git ls-files`.split("\n")
+  #s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.test_files    = Dir.glob("test/**/*.rb")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/chute.rb

@@ -0,0 +1,22 @@
+#require "chute/version"
+#require "httparty"
+
+# include utility modules
+require 'chute/util'
+require 'chute/http_service'
+require 'chute/collection'
+require 'chute/exception'
+
+# include chute modules
+
+# base class
+require 'chute/resource'  
+require 'chute/chute'
+require 'chute/asset'
+require 'chute/account'
+require 'chute/bundle'
+require 'chute/comment'
+require 'chute/parcel'
+require 'chute/user'
+require 'chute/app'
+require 'chute/inbox'

data/lib/chute/account.rb

@@ -0,0 +1,58 @@
+module Chute
+  class GCAccount < GCResource
+
+    attr_accessor :id,
+                  :uid,
+                  :type,
+                  :email,
+                  :name,
+                  :access_key,
+                  :notifications_enabled
+                  
+    def initialize(attributes = {})
+      super
+      @id                     = attributes[:id]
+      @uid                    = attributes[:uid]
+      @email                  = attributes[:email]
+      @name                   = attributes[:name]
+      @access_key             = attributes[:access_key]
+      @notifications_enabled  = attributes[:notifications_enabled]
+    end
+    
+    # Public: Pluralized name of the resource.
+    def resource_name
+      'accounts'
+    end
+    
+    # Public: Disable notifications for the account
+    def mute
+      perform(self.class.post("/#{resource_name}/#{id}/mute"))
+    end
+    
+    # Public: Enable notifications for the account
+    def unmute
+      perform(self.class.post("/#{resource_name}/#{id}/unmute"))
+    end
+    
+    # Public: Pluralized name of the resource.
+    def self.class_path
+      "accounts"
+    end
+    
+    # Public: Fetch account from its id.
+    # id - Integer: identifier.
+    #
+    # Example
+    #
+    #   Chute::GAccount.find_by_id(23)     
+    #   # => account
+    #   # => false if not found
+    # Returns GCAccount.
+    
+    def self.find_by_id(id)
+      account = Chute::GCAccount.new
+      account.perform(get("/accounts/#{id}")) ? account : false
+    end
+                  
+  end
+end

data/lib/chute/app.rb

@@ -0,0 +1,32 @@
+module Chute
+  class GCApp < GCResource
+    
+    def save
+      raise NotImplementedError
+    end
+    
+    def update
+      raise NotImplementedError
+    end
+    
+    def destroy
+      raise NotImplementedError
+    end
+    
+    # Public: Resource name
+    def resource_name
+      'app'
+    end
+    
+    # Public: Resource name
+    def resource_path
+      'app'
+    end
+    
+    # Public: Resource name
+    def class_path
+      'app'
+    end
+                  
+  end
+end

data/lib/chute/asset.rb

@@ -0,0 +1,124 @@
+module Chute
+  class GCAsset < GCResource
+    
+    attr_accessor :id,
+                  :url,
+                  :share_url,
+                  :is_portrait
+
+    def initialize(attributes = {})
+      super
+      @id           = attributes[:id]
+      @url          = attributes[:url]
+      @share_url    = attributes[:share_url]
+      @is_portrait  = attributes[:is_portrait]
+    end
+    
+    # Public: Returns pluralized name of the resource.
+    def resource_name
+      'assets'
+    end
+    
+    # Public: Relative url of an asset for a custom geometry
+    #
+    # height - Integer: height of the asset images
+    # width  - String: width of the asset image
+    #
+    # Examples
+    # 
+    #   asset.url = "asset url"
+    #   asset.custom_url(200, 300)
+    #   # => "asset url/200x300"
+    # Returns the url to the custom image
+    
+    def custom_url(height, width)
+      "#{url}/#{height}x#{width}" if url
+    end
+    
+    #================================================#
+    # Class Methods                                  #
+    #================================================#
+    
+    # Public: Fetch asset from its id.
+    # id - Integer: identifier.
+    #
+    # Example
+    #
+    #   Chute::GCAsset.find_by_id(23)     
+    #   # => asset
+    #   # => false if not found
+    # Returns GCAsset
+    
+    def self.find_by_id(id)
+      asset = Chute::GCAsset.new
+      asset.perform(get("/assets/#{id}")) ? asset : false
+    end
+    
+    # Public: Returns pluralized name of the resource.
+    def self.class_path
+      "assets"
+    end
+    
+    # Public: Make asset as favorite
+    # id - Identifier.
+    #
+    # Example
+    #
+    #   Chute::GCAsset.heart(23)     
+    #   # => true
+    # Returns boolean true or false
+    
+    def self.heart(id)
+      response = get("/assets/#{id}/heart")
+      response.is_success
+    end
+    
+    # Public: Remove asset as favorite
+    # id - Identifier.
+    #
+    # Example
+    #
+    #   Chute::GCAsset.unheart(23)     
+    #   # => true
+    # Returns boolean true or false
+    
+    def self.unheart(id)
+      response = get("/assets/#{id}/unheart")
+      response.is_success
+    end
+    
+    # Public: Remove assets
+    # ids - Array: Identifier list
+    #
+    # Example
+    #
+    #   Chute::GCAsset.remove([1, 23, 56])     
+    #   # => true
+    # Returns boolean true or false
+    
+    def self.remove(ids=[])
+      response = post("/assets/remove", {:asset_ids => ids})
+      response.is_success
+    end
+    
+    # Public: Verify assets
+    # files - Array: [URL, size, md5]
+    #
+    # Example
+    #
+    # files = [{
+    #           :url    => "Users/payalgupta/Desktop/39-Dcroe.jpg",
+    #           :size   => 34500,
+    #           :md5    => 34500
+    #         }]
+    #   Chute::GCAsset.verify(files)     
+    #   # => true
+    # Returns boolean true or false
+    
+    def self.verify(files=[])
+      response = post("/assets/verify", {:files => files})
+      response.is_success
+    end
+
+  end
+end

data/lib/chute/bundle.rb

@@ -0,0 +1,72 @@
+module Chute
+  class GCBundle < GCResource
+    attr_accessor :id,
+                  :url,
+                  :shortcut
+    
+    def initialize(attributes={})
+      super
+      @id           = attributes[:id]
+      @url          = attributes[:url]
+      @shortcut     = attributes[:shortcut]
+    end
+    
+    # Public: Returns pluralized name of the resource.
+    def resource_name
+      'bundles'
+    end
+    
+    def destroy
+      raise NotImplementedError
+    end
+    
+    # Public: Add assets to a bundle
+    # asset_ids - Array: Identifier list of assets
+    #
+    # Example
+    #
+    #   Chute::GCBundle.add_assets([1, 23, 56])     
+    #   # => true
+    # Returns boolean true or false
+    
+    def add_assets(asset_ids)
+      response = self.class.post("/bundles/#{id}/add", :asset_ids => "#{asset_ids}")
+      response.is_success
+    end
+    
+    # Public: Remove assets from a bundle
+    # asset_ids - Array: Identifier list of assets
+    #
+    # Example
+    #
+    #   Chute::GCBundle.remove_assets([1, 23, 56])     
+    #   # => true
+    # Returns boolean true or false
+    
+    def remove_assets(asset_ids)
+      response = self.class.post("/bundles/#{id}/remove", :asset_ids => "#{asset_ids}")
+      response.is_success
+    end
+    
+    # Public: Fetch bundle from its id.
+    # id - Integer: identifier.
+    #
+    # Example
+    #
+    #   Chute::GCBundle.find_by_id(23)     
+    #   # => bundle
+    #   # => false if not found
+    # Returns GCBundle
+    
+    def self.find_by_id(id)
+      bundle = Chute::GCBundle.new
+      bundle.perform(get("/bundles/#{id}")) ? bundle : false
+    end
+    
+    # Public: Returns pluralized name of the resource.
+    def self.class_path
+      "bundles"
+    end
+
+  end
+end