From aa1ec87d52b2167154f3a5a3b68ec95ab9b1891a Mon Sep 17 00:00:00 2001 From: Chris McDonough Date: Sat, 18 Dec 2010 04:20:23 -0500 Subject: summarize asset/resource/model changes --- CHANGES.txt | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) (limited to 'CHANGES.txt') diff --git a/CHANGES.txt b/CHANGES.txt index 2f8a784c0..5300d9cbc 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -1,6 +1,73 @@ Next release ============ +Terminology Changes +------------------- + +- The Pyramid concept previously known as "model" is now known as "resource". + As a result: + + - The following API changes have been made:: + + pyramid.url.model_url -> + pyramid.url.resource_url + pyramid.traversal.find_model -> + pyramid.url.find_resource + pyramid.traversal.model_path -> + pyramid.traversal.resource_path + pyramid.traversal.model_path_tuple -> + pyramid.traversal.resource_path_tuple + pyramid.traversal.ModelGraphTraverser -> + pyramid.traversal.ResourceTreeTraverser + pyramid.traversal.ModelGraphTraverser -> + pyramid.traversal.ResourceTreeTraverser + pyramid.config.Configurator.testing_models -> + pyramid.config.Configurator.testing_resources + pyramid.request.Request.model_url -> + pyramid.request.Request.resource_url + pyramid.testing.registerModels -> + pyramid.testing.registerResources + pyramid.testing.DummyModel -> + pyramid.testing.DummyResource + + - All documentation which previously referred to "model" now refers to + "resource". + + - The ``starter`` and ``starter_zcml`` paster templates now have a + ``resources.py`` module instead of a ``models.py`` module. + + - Positional argument names of various APIs have been changed from + ``model`` to ``resource``. + + Backwards compatibility shims have been left in place in all cases. They + will continue to work "forever". + +- The Pyramid concept previously known as "resource" is now known as "asset". + As a result: + + - The (non-API) module previously known as ``pyramid.resource`` is now + known as ``pyramid.asset``. + + - All docs that previously referred to "resource specification" now refer + to "asset specification". + + - The following API changes were made:: + + pyramid.config.Configurator.absolute_resource_spec -> + pyramid.config.Configurator.absolute_asset_spec + pyramid.config.Configurator.override_resource -> + pyramid.config.Configurator.override_asset + + - The ZCML directive previously known as ``resource`` is now known as + ``asset``. + + - The setting previously known as ``BFG_RELOAD_RESOURCES`` (envvar) or + ``reload_resources`` (config file) is now known, respectively, as + ``BFG_RELOAD_ASSETS`` and ``reload_assets``. + + Backwards compatibility shims have been left in place in all cases. They + will continue to work "forever". + Bug Fixes --------- @@ -30,6 +97,9 @@ Documentation - Direct Jython users to Mako rather than Jinja2 in "Install" narrative chapter. +- Many changes to support terminological renaming of "model" to "resource" + and "resource" to "asset". + Paster Templates ---------------- -- cgit v1.2.3