debian-mirror-gitlab/lib/api/repositories.rb

180 lines
5.3 KiB
Ruby
Raw Normal View History

2014-09-02 18:07:02 +05:30
require 'mime/types'
module API
# Projects API
class Repositories < Grape::API
before { authenticate! }
before { authorize! :download_code, user_project }
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
# 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
2015-04-26 12:48:37 +05:30
present user_project.repo.tags.sort_by(&:name).reverse,
with: Entities::RepoTag, project: user_project
2014-09-02 18:07:02 +05:30
end
# 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
2015-04-26 12:48:37 +05:30
# message (optional) - Specifying a message creates an annotated tag.
2014-09-02 18:07:02 +05:30
# Example Request:
# POST /projects/:id/repository/tags
post ':id/repository/tags' do
authorize_push_project
2015-04-26 12:48:37 +05:30
message = params[:message] || nil
result = CreateTagService.new(user_project, current_user).
execute(params[:tag_name], params[:ref], message)
if result[:status] == :success
present result[:tag],
with: Entities::RepoTag,
project: user_project
else
render_api_error!(result[:message], 400)
end
2014-09-02 18:07:02 +05:30
end
# 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
2015-04-26 12:48:37 +05:30
get ':id/repository/tree' do
2014-09-02 18:07:02 +05:30
ref = params[:ref_name] || user_project.try(:default_branch) || 'master'
path = params[:path] || nil
2015-09-11 14:41:01 +05:30
commit = user_project.commit(ref)
2015-04-26 12:48:37 +05:30
not_found!('Tree') unless commit
2014-09-02 18:07:02 +05:30
tree = user_project.repository.tree(commit.id, path)
present tree.sorted_entries, with: Entities::RepoTreeObject
end
# 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:
# GET /projects/:id/repository/blobs/:sha
get [ ":id/repository/blobs/:sha", ":id/repository/commits/:sha/blob" ] do
required_attributes! [:filepath]
ref = params[:sha]
repo = user_project.repository
commit = repo.commit(ref)
not_found! "Commit" unless commit
blob = Gitlab::Git::Blob.find(repo, commit.id, params[:filepath])
not_found! "File" unless blob
content_type 'text/plain'
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
2015-04-26 12:48:37 +05:30
get ':id/repository/raw_blobs/:sha' do
2014-09-02 18:07:02 +05:30
ref = params[:sha]
repo = user_project.repository
2015-04-26 12:48:37 +05:30
begin
blob = Gitlab::Git::Blob.raw(repo, ref)
rescue
not_found! 'Blob'
end
2014-09-02 18:07:02 +05:30
2015-04-26 12:48:37 +05:30
not_found! 'Blob' unless blob
2014-09-02 18:07:02 +05:30
env['api.format'] = :txt
content_type blob.mime_type
present blob.data
end
# Get a an archive of the repository
#
# Parameters:
# id (required) - The ID of a project
# sha (optional) - the commit sha to download defaults to the tip of the default branch
# Example Request:
# GET /projects/:id/repository/archive
2015-04-26 12:48:37 +05:30
get ':id/repository/archive',
requirements: { format: Gitlab::Regex.archive_formats_regex } do
2014-09-02 18:07:02 +05:30
authorize! :download_code, user_project
2015-04-26 12:48:37 +05:30
begin
2015-10-24 18:46:33 +05:30
ArchiveRepositoryService.new(
2015-04-26 12:48:37 +05:30
user_project,
params[:sha],
params[:format]
).execute
rescue
not_found!('File')
end
2014-09-02 18:07:02 +05:30
end
# 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
required_attributes! [:from, :to]
compare = Gitlab::Git::Compare.new(user_project.repository.raw_repository, params[:from], params[:to])
present compare, with: Entities::Compare
end
# 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
2015-04-26 12:48:37 +05:30
begin
present user_project.repository.contributors,
with: Entities::Contributor
rescue
not_found!
end
2014-09-02 18:07:02 +05:30
end
end
end
end