module API module V3 class Files < Grape::API helpers do def commit_params(attrs) { file_path: attrs[:file_path], start_branch: attrs[:branch], target_branch: attrs[:branch], commit_message: attrs[:commit_message], file_content: attrs[:content], file_content_encoding: attrs[:encoding], author_email: attrs[:author_email], author_name: attrs[:author_name] } end def commit_response(attrs) { file_path: attrs[:file_path], branch: attrs[:branch] } end params :simple_file_params do requires :file_path, type: String, desc: 'The path to new file. Ex. lib/class.rb' requires :branch_name, type: String, desc: 'The name of branch' requires :commit_message, type: String, desc: 'Commit Message' optional :author_email, type: String, desc: 'The email of the author' optional :author_name, type: String, desc: 'The name of the author' end params :extended_file_params do use :simple_file_params requires :content, type: String, desc: 'File content' optional :encoding, type: String, values: %w[base64], desc: 'File encoding' end end params do requires :id, type: String, desc: 'The project ID' end resource :projects do desc 'Get a file from repository' params do requires :file_path, type: String, desc: 'The path to the file. Ex. lib/class.rb' requires :ref, type: String, desc: 'The name of branch, tag, or commit' end get ":id/repository/files" do authorize! :download_code, user_project commit = user_project.commit(params[:ref]) not_found!('Commit') unless commit repo = user_project.repository blob = repo.blob_at(commit.sha, params[:file_path]) not_found!('File') unless blob blob.load_all_data!(repo) status(200) { file_name: blob.name, file_path: blob.path, size: blob.size, encoding: "base64", content: Base64.strict_encode64(blob.data), ref: params[:ref], blob_id: blob.id, commit_id: commit.id, last_commit_id: repo.last_commit_id_for_path(commit.sha, params[:file_path]) } end desc 'Create new file in repository' params do use :extended_file_params end post ":id/repository/files" do authorize! :push_code, user_project file_params = declared_params(include_missing: false) file_params[:branch] = file_params.delete(:branch_name) result = ::Files::CreateService.new(user_project, current_user, commit_params(file_params)).execute if result[:status] == :success status(201) commit_response(file_params) else render_api_error!(result[:message], 400) end end desc 'Update existing file in repository' params do use :extended_file_params end put ":id/repository/files" do authorize! :push_code, user_project file_params = declared_params(include_missing: false) file_params[:branch] = file_params.delete(:branch_name) result = ::Files::UpdateService.new(user_project, current_user, commit_params(file_params)).execute if result[:status] == :success status(200) commit_response(file_params) else http_status = result[:http_status] || 400 render_api_error!(result[:message], http_status) end end desc 'Delete an existing file in repository' params do use :simple_file_params end delete ":id/repository/files" do authorize! :push_code, user_project file_params = declared_params(include_missing: false) file_params[:branch] = file_params.delete(:branch_name) result = ::Files::DestroyService.new(user_project, current_user, commit_params(file_params)).execute if result[:status] == :success status(200) commit_response(file_params) else render_api_error!(result[:message], 400) end end end end end end