Module: Gitlab::Client::Milestones

Included in:
Gitlab::Client
Defined in:
lib/gitlab/client/milestones.rb

Overview

Defines methods related to milestones.

Instance Method Summary collapse

Instance Method Details

#create_milestone(project, title, options = {}) ⇒ Gitlab::ObjectifiedHash

Creates a new milestone.

Parameters:

  • project (Integer, String) —

    The ID or code name of a project.

  • title (String) —

    The title of a milestone.

  • options (Hash) (defaults to: {}) —

    A customizable set of options.

Options Hash (options):

  • :description (String) —

    The description of a milestone.

  • :due_date (String) —

    The due date of a milestone.

Returns:



40
41
42
43
 
# File 'lib/gitlab/client/milestones.rb', line 40

def create_milestone(project, title, options={})
  body = {:title => title}.merge(options)
  post("/projects/#{project}/milestones", :body => body)
end

#edit_milestone(project, id, options = {}) ⇒ Gitlab::ObjectifiedHash

Updates a milestone.

Parameters:

  • project (Integer, String) —

    The ID or code name of a project.

  • id (Integer) —

    The ID of a milestone.

  • options (Hash) (defaults to: {}) —

    A customizable set of options.

Options Hash (options):

  • :title (String) —

    The title of a milestone.

  • :description (String) —

    The description of a milestone.

  • :due_date (String) —

    The due date of a milestone.

  • :closed (Boolean) —

    The state of a milestone (0 = false, 1 = true).

Returns:



55
56
57
 
# File 'lib/gitlab/client/milestones.rb', line 55

def edit_milestone(project, id, options={})
  put("/projects/#{project}/milestones/#{id}", :body => options)
end

#milestone(project, id) ⇒ Array<Gitlab::ObjectifiedHash>

Gets a single milestone.

Examples:

Gitlab.milestone(5, 36)
Gitlab.milestone('gitlab', 42)

Parameters:

  • project (Integer, String) —

    The ID or code name of a project.

  • id (Integer) —

    The ID of a milestone.

Returns:



28
29
30
 
# File 'lib/gitlab/client/milestones.rb', line 28

def milestone(project, id)
  get("/projects/#{project}/milestones/#{id}")
end

#milestones(project, options = {}) ⇒ Array<Gitlab::ObjectifiedHash>

Gets a list of project’s milestones.

Examples:

Gitlab.milestones(5)
Gitlab.milestones('gitlab')

Parameters:

  • project (Integer, String) —

    The ID or code name of a project.

  • options (Hash) (defaults to: {}) —

    A customizable set of options.

Options Hash (options):

  • :page (Integer) —

    The page number.

  • :per_page (Integer) —

    The number of results per page.

Returns:



15
16
17
 
# File 'lib/gitlab/client/milestones.rb', line 15

def milestones(project, options={})
  get("/projects/#{project}/milestones", :query => options)
end