[Erp5-report] r29815 - /erp5/trunk/products/ERP5/interfaces/cached_convertable.py
nobody at svn.erp5.org
nobody at svn.erp5.org
Mon Oct 19 19:32:23 CEST 2009
Author: jp
Date: Mon Oct 19 19:32:22 2009
New Revision: 29815
URL: http://svn.erp5.org?rev=29815&view=rev
Log:
Initial upload
Added:
erp5/trunk/products/ERP5/interfaces/cached_convertable.py
Added: erp5/trunk/products/ERP5/interfaces/cached_convertable.py
URL: http://svn.erp5.org/erp5/trunk/products/ERP5/interfaces/cached_convertable.py?rev=29815&view=auto
==============================================================================
--- erp5/trunk/products/ERP5/interfaces/cached_convertable.py (added)
+++ erp5/trunk/products/ERP5/interfaces/cached_convertable.py [utf8] Mon Oct 19 19:32:22 2009
@@ -1,0 +1,102 @@
+# -*- coding: utf-8 -*-
+##############################################################################
+#
+# Copyright (c) 2009 Nexedi SA and Contributors. All Rights Reserved.
+# Jean-Paul Smets-Solanes <jp at nexedi.com>
+#
+# WARNING: This program as such is intended to be used by professional
+# programmers who take the whole responsability of assessing all potential
+# consequences resulting from its eventual inadequacies and bugs
+# End users who are looking for a ready-to-use solution with commercial
+# garantees and support are strongly adviced to contract a Free Software
+# Service Company
+#
+# 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.
+#
+##############################################################################
+
+from zope.interface import Interface
+
+class ICachedConvertable(Interface):
+ """
+ Cached Convertable interface specification
+
+ The conversion of documents which implement the ICachedConvertable
+ interface can be cached efficiently and querried.
+ """
+
+ def hasConversion(**kw):
+ """
+ Return True if the conversion is already cache, False else.
+
+ **kw -- conversion parameters
+ """
+
+ def setConversion(data, mime=None, date=None, **kw):
+ """
+ Saves in the cache the converted data and mime type of a document,
+ and records the date of conversion.
+
+ data -- the converted data (string or PData)
+
+ mime -- the mime type of the converted data (string)
+
+ date -- conversion date
+
+ **kw -- conversion parameters
+ """
+
+ def getConversion(**kw):
+ """
+ Returns the converted mime type and data of a document if any,
+ otherwise, raises an KeyError exception. mime type is a string.
+ data is either or PData instance (preferred) or a string.
+
+ **kw -- conversion parameters
+ """
+
+ def getConversionSize(**kw):
+ """
+ Returns the size (in bytes) of the converted document if any,
+ otherwise, raises an KeyError exception.
+
+ **kw -- conversion parameters
+ """
+
+ def getConversionDate(**kw):
+ """
+ Returns the date of conversion of the document if any,
+ otherwise, raises an KeyError exception.
+
+ **kw -- conversion parameters
+ """
+
+ def getConversionMd5(**kw):
+ """
+ Returns the MD5 hash of the converted document if any,
+ otherwise, raises an KeyError exception.
+
+ **kw -- conversion parameters
+ """
+
+ def clearConversionCache():
+ """
+ Clear the conversion cache for the current document.
+
+ NOTE: clearing conversion cache should be implemented
+ also with non-clearable caching systems, for example
+ by automatically adding the revision number to the
+ conversion keys.
+ """
More information about the Erp5-report
mailing list