reenhanced_bitbucket_api 0.1.6

data/lib/bitbucket_rest_api/repos/following.rb

@@ -0,0 +1,39 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos::Following < API
+
+    # List repo followers
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new :user => 'user-name', :repo => 'repo-name'
+    #  bitbucket.repos.following.followers
+    #  bitbucket.repos.following.followers { |watcher| ... }
+    #
+    def followers(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}/followers/", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    # List repos being followed by the authenticated user
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #  bitbucket.repos.following.followed
+    #
+    def followed(*args)
+      params = args.extract_options!
+      normalize! params
+
+      response = get_request("/user/follows", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+  end # Repos::Watching
+end # BitBucket

data/lib/bitbucket_rest_api/repos/keys.rb

@@ -0,0 +1,87 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos::Keys < API
+
+    VALID_KEY_PARAM_NAMES = %w[ label key ].freeze
+
+    # List deploy keys
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.keys.list 'user-name', 'repo-name'
+    #  bitbucket.repos.keys.list 'user-name', 'repo-name' { |key| ... }
+    #
+    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}/deploy-keys/", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+    alias :all :list
+
+    # Create a key
+    #
+    # = Inputs
+    # * <tt>:title</tt> - Required string.
+    # * <tt>:key</tt> - Required string.
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.keys.create 'user-name', 'repo-name',
+    #    "label" => "octocat@octomac",
+    #    "key" =>  "ssh-rsa AAA..."
+    #
+    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
+      filter! VALID_KEY_PARAM_NAMES, params
+      assert_required_keys(VALID_KEY_PARAM_NAMES, params)
+
+      post_request("/repositories/#{user}/#{repo.downcase}/deploy-keys/", params)
+    end
+
+    # Edit a key
+    #
+    # = Inputs
+    # * <tt>:title</tt> - Required string.
+    # * <tt>:key</tt> - Required string.
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.keys.edit 'user-name', 'repo-name',
+    #    "label" => "octocat@octomac",
+    #    "key" =>  "ssh-rsa AAA..."
+    #
+    def edit(user_name, repo_name, key_id, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of key_id
+
+      normalize! params
+      filter! VALID_KEY_PARAM_NAMES, params
+
+      put_request("/repositories/#{user}/#{repo.downcase}/deploy-keys/#{key_id}", params)
+    end
+
+    # Delete key
+    #
+    # = Examples
+    #  @bitbucket = BitBucket.new
+    #  @bitbucket.repos.keys.delete 'user-name', 'repo-name', 'key-id'
+    #
+    def delete(user_name, repo_name, key_id, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of key_id
+      normalize! params
+
+      delete_request("/repositories/#{user}/#{repo.downcase}/deploy-keys/#{key_id}", params)
+    end
+
+  end # Repos::Keys
+end # BitBucket

data/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

data/lib/bitbucket_rest_api/repos/sources.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos::Sources < API
+
+    REQUIRED_COMMENT_PARAMS = %w[
+        body
+        changeset_id
+        line
+        path
+        position
+      ].freeze
+
+    # Gets a source of repo 
+    #
+    # = Examples
+    #  @bitbucket = BitBucket.new
+    #  @bitbucket.repos.sources.get 'user-name', 'repo-name', '6dcb09b5b57875f334f61aebed6', 'app/contorllers/')
+    #
+    def get(user_name, repo_name, sha, path, params={})
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      _validate_presence_of sha
+      normalize! params
+
+      get_request("/repositories/#{user}/#{repo.downcase}/src/#{sha}/#{path}", params)
+    end
+    alias :find :get
+
+  end # Repos::Sources
+end # BitBucket

data/lib/bitbucket_rest_api/repos.rb

@@ -0,0 +1,238 @@
+# encoding: utf-8
+
+module BitBucket
+  class Repos < API
+    extend AutoloadHelper
+
+    # Load all the modules after initializing Repos to avoid superclass mismatch
+    autoload_all 'bitbucket_rest_api/repos',
+                 :Changesets  => 'changesets',
+                 :Keys        => 'keys',
+                 :Services    => 'services',
+                 :Following   => 'following',
+                 :Sources     => 'sources'
+
+    DEFAULT_REPO_OPTIONS = {
+        "website"         => "",
+        "is_private"      => false,
+        "has_issues"      => false,
+        "has_wiki"        => false,
+        "scm"             => "git",
+        "no_public_forks" => false
+    }.freeze
+
+    VALID_REPO_OPTIONS = %w[
+      owner
+      name
+      description
+      website
+      is_private
+      has_issues
+      has_wiki
+      no_public_forks
+      language
+      scm
+    ].freeze
+
+    # Creates new Repositories API
+    def initialize(options = { })
+      super(options)
+    end
+
+    # Access to Repos::Commits API
+    def changesets
+      @changesets ||= ApiFactory.new 'Repos::Changesets'
+    end
+
+    # Access to Repos::Keys API
+    def keys
+      @keys ||= ApiFactory.new 'Repos::Keys'
+    end
+
+    # Access to Repos::Watchin API
+    def following
+      @following ||= ApiFactory.new 'Repos::Following'
+    end
+
+    # Access to Repos::Commits API
+    def sources
+      @sources ||= ApiFactory.new 'Repos::Sources'
+    end
+
+    # Access to Repos::Services API
+    def services
+      @services ||= ApiFactory.new 'Repos::Services'
+    end
+
+    # List branches
+    #
+    # = Examples
+    #
+    #   bitbucket = BitBucket.new
+    #   bibucket.repos.branches 'user-name', 'repo-name'
+    #
+    #   repos = BitBucket::Repos.new
+    #   repos.branches 'user-name', 'repo-name'
+    #
+    def branches(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}/branches/", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    alias :list_branches :branches
+
+    # Create a new repository for the authenticated user.
+    #
+    # = Parameters
+    #  <tt>:name</tt> - Required string
+    #  <tt>:description</tt> - Optional string
+    #  <tt>:website</tt> - Optional string
+    #  <tt>:is_private</tt> - Optional boolean - <tt>true</tt> to create a private repository, <tt>false</tt> to create a public one.
+    #  <tt>:has_issues</tt> - Optional boolean - <tt>true</tt> to enable issues for this repository, <tt>false</tt> to disable them
+    #  <tt>:has_wiki</tt> - Optional boolean - <tt>true</tt> to enable the wiki for this repository, <tt>false</tt> to disable it. Default is <tt>true</tt>
+    #  <tt>:owner</tt> Optional string - The team in which this repository will be created
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.create "name" => 'repo-name'
+    #    "description": "This is your first repo",
+    #    "website": "https://bitbucket.com",
+    #    "is_private": false,
+    #    "has_issues": true,
+    #    "has_wiki": true
+    #
+    # Create a new repository in this team. The authenticated user
+    # must be a member of this team
+    #
+    # Examples:
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.repos.create :name => 'repo-name', :owner => 'team-name'
+    #
+    def create(*args)
+      params = args.extract_options!
+      normalize! params
+      filter! VALID_REPO_OPTIONS + %w[ org ], params
+      assert_required_keys(%w[ name ], params)
+
+      # Requires authenticated user
+      post_request("/repositories/", DEFAULT_REPO_OPTIONS.merge(params))
+    end
+
+    # Edit a repository
+    #
+    # = Parameters
+    # * <tt>:name</tt> Required string
+    # * <tt>:description</tt>   Optional string
+    # * <tt>:website</tt>       Optional string
+    # * <tt>:private</tt> - Optional boolean - <tt>false</tt> to create public reps, <tt>false</tt> to create a private one
+    # * <tt>:has_issues</tt>    Optional boolean - <tt>true</tt> to enable issues for this repository, <tt>false</tt> to disable them
+    # * <tt>:has_wiki</tt>      Optional boolean - <tt>true</tt> to enable the wiki for this repository, <tt>false</tt> to disable it. Default is <tt>true</tt>
+    # * <tt>:has_downloads</tt> Optional boolean - <tt>true</tt> to enable downloads for this repository
+    #
+    # = Examples
+    #
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.edit 'user-name', 'repo-name',
+    #    :name => 'hello-world',
+    #    :description => 'This is your first repo',
+    #    :website => "https://bitbucket.com",
+    #    :public => true, :has_issues => true
+    #
+    def edit(user_name, repo_name, params={ })
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+
+      normalize! params
+      filter! VALID_REPO_OPTIONS, params
+
+      put_request("/repositories/#{user}/#{repo.downcase}/", DEFAULT_REPO_OPTIONS.merge(params))
+    end
+
+    # Get a repository
+    #
+    # = Examples
+    #  bitbucket = BitBucket.new
+    #  bitbucket.repos.get 'user-name', 'repo-name'
+    #
+    def get(user_name, repo_name, params={ })
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+      normalize! params
+
+      get_request("/repositories/#{user}/#{repo.downcase}", params)
+    end
+
+    alias :find :get
+
+    # Delete a repository
+    #
+    # = Examples
+    #  @bitbucket = BitBucket.new
+    #  @bitbucket.repos.delete 'user-name', 'repo-name'
+    #
+    def delete(user_name, repo_name)
+      _update_user_repo_params(user_name, repo_name)
+      _validate_user_repo_params(user, repo) unless user? && repo?
+
+      delete_request("/repositories/#{user}/#{repo.downcase}")
+    end
+
+    # List repositories for the authenticated user
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new :oauth_token => '...', :oauth_secret => '...'
+    #   bitbucket.repos.list
+    #   bitbucket.repos.list { |repo| ... }
+    #
+    # List public repositories for the specified user.
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new
+    #   bitbucket.repos.list :user => 'user-name'
+    #   bitbucket.repos.list :user => 'user-name', { |repo| ... }
+    def list(*args)
+      params = args.extract_options!
+      normalize! params
+      _merge_user_into_params!(params) unless params.has_key?('user')
+      filter! %w[ user type ], params
+
+      response = #if (user_name = params.delete("user"))
+                 #  get_request("/users/#{user_name}", params)
+                 #else
+                   # For authenticated user
+                   get_request("/user/repositories", params)
+                 #end
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    alias :all :list
+
+    # List tags
+    #
+    # = Examples
+    #   bitbucket = BitBucket.new
+    #   bitbucket.repos.tags 'user-name', 'repo-name'
+    #   bitbucket.repos.tags 'user-name', 'repo-name' { |tag| ... }
+    #
+    def tags(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}/tags/", params)
+      return response unless block_given?
+      response.each { |el| yield el }
+    end
+
+    alias :list_tags :tags
+    alias :repo_tags :tags
+    alias :repository_tags :tags
+
+  end # Repos
+end # BitBucket

data/lib/bitbucket_rest_api/request/basic_auth.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+
+require 'faraday'
+require 'base64'
+
+module BitBucket
+  module Request
+    class BasicAuth < Faraday::Middleware
+      dependency 'base64'
+
+      def call(env)
+        env[:request_headers].merge!('Authorization' => "Basic #{@auth}\"")
+
+        @app.call env
+      end
+
+      def initialize(app, *args)
+        @app = app
+        credentials = ""
+        options = args.extract_options!
+        if options.has_key? :login
+          credentials = "#{options[:login]}:#{options[:password]}"
+        elsif options.has_key? :basic_auth
+          credentials = "#{options[:basic_auth]}"
+        end
+        @auth = Base64.encode64(credentials)
+        @auth.gsub!("\n", "")
+      end
+    end # BasicAuth
+  end # Request
+end # BitBucket

data/lib/bitbucket_rest_api/request/jsonize.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'faraday'
+
+module BitBucket
+  class Request::Jsonize < Faraday::Middleware
+
+    CONTENT_TYPE = 'Content-Type'.freeze
+    MIME_TYPE    = 'application/json'.freeze
+
+    dependency 'multi_json'
+
+    def call(env)
+      if request_with_body?(env)
+        env[:request_headers][CONTENT_TYPE] ||= MIME_TYPE
+        env[:body] = encode_body env unless env[:body].respond_to?(:to_str)
+      end
+      @app.call env
+    end
+
+    def encode_body(env)
+      if MultiJson.respond_to?(:dump)
+        MultiJson.dump env[:body]
+      else
+        MultiJson.encode env[:body]
+      end
+    end
+
+    def request_with_body?(env)
+      type = request_type(env)
+      has_body?(env) and (type.empty? or type == MIME_TYPE)
+    end
+
+    # Don't encode bodies in string form
+    def has_body?(env)
+      body = env[:body] and !(body.respond_to?(:to_str) and body.empty?)
+    end
+
+    def request_type(env)
+      type = env[:request_headers][CONTENT_TYPE].to_s
+      type = type.split(';', 2).first if type.index(';')
+      type
+    end
+
+  end # Request::Jsonize
+end # BitBucket

data/lib/bitbucket_rest_api/request/oauth.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require 'faraday'
+
+module BitBucket
+  module Request
+    class OAuth < Faraday::Middleware
+      include BitBucket::Utils::Url
+
+      AUTH_HEADER  = 'Authorization'.freeze
+
+      dependency 'simple_oauth'
+
+      def call(env)
+        # Extract parameters from the query
+        params = {  }.update query_params(env[:url])
+
+        if (@token and @secret) and (!@token.empty? and !@secret.empty?)
+          access_token = ::OAuth::AccessToken.new(@consumer, @token, @secret)
+          env[:url].query = build_query params
+          
+          puts oauth_helper.header
+          puts oauth_helper.header.class
+          env[:request_headers].merge!(AUTH_HEADER => oauth_helper.header)
+        end
+          
+          env[:url].query = build_query params
+
+
+
+        @app.call env
+      end
+
+      def initialize(app, *args)
+        super app
+        @app = app
+        @consumer = args.shift
+        @token = args.shift
+        @secret = args.shift
+      end
+
+      def query_params(url)
+        if url.query.nil? or url.query.empty?
+          {}
+        else
+          parse_query url.query
+        end
+      end
+    end # OAuth
+  end # Request
+end # BitBucket

data/lib/bitbucket_rest_api/request.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+module BitBucket
+  # Defines HTTP verbs
+  module Request
+
+    METHODS = [:get, :post, :put, :delete, :patch]
+    METHODS_WITH_BODIES = [ :post, :put, :patch ]
+
+    def get_request(path, params={}, options={})
+      request(:get, path, params, options)
+    end
+
+    def patch_request(path, params={}, options={})
+      request(:patch, path, params, options)
+    end
+
+    def post_request(path, params={}, options={})
+      request(:post, path, params, options)
+    end
+
+    def put_request(path, params={}, options={})
+      request(:put, path, params, options)
+    end
+
+    def delete_request(path, params={}, options={})
+      request(:delete, path, params, options)
+    end
+
+    def request(method, path, params, options)
+      if !METHODS.include?(method)
+        raise ArgumentError, "unkown http method: #{method}"
+      end
+      # _extract_mime_type(params, options)
+
+      puts "EXECUTED: #{method} - #{path} with #{params} and #{options}" if ENV['DEBUG']
+
+      conn = connection(options)
+      path = (conn.path_prefix + path).gsub(/\/\//,'/') if conn.path_prefix != '/'
+
+      response = conn.send(method) do |request|
+        case method.to_sym
+        when *(METHODS - METHODS_WITH_BODIES)
+          request.body = params.delete('data') if params.has_key?('data')
+          request.url(path, params)
+        when *METHODS_WITH_BODIES
+          request.path = path
+          request.body = extract_data_from_params(params) unless params.empty?
+        end
+      end
+      response.body
+    end
+
+    private
+
+    def extract_data_from_params(params) # :nodoc:
+      return params['data'] if params.has_key?('data') and !params['data'].nil?
+      return params
+    end
+
+    def _extract_mime_type(params, options) # :nodoc:
+      options['resource']  = params['resource'] ? params.delete('resource') : ''
+      options['mime_type'] = params['resource'] ? params.delete('mime_type') : ''
+    end
+
+  end # Request
+end # BitBucket