327 lines
9.7 KiB
Python
327 lines
9.7 KiB
Python
import os
|
|
import posixpath
|
|
import re
|
|
import ghdiff
|
|
import yaml
|
|
from dulwich.object_store import tree_lookup_path
|
|
from dulwich.repo import Repo, NotGitRepository
|
|
from realms.lib.util import cname_to_filename, filename_to_cname
|
|
from realms import cache
|
|
from realms.lib.hook import HookMixin
|
|
|
|
|
|
class PageNotFound(Exception):
|
|
pass
|
|
|
|
|
|
class Wiki(HookMixin):
|
|
path = None
|
|
base_path = '/'
|
|
default_ref = 'master'
|
|
default_committer_name = 'Anon'
|
|
default_committer_email = 'anon@anon.anon'
|
|
index_page = 'home'
|
|
repo = None
|
|
|
|
def __init__(self, path):
|
|
try:
|
|
self.repo = Repo(path)
|
|
except NotGitRepository:
|
|
self.repo = Repo.init(path, mkdir=True)
|
|
|
|
self.path = path
|
|
|
|
def __repr__(self):
|
|
return "Wiki: %s" % self.path
|
|
|
|
def commit(self, name, email, message, files):
|
|
"""Commit to the underlying git repo.
|
|
|
|
:param name: Committer name
|
|
:param email: Committer email
|
|
:param message: Commit message
|
|
:param files: list of file names that will be staged for commit
|
|
:return:
|
|
"""
|
|
if isinstance(name, unicode):
|
|
name = name.encode('utf-8')
|
|
if isinstance(email, unicode):
|
|
email = email.encode('utf-8')
|
|
if isinstance(message, unicode):
|
|
message = message.encode('utf-8')
|
|
author = committer = "%s <%s>" % (name, email)
|
|
self.repo.stage(files)
|
|
return self.repo.do_commit(message=message,
|
|
committer=committer,
|
|
author=author)
|
|
|
|
def get_page(self, name, sha='HEAD'):
|
|
"""Get page data, partials, commit info.
|
|
|
|
:param name: Name of page.
|
|
:param sha: Commit sha.
|
|
:return: dict
|
|
|
|
"""
|
|
return WikiPage(name, self, sha=sha)
|
|
|
|
def get_index(self):
|
|
"""Get repo index of head.
|
|
|
|
:return: list -- List of dicts
|
|
|
|
"""
|
|
rv = []
|
|
index = self.repo.open_index()
|
|
for name in index:
|
|
rv.append(dict(name=filename_to_cname(name),
|
|
filename=name,
|
|
ctime=index[name].ctime[0],
|
|
mtime=index[name].mtime[0],
|
|
sha=index[name].sha,
|
|
size=index[name].size))
|
|
|
|
return rv
|
|
|
|
|
|
class WikiPage(HookMixin):
|
|
def __init__(self, name, wiki, sha='HEAD'):
|
|
self.name = name
|
|
self.filename = cname_to_filename(name)
|
|
self.sha = sha.encode('latin-1')
|
|
self.wiki = wiki
|
|
|
|
@property
|
|
def data(self):
|
|
cache_key = self._cache_key('data')
|
|
cached = cache.get(cache_key)
|
|
if cached:
|
|
return cached
|
|
|
|
mode, sha = tree_lookup_path(self.wiki.repo.get_object, self.wiki.repo[self.sha].tree, self.filename)
|
|
data = self.wiki.repo[sha].data
|
|
cache.set(cache_key, data)
|
|
return data
|
|
|
|
@property
|
|
def info(self):
|
|
cache_key = self._cache_key('info')
|
|
cached = cache.get(cache_key)
|
|
if cached:
|
|
return cached
|
|
|
|
info = self.get_history(limit=1)[0]
|
|
cache.set(cache_key, info)
|
|
return info
|
|
|
|
def get_history(self, limit=100):
|
|
"""Get page history.
|
|
|
|
:param limit: Limit history size.
|
|
:return: list -- List of dicts
|
|
|
|
"""
|
|
versions = []
|
|
|
|
try:
|
|
walker = self.wiki.repo.get_walker(paths=[self.filename], max_entries=limit, follow=True)
|
|
except KeyError:
|
|
# We don't have a head, no commits
|
|
return []
|
|
|
|
for entry in walker:
|
|
change_type = None
|
|
for change in entry.changes():
|
|
# Changes should already be filtered to only the one affecting our file
|
|
change_type = change.type
|
|
break
|
|
author_name, author_email = entry.commit.author.rstrip('>').split('<')
|
|
versions.append(dict(
|
|
author=author_name.strip(),
|
|
author_email=author_email,
|
|
time=entry.commit.author_time,
|
|
message=entry.commit.message,
|
|
sha=entry.commit.id,
|
|
type=change_type))
|
|
|
|
return versions
|
|
|
|
@property
|
|
def partials(self):
|
|
data = self.data
|
|
if not data:
|
|
return {}
|
|
partials = {}
|
|
meta = self._get_meta(data)
|
|
if meta and 'import' in meta:
|
|
for partial_name in meta['import']:
|
|
partials[partial_name] = self.wiki.get_page(partial_name, sha=self.sha)
|
|
return partials
|
|
|
|
@staticmethod
|
|
def _get_meta(content):
|
|
"""Get metadata from page if any.
|
|
|
|
:param content: Page content
|
|
:return: dict
|
|
|
|
"""
|
|
if not content.startswith("---"):
|
|
return None
|
|
|
|
meta_end = re.search("\n(\.{3}|\-{3})", content)
|
|
|
|
if not meta_end:
|
|
return None
|
|
|
|
try:
|
|
return yaml.safe_load(content[0:meta_end.start()])
|
|
except Exception as e:
|
|
return {'error': e.message}
|
|
|
|
def _cache_key(self, property):
|
|
return 'page/{0}[{1}].{2}'.format(self.name, self.sha, property)
|
|
|
|
def _get_user(self, username, email):
|
|
if not username:
|
|
username = self.wiki.default_committer_name
|
|
|
|
if not email:
|
|
email = self.wiki.default_committer_email
|
|
|
|
return username, email
|
|
|
|
def _clear_cache(self):
|
|
cache.delete_many(*(self._cache_key(p) for p in ['data', 'info']))
|
|
|
|
def delete(self, username=None, email=None, message=None):
|
|
"""Delete page.
|
|
:param username: Committer name
|
|
:param email: Committer email
|
|
:return: str -- Commit sha1
|
|
|
|
"""
|
|
username, email = self._get_user(username, email)
|
|
|
|
if not message:
|
|
message = "Deleted %s" % self.name
|
|
|
|
os.remove(os.path.join(self.wiki.path, self.filename))
|
|
commit = self.wiki.commit(name=username,
|
|
email=email,
|
|
message=message,
|
|
files=[self.filename])
|
|
self._clear_cache()
|
|
return commit
|
|
|
|
def rename(self, new_name, username=None, email=None, message=None):
|
|
"""Rename page.
|
|
|
|
:param new_name: New name of page.
|
|
:param username: Committer name
|
|
:param email: Committer email
|
|
:return: str -- Commit sha1
|
|
|
|
"""
|
|
assert self.sha == 'HEAD'
|
|
old_filename, new_filename = self.filename, cname_to_filename(new_name)
|
|
if old_filename not in self.wiki.repo.open_index():
|
|
# old doesn't exist
|
|
return None
|
|
elif old_filename == new_filename:
|
|
return None
|
|
else:
|
|
# file is being overwritten, but that is ok, it's git!
|
|
pass
|
|
|
|
username, email = self._get_user(username, email)
|
|
|
|
if not message:
|
|
message = "Moved %s to %s" % (self.name, new_name)
|
|
|
|
os.rename(os.path.join(self.wiki.path, old_filename), os.path.join(self.wiki.path, new_filename))
|
|
commit = self.wiki.commit(name=username,
|
|
email=email,
|
|
message=message,
|
|
files=[old_filename, new_filename])
|
|
|
|
self._clear_cache()
|
|
self.name = new_name
|
|
self.filename = new_filename
|
|
# We need to clear the cache for the new name as well as the old
|
|
self._clear_cache()
|
|
|
|
return commit
|
|
|
|
def write(self, content, message=None, username=None, email=None):
|
|
"""Write page to git repo
|
|
|
|
:param content: Content of page.
|
|
:param message: Commit message.
|
|
:param username: Commit Name.
|
|
:param email: Commit Email.
|
|
:return: Git commit sha1.
|
|
"""
|
|
assert self.sha == 'HEAD'
|
|
dirname = posixpath.join(self.wiki.path, posixpath.dirname(self.filename))
|
|
|
|
if not os.path.exists(dirname):
|
|
os.makedirs(dirname)
|
|
|
|
with open(self.wiki.path + "/" + self.filename, 'w') as f:
|
|
f.write(content)
|
|
|
|
if not message:
|
|
message = "Updated %s" % self.name
|
|
|
|
username, email = self._get_user(username, email)
|
|
|
|
ret = self.wiki.commit(name=username,
|
|
email=email,
|
|
message=message,
|
|
files=[self.filename])
|
|
|
|
self._clear_cache()
|
|
return ret
|
|
|
|
def revert(self, commit_sha, message, username, email):
|
|
"""Revert page to passed commit sha1
|
|
|
|
:param commit_sha: Commit Sha1 to revert to.
|
|
:param message: Commit message.
|
|
:param username: Committer name.
|
|
:param email: Committer email.
|
|
:return: Git commit sha1
|
|
|
|
"""
|
|
assert self.sha == 'HEAD'
|
|
new_page = self.wiki.get_page(self.name, commit_sha)
|
|
if not new_page:
|
|
raise PageNotFound('Commit not found')
|
|
|
|
if not message:
|
|
message = "Revert '%s' to %s" % (self.name, commit_sha[:7])
|
|
|
|
return self.write(new_page.data, message=message, username=username, email=email)
|
|
|
|
def compare(self, old_sha):
|
|
"""Compare two revisions of the same page.
|
|
|
|
:param old_sha: Older sha.
|
|
:return: str - Raw markup with styles
|
|
|
|
"""
|
|
|
|
# TODO: This could be effectively done in the browser
|
|
old = self.wiki.get_page(self.name, sha=old_sha)
|
|
return ghdiff.diff(old.data, self.data)
|
|
|
|
def __nonzero__(self):
|
|
# Verify this file is in the tree for the given commit sha
|
|
try:
|
|
tree_lookup_path(self.wiki.repo.get_object, self.wiki.repo[self.sha].tree, self.filename)
|
|
except KeyError:
|
|
# We'll get a KeyError if self.sha isn't in the repo, or if self.filename isn't in the tree of our commit
|
|
return False
|
|
return True
|