From 1768ddfbc0750aa0239e23b6fe4fd158b0ef07a1 Mon Sep 17 00:00:00 2001
From: helmutm <helmutm@fd906abe-77d9-0310-91a1-e0d9ade77398>
Date: Wed, 3 Nov 2010 13:18:29 +0000
Subject: [PATCH] work in progress: add media manager and media (attachment)
 functionality

git-svn-id: svn://svn.cy55.de/Zope3/src/cybertools/trunk@4057 fd906abe-77d9-0310-91a1-e0d9ade77398
---
 wiki/README.txt     | 11 ++++++
 wiki/base/config.py |  1 +
 wiki/base/media.py  | 86 +++++++++++++++++++++++++++++++++++++++++++++
 wiki/interfaces.py  |  4 +--
 wiki/tests.py       |  2 ++
 5 files changed, 102 insertions(+), 2 deletions(-)
 create mode 100644 wiki/base/media.py

diff --git a/wiki/README.txt b/wiki/README.txt
index 4432ef9..a1ff657 100644
--- a/wiki/README.txt
+++ b/wiki/README.txt
@@ -163,3 +163,14 @@ created.
 Media Objects
 =============
 
+  >>> from cybertools.wiki.interfaces import IMediaManager
+  >>> mmName = manager.getConfig('mediaManager')
+  >>> mm = component.getAdapter(wiki, IMediaManager, name=mmName)
+
+  >>> media01 = mm.createObject('media01', 'Media Object #1')
+  >>> media01.setRawData('Some data we don\'t care about...')
+  >>> media01.getRawData()
+  "Some data..."
+
+  >>> [(obj.name, obj.title) for obj in mm.listObjects()]
+  [('media01', 'Media Object #1')]
diff --git a/wiki/base/config.py b/wiki/base/config.py
index e2d87a8..a3e1c22 100644
--- a/wiki/base/config.py
+++ b/wiki/base/config.py
@@ -95,4 +95,5 @@ class WikiConfiguration(BaseConfiguration):
                     writer='docutils.html',
                     linkManager='basic',
                     nodeProcessors=dict(reference=['default']),
+                    mediaManager='default',
     )
diff --git a/wiki/base/media.py b/wiki/base/media.py
new file mode 100644
index 0000000..e6ee88d
--- /dev/null
+++ b/wiki/base/media.py
@@ -0,0 +1,86 @@
+#
+#  Copyright (c) 2010 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) implementation for a wiki media manager and media objects.
+
+$Id$
+"""
+
+from zope.component import adapts
+from zope.interface import implements
+from cybertools.wiki.interfaces import IWiki, IMediaManager, IMediaObject
+
+
+class WikiMediaManager(object):
+    """ A Wiki adapter for providing media manager functionality. """
+
+    implements(IMediaManager)
+    adapts(IWiki)
+
+    name = '.media'
+    title = 'Wiki Media Manager'
+
+    def __init__(self, context):
+        self.context = context
+        objects = getattr(context, '_media', None)
+        if objects is None:
+            objects = context._media = {}
+        self.objects = objects
+
+    def getWiki(self):
+        return self.context
+
+    def createObject(self, name, title=None):
+        obj = MediaObject(name, title=title, parent=self.context)
+        self.objects[name] = obj
+        return obj
+
+    def removeObject(self, name):
+        del self.objects[name]
+
+    def getObject(self, name):
+        return self.objects.get(name)
+
+    def listObjects(self):
+        return self.objects.values()
+
+
+class MediaObject(object):
+    """ A basic (maybe persistent) media object. """
+
+    implements(IMediaObject)
+
+    data = None
+
+    def __init__(self, name, title=None, parent=None):
+        self.name = name
+        self.title = title or Name
+        self.parent = parent
+
+    def getManager(self):
+        if self.parent is None:
+            return None
+        mmName = self.parent.getConfig('mediaManager')
+        return component.getAdapter(self.parent, IMediaManager, name=mmName)
+
+    def getRawData(self):
+        return self.data
+
+    def setRawData(self, data):
+        self.data = data
diff --git a/wiki/interfaces.py b/wiki/interfaces.py
index 14ce927..f03027f 100644
--- a/wiki/interfaces.py
+++ b/wiki/interfaces.py
@@ -150,7 +150,7 @@ class IWikiPage(IWebResource, IIntIdProvider):
     """
 
     name = Attribute('A page name or address unique within the wiki.')
-    title = Attribute('A short string describing the wiki page the may be '
+    title = Attribute('A short string describing the wiki page that may be '
                 'use as a page title.')
     text = Attribute('The page content in input text format.')
 
@@ -330,7 +330,7 @@ class IMediaManager(Interface):
     """
 
     name = Attribute('A page name or address unique within the wiki.')
-    title = Attribute('A short string describing the wiki page the may be '
+    title = Attribute('A short string describing the object that may be '
                 'use as a page title.')
 
     def getWiki():
diff --git a/wiki/tests.py b/wiki/tests.py
index 5910464..0218797 100755
--- a/wiki/tests.py
+++ b/wiki/tests.py
@@ -16,6 +16,7 @@ from zope.traversing.browser.interfaces import IAbsoluteURL
 
 from cybertools.relation.tests import IntIdsStub
 from cybertools.wiki.base.config import WikiConfiguration
+from cybertools.wiki.base.media import WikiMediaManager
 from cybertools.link.base import LinkManager
 from cybertools.link.interfaces import ILinkManager
 from cybertools.wiki.dcu.html import Writer as DocutilsHTMLWriter
@@ -61,6 +62,7 @@ def setUp(testCase):
     component.provideAdapter(process.Reference, name='default')
     component.provideUtility(LinkManager(), provides=ILinkManager,
                              name='cybertools.link')
+    component.provideAdapter(WikiMediaManager, name='default')
     from cybertools.wiki.generic import adapter
     adapter.IntIds = IntIdsStub