Class: BitBucket::Repos

Inherits:
API
  • Object
show all
Extended by:
AutoloadHelper
Defined in:
lib/bitbucket_rest_api/repos.rb

Defined Under Namespace

Classes: Changesets, Commits, DefaultReviewers, Download, Following, Forks, Keys, PullRequest, Services, Sources, Statuses, Webhooks

Constant Summary collapse

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

Constants included from Validations

Validations::VALID_API_KEYS

Constants included from Validations::Token

Validations::Token::TOKEN_REQUIRED, Validations::Token::TOKEN_REQUIRED_REGEXP

Constants included from Request

BitBucket::Request::METHODS, BitBucket::Request::METHODS_WITH_BODIES

Constants included from Connection

Connection::ALLOWED_OPTIONS

Constants included from Constants

Constants::ACCEPT, Constants::ACCEPT_CHARSET, Constants::CACHE_CONTROL, Constants::CONTENT_LENGTH, Constants::CONTENT_TYPE, Constants::DATE, Constants::ETAG, Constants::HEADER_LAST, Constants::HEADER_LINK, Constants::HEADER_NEXT, Constants::LOCATION, Constants::META_FIRST, Constants::META_LAST, Constants::META_NEXT, Constants::META_PREV, Constants::META_REL, Constants::PARAM_PAGE, Constants::PARAM_PER_PAGE, Constants::PARAM_START_PAGE, Constants::QUERY_STR_SEP, Constants::RATELIMIT_LIMIT, Constants::RATELIMIT_REMAINING, Constants::SERVER, Constants::USER_AGENT

Instance Method Summary collapse

Methods included from AutoloadHelper

autoload_all, lookup_constant, register_constant

Methods inherited from API

#_merge_mime_type, #_merge_user_into_params!, #_merge_user_repo_into_params!, #_update_user_repo_params, #api_methods_in, inherited, #method_missing, #process_basic_auth, #setup, #update_and_validate_user_repo_params

Methods included from Helpers::RepositoryHelper

#sanitize_repository_name

Methods included from Normalizer

#normalize!

Methods included from ParameterFilter

#filter!

Methods included from Validations::Required

#assert_required_keys, #assert_required_values_present, #parse_values

Methods included from Validations::Token

#validates_token_for

Methods included from Validations::Format

#assert_valid_values

Methods included from Validations::Presence

#_validate_presence_of, #_validate_user_repo_params

Methods included from Request

#delete_request, #get_request, #patch_request, #post_request, #put_request, #request, #retry_token_refresh_errors

Methods included from Connection

#caching?, #clear_cache, #connection, #default_middleware, #default_options, #stack

Methods included from Authorization

#authenticated?, #authentication, #basic_authed?

Constructor Details

#initialize(options = { }) ⇒ Repos

Creates new Repositories API



45
46
47
 
# File 'lib/bitbucket_rest_api/repos.rb', line 45

def initialize(options = { })
  super(options)
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class BitBucket::API

Instance Method Details

#branches(user_name, repo_name, params = {}) ⇒ Object Also known as: list_branches

List branches

Examples

bitbucket = BitBucket.new
bibucket.repos.branches 'user-name', 'repo-name'

repos = BitBucket::Repos.new
repos.branches 'user-name', 'repo-name'



113
114
115
116
117
118
119
120
121
 
# File 'lib/bitbucket_rest_api/repos.rb', line 113

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("/1.0/repositories/#{user}/#{repo.downcase}/branches/", params)
  return response unless block_given?
  response.each { |el| yield el }
end

#changesets ⇒ Object

Access to Repos::Commits API



50
51
52
 
# File 'lib/bitbucket_rest_api/repos.rb', line 50

def changesets
  @changesets ||= ApiFactory.new 'Repos::Changesets'
end

#commits ⇒ Object 



82
83
84
 
# File 'lib/bitbucket_rest_api/repos.rb', line 82

def commits
  @commits ||=ApiFactory.new 'Repos::Commits'
end

#create(*args) ⇒ Object

FIXME: ‘POST a new repository’ is a deprecated feature of the API 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'



153
154
155
156
157
158
159
160
161
 
# File 'lib/bitbucket_rest_api/repos.rb', line 153

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("/1.0/repositories/", DEFAULT_REPO_OPTIONS.merge(params))
end

#default_reviewers ⇒ Object 



99
100
101
 
# File 'lib/bitbucket_rest_api/repos.rb', line 99

def default_reviewers
  @default_reviewers ||= ApiFactory.new 'Repos::DefaultReviewers'
end

#delete(user_name, repo_name) ⇒ Object

FIXME: ‘DELETE an existing repository’ is a deprecated feature of the API Delete a repository

Examples

@bitbucket = BitBucket.new
@bitbucket.repos.delete 'user-name', 'repo-name'



222
223
224
225
226
227
 
# File 'lib/bitbucket_rest_api/repos.rb', line 222

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("/1.0/repositories/#{user}/#{repo.downcase}")
end

#download ⇒ Object 



86
87
88
 
# File 'lib/bitbucket_rest_api/repos.rb', line 86

def download
  @download ||=ApiFactory.new "Repos::Download"
end

#edit(user_name, repo_name, params = { }) ⇒ Object

Edit a repository

Parameters

  • :name Required string

  • :description Optional string

  • :website Optional string

  • :private - Optional boolean - false to create public reps, false to create a private one

  • :has_issues Optional boolean - true to enable issues for this repository, false to disable them

  • :has_wiki Optional boolean - true to enable the wiki for this repository, false to disable it. Default is true

  • :has_downloads Optional boolean - true 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



183
184
185
186
187
188
189
190
191
 
# File 'lib/bitbucket_rest_api/repos.rb', line 183

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("/1.0/repositories/#{user}/#{repo.downcase}/", DEFAULT_REPO_OPTIONS.merge(params))
end

#following ⇒ Object

Access to Repos::Watchin API



60
61
62
 
# File 'lib/bitbucket_rest_api/repos.rb', line 60

def following
  @following ||= ApiFactory.new 'Repos::Following'
end

#forks ⇒ Object 



78
79
80
 
# File 'lib/bitbucket_rest_api/repos.rb', line 78

def forks
  @forks ||= ApiFactory.new 'Repos::Forks'
end

#get(user_name, repo_name, params = { }) ⇒ Object Also known as: find

Get a repository

Examples

bitbucket = BitBucket.new
bitbucket.repos.get 'user-name', 'repo-name'



199
200
201
202
203
204
205
206
207
208
209
210
211
 
# File 'lib/bitbucket_rest_api/repos.rb', line 199

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

  url = if BitBucket.options[:bitbucket_server]
          "/1.0/projects/#{user}/repos/#{repo.downcase}"
        else
          "/1.0/repositories/#{user}/#{repo.downcase}"
        end

  get_request(url, params)
end

#keys ⇒ Object

Access to Repos::Keys API



55
56
57
 
# File 'lib/bitbucket_rest_api/repos.rb', line 55

def keys
  @keys ||= ApiFactory.new 'Repos::Keys'
end

#list(*args) ⇒ Object Also known as: all

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| ... }



242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
 
# File 'lib/bitbucket_rest_api/repos.rb', line 242

def list(*args)
  params = args.extract_options!
  normalize! params
  _merge_user_into_params!(params) unless params.has_key?('user')
  filter! %w[ user type ], params

  url = if BitBucket.options[:bitbucket_server]
          if params.has_key?('user')
            "/1.0/users/#{params['user']}/repos"
          else
            '/1.0/repos'
          end
        else
          '/1.0/user/repositories'
        end
  response = get_request(url, params)

  return response unless block_given?
  response.each { |el| yield el }
end

#pull_request ⇒ Object

Access to Repos::PullRequests API



95
96
97
 
# File 'lib/bitbucket_rest_api/repos.rb', line 95

def pull_request
  @pull_request ||= ApiFactory.new 'Repos::PullRequest'
end

#services ⇒ Object

Access to Repos::Services API



70
71
72
 
# File 'lib/bitbucket_rest_api/repos.rb', line 70

def services
  @services ||= ApiFactory.new 'Repos::Services'
end

#sources ⇒ Object

Access to Repos::Commits API



65
66
67
 
# File 'lib/bitbucket_rest_api/repos.rb', line 65

def sources
  @sources ||= ApiFactory.new 'Repos::Sources'
end

#statuses ⇒ Object 



74
75
76
 
# File 'lib/bitbucket_rest_api/repos.rb', line 74

def statuses
  @statuses ||= ApiFactory.new 'Repos::Statuses'
end

#tags(user_name, repo_name, params = { }) ⇒ Object Also known as: list_tags, repo_tags, repository_tags

List tags

Examples

bitbucket = BitBucket.new
bitbucket.repos.tags 'user-name', 'repo-name'
bitbucket.repos.tags 'user-name', 'repo-name' { |tag| ... }



272
273
274
275
276
277
278
279
280
 
# File 'lib/bitbucket_rest_api/repos.rb', line 272

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("/1.0/repositories/#{user}/#{repo.downcase}/tags/", params)
  return response unless block_given?
  response.each { |el| yield el }
end

#webhooks ⇒ Object 



90
91
92
 
# File 'lib/bitbucket_rest_api/repos.rb', line 90

def webhooks
  @webhooks ||= ApiFactory.new 'Repos::Webhooks'
end