Class: BitBucket::Issues::Milestones

Inherits:
API
  • Object
show all
Defined in:
lib/bitbucket_rest_api/issues/milestones.rb

Constant Summary collapse

VALID_MILESTONE_INPUTS = 
%w[
  name
].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

Request::METHODS, 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 inherited from API

#_hash_traverse, #_merge_mime_type, #_merge_user_into_params!, #_merge_user_repo_into_params!, #_update_user_repo_params, #api_methods_in, #append_arguments, inherited, #method_missing, #process_basic_auth, #set_api_client, #setup

Methods included from Normalizer

#normalize!

Methods included from ParameterFilter

#filter!

Methods included from AutoloadHelper

#autoload_all, #lookup_constant, #register_constant

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

#_validate_presence_of, #_validate_user_repo_params

Methods included from Request

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

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 = {}) ⇒ Milestones

Creates new Issues::Milestones API



11
12
13
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 11

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

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

Create a milestone

Inputs

<tt>:name</tt> - Required string

Examples

bitbucket = BitBucket.new :user => 'user-name', :repo => 'repo-name'
bitbucket.issues.milestones.create :name => 'hello-world'



58
59
60
61
62
63
64
65
66
67
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 58

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_MILESTONE_INPUTS, params
  assert_required_keys(%w[ name ], params)

  post_request("/repositories/#{user}/#{repo.downcase}/issues/milestones", params)
end

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

Delete a milestone

Examples

bitbucket = BitBucket.new
bitbucket.issues.milestones.delete 'user-name', 'repo-name', 'milestone-id'



97
98
99
100
101
102
103
104
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 97

def delete(user_name, repo_name, milestone_id, params={})
  _update_user_repo_params(user_name, repo_name)
  _validate_user_repo_params(user, repo) unless user? && repo?
  _validate_presence_of milestone_id
  normalize! params

  delete_request("/repositories/#{user}/#{repo.downcase}/issues/milestones/#{milestone_id}", params)
end

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

Get a single milestone

Examples

bitbucket = BitBucket.new
bitbucket.issues.milestones.get 'user-name', 'repo-name', 'milestone-id'



39
40
41
42
43
44
45
46
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 39

def get(user_name, repo_name, milestone_id, params={})
  _update_user_repo_params(user_name, repo_name)
  _validate_user_repo_params(user, repo) unless user? && repo?
  _validate_presence_of milestone_id
  normalize! params

  get_request("/repositories/#{user}/#{repo.downcase}/issues/milestones/#{milestone_id}", params)
end

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

List milestones for a repository

Examples

bitbucket = BitBucket.new :user => 'user-name', :repo => 'repo-name'
bitbucket.issues.milestones.list



21
22
23
24
25
26
27
28
29
30
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 21

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}/issues/milestones", params)
  return response unless block_given?
  response.each { |el| yield el }
end

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

Update a milestone

Inputs

<tt>:name</tt> - Required string

Examples

bitbucket = BitBucket.new
bitbucket.issues.milestones.update 'user-name', 'repo-name', 'milestone-id',
  :name => 'hello-world'



79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/bitbucket_rest_api/issues/milestones.rb', line 79

def update(user_name, repo_name, milestone_id, params={})
  _update_user_repo_params(user_name, repo_name)
  _validate_user_repo_params(user, repo) unless user? && repo?
  _validate_presence_of milestone_id

  normalize! params
  filter! VALID_MILESTONE_INPUTS, params
  assert_required_keys(%w[ name ], params)

  put_request("/repositories/#{user}/#{repo.downcase}/issues/milestones/#{milestone_id}", params)
end