# # Copyright (c) 2009 Helmut Merz helmutm@cy55.de # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # """ Basic (sample) implementations for links and link management. $Id$ """ from docutils.nodes import Text from zope.interface import implements from zope.traversing.browser import absoluteURL from cybertools.wiki.interfaces import ILink, ILinkManager, ILinkProcessor class LinkManager(object): """ A very basic link manager implementation. """ implements(ILinkManager) def __init__(self): self.links = {} self.linksBySource = {} def createLink(self, name, source, target, **kw): link = Link(name, source, target, **kw) link.manager = self id = self.generateLinkIdentifier(link) self.links[id] = link self.linksBySource.setdefault(source, []).append(link) return link def removeLink(self, link): if link.identifier in self.links: link.manager = None del self.links[link.identifier] def getLink(self, name): result = self.query(name=name) if result: return result[0] def query(self, source=None, target=None, name=None, **kw): if source is None: result = self.links.values() else: result = self.linksBySource.get(source, []) kw.update(dict(target=target, name=name)) for k, v in kw.items(): if v is None: continue if not isinstance(v, (list, tuple)): v = [v] result = [r for r in result if getattr(r, k) in v] return result def generateLinkIdentifier(self, link): identifier = '%07i' % (max([int(k) for k in self.links.keys()] or [0]) + 1) link.identifier = identifier return identifier class Link(object): implements(ILink) identifier = None manager = None def __init__(self, name, source, target, **kw): self.name = name self.source = source self.target = target for k, v in kw.items(): if k not in ILink: raise AttributeError(k) setattr(self, k, v) def getManager(self): return self.manager def __getattr__(self, attr): if attr not in ILink: raise AttributeError(attr) return self.__dict__.get(attr) class LinkProcessor(object): """ Abstract base class. """ implements(ILinkProcessor) source = request = None targetName = '' def __init__(self, context): self.context = context def process(self): if '..' in self.targetName: return wiki = self.source.getWiki() manager = wiki.getManager() sourceUid = self.source.getUid() lmName = self.source.getConfig('linkManager') lm = manager.getPlugin(ILinkManager, lmName) targetPageName = self.targetName params = fragment = '' if '?' in targetPageName: targetPageName, params = targetPageName.split('?', 1) if '#' in targetPageName: targetPageName, fragment = targetPageName.split('#', 1) existing = iter(lm.query(source=sourceUid, name=self.targetName)) if existing: link = existing.next() if link.target is not None: target = manager.getObject(link.target) else: target = None else: target = wiki.getPage(targetPageName) targetUid = target is not None and target.getUid() or None link = lm.createLink(self.targetName, sourceUid, targetUid) #if link.refuri is None: if fragment: link.targetFragment = fragment if params: link.targetParameters = params if self.request is not None: if target is None: #uri = link.refuri = '%s/create.html?name=%s' % ( uri = '%s/create.html?name=%s' % ( absoluteURL(wiki, self.request), link.name) else: #uri = link.refuri = target.getURI(self.request) uri = target.getURI(self.request) uri += self.fragmentAndParams(fragment, params) #else: # uri = link.refuri + self.fragmentAndParams( # link.targetFragment, # link.targetParameters) self.setURI(uri) if target is None: self.markPresentation('create') self.addText('?') def fragmentAndParams(self, fragment, params): f = p = '' if fragment: f = '#' + fragment if params: p = '?' + params return f + p def setURI(self, uri): raise ValueError('To be implemented by subclass.') def markPresentation(self, feature): raise ValueError('To be implemented by subclass.') def addText(self, text): raise ValueError('To be implemented by subclass.')