tacokit 0.1.0

data/lib/tacokit/client/checklists.rb

@@ -0,0 +1,59 @@
+module Tacokit
+  class Client
+    module Checklists
+
+      # GET /1/checklists/[idChecklist]
+      def checklist(checklist_id, options = nil)
+        get checklist_path(checklist_id), options
+      end
+
+      # GET /1/checklists/[idChecklist]/[field]
+      def checklist_field(checklist_id, field)
+        get checklist_path(checklist_id, camp(field))
+      end
+
+      # GET /1/checklists/[idChecklist]/[resource]
+      # board
+      # board/[field]
+      # checklists
+      # checklists/[filter]
+      # checkItems
+      # checkItems/[idCheckItem]
+      def checklist_resource(checklist_id, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get checklist_path(checklist_id, *paths), options
+      end
+
+      # PUT /1/checklists/[idChecklist]
+      def update_checklist(checklist_id, options = {})
+        put checklist_path(checklist_id), options
+      end
+
+      # PUT /1/checklists/[idChecklist]/[field]
+      # idCard
+      # name
+      # pos
+
+      # POST /1/checklists
+      def create_checklist(card_id, name, options = {})
+        options.update \
+          card_id: card_id,
+          name: name
+        post checklist_path, options
+      end
+
+      # POST /1/checklists/[idChecklist]/checkItems
+
+      # DELETE /1/checklists/[idChecklist]
+      def delete_checklist(checklist_id)
+        delete checklist_path(checklist_id)
+      end
+
+      # DELETE /1/checklists/[idChecklist]/checkItems/[idCheckItem]
+
+      def checklist_path(*paths)
+        path_join("checklists", *paths)
+      end
+    end
+  end
+end

data/lib/tacokit/client/labels.rb

@@ -0,0 +1,44 @@
+module Tacokit
+  class Client
+    module Labels
+
+      # GET /1/labels/[idLabel]
+      def label(label_id, options = nil)
+        get label_path(label_id), options
+      end
+
+      # GET /1/labels/[idLabel]/[resource]
+      # board
+      # board/[field]
+      def label_resource(label_id, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get label_path(label_id, *paths), options
+      end
+
+      # PUT /1/labels/[idLabel]
+      def update_label(label_id, options = {})
+        put label_path(label_id), options
+      end
+
+      # PUT /1/labels/[idLabel]/color
+      # PUT /1/labels/[idLabel]/name
+
+      # POST /1/labels
+      def create_label(board_id, name, color)
+        post label_path,
+          board_id: board_id,
+          name: name,
+          color: color
+      end
+
+      # DELETE /1/labels/[idLabel]
+      def delete_label(label_id)
+        delete label_path(label_id)
+      end
+
+      def label_path(*paths)
+        path_join "labels", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/lists.rb

@@ -0,0 +1,54 @@
+module Tacokit
+  class Client
+    module Lists
+
+      # GET /1/lists/[idList]
+      def list(list_id, options = nil)
+        get list_path(list_id), options
+      end
+
+      # GET /1/lists/[idList]/[field]
+      def list_field(list_id, field, options = nil)
+        get list_path(list_id, camp(field)), options
+      end
+
+      # GET /1/lists/[idList]/[resource]
+      # actions
+      # board
+      # board/[field]
+      # lists
+      # lists/[filter]
+      def list_resource(list_id, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get list_path(list_id, *paths), options
+      end
+
+      # PUT /1/lists/[idList]
+      def update_list(list_id, options = {})
+        put list_path(list_id), options
+      end
+
+      # PUT /1/lists/[idList]/[field]
+      # closed
+      # idBoard
+      # name
+      # pos
+      # subscribed
+
+      # POST /1/lists
+      def create_list(board_id, name, options = {})
+        post list_path, options.merge(name: name, board_id: board_id)
+      end
+
+      # POST /1/lists/[idList]/[resource]
+      # archiveAllCards
+      # cards
+      # moveAllCards
+
+      def list_path(*paths)
+        path_join("lists", *paths)
+      end
+
+    end
+  end
+end

data/lib/tacokit/client/members.rb

@@ -0,0 +1,91 @@
+module Tacokit
+  class Client
+    module Members
+
+      # GET /1/members/[idMember or username]
+      def member(username = 'me', options = nil)
+        get member_path(username), options
+      end
+
+      # GET /1/members/[idMember or username]/[field]
+      def member_field(username, field, options = nil)
+        get member_path(username, camp(field)), options
+      end
+
+      # GET /1/members/[idMember or username]/[resource]
+      # actions
+      # boardBackgrounds
+      # boardBackgrounds/[idBoardBackground]
+      # boardStars
+      # boardStars/[idBoardStar]
+      # boards/[filter]
+      # boardsInvited
+      # boardsInvited/[field]
+      # cards
+      # cards/[filter]
+      # customBoardBackgrounds
+      # customBoardBackgrounds/[idBoardBackground]
+      # customEmoji
+      # customEmoji/[idCustomEmoji]
+      # customStickers
+      # customStickers/[idCustomSticker]
+      # deltas
+      # notifications
+      # notifications/[filter]
+      # organizations
+      # organizations/[filter]
+      # organizationsInvited
+      # organizationsInvited/[field]
+      # savedSearches
+      # savedSearches/[idSavedSearch]
+      # tokens
+      def member_resource(username, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get member_path(username, *paths), options
+      end
+
+      # POST /1/members/[idMember or username]/[resource]
+      # avatar
+      # boardBackgrounds
+      # boardStars
+      # customBoardBackgrounds
+      # customEmoji
+      # customStickers
+      # oneTimeMessagesDismissed
+      # savedSearches
+
+      # PUT /1/members/[idMember or username]
+      def update_member(username, options = {})
+        put member_path(username), options
+      end
+
+      # PUT /1/members/[idMember or username]/[field]
+      # avatarSource
+      # fullName
+      # initials
+      # username
+      # boardBackgrounds/[idBoardBackground]
+      # boardStars/[idBoardStar]
+      # boardStars/[idBoardStar]/idBoard
+      # boardStars/[idBoardStar]/pos
+      # customBoardBackgrounds/[idBoardBackground]
+      # prefs/colorBlind
+      # prefs/minutesBetweenSummaries
+      # savedSearches/[idSavedSearch]
+      # savedSearches/[idSavedSearch]/name
+      # savedSearches/[idSavedSearch]/pos
+      # savedSearches/[idSavedSearch]/query
+
+      # DELETE /1/members/[idMember or username]/[resource]/[resource_id]
+      # boardBackgrounds/[idBoardBackground]
+      # boardStars/[idBoardStar]
+      # customBoardBackgrounds/[idBoardBackground]
+      # customStickers/[idCustomSticker]
+      # savedSearches/[idSavedSearch]
+
+      def member_path(*paths)
+        path_join "members", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/notifications.rb

@@ -0,0 +1,48 @@
+module Tacokit
+  class Client
+    module Notifications
+
+      # GET /1/notifications/[idNotification]
+      def notification(notification_id, options = nil)
+        get notification_path(notification_id), options
+      end
+
+      # GET /1/notifications/[idNotification]/[field]
+      def notification_field(notification_id, field)
+        get notification_path(notification_id, camp(field))
+      end
+
+      # GET /1/notifications/[idNotification]/[resource]
+      # board
+      # board/[field]
+      # notification
+      # notification/[field]
+      # entities
+      # list
+      # list/[field]
+      # member
+      # member/[field]
+      # memberCreator
+      # memberCreator/[field]
+      # organization
+      # organization/[field]
+      def notification_resource(notification_id, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get notification_path(notification_id, *paths), options
+      end
+
+      # PUT /1/notifications/[idNotification]
+      def update_notification(notification_id, options = {})
+        put notification_path(notification_id), options
+      end
+
+      # PUT /1/notifications/[idNotification]/unread
+
+      # POST /1/notifications/all/read
+
+      def notification_path(*paths)
+        path_join "notifications", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/organizations.rb

@@ -0,0 +1,79 @@
+module Tacokit
+  class Client
+    module Organizations
+
+      # GET /1/organizations/[idOrg or name]
+      def organization(org_id, options = nil)
+        get organization_path(org_id), options
+      end
+
+      # GET /1/organizations/[idOrg or name]/[field]
+      def organization_field(org_id, field, options = nil)
+        get organization_path(org_id, camp(field)), options
+      end
+
+      # GET /1/organizations/[idOrg or name]/[resource]
+      # actions
+      # boards
+      # boards/[filter]
+      # deltas
+      # members
+      # members/[filter]
+      # members/[idMember]/cards
+      # membersInvited
+      # membersInvited/[field]
+      # memberships
+      # memberships/[idMembership]
+      def organization_resource(org_id, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get organization_path(org_id, *paths), options
+      end
+
+      # PUT /1/organizations/[idOrg or name]
+      def update_organization(org_id, options = {})
+        put organization_path(org_id), options
+      end
+
+      # PUT /1/organizations/[idOrg or name]/[field]
+      # desc
+      # displayName
+      # members
+      # members/[idMember]
+      # members/[idMember]/deactivated
+      # memberships/[idMembership]
+      # name
+      # prefs/associatedDomain
+      # prefs/boardVisibilityRestrict/org
+      # prefs/boardVisibilityRestrict/private
+      # prefs/boardVisibilityRestrict/public
+      # prefs/externalMembersDisabled
+      # prefs/googleAppsVersion
+      # prefs/orgInviteRestrict
+      # prefs/permissionLevel
+      # website
+
+      # POST /1/organizations
+      def create_organization(display_name, options = {})
+        post organization_path, options.merge(display_name: display_name)
+      end
+
+      # POST /1/organizations/[idOrg or name]/logo
+
+      # DELETE /1/organizations/[idOrg or name]
+      def delete_organization(org_id)
+        delete organization_path(org_id)
+      end
+
+      # DELETE /1/organizations/[idOrg or name]/[resource]
+      # logo
+      # members/[idMember]
+      # members/[idMember]/all
+      # prefs/associatedDomain
+      # prefs/orgInviteRestrict
+
+      def organization_path(*paths)
+        path_join "organizations", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/searches.rb

@@ -0,0 +1,20 @@
+module Tacokit
+  class Client
+    module Searches
+
+      # GET /1/search
+      def search(query, options = {})
+        get search_path, options.merge(query: query)
+      end
+
+      # GET /1/search/members
+      def search_members(query, options = {})
+        get search_path("members"), options.merge(query: query)
+      end
+
+      def search_path(*paths)
+        path_join "search", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/tokens.rb

@@ -0,0 +1,41 @@
+module Tacokit
+  class Client
+    module Tokens
+
+      # GET /1/tokens/[token]
+      def token(token, options = nil)
+        get token_path(token), options
+      end
+
+      # GET /1/tokens/[token]/[field]
+      def token_field(token, field, options = nil)
+        get token_path(token, camp(field)), options
+      end
+
+      # GET /1/tokens/[token]/[resource]
+      # member
+      # webhooks
+      # member/[field]
+      # webhooks/[idWebhook]
+      def token_resource(token, resource, *paths)
+        paths, options = extract_options(camp(resource), *paths)
+        get token_path(token, *paths), options
+      end
+
+      # POST /1/tokens/[token]/webhooks
+
+      # PUT /1/tokens/[token]/webhooks
+
+      # DELETE /1/tokens/[token]
+      def delete_token(token)
+        delete token_path(token)
+      end
+
+      # DELETE /1/tokens/[token]/webhooks/[idWebhook]
+
+      def token_path(*paths)
+        path_join "tokens", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client/types.rb

@@ -0,0 +1,11 @@
+module Tacokit
+  class Client
+    module Types
+
+      # GET /1/types/[id]
+      def type(model_id)
+        get path_join "types", model_id
+      end
+    end
+  end
+end

data/lib/tacokit/client/webhooks.rb

@@ -0,0 +1,43 @@
+module Tacokit
+  class Client
+    module Webhooks
+
+      # GET /1/webhooks/[idWebhook]
+      def webhook(webhook_id)
+        get webhook_path(webhook_id)
+      end
+
+      # GET /1/webhooks/[idWebhook]/[field]
+      def webhook_field(webhook_id, field, options = nil)
+        get webhook_path(webhook_id, camp(field)), options
+      end
+
+      # PUT /1/webhooks/[idWebhook]
+      def update_webhook(webhook_id, options = {})
+        put webhook_path(webhook_id), options
+      end
+
+      # PUT /1/webhooks/[idWebhook]/[field]
+      # active
+      # callbackURL
+      # description
+      # idModel
+
+      # POST /1/webhooks
+      def create_webhook(token, model_id, callback_url, options = {})
+        post webhook_path, options.merge(
+          model_id: model_id,
+          callback_url: callback_url)
+      end
+
+      # DELETE /1/webhooks/[idWebhook]
+      def delete_webhook(webhook_id)
+        delete webhook_path(webhook_id)
+      end
+
+      def webhook_path(*paths)
+        path_join "webhooks", *paths
+      end
+    end
+  end
+end

data/lib/tacokit/client.rb

@@ -0,0 +1,169 @@
+require 'forwardable'
+
+require 'faraday'
+require 'faraday_middleware'
+
+require 'tacokit/authorization'
+require 'tacokit/configuration'
+require 'tacokit/middleware'
+require 'tacokit/response'
+require 'tacokit/transform'
+
+require 'tacokit/client/actions'
+require 'tacokit/client/boards'
+require 'tacokit/client/cards'
+require 'tacokit/client/checklists'
+require 'tacokit/client/labels'
+require 'tacokit/client/lists'
+require 'tacokit/client/members'
+require 'tacokit/client/notifications'
+require 'tacokit/client/organizations'
+require 'tacokit/client/searches'
+require 'tacokit/client/tokens'
+require 'tacokit/client/types'
+require 'tacokit/client/webhooks'
+
+module Tacokit
+  class Client
+    extend Forwardable
+
+    include Tacokit::Authorization
+    include Tacokit::Utils
+
+    include Tacokit::Client::Actions
+    include Tacokit::Client::Boards
+    include Tacokit::Client::Cards
+    include Tacokit::Client::Checklists
+    include Tacokit::Client::Labels
+    include Tacokit::Client::Lists
+    include Tacokit::Client::Members
+    include Tacokit::Client::Notifications
+    include Tacokit::Client::Organizations
+    include Tacokit::Client::Searches
+    include Tacokit::Client::Tokens
+    include Tacokit::Client::Types
+    include Tacokit::Client::Webhooks
+
+    def_delegators :configuration, *Configuration.keys
+    def_delegators :configuration, :user_authenticated?, :user_credentials
+    def_delegators :configuration, :app_authenticated?, :app_credentials
+    def_delegators :transform, :serialize, :deserialize
+
+    def initialize(options = {})
+      self.configuration.options = options
+    end
+
+    def reset!
+      @configuration = nil
+    end
+
+    def configure
+      yield configuration if block_given?
+    end
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def get(url, options = {})
+      request :get, url, options
+    end
+
+    def post(url, options = {})
+      request :post, url, options
+    end
+
+    def put(url, options = {})
+      request :put, url, options
+    end
+
+    def delete(url, options = {})
+      request :delete, url, options
+    end
+
+    def request(method, url, data = nil, params = nil)
+      if [:get, :body].include?(method)
+        params ||= data
+        data      = nil
+      end
+
+      params = normalize_request_params(params || {})
+      response = connection.send method, url do |req|
+        req.params.update params
+        req.body = serialize(data) if data
+      end
+
+      Response.new(self, response).data
+    end
+
+    def transform
+      @transform ||= Transform.new
+    end
+
+    # Prepare ruby-style params for trello request
+    def normalize_request_params(params)
+      {}.tap do |norm|
+        params.each do |key,value|
+          norm[key] = normalize_param_value(value)
+        end
+      end
+    end
+
+    def normalize_param_value(value)
+      case value
+      when Array
+        value.map { |v| camp(v) }.join(',')
+      when /\,/
+        normalize_param_value(value.split(','))
+      else
+        camp(value)
+      end
+    end
+
+    def path_join(*paths)
+      paths.join('/')
+    end
+
+    def to_path(*paths)
+      warn "to_path is deprecated"
+      path_join(*paths)
+    end
+
+    def camel_path(path)
+      camelize(path.to_s, :lower)
+    end
+    alias camp camel_path
+
+    def camel_join(*paths)
+      path_join paths.map { |p| camel_path(p) }
+    end
+
+    def to_s
+      "<#{self.class}:#{object_id}>"
+    end
+    alias_method :inspect, :to_s
+
+    def connection
+      @connection = Faraday.new(url: api_endpoint) do |http|
+        http.headers[:user_agent] = 'TacoKit 0.0.1'
+
+        if user_authenticated?
+          http.request :oauth, user_credentials
+        else app_authenticated?
+          http.params.update app_credentials
+        end
+
+        http.request :json
+        http.request :multipart
+        http.request :url_encoded
+
+        http.response :json, content_type: /\bjson$/
+        http.response :boom
+        http.response :logger if ENV['DEBUG']
+
+        http.adapter Faraday.default_adapter
+      end
+    end
+
+  end
+end