Class: BitBucket::Client::Repos::Services

Inherits:
API
  • Object
show all
Defined in:
lib/bitbucket_rest_api/client/repos/services.rb

Constant Summary collapse

REQUIRED_KEY_PARAM_NAMES =
%w[ type ].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 BitBucket::Constants

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

Instance Attribute Summary

Attributes inherited from API

#current_options

Instance Method Summary collapse

Methods inherited from API

#_merge_user_into_params!, #_merge_user_repo_into_params!, #_update_user_repo_params, #api_methods_in, #append_arguments, #arguments, extract_class_name, inherited, #initialize, #method_missing, namespace, #process_basic_auth, #set, #set_api_client, #setup, #with, #yield_or_eval

Methods included from BitBucket::ClassMethods

#configuration, #configure, #require_all

Methods included from Normalizer

#normalize!

Methods included from ParameterFilter

#filter!

Methods included from Validations::Required

#assert_required_keys

Methods included from Validations::Token

#validates_token_for

Methods included from Validations::Format

#assert_valid_values

Methods included from Validations::Presence

#assert_presence_of

Methods included from Request::Verbs

#delete_request, #get_request, #options_request, #patch_request, #post_request, #put_request

Methods included from Authorization

#authenticated?, #authentication, #basic_authed?

Constructor Details

This class inherits a constructor from BitBucket::API

Dynamic Method Handling

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

Instance Method Details

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

Create a service

Inputs

  • :type - 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" => "..."


56
57
58
59
60
61
62
63
# File 'lib/bitbucket_rest_api/client/repos/services.rb', line 56

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

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

Delete service

Examples

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


94
95
96
97
98
99
100
101
# File 'lib/bitbucket_rest_api/client/repos/services.rb', line 94

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

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

Edit a service

Inputs

  • :type - 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" => "..."


78
79
80
81
82
83
84
85
86
# File 'lib/bitbucket_rest_api/client/repos/services.rb', line 78

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

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

Gets a single service

Examples

@bitbucket = BitBucket.new
@bitbucket.repos.services.get 'user-name', 'repo-name', 109172378)


33
34
35
36
37
38
39
40
# File 'lib/bitbucket_rest_api/client/repos/services.rb', line 33

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

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

List services

Examples

bitbucket = BitBucket.new
bitbucket.repos.services.list 'user-name', 'repo-name'
bitbucket.repos.services.list 'user-name', 'repo-name' { |service| ... }


16
17
18
19
20
21
22
23
24
# File 'lib/bitbucket_rest_api/client/repos/services.rb', line 16

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