Metadata-Version: 1.0
Name: zopyx.plone.persistentlogger
Version: 0.1.4
Summary: Persistent logging for Plone objects
Home-page: http://pypi.python.org/pypi/zopyx.plone.persistentlogger
Author: Andreas Jung
Author-email: info@zopyx.com
License: GPL
Description: zopyx.plone.persistentlogger
        ============================
        
        ``zopyx.plone.persistentlogger`` supports persistent logging where
        the log data is stored on an arbitrary persistent Plone object.
        Typical usecases are application specific logging e.g. for logging 
        a history per content object directly in Plone rather then having
        a huge common log on the filesystem. The log entries are stored
        using object annotations.
        
        Usage::
        
            from zopyx.plone.persistentlogger import IPersistentLogger
        
            def do_something(...):
        
                # ``context`` represents the current context object
                
                adapter = IPersistentLogger(context)
                adapter.log(u'this is a logging message')
                adapter.log(u'this is an error message', level='error')
                adapter.log(u'this is an error message', level='error', details='....')
        
        ``details`` can be either a string or a Python datastructure like a dict, a
        list or a tuple. The logger will convert non-string data using the ``pprint``
        module of Python into a nicely readable string.
        
        The logs can be view through-the-web through the URL http://host/path/to/object/@@persistent-log .
        The logs can be clear using the URL http://host/path/to/object/@@persistent-log-clear.
        Both URLs require the permission of modify the related object.
        
        All logs can be searched, sorted and filtered individually based on the Datatables.net
        implementation.
        
        Repository
        ----------
        
        - https://github.com/zopyx/zopyx.plone.persistentlogger
        
        .. image:: https://travis-ci.org/zopyx/zopyx.plone.persistentlogger.svg?branch=master
        
        
        Author
        ------
        | Andreas Jung/ZOPYX
        | Hundskapfklinge 33
        | D-72074 Tuebingen, Germany
        | info@zopyx.com
        | www.zopyx.com
        
        Changelog
        =========
        
        0.1.0 (2015-08-31)
        ------------------
        
        - initial release
        
        
Keywords: Plone Logging
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.3
Classifier: Framework :: Zope2
Classifier: Topic :: Software Development :: Libraries :: Python Modules
