Metadata-Version: 1.0
Name: gocept.sequence
Version: 0.31
Summary: Generates a sequence
Home-page: http://pypi.python.org/pypi/gocept.sequence/
Author: Daniel Havlik, Sebastian Wehrmann
Author-email: dh@gocept.com
License: ZPL 2.1
Description: This package lets you generate a persistent sequence. That means in practice,
        that you can generate sequent numbers without having to worry about storing
        the last generated number. This is done by gocept.sequence within the
        annotation of an object you provide.
        
        
        ===============
        gocept.sequence
        ===============
        
        Sequences
        =========
        
        >>> import Persistence
        >>> import zope.annotation.interfaces
        >>> from zope.interface import implements
        
        
        We need a testobject, where the SequenceGenerator stores his data:
        
        >>> class Dummy(Persistence.Persistent):
        ...     implements(zope.annotation.interfaces.IAttributeAnnotatable)
        
        >>> test_object = zope.annotation.interfaces.IAnnotations(Dummy())
        
        
        You get a SequenceGenerator by adapting to ISequenceGenerator:
        
        >>> from gocept.sequence.interfaces import ISequenceGenerator
        >>> seq_gen = ISequenceGenerator(test_object)
        
        
        You get a sequence like this:
        
        >>> seq_gen.getNextValue()
        1
        >>> seq_gen.getNextValue()
        2
        >>> seq_gen.getNextValue()
        3
        
        
        You can also set the generator to a value:
        
        >>> seq_gen.setNextValue(1)
        >>> seq_gen.getNextValue()
        1
        
        >>> seq_gen.setNextValue(5)
        >>> seq_gen.getNextValue()
        5
        >>> seq_gen.getNextValue()
        6
        >>> seq_gen.getNextValue()
        7
        >>> seq_gen.getNextValue()
        8
        
        
        But setNextValue only accepts integer arguments:
        
        >>> seq_gen.setNextValue('1')
        Traceback (most recent call last):
        ...
        ValueError: setNextValue expected Integer, <type 'str'> found.
        
        >>> seq_gen.setNextValue(3.14)
        Traceback (most recent call last):
        ...
        ValueError: setNextValue expected Integer, <type 'float'> found.
        
        
        Changes
        =======
        
        
        0.4 (unreleased)
        ----------------
        
        
        0.31 (2008-07-21)
        ----------------
        
        - added migration code and tests for the bugfix of release 0.3
        - added README text and CHANGELOG
        
        
        0.3 (2008-07-21)
        ----------------
        
        - fixed a bug with Plone, where the dot in the annotation key caused an access
        error
        - improved readability of test cases
        
        0.1
        ---
        
        - initial release
        
Keywords: sequence generator
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: WWW/HTTP
