Merge pull request #20 from keithpitt/services-api

Added services/hooks API

Author: vongrippen

lib/bitbucket_rest_api/repos.rb

@@ -6,10 +6,11 @@ class Repos < API
 
     # Load all the modules after initializing Repos to avoid superclass mismatch
     autoload_all 'bitbucket_rest_api/repos',
-                 :Changesets       => 'changesets',
-                 :Keys          => 'keys',
-                 :Following      => 'following',
-                 :Sources      => 'sources'
+                 :Changesets  => 'changesets',
+                 :Keys        => 'keys',
+                 :Services    => 'services',
+                 :Following   => 'following',
+                 :Sources     => 'sources'
 
     DEFAULT_REPO_OPTIONS = {
         "website"         => "",
@@ -58,6 +59,11 @@ def sources
       @sources ||= ApiFactory.new 'Repos::Sources'
     end
 
+    # Access to Repos::Services API
+    def services
+      @services ||= ApiFactory.new 'Repos::Services'
+    end
+
     # List branches
     #
     # = Examples

lib/bitbucket_rest_api/repos/services.rb

@@ -0,0 +1,103 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos::Services < API
+
+    REQUIRED_KEY_PARAM_NAMES = %w[ type ].freeze
+
+    # List services
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.services.list 'user-name', 'repo-name'
+    #  bitbucket.repos.services.list 'user-name', 'repo-name' { |service| ... }
+    #
+    def list(user_name, repo_name, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      normalize! params
+
+      response = get_request("/repositories/#{user}/#{repo.downcase}/services", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Gets a single service
+    #
+    # = Examples
+    #  @bitbucket = BitBucket.new
+    #  @bitbucket.repos.services.get 'user-name', 'repo-name', 109172378)
+    #
+    def get(user_name, repo_name, service_id, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of(service_id)
+      normalize! params
+
+      get_request("/repositories/#{user}/#{repo.downcase}/services/#{service_id}", params)
+    end
+    alias :find :get
+
+    # Create a service
+    #
+    # = Inputs
+    # * <tt>:type</tt> - One of the supported services. The type is a case-insensitive value.
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.services.create 'user-name', 'repo-name',
+    #    "type"           => "Basecamp",
+    #    "Password"       => "...",
+    #    "Username"       => "...",
+    #    "Discussion URL" => "..."
+    #
+    def create(user_name, repo_name, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      normalize! params
+      assert_required_keys(REQUIRED_KEY_PARAM_NAMES, params)
+
+      post_request("/repositories/#{user}/#{repo.downcase}/services", params)
+    end
+
+    # Edit a service
+    #
+    # = Inputs
+    # * <tt>:type</tt> - One of the supported services. The type is a case-insensitive value.
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.services.edit 'user-name', 'repo-name', 109172378,
+    #    "type"           => "Basecamp",
+    #    "Password"       => "...",
+    #    "Username"       => "...",
+    #    "Discussion URL" => "..."
+    #
+    def edit(user_name, repo_name, service_id, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of(service_id)
+
+      normalize! params
+
+      put_request("/repositories/#{user}/#{repo.downcase}/services/#{service_id}", params)
+    end
+
+    # Delete service
+    #
+    # = Examples
+    #  @bitbucket = BitBucket.new
+    #  @bitbucket.repos.services.delete 'user-name', 'repo-name', 109172378
+    #
+    def delete(user_name, repo_name, service_id, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of(service_id)
+      normalize! params
+
+      delete_request("/repositories/#{user}/#{repo.downcase}/services/#{service_id}", params)
+    end
+
+  end # Repos::Keys
+end # BitBucket