gitlab-org--gitlab-foss/app/models/project_wiki.rb

194 lines
4.3 KiB
Ruby
Raw Normal View History

class ProjectWiki
include Gitlab::ShellAdapter
MARKUPS = {
2016-02-28 07:11:43 -05:00
'Markdown' => :markdown,
'RDoc' => :rdoc,
'AsciiDoc' => :asciidoc
2017-02-21 18:32:18 -05:00
}.freeze unless defined?(MARKUPS)
CouldNotCreateWikiError = Class.new(StandardError)
# Returns a string describing what went wrong after
# an operation fails.
attr_reader :error_message
2016-01-22 04:24:38 -05:00
attr_reader :project
def initialize(project, user = nil)
@project = project
@user = user
end
2017-02-22 17:35:08 -05:00
delegate :empty?, to: :pages
delegate :repository_storage_path, to: :project
def path
@project.path + '.wiki'
end
def path_with_namespace
@project.path_with_namespace + ".wiki"
end
def web_url
Gitlab::Routing.url_helpers.project_wiki_url(@project, :home)
end
def url_to_repo
gitlab_shell.url_to_repo(path_with_namespace)
end
def ssh_url_to_repo
url_to_repo
end
def http_url_to_repo
"#{Gitlab.config.gitlab.url}/#{path_with_namespace}.git"
end
def wiki_base_path
[Gitlab.config.gitlab.relative_url_root, "/", @project.path_with_namespace, "/wikis"].join('')
end
# Returns the Gollum::Wiki object.
def wiki
@wiki ||= begin
Gollum::Wiki.new(path_to_repo)
2016-02-28 07:11:43 -05:00
rescue Rugged::OSError
create_repo!
end
end
2016-08-12 21:56:40 -04:00
def repository_exists?
!!repository.exists?
end
def has_home_page?
!!find_page('home')
end
2016-08-12 21:56:40 -04:00
# Returns an Array of Gitlab WikiPage instances or an
# empty Array if this Wiki has no pages.
def pages
wiki.pages.map { |page| WikiPage.new(self, page, true) }
end
# Finds a page within the repository based on a tile
# or slug.
#
# title - The human readable or parameterized title of
# the page.
#
# Returns an initialized WikiPage instance or nil
def find_page(title, version = nil)
2014-04-28 10:22:31 -04:00
page_title, page_dir = page_title_and_dir(title)
if page = wiki.page(page_title, version, page_dir)
WikiPage.new(self, page, true)
else
nil
end
end
def find_file(name, version = nil, try_on_disk = true)
version = wiki.ref if version.nil? # Gollum::Wiki#file ?
if wiki_file = wiki.file(name, version, try_on_disk)
wiki_file
else
nil
end
end
def create_page(title, content, format = :markdown, message = nil)
commit = commit_details(:created, message, title)
2016-02-28 07:11:43 -05:00
wiki.write_page(title, format.to_sym, content, commit)
update_project_activity
rescue Gollum::DuplicatePageError => e
@error_message = "Duplicate page: #{e.message}"
return false
end
def update_page(page, content, format = :markdown, message = nil)
commit = commit_details(:updated, message, page.title)
2016-02-28 07:11:43 -05:00
wiki.update_page(page, page.name, format.to_sym, content, commit)
update_project_activity
end
def delete_page(page, message = nil)
wiki.delete_page(page, commit_details(:deleted, message, page.title))
update_project_activity
end
2014-04-28 10:22:31 -04:00
def page_title_and_dir(title)
title_array = title.split("/")
2014-04-28 10:22:31 -04:00
title = title_array.pop
[title, title_array.join("/")]
2014-04-28 10:22:31 -04:00
end
def search_files(query)
2016-11-10 12:27:09 -05:00
repository.search_files_by_content(query, default_branch)
end
def repository
@repository ||= Repository.new(path_with_namespace, @project)
end
def default_branch
wiki.class.default_ref
end
def create_repo!
if init_repo(path_with_namespace)
wiki = Gollum::Wiki.new(path_to_repo)
else
raise CouldNotCreateWikiError
end
repository.after_create
wiki
end
2016-05-27 19:31:03 -04:00
2017-06-28 09:42:59 -04:00
def ensure_repository
create_repo! unless repository_exists?
end
def hook_attrs
{
web_url: web_url,
git_ssh_url: ssh_url_to_repo,
git_http_url: http_url_to_repo,
path_with_namespace: path_with_namespace,
2016-05-27 19:31:03 -04:00
default_branch: default_branch
}
end
private
def init_repo(path_with_namespace)
gitlab_shell.add_repository(project.repository_storage_path, path_with_namespace)
end
def commit_details(action, message = nil, title = nil)
commit_message = message || default_message(action, title)
{ email: @user.email, name: @user.name, message: commit_message }
end
def default_message(action, title)
"#{@user.username} #{action} page: #{title}"
end
def path_to_repo
@path_to_repo ||= File.join(project.repository_storage_path, "#{path_with_namespace}.git")
end
def update_project_activity
@project.touch(:last_activity_at, :last_repository_updated_at)
end
end