summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2008-11-09More docs.Chris McDonough
2008-11-09More docs.Chris McDonough
2008-11-08Get rid of BFGTestCase base class: use only functions.Chris McDonough
2008-11-08registerTemplate -> registerDummyTemplateChris McDonough
2008-11-08Add makeRequest API.Chris McDonough
Add minimal documentation of BFGTestCase.
2008-11-07 FeaturesChris McDonough
- Added a ``repoze.bfg.testing`` module to attempt to make it slightly easier to write unittest-based automated tests of BFG applications. Information about this class is in the documentation. - The default template renderer now supports testing better by looking for ``ITestingTemplateRenderer`` using a relative pathname. This is exposed indirectly through the API named ``registerTemplate`` in ``repoze.bfg.testing``. Deprecations - The names ``repoze.bfg.interfaces.ITemplate`` , ``repoze.bfg.interfaces.ITemplateFactory`` and ``repoze.bfg.interfaces.INodeTemplate`` have been deprecated. These should now be imported as ``repoze.bfg.interfaces.ITemplateRenderer`` and ``repoze.bfg.interfaces.ITemplateRendererFactory``, and ``INodeTemplateRenderer`` respectively. - The name ``repoze.bfg.chameleon_zpt.ZPTTemplateFactory`` is deprecated. Use ``repoze.bfg.chameleon_zpt.ZPTTemplateRenderer``. - The name ``repoze.bfg.chameleon_genshi.GenshiTemplateFactory`` is deprecated. Use ``repoze.bfg.chameleon_genshi.GenshiTemplateRenderer``. - The name ``repoze.bfg.xslt.XSLTemplateFactory`` is deprecated. Use ``repoze.bfg.xslt.XSLTemplateRenderer``.
2008-11-02Prep for 0.4.3.Chris McDonough
2008-11-02Prep for 0.4.2.Chris McDonough
2008-11-02 FeaturesChris McDonough
- The ``BFG_DEBUG_AUTHORIZATION`` envvar and the ``debug_authorization`` config file value now only imply debugging of view-invoked security checks. Previously, information was printed for every call to ``has_permission`` as well, which made output confusing. To debug ``has_permission`` checks and other manual permission checks, use the debugger and print statements in your own code. - Authorization debugging info is now only present in the HTTP response body oif ``debug_authorization`` is true. - The format of authorization debug messages was improved. - A new ``BFG_DEBUG_NOTFOUND`` envvar was added and a symmetric ``debug_notfound`` config file value was added. When either is true, and a NotFound response is returned by the BFG router (because a view could not be found), debugging information is printed to stderr. When this value is set true, the body of HTTPNotFound responses will also contain the same debugging information. - ``Allowed`` and ``Denied`` responses from the security machinery are now specialized into two types: ACL types, and non-ACL types. The ACL-related responses are instances of ``repoze.bfg.security.ACLAllowed`` and ``repoze.bfg.security.ACLDenied``. The non-ACL-related responses are ``repoze.bfg.security.Allowed`` and ``repoze.bfg.security.Denied``. The allowed-type responses continue to evaluate equal to things that themselves evaluate equal to the ``True`` boolean, while the denied-type responses continue to evaluate equal to things that themselves evaluate equal to the ``False`` boolean. The only difference between the two types is the information attached to them for debugging purposes. - Added a new ``BFG_DEBUG_ALL`` envvar and a symmetric ``debug_all`` config file value. When either is true, all other debug-related flags are set true unconditionally (e.g. ``debug_notfound`` and ``debug_authorization``). Documentation - Added info about debug flag changes. - Added a section to the security chapter named "Debugging Imperative Authorization Failures" (for e.g. ``has_permssion``).
2008-11-01 - Change default paster template generator to use ``Paste#http``Chris McDonough
server rather than ``PasteScript#cherrpy`` server. The cherrypy server has a security risk in it when ``REMOTE_USER`` is trusted by the downstream application.
2008-10-31Changes from jpcw.Chris McDonough
2008-10-28 - If the ``render_view_to_response`` function was called, if theChris McDonough
view was found and called, but it returned something that did not implement IResponse, the error would pass by unflagged. This was noticed when I created a view function that essentially returned None, but received a NotFound error rather than a ValueError when the view was rendered. This was fixed.
2008-10-22Fix link styling in navbar.Chris McDonough
2008-10-17Add repoze.org color scheme.Tres Seaver
2008-10-17Include logo in sphinx docs.Tres Seaver
2008-10-17Missing period in the self.__dict__Fernando Correa Neto
2008-10-15Workflow.Chris McDonough
2008-10-15wrong import in tutorials/cmf/catalogFernando Correa Neto
2008-10-13Adjustments.Chris McDonough
2008-10-03 Docs Chris McDonough
- An "Environment and Configuration" chapter was added to the narrative portion of the documentation. Features - Ensure bfg doesn't generate warnings when running under Python 2.6. - The environment variable ``BFG_RELOAD_TEMPLATES`` is now available (serves the same purpose as ``reload_templates`` in the config file). - A new configuration file option ``debug_authorization`` was added. This turns on printing of security authorization debug statements to ``sys.stderr``. The ``BFG_DEBUG_AUTHORIZATION`` environment variable was also added; this performs the same duty. Bug Fixes - The environment variable ``BFG_SECURITY_DEBUG`` did not always work. It has been renamed to ``BFG_DEBUG_AUTHORIZATION`` and fixed. Deprecations - A deprecation warning is now issued when old API names from the ``repoze.bfg.templates`` module are imported. Backwards incompatibilities - The ``BFG_SECURITY_DEBUG`` environment variable was renamed to ``BFG_DEBUG_AUTHORIZATION``.
2008-10-03Note Python 2.6 compat.Chris McDonough
2008-09-28(no commit message)Chris McDonough
2008-09-28Prep for 0.3.9 release.Chris McDonough
2008-09-28 FeaturesChris McDonough
- A ``repoze.bfg.location`` API module was added. Backwards incompatibilities - Applications must now use the ``repoze.bfg.interfaces.ILocation`` interface rather than ``zope.location.interfaces.ILocation`` to represent that a model object is "location-aware". We've removed a dependency on ``zope.location`` for cleanliness purposes: as new versions of zope libraries are released which have improved dependency information, getting rid of our dependence on ``zope.location`` will prevent a newly installed repoze.bfg application from requiring the ``zope.security``, egg, which not truly used at all in a "stock" repoze.bfg setup. These dependencies are still required by the stack at this time; this is purely a futureproofing move. The security and model documentation for previous versions of ``repoze.bfg`` recommended using the ``zope.location.interfaces.ILocation`` interface to represent that a model object is "location-aware". This documentation has been changed to reflect that this interface should now be imported from ``repoze.bfg.interfaces.ILocation`` instead.
2008-09-26(no commit message)Chris McDonough
2008-09-26Move to Chameleon.Chris McDonough
2008-09-21Rendering fixes.Chris McDonough
2008-09-21Add workflow chapter, fix renderings.Chris McDonough
2008-09-21Tweakage.Chris McDonough
2008-09-21Add actions chapter.Chris McDonough
2008-09-21Add skins chapter.Chris McDonough
2008-09-21Add docs about cataloging.Chris McDonough
2008-09-21 - Add ``principals_allowed_by_permission`` API to security module.Chris McDonough
2008-09-19Begin CMF migration documentation.Chris McDonough
2008-09-16typo.Chris McDonough
2008-09-16Document url dispatch in narrative form.Chris McDonough
2008-09-090.3.7.Chris McDonough
2008-09-06Note done.Chris McDonough
2008-09-06Define ACE.Chris McDonough
2008-09-06Dollar.Chris McDonough
2008-09-06Info about debugging security failures.Chris McDonough
2008-09-04Prep for 0.3.6.Chris McDonough
2008-09-03(no commit message)Chris McDonough
2008-09-03Fux bigs.Chris McDonough
2008-09-03 - Add startup process docs.Chris McDonough
2008-09-01Prep for 0.3.5.Chris McDonough
2008-09-01Add render_view function.Chris McDonough
2008-09-01 - New API module: ``repoze.bfg.view``. This module contains the functionsChris McDonough
named ``render_view_to_response``, ``render_view_to_iterable`` and ``is_response``, which are documented in the API docs. These features aid programmatic (non-request-driven) view execution.
2008-08-30(no commit message)Chris McDonough
2008-08-30Fix project docs.Chris McDonough