BigW Consortium Gitlab

repositories.rb 5.7 KB
Newer Older
1 2
require 'mime/types'

3 4 5 6
module API
  # Projects API
  class Repositories < Grape::API
    before { authenticate! }
7
    before { authorize! :download_code, user_project }
8 9 10 11 12 13 14 15 16 17

    resource :projects do
      helpers do
        def handle_project_member_errors(errors)
          if errors[:project_access].any?
            error!(errors[:project_access], 422)
          end
          not_found!
        end
      end
18

19 20 21 22 23 24 25
      # Get a project repository tags
      #
      # Parameters:
      #   id (required) - The ID of a project
      # Example Request:
      #   GET /projects/:id/repository/tags
      get ":id/repository/tags" do
26 27
        present user_project.repo.tags.sort_by(&:name).reverse,
                with: Entities::RepoTag, project: user_project
28 29
      end

30 31 32 33 34 35
      # Create tag
      #
      # Parameters:
      #   id (required) - The ID of a project
      #   tag_name (required) - The name of the tag
      #   ref (required) - Create tag from commit sha or branch
36
      #   message (optional) - Specifying a message creates an annotated tag.
37 38 39 40
      # Example Request:
      #   POST /projects/:id/repository/tags
      post ':id/repository/tags' do
        authorize_push_project
41
        message = params[:message] || nil
42 43
        result = CreateTagService.new(user_project, current_user).
          execute(params[:tag_name], params[:ref], message)
Dmitriy Zaporozhets committed
44

45 46
        if result[:status] == :success
          present result[:tag],
47
                  with: Entities::RepoTag,
48 49 50 51
                  project: user_project
        else
          render_api_error!(result[:message], 400)
        end
52 53
      end

54 55 56 57 58 59 60
      # Get a project repository tree
      #
      # Parameters:
      #   id (required) - The ID of a project
      #   ref_name (optional) - The name of a repository branch or tag, if not given the default branch is used
      # Example Request:
      #   GET /projects/:id/repository/tree
61
      get ':id/repository/tree' do
62 63 64 65
        ref = params[:ref_name] || user_project.try(:default_branch) || 'master'
        path = params[:path] || nil

        commit = user_project.repository.commit(ref)
66 67
        not_found!('Tree') unless commit

68
        tree = user_project.repository.tree(commit.id, path)
69

70
        present tree.sorted_entries, with: Entities::RepoTreeObject
71 72
      end

73 74 75 76 77 78 79
      # Get a raw file contents
      #
      # Parameters:
      #   id (required) - The ID of a project
      #   sha (required) - The commit or branch name
      #   filepath (required) - The path to the file to display
      # Example Request:
80 81
      #   GET /projects/:id/repository/blobs/:sha
      get [ ":id/repository/blobs/:sha", ":id/repository/commits/:sha/blob" ] do
82 83 84 85 86 87 88 89 90
        required_attributes! [:filepath]

        ref = params[:sha]

        repo = user_project.repository

        commit = repo.commit(ref)
        not_found! "Commit" unless commit

91 92
        blob = Gitlab::Git::Blob.find(repo, commit.id, params[:filepath])
        not_found! "File" unless blob
93

94
        content_type 'text/plain'
95 96 97 98 99 100 101 102 103 104
        present blob.data
      end

      # Get a raw blob contents by blob sha
      #
      # Parameters:
      #   id (required) - The ID of a project
      #   sha (required) - The blob's sha
      # Example Request:
      #   GET /projects/:id/repository/raw_blobs/:sha
105
      get ':id/repository/raw_blobs/:sha' do
106 107 108 109
        ref = params[:sha]

        repo = user_project.repository

110 111 112 113 114
        begin
          blob = Gitlab::Git::Blob.raw(repo, ref)
        rescue
          not_found! 'Blob'
        end
115

116
        not_found! 'Blob' unless blob
117 118

        env['api.format'] = :txt
119

120 121 122
        content_type blob.mime_type
        present blob.data
      end
123 124 125 126 127

      # Get a an archive of the repository
      #
      # Parameters:
      #   id (required) - The ID of a project
128
      #   sha (optional) - the commit sha to download defaults to the tip of the default branch
129 130
      # Example Request:
      #   GET /projects/:id/repository/archive
131 132
      get ':id/repository/archive',
          requirements: { format: Gitlab::Regex.archive_formats_regex } do
133
        authorize! :download_code, user_project
134 135 136 137 138 139 140 141 142

        begin
          file_path = ArchiveRepositoryService.new.execute(
              user_project,
              params[:sha],
              params[:format])
        rescue
          not_found!('File')
        end
143

144 145
        if file_path && File.exists?(file_path)
          data = File.open(file_path, 'rb').read
146 147
          basename = File.basename(file_path)
          header['Content-Disposition'] = "attachment; filename=\"#{basename}\""
148
          content_type MIME::Types.type_for(file_path).first.content_type
149
          env['api.format'] = :binary
150 151
          present data
        else
152
          not_found!('File')
153 154
        end
      end
155 156 157 158 159 160 161 162 163 164 165

      # Compare two branches, tags or commits
      #
      # Parameters:
      #   id (required) - The ID of a project
      #   from (required) - the commit sha or branch name
      #   to (required) - the commit sha or branch name
      # Example Request:
      #   GET /projects/:id/repository/compare?from=master&to=feature
      get ':id/repository/compare' do
        authorize! :download_code, user_project
166
        required_attributes! [:from, :to]
167
        compare = Gitlab::Git::Compare.new(user_project.repository.raw_repository, params[:from], params[:to])
168 169
        present compare, with: Entities::Compare
      end
170 171 172 173 174 175 176 177 178 179

      # Get repository contributors
      #
      # Parameters:
      #   id (required) - The ID of a project
      # Example Request:
      #   GET /projects/:id/repository/contributors
      get ':id/repository/contributors' do
        authorize! :download_code, user_project

180 181 182 183 184 185
        begin
          present user_project.repository.contributors,
                  with: Entities::Contributor
        rescue
          not_found!
        end
186
      end
187 188 189
    end
  end
end