Metadata-Version: 1.0
Name: five.grok
Version: 1.1.2
Summary: Grok-like layer for Zope 2
Home-page: http://svn.zope.org/five.grok/
Author: Lennart Regebro, Godefroid Chapelle
Author-email: grok-dev@zope.org
License: ZPL
Description: five.grok
        =========
        
        .. contents::
        
        Introduction
        ------------
        
        `five.grok` is a development layer for Zope 2, based on Grok framework
        concepts.
        
        The development techniques are similar to the ones used with Grok
        framework.
        
        It is based on `grokcore` namespace packages that were factored out of Grok
        framework.
        
        Implemented features
        --------------------
        
        Coming from Grok, the following components are available to Zope 2
        developers:
        
        - Zope 3 Component (Adapter, Global utilities, Subscribers),
        
        - Permissions,
        
        - Views and Viewlets,
        
        - Skins and resources directories,
        
        - Page Templates (using the Zope 2 Page Templates),
        
        - Formlib forms,
        
        - Local sites and local utilities,
        
        - Annotations.
        
        All those components are available with exactly the same syntax than
        in grok. You just have to do::
        
          from five import grok
        
        Instead of::
        
          import grok
        
        Installation
        ------------
        
        After adding the dependency to ``five.grok`` in your project, you have
        to load the following ZCML::
        
          <include package="five.grok" />
        
        Note
        ~~~~
        
        And for this release we recommend to pin down the following version in
        your buildout::
        
          grokcore.annotation = 1.2
          grokcore.component = 1.8
          grokcore.formlib = 1.5
          grokcore.security = 1.4
          grokcore.site = 1.2
          grokcore.view = 1.12.2
          grokcore.viewlet = 1.4.1
          five.localsitemanager = 2.0.3
          martian = 0.11.2
        
        Zope 2.12 is required. If you wish to use a previous version of Zope
        2, look at the version 1.0 of five.grok.
        
        
        More information
        ----------------
        
        You can refer to the Grok website: http://grok.zope.org/, and the Grok
        documentation: http://grok.zope.org/documentation/.
        
        You can check the doctest included in sources as well.
        
        Changelog
        =========
        
        1.1.2 (2010-08-04)
        ------------------
        
        - Fixed problem with unrestrictedTraverse() and files in subfolders of grokked
          resource directories. This fix also depends on fixes in Zope 2.12.6 or
          later.
          [optilude]
        
        1.1.1 (2010-02-04)
        ------------------
        
        - Fix namespace override in ZopeTwoPageTemplate, i.e. let users
          override 'view' for instance using the namespace method of a Grok
          view class. This bug was introduced in the 1.1 release.
          [thefunny42]
        
        
        1.1 (2009-11-16)
        ----------------
        
        - Update code and tests to work with Zope 2.12. People using Zope 2.10
          and 2.11 should keep using five.grok 1.0.
          [thefunny42 and optilude]
        
        - Update to martian 0.11.1, `grokcore.annotation`_ 1.1 and
          `grokcore.site`_ 1.1, `grokcore.view`_ to 1.12.2.
          [vincentfretin]
        
        - Local utility implements IAttributeAnnotatable, IContext like in
          `grokcore.site`_.
          [thefunny42]
        
        
        1.0 (2009-09-17)
        ----------------
        
        - Define an IFiveGrokAPI.
          [thefunny42]
        
        - Fix the broken ``url`` method on views.
          [thefunny42]
        
        - Reverted the CodeView base class, see grokcore.view changelog for
          more details.
          ``CodeView`` is still available as a backwards compatibility alias
          for ``View``. Please update all references to ``CodeView`` to
          ``View``.
          [vincentfretin]
        
        
        1.0b2 (2009-07-21)
        ------------------
        
        - Added dependency on grokcore.view 1.9, grokcore.viewlet 1.1 and
          grokcore.formlib 1.2, and support for the new CodeView from grokcore.View.
          [optilude]
        
        
        1.0b1 (2009-06-30)
        ------------------
        
        - Added support for annotations with `grokcore.annotation`_.
          [thefunny42]
        
        - Added support for local site and utilities with `grokcore.site`_.
          [thefunny42]
        
        - Fix grok.EditForm when used with grokcore.formlib 1.1.
          The Apply action was gone.
          [thefunny42]
        
        - Let static resource directories allow access to unprotected subattributes
          to avoid authorisation problems when accessing them from protected code.
          [optilude]
        
        - Do not create static resource directories if the 'static' directory does
          not actually exist.
          [optilude]
        
        
        1.0a2 (2008-11-23)
        ------------------
        
        - Added support for viewlets with `grokcore.viewlet`_.
          [thefunny42]
        
        - Added support for the DirectoryResource component (new in
          `grokcore.view`_ 1.2).
          [thefunny42]
        
        - Added support for using Zope 2 templates by default when doing ``from
          five import grok`` and using grok.PageTemplateFile (being consistent
          with grok.PageTemplate).
          [thefunny42]
        
        - Added a convenient grok.Container.
          [thefunny42]
        
        - Fix AutoFields (and form grokker) not to include OFS Zope 2 defined
          fields by default. This use to add a lot of buggy and wanted
          fields.
          [thefunny42]
        
        
        1.0a1 (2008-10-22)
        ------------------
        
        - Added support for formlib forms with `grokcore.formlib`_.
          [thefunny42]
        
        - Added support for static resource directory.
          [thefunny42]
        
        - Added support for inline templates and made Zope 2 template semantics
          the default when doing ``from five import grok`` and using
          grok.PageTemplate.
          [optilude]
        
        - Added override to make templates use Five's ViewPageTemplateFile instead
          of the one from zope.app.pagetemplate.
          [optilude]
        
        - Added `grokcore.view`_ support with tests.
          [regebro, jfroche, gotcha et al.]
        
        - Added tests for grok.subscriber directive.
          [kamon]
        
        - Initial release (tests for adapters and utilities, initial support for
          views).
          [regebro, gotcha]
        
        .. _grokcore.annotation: http://pypi.python.org/pypi/grokcore.annotation
        .. _grokcore.site: http://pypi.python.org/pypi/grokcore.site
        .. _grokcore.view: http://pypi.python.org/pypi/grokcore.view
        .. _grokcore.viewlet: http://pypi.python.org/pypi/grokcore.viewlet
        .. _grokcore.formlib: http://pypi.python.org/pypi/grokcore.formlib
        
Keywords: zope2 grok
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Framework :: Zope2
