File: project_exports.rb

package info (click to toggle)
ruby-gitlab 5.1.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,660 kB
  • sloc: ruby: 12,582; makefile: 7; sh: 4
file content (54 lines) | stat: -rw-r--r-- 1,980 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# frozen_string_literal: true

class Gitlab::Client
  # Defines methods related to project exports.
  # @see https://docs.gitlab.com/ce/api/project_import_export.html
  module ProjectExports
    # Start a new export
    #
    # @example
    #   Gitlab.export_project(2)
    #
    # @param [Integer, String] id The ID or path of a project.
    # @param [Hash] options A customizable set of options.
    # @option options [String] description(optional) Overrides the project description
    # @option options [hash] upload(optional) Hash that contains the information to upload the exported project to a web server
    # @option options [String] upload[url] TThe URL to upload the project
    # @option options [String] upload[http_method](optional) The HTTP method to upload the exported project. Only PUT and POST methods allowed. Default is PUT
    # @return [Gitlab::ObjectifiedHash]
    def export_project(id, options = {})
      post("/projects/#{url_encode id}/export", body: options)
    end

    # Get the status of export
    #
    # @example
    #   Gitlab.export_project_status(2)
    #
    # @param [Integer, String] id The ID or path of a project.
    # @return [Gitlab::ObjectifiedHash]
    def export_project_status(id)
      get("/projects/#{url_encode id}/export")
    end

    # Download the finished export
    #
    # @example
    #   Gitlab.exported_project_download(2)
    #
    # @param [Integer, String] id The ID or path of a project.
    # @return [Gitlab::FileResponse]
    def exported_project_download(id)
      get("/projects/#{url_encode id}/export/download",
          format: nil,
          headers: { Accept: 'application/octet-stream' },
          parser: proc { |body, _|
            if body.encoding == Encoding::ASCII_8BIT # binary response
              ::Gitlab::FileResponse.new StringIO.new(body, 'rb+')
            else # error with json response
              ::Gitlab::Request.parse(body)
            end
          })
    end
  end
end