gitlab 4.5.0 → 5.1.0

data/lib/gitlab/client/merge_requests.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to merge requests.
   # @see https://docs.gitlab.com/ce/api/merge_requests.html
@@ -25,7 +27,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def merge_requests(project, options={})
+    def merge_requests(project, options = {})
       get("/projects/#{url_encode project}/merge_requests", query: options)
     end
 
@@ -33,12 +35,71 @@ class Gitlab::Client
     #
     # @example
     #   Gitlab.merge_request(5, 36)
+    #   Gitlab.merge_request(5, 36, { include_diverged_commits_count: true })
     #
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a merge request.
+    # @option options [Boolean] :render_html If true response includes rendered HTML for title and description.
+    # @option options [Boolean] :include_diverged_commits_count If true response includes the commits behind the target branch.
+    # @option options [Boolean] :include_rebase_in_progress If true response includes whether a rebase operation is in progress.
     # @return <Gitlab::ObjectifiedHash]
-    def merge_request(project, id)
-      get("/projects/#{url_encode project}/merge_requests/#{id}")
+    def merge_request(project, id, options = {})
+      get("/projects/#{url_encode project}/merge_requests/#{id}", query: options)
+    end
+
+    # Gets a list of merge request pipelines.
+    #
+    # @example
+    #   Gitlab.merge_request_pipelines(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_pipelines(project, id)
+      get("/projects/#{url_encode project}/merge_requests/#{id}/pipelines")
+    end
+
+    # Shows information about the merge request dependencies that must be resolved before merging.
+    #
+    # @example
+    #   Gitlab.merge_request_dependencies(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_dependencies(project, id)
+      get("/projects/#{url_encode project}/merge_requests/#{id}/blocks")
+    end
+
+    # Create a new pipeline for a merge request.
+    # A pipeline created via this endpoint doesnt run a regular branch/tag pipeline.
+    # It requires .gitlab-ci.yml to be configured with only: [merge_requests] to create jobs.
+    #
+    # The new pipeline can be:
+    #
+    # A detached merge request pipeline.
+    # A pipeline for merged results if the project setting is enabled.
+    #
+    # @example
+    #   Gitlab.create_merge_request_pipeline(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] iid The internal ID of a merge request.
+    # @return [Gitlab::ObjectifiedHash]
+    def create_merge_request_pipeline(project, iid)
+      post("/projects/#{url_encode project}/merge_requests/#{iid}/pipelines")
+    end
+
+    # Get a list of merge request participants.
+    #
+    # @example
+    #   Gitlab.merge_request_participants(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_participants(project, id)
+      get("/projects/#{url_encode project}/merge_requests/#{id}/participants")
     end
 
     # Creates a merge request.
@@ -55,10 +116,16 @@ class Gitlab::Client
     # @option options [String] :source_branch (required) The source branch name.
     # @option options [String] :target_branch (required) The target branch name.
     # @option options [Integer] :assignee_id (optional) The ID of a user to assign merge request.
+    # @option options [Array<Integer>] :assignee_ids (optional) The ID of the user(s) to assign the MR to. Set to 0 or provide an empty value to unassign all assignees.
+    # @option options [String] :description (optional) Description of MR. Limited to 1,048,576 characters.
     # @option options [Integer] :target_project_id (optional) The target project ID.
     # @option options [String] :labels (optional) Labels as a comma-separated list.
+    # @option options [Integer] :milestone_id (optional) The global ID of a milestone
+    # @option options [Boolean] :remove_source_branch (optional) Flag indicating if a merge request should remove the source branch when merging
+    # @option options [Boolean] :allow_collaboration (optional) Allow commits from members who can merge to the target branch
+    # @option options [Boolean] :squash (optional) Squash commits into a single commit when merging
     # @return [Gitlab::ObjectifiedHash] Information about created merge request.
-    def create_merge_request(project, title, options={})
+    def create_merge_request(project, title, options = {})
       body = { title: title }.merge(options)
       post("/projects/#{url_encode project}/merge_requests", body: body)
     end
@@ -77,7 +144,7 @@ class Gitlab::Client
     # @option options [Integer] :assignee_id The ID of a user to assign merge request.
     # @option options [String] :state_event New state (close|reopen|merge).
     # @return [Gitlab::ObjectifiedHash] Information about updated merge request.
-    def update_merge_request(project, id, options={})
+    def update_merge_request(project, id, options = {})
       put("/projects/#{url_encode project}/merge_requests/#{id}", body: options)
     end
 
@@ -89,9 +156,14 @@ class Gitlab::Client
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a merge request.
     # @param  [Hash] options A customizable set of options.
-    # @option options [String] :merge_commit_message Custom merge commit message
+    # @option options [String] :merge_commit_message(optional) Custom merge commit message
+    # @option options [String] :squash_commit_message(optional) Custom squash commit message
+    # @option options [Boolean] :squash(optional) if true the commits will be squashed into a single commit on merge
+    # @option options [Boolean] :should_remove_source_branch(optional) if true removes the source branch
+    # @option options [Boolean] :merge_when_pipeline_succeeds(optional) if true the MR is merged when the pipeline succeeds
+    # @option options [String] :sha(optional) if present, then this SHA must match the HEAD of the source branch, otherwise the merge will fail
     # @return [Gitlab::ObjectifiedHash] Information about updated merge request.
-    def accept_merge_request(project, id, options={})
+    def accept_merge_request(project, id, options = {})
       put("/projects/#{url_encode project}/merge_requests/#{id}/merge", body: options)
     end
 
@@ -127,7 +199,7 @@ class Gitlab::Client
     # @param [Integer] project The ID of a project
     # @param [Integer] iid The internal ID of a merge request
     def merge_request_closes_issues(project_id, merge_request_iid)
-      get("/projects/#{project_id}/merge_requests/#{merge_request_iid}/closes_issues")
+      get("/projects/#{url_encode project_id}/merge_requests/#{merge_request_iid}/closes_issues")
     end
 
     # Subscribes to a merge request.
@@ -163,9 +235,11 @@ class Gitlab::Client
     #   Gitlab.merge_request_discussions('gitlab', 1)
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [Integer] id The ID of a merge request.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
     # @return [Gitlab::ObjectifiedHash] List of the merge request discussions.
-    def merge_request_discussions(project, merge_request_id)
-      get("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/discussions")
+    def merge_request_discussions(project, merge_request_id, options = {})
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/discussions", query: options)
     end
 
     # Get single merge request discussion
@@ -205,7 +279,7 @@ class Gitlab::Client
     #     * :x (Integer) X coordinate (for 'image' diff notes)
     #     * :y (Integer) Y coordinate (for 'image' diff notes)
     # @return [Gitlab::ObjectifiedHash] The created merge request discussion.
-    def create_merge_request_discussion(project, merge_request_id, options={})
+    def create_merge_request_discussion(project, merge_request_id, options = {})
       post("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/discussions", body: options)
     end
 
@@ -271,5 +345,68 @@ class Gitlab::Client
     def delete_merge_request_discussion_note(project, merge_request_id, discussion_id, note_id)
       delete("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/discussions/#{discussion_id}/notes/#{note_id}")
     end
+
+    # Delete a merge request
+    #
+    # @example
+    #   Gitlab.delete_merge_request(5, 1)
+    #   Gitlab.delete_merge_request('gitlab', 1)
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Gitlab::ObjectifiedHash] An empty response.
+    def delete_merge_request(project, merge_request_id)
+      delete("/projects/#{url_encode project}/merge_requests/#{merge_request_id}")
+    end
+
+    # Gets a list of merge request diffs
+    #
+    # @example
+    #   Gitlab.merge_request_diffs(5, 1)
+    #   Gitlab.merge_request_diffs('gitlab', 1)
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Gitlab::ObjectifiedHash] A list of the merge request diffs.
+    def merge_request_diffs(project, merge_request_id)
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/diffs")
+    end
+
+    # Gets a list of merge request diff versions
+    #
+    # @example
+    #   Gitlab.merge_request_versions(5, 1)
+    #   Gitlab.merge_request_versions('gitlab', 1)
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Gitlab::ObjectifiedHash] A list of the merge request versions.
+    def merge_request_diff_versions(project, merge_request_id)
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/versions")
+    end
+
+    # Gets the diff a single merge request diff version\
+    #
+    # @example
+    #   Gitlab.merge_request_diff_version(5, 1, 1)
+    #   Gitlab.merge_request_diff_version('gitlab', 1, 1)
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @param  [Integer] id The ID of a merge request diff version.
+    # @return [Gitlab::ObjectifiedHash] Record of the specific diff
+    def merge_request_diff_version(project, merge_request_id, version_id)
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request_id}/versions/#{version_id}")
+    end
+
+    # Rebase a merge request.
+    #
+    # @example
+    #   Gitlab.rebase_merge_request(5, 42, { skip_ci: true })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :skip_ci Set to true to skip creating a CI pipeline
+    # @return [Gitlab::ObjectifiedHash] Rebase progress status
+    def rebase_merge_request(project, id, options = {})
+      put("/projects/#{url_encode project}/merge_requests/#{id}/rebase", body: options)
+    end
   end
 end

data/lib/gitlab/client/merge_trains.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to merge trains.
+  # @see https://docs.gitlab.com/ee/api/merge_trains.html
+  module MergeTrains
+    # Get list of merge trains for a project.
+    #
+    # @example
+    #  Gitlab.merge_trains(1, scope: :active, sort: :asc)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Hash] options A customizable set of options.
+    # @option options [String] :scope The scope of merge trains to return, one of: :active, :complete
+    # @option options [String] :sort Sort by created_at either 'asc' or 'desc'
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_trains(project, options = {})
+      get("/projects/#{url_encode project}/merge_trains", query: options)
+    end
+
+    # Get all merge requests added to a merge train for the requested target branch.
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [String] target_branch The target branch of the merge train.
+    # @param [Hash] options A customizable set of options.
+    # @option options [String] :scope The scope of merge trains to return, one of: :active, :complete
+    # @option options [String] :sort Sort by created_at either 'asc' or 'desc'
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_train_merge_requests(project, target_branch, options = {})
+      get("/projects/#{url_encode project}/merge_trains/#{target_branch}", query: options)
+    end
+
+    # Get merge train information for the requested merge request.
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] merge_request_iid The IID of the merge request.
+    # @return [Gitlab::ObjectifiedHash]
+    def merge_train_status(project, merge_request_iid)
+      get("/projects/#{url_encode project}/merge_trains/merge_requests/#{merge_request_iid}")
+    end
+
+    # Add a merge request to the merge train targeting the merge request’s target branch.
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] merge_request_iid The IID of the merge request.
+    # @param [Hash] options A customizable set of options.
+    # @option options [Boolean] :when_pipeline_succeeds Add merge request to merge train when pipeline succeeds.
+    # @option options [String] :sha If present, the SHA must match the HEAD of the source branch, otherwise the merge fails.
+    # @option options [Boolean] :squash If true, the commits are squashed into a single commit on merge.
+    # @return [Array<Gitlab::ObjectifiedHash>] <description>
+    def add_merge_request_to_merge_train(project, merge_request_iid, options = {})
+      post("/projects/#{url_encode project}/merge_trains/merge_requests/#{merge_request_iid}", query: options)
+    end
+  end
+end

data/lib/gitlab/client/milestones.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to milestones.
   # @see https://docs.gitlab.com/ce/api/milestones.html
@@ -12,7 +14,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def milestones(project, options={})
+    def milestones(project, options = {})
       get("/projects/#{url_encode project}/milestones", query: options)
     end
 
@@ -38,7 +40,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def milestone_issues(project, milestone, options={})
+    def milestone_issues(project, milestone, options = {})
       get("/projects/#{url_encode project}/milestones/#{milestone}/issues", query: options)
     end
 
@@ -52,7 +54,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def milestone_merge_requests(project, milestone, options={})
+    def milestone_merge_requests(project, milestone, options = {})
       get("/projects/#{url_encode project}/milestones/#{milestone}/merge_requests", query: options)
     end
 
@@ -67,7 +69,7 @@ class Gitlab::Client
     # @option options [String] :description The description of a milestone.
     # @option options [String] :due_date The due date of a milestone.
     # @return [Gitlab::ObjectifiedHash] Information about created milestone.
-    def create_milestone(project, title, options={})
+    def create_milestone(project, title, options = {})
       body = { title: title }.merge(options)
       post("/projects/#{url_encode project}/milestones", body: body)
     end
@@ -85,8 +87,20 @@ class Gitlab::Client
     # @option options [String] :due_date The due date of a milestone.
     # @option options [String] :state_event The state of a milestone ('close' or 'activate').
     # @return [Gitlab::ObjectifiedHash] Information about updated milestone.
-    def edit_milestone(project, id, options={})
+    def edit_milestone(project, id, options = {})
       put("/projects/#{url_encode project}/milestones/#{id}", body: options)
     end
+
+    # Delete a project milestone.
+    #
+    # @example
+    #   Gitlab.delete_milestone(5, 2)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a milestone.
+    # @return [nil] This API call returns an empty response body.
+    def delete_milestone(project, id)
+      delete("/projects/#{url_encode project}/milestones/#{id}")
+    end
   end
 end

data/lib/gitlab/client/namespaces.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to namespaces
   # @see https://docs.gitlab.com/ce/api/namespaces.html
@@ -13,8 +15,8 @@ class Gitlab::Client
     # @options options [Integer] :per_page The number of results per page.
     # @options opttion [String]  :search The string to search for.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def namespaces(options={})
-      get("/namespaces", query: options)
+    def namespaces(options = {})
+      get('/namespaces', query: options)
     end
   end
 end

data/lib/gitlab/client/notes.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to notes.
   # @see https://docs.gitlab.com/ce/api/notes.html
@@ -11,7 +13,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def notes(project, options={})
+    def notes(project, options = {})
       get("/projects/#{url_encode project}/notes", query: options)
     end
 
@@ -25,7 +27,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def issue_notes(project, issue, options={})
+    def issue_notes(project, issue, options = {})
       get("/projects/#{url_encode project}/issues/#{issue}/notes", query: options)
     end
 
@@ -39,7 +41,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def snippet_notes(project, snippet, options={})
+    def snippet_notes(project, snippet, options = {})
       get("/projects/#{url_encode project}/snippets/#{snippet}/notes", query: options)
     end
 
@@ -53,10 +55,24 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def merge_request_notes(project, merge_request, options={})
+    def merge_request_notes(project, merge_request, options = {})
       get("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", query: options)
     end
-    alias_method :merge_request_comments, :merge_request_notes
+    alias merge_request_comments merge_request_notes
+
+    # Gets a list of notes for an epic.
+    #
+    # @example
+    #   Gitlab.epic_notes(5, 10)
+    #
+    # @param [Integer] project The ID of a group.
+    # @param [Integer] epic The ID of an epic.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def epic_notes(group, epic, options = {})
+      get("/groups/#{url_encode group}/epics/#{epic}/notes", query: options)
+    end
 
     # Gets a single wall note.
     #
@@ -158,7 +174,20 @@ class Gitlab::Client
     def create_merge_request_note(project, merge_request, body)
       post("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", body: { body: body })
     end
-    alias_method :create_merge_request_comment, :create_merge_request_note
+    alias create_merge_request_comment create_merge_request_note
+
+    # Creates a new epic note.
+    #
+    # @example
+    #   Gitlab.create_epic_note(6, 1, 'Adding a note to my epic.')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] epic The ID of an epic.
+    # @param  [String] body The body of a note.
+    # @return [Gitlab::ObjectifiedHash] Information about created note.
+    def create_epic_note(group, epic, body)
+      post("/groups/#{url_encode group}/epics/#{epic}/notes", body: { body: body })
+    end
 
     # Deletes a wall note.
     #
@@ -210,7 +239,7 @@ class Gitlab::Client
     def delete_merge_request_note(project, merge_request, id)
       delete("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}")
     end
-    alias_method :delete_merge_request_comment, :delete_merge_request_note
+    alias delete_merge_request_comment delete_merge_request_note
 
     # Modifies a wall note.
     #
@@ -266,7 +295,7 @@ class Gitlab::Client
     def edit_merge_request_note(project, merge_request, id, body)
       put("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}", body: note_content(body))
     end
-    alias_method :edit_merge_request_comment, :edit_merge_request_note
+    alias edit_merge_request_comment edit_merge_request_note
 
     private
 
@@ -274,7 +303,7 @@ class Gitlab::Client
     # in the 'else'.
     def note_content(body)
       if body.is_a?(Hash)
-        STDERR.puts "Passing the note body as a Hash is deprecated.  You should just pass the String."
+        warn 'Passing the note body as a Hash is deprecated.  You should just pass the String.'
         body
       else
         { body: body }

data/lib/gitlab/client/packages.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to GitLab Packages.
+  # @see https://docs.gitlab.com/ee/api/packages.html
+  module Packages
+    # Gets a list of project packages.
+    #
+    # @example
+    #   Gitlab.project_packages(5)
+    #   Gitlab.project_packages(5, { package_type: 'npm', sort: 'desc' })
+    #
+    # @param   [Integer, String] :project the ID or name of a project.
+    # @param   [Hash] options A customizable set of options.
+    # @options options [String] :order_by The field to use as order. One of created_at (default), name, version, or type.
+    # @options options [String] :sort The direction of the order, either asc (default) for ascending order or desc for descending order.
+    # @options options [String] :package_type Filter the returned packages by type. One of conan, maven, npm, pypi, composer, nuget, helm, terraform_module, or golang.
+    # @options options [String] :package_name Filter the project packages with a fuzzy search by name.
+    # @options options [String] :include_versionless When set to true, versionless packages are included in the response.
+    # @options options [String] :status Filter the returned packages by status. One of default (default), hidden, processing, error, or pending_destruction.
+    # @return  [Array<Gitlab::ObjectifiedHash>]
+    def project_packages(project, options = {})
+      get("/projects/#{url_encode project}/packages", query: options)
+    end
+
+    # Gets a list of project packages.
+    #
+    # @example
+    #   Gitlab.group_packages(5)
+    #   Gitlab.group_packages(5, { package_type: 'npm', sort: 'desc' })
+    #
+    # @param   [Integer, String] project the ID or name of a project.
+    # @param   [Hash] options A customizable set of options.
+    # @options options [String] :exclude_subgroups If the parameter is included as true, packages from projects from subgroups are not listed. Default is false.
+    # @options options [String] :order_by The field to use as order. One of created_at (default), name, version, or type.
+    # @options options [String] :sort The direction of the order, either asc (default) for ascending order or desc for descending order.
+    # @options options [String] :package_type Filter the returned packages by type. One of conan, maven, npm, pypi, composer, nuget, helm, terraform_module, or golang.
+    # @options options [String] :package_name Filter the project packages with a fuzzy search by name.
+    # @options options [String] :include_versionless When set to true, versionless packages are included in the response.
+    # @options options [String] :status Filter the returned packages by status. One of default (default), hidden, processing, error, or pending_destruction.
+    # @return  [Array<Gitlab::ObjectifiedHash>]
+    def group_packages(group, options = {})
+      get("/groups/#{url_encode group}/packages", query: options)
+    end
+
+    # Get a single project package.
+    #
+    # @example
+    #   Gitlab.project_package(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [Gitlab::ObjectifiedHash]
+    def project_package(project, id)
+      get("/projects/#{url_encode project}/packages/#{id}")
+    end
+
+    # Get a list of package files of a single package.
+    #
+    # @example
+    #   Gitlab.project_package_files(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_package_files(project, id)
+      get("/projects/#{url_encode project}/packages/#{id}/package_files")
+    end
+
+    # Deletes a project package.
+    #
+    # @example
+    #   Gitlab.delete_project_package(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [void] This API call returns an empty response body.
+    def delete_project_package(project, id)
+      delete("/projects/#{url_encode project}/packages/#{id}")
+    end
+
+    # Delete a package file.
+    #
+    # @example
+    #   Gitlab.delete_project_file(5, 3, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] package_id ID of a package.
+    # @param  [Integer] file_id ID of a package file.
+    # @return [void] This API call returns an empty response body.
+    def delete_project_package_file(project, package_id, file_id)
+      delete("/projects/#{url_encode project}/packages/#{package_id}/package_files/#{file_id}")
+    end
+  end
+end