=================
zope.traversing
=================
.. image:: https://img.shields.io/pypi/v/zope.traversing.svg
:target: https://pypi.python.org/pypi/zope.traversing/
:alt: Latest release
.. image:: https://img.shields.io/pypi/pyversions/zope.traversing.svg
:target: https://pypi.org/project/zope.traversing/
:alt: Supported Python versions
.. image:: https://github.com/zopefoundation/zope.traversing/actions/workflows/tests.yml/badge.svg
:target: https://github.com/zopefoundation/zope.traversing/actions/workflows/tests.yml
.. image:: https://coveralls.io/repos/github/zopefoundation/zope.traversing/badge.svg?branch=master
:target: https://coveralls.io/github/zopefoundation/zope.traversing?branch=master
.. image:: https://readthedocs.org/projects/zopetraversing/badge/?version=latest
:target: https://zopetraversing.readthedocs.io/en/latest/
:alt: Documentation Status
This package provides adapters for resolving object paths by traversing
an object hierarchy. This package also includes support for traversal
namespaces (e.g. ``++view++``, ``++skin++``, etc.) as well as computing
URLs via the ``@@absolute_url`` view.
Documentation is hosted at https://zopetraversing.readthedocs.io/
=========
Changes
=========
5.0 (2023-03-27)
================
- Drop support for Python 2.7, 3.5, 3.6.
- Add support for Python 3.9, 3.10, 3.11.
4.4.1 (2020-03-31)
==================
- Ensure all objects have consistent resolution orders. Previously,
the "debug" namespace's "errors" flag completely changed the
resolution order of the request instead of simply adding the "Debug" skin.
4.4.0 (2020-03-30)
==================
- Drop support for Python 3.4.
- Add support for Python 3.8.
4.3.1 (2018-10-16)
==================
- Fix DeprecationWarnings for ``ComponentLookupError`` by
importing them from ``zope.interface.interfaces``. See `issue 10
<https://github.com/zopefoundation/zope.traversing/issues/10>`_.
4.3 (2018-10-05)
================
- Add support for Python 3.7.
- Host documentation at https://zopetraversing.readthedocs.io
4.2.0 (2017-09-23)
==================
- Add support for Python 3.6.
- Drop support for Python 3.3.
- Drop support for ``python setup.py test``.
4.1.0 (2016-08-05)
==================
- Add support for Python 3.5.
- Drop support for Python 2.6.
- Gracefully handle ``UnicodeEncodeError`` that can be produced when
doing attribute lookup on Python 2 by instead raising a ``LocationError``.
4.0.0 (2014-03-21)
==================
- Add support for Python 3.4.
4.0.0a3 (2013-03-12)
====================
- Add support for PyPy.
4.0.0a2 (2013-02-21)
====================
- Remove ``zope.container`` testing dependency to break another circular
dependency.
- Remove ``zope.pagetemplate`` testing dependency to break another circular
dependency.
- Remove ``zope.browserpage`` (ZCML) dependency by using low-level directives.
- Remove ``zope.site`` testing dependency.
4.0.0a1 (2013-02-20)
====================
- Replace deprecated ``zope.component.adapts`` usage with equivalent
``zope.component.adapter`` decorator.
- Replace deprecated ``zope.interface.implements`` usage with equivalent
``zope.interface.implementer`` decorator.
- Drop support for Python 2.4 and 2.5.
- Add support for Python 3.3.
- Fix dependencies : removed ``zope.tal`` and added ``zope.browserpage``.
3.14.0 (2011-03-02)
===================
- Re-release of 3.13.1 as a feature version as it introduces dependencies on
new feature releases.
3.13.1 (2010-12-14)
===================
- Fix ZCML-related dependencies.
3.13 (2010-07-09)
=================
- When a ``__parent__`` attribute is available on an object, it is
always used for absolute URL construction, and no ILocation adapter
lookup is performed for it. This was the previous behavior but was
broken (around 3.5?) due to dependency refactoring.
If the object provides no ``__parent__`` then an ILocation adapter
lookup will be performed. This will always succeed as zope.location
provides a default LocationProxy for everything, but more specific
ILocation adapters can also be provided.
3.12.1 (2010-04-30)
===================
- Remove use of ``zope.testing.doctestunit`` in favor of stdlib's doctest.
3.12.0 (2009-12-29)
===================
- Avoid testing dependencies on ``zope.securitypolicies`` and
``zope.principalregistry``.
3.11.0 (2009-12-27)
===================
- Remove testing dependency on ``zope.app.publication``.
3.10.0 (2009-12-16)
===================
- Remove stray test claiming a no longer existing dependency on
``zope.app.applicationcontrol``.
- Refactor functional tests to loose dependency on both
``zope.app.appsetup`` and ``zope.app.testing``.
- Simplify tests for the ``browser`` sub-package by using ``PlacelessSetup``
from ``zope.component.testing`` instead of ``zope.app.testing``.
- Simplify ``test_dependencies`` module by using ``zope.configuration``
instead of ``zope.app.testing.functional``.
- Remove testing dependency on ``zope.app.publisher``.
- Replace testing dependency on ``zope.app.security`` with
``zope.securitypolicy``.
- Remove testing dependency on ``zope.app.zcmlfiles`` in favor of more
explicit dependencies.
- Remove testing dependency on ``zope.app.component``.
- Replace a test dependency on ``zope.app.zptpage`` with a dependency on
``zope.pagetemplate``.
3.9.0 (2009-12-15)
==================
- Move ``IBeforeTraverseEvent`` here from ``zope.app.publication``,
as we already deal with publication traversal.
3.8.0 (2009-09-29)
==================
- In ``zope.traversing.api.getParent()``, try to delegate to
``zope.location.interfaces.ILocationInfo.getParent()``, analogous to
``getParents()``. Keep returning the traversal parent as a fallback.
- Bring ``ITraverser`` back from ``zope.location`` where it had been moved
to invert the package interdependency, but where it is now no longer used.
3.7.2 (2009-08-29)
==================
- Make virtual hosting tests compatible with ``zope.publisher`` 3.9.
Redirecting to a different host requires an explicit ``trusted``
redirect now.
3.7.1 (2009-06-16)
==================
- ``AbsoluteURL`` now implements the fact that ``__call__`` returns the same
as ``__str__`` in a manner that it applies for subclasses, too, so they only
have to override ``__str__`` and not both.
3.7.0 (2009-05-23)
==================
- Move the ``publicationtraverse`` module to ``zope.traversing``, removing the
``zope.app.publisher`` -> ``zope.app.publication`` dependency (which was a
cycle).
- Look up the application controller through a utility registration
rather than a direct reference.
3.6.0 (2009-04-06)
==================
- Change ``configure.zcml`` not to depend on ``zope.app.component``.
- This release includes the BBB-incompatible ``zope.publisher.skinnable``
change from 3.5.3.
3.5.4 (2009-04-06)
==================
- Revert BBB-incompatible use of ``zope.publisher.skinnable``: that
change belongs in a 3.6.0 release, because it requires a BBB-incompatible
version of ``zope.publisher``.
3.5.3 (2009-03-10)
==================
- Use applySkin from new location. zope.publisher.skinnable instead of
zope.publisher.browser.
- Use IAbsoluteURL lookup instead of the "absolute_url" view in the
recursive AbsoluteURL adapters (LP: #338101).
3.5.2 (2009-02-04)
==================
- ``RootPhysicallyLocatable`` is not the same as
``LocationPhysicallyLocatable`` (now in ``zope.location``).
Fix the import and testing setups.
3.5.1 (2009-02-02)
==================
- Obsolete the ``RootPhysicallyLocatable`` adapter, which has been superseded
by the refactored ``zope.location.traversing.LocationPhysicallyLocatable``
that we depend on since 3.5.0a4.
Remove the adapter and its registration, and making its import place
pointing to ``zope.location.traversing.LocationPhysicallyLocatable``
to maintain backward-compatibility.
This also fixes a bug introduced in version 3.5.0a4 when trying to
call ``getParents`` function for the root object.
- Use direct imports instead of compatibility ones for things that were
moved to ``zope.location``.
- Remove the ``zope.traversing.interfaces.INamespaceHandler`` interface,
as it seems not to be used for years.
- Change package's mailing list address to zope-dev at zope.org instead
of retired zope3-dev at zope.org
3.5.0 (2009-01-31)
==================
- Use zope.container instead of ``zope.app.container``.
- Use zope.site instead of ``zope.app.folder`` in the unit tests.
- Reduce, but not eliminate, test dependencies on ``zope.app.component``.
3.5.0a4 (2008-08-01)
====================
- Reverse dependencies between ``zope.location`` and ``zope.traversing``.
- Update (test) dependencies and tests to expect and work with a spec
compliant TAL interpreter as available in ``zope.tal`` >= 3.5.0.
- Fix deprecation warning caused by using an old module name for
``ZopeSecurityPolicy`` in ``ftesting.zcml``.
- Ensure traversing doesn't raise an TypeError but a TraversalError when the
traversal step before yielded a string.
3.5.0a3 (2007-12-28)
====================
- Back out the controversial ``++skin++`` traverser for XML-RPC.
3.5.0a2 (2007-11-28)
====================
- Port 3.4.1a1 to trunk
- Do not use unicode strings to set the application server in the virtual
host namespace. This caused ``absolute_url`` to create unicode URL's.
- Add a traverer for ``++skin++`` for XMLRPC skins (``IXMLRPCSkinType``).
This also means that the normal ``++skin++`` namespace handler is only
bound to ``IBrowserRequest``.
- Resolve the dependency on ``zope.app.applicationcontrol`` by importing the
application controller only if the package is available.
3.4.1 (2008-07-30)
==================
- Fix deprecation warning caused by using an old module name for
``ZopeSecurityPolicy`` in ``ftesting.zcml``.
3.4.1a1 (2007-11-13)
====================
- Do not use unicode strings to set the application server in the virtual
host namespace. This caused absolute_url to create unicode URL's.
3.4.0 (2007-09-29)
==================
No further changes since 3.4.0a1.
3.4.0a1 (2007-04-22)
====================
Initial release as a separate project, corresponds to ``zope.traversing``
from Zope 3.4.0a1
Raw data
{
"_id": null,
"home_page": "https://github.com/zopefoundation/zope.traversing",
"name": "zope.traversing",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "zope traversal route URL view",
"author": "Zope Foundation and Contributors",
"author_email": "zope-dev@zope.dev",
"download_url": "https://files.pythonhosted.org/packages/ba/eb/4fb91cde93ef76be16b958a8b48045892c94c3fca0834d29656f174ef70a/zope.traversing-5.0.tar.gz",
"platform": null,
"description": "=================\n zope.traversing\n=================\n\n.. image:: https://img.shields.io/pypi/v/zope.traversing.svg\n :target: https://pypi.python.org/pypi/zope.traversing/\n :alt: Latest release\n\n.. image:: https://img.shields.io/pypi/pyversions/zope.traversing.svg\n :target: https://pypi.org/project/zope.traversing/\n :alt: Supported Python versions\n\n.. image:: https://github.com/zopefoundation/zope.traversing/actions/workflows/tests.yml/badge.svg\n :target: https://github.com/zopefoundation/zope.traversing/actions/workflows/tests.yml\n\n.. image:: https://coveralls.io/repos/github/zopefoundation/zope.traversing/badge.svg?branch=master\n :target: https://coveralls.io/github/zopefoundation/zope.traversing?branch=master\n\n.. image:: https://readthedocs.org/projects/zopetraversing/badge/?version=latest\n :target: https://zopetraversing.readthedocs.io/en/latest/\n :alt: Documentation Status\n\nThis package provides adapters for resolving object paths by traversing\nan object hierarchy. This package also includes support for traversal\nnamespaces (e.g. ``++view++``, ``++skin++``, etc.) as well as computing\nURLs via the ``@@absolute_url`` view.\n\nDocumentation is hosted at https://zopetraversing.readthedocs.io/\n\n\n=========\n Changes\n=========\n\n5.0 (2023-03-27)\n================\n\n- Drop support for Python 2.7, 3.5, 3.6.\n\n- Add support for Python 3.9, 3.10, 3.11.\n\n\n4.4.1 (2020-03-31)\n==================\n\n- Ensure all objects have consistent resolution orders. Previously,\n the \"debug\" namespace's \"errors\" flag completely changed the\n resolution order of the request instead of simply adding the \"Debug\" skin.\n\n\n4.4.0 (2020-03-30)\n==================\n\n- Drop support for Python 3.4.\n\n- Add support for Python 3.8.\n\n\n4.3.1 (2018-10-16)\n==================\n\n- Fix DeprecationWarnings for ``ComponentLookupError`` by\n importing them from ``zope.interface.interfaces``. See `issue 10\n <https://github.com/zopefoundation/zope.traversing/issues/10>`_.\n\n\n4.3 (2018-10-05)\n================\n\n- Add support for Python 3.7.\n\n- Host documentation at https://zopetraversing.readthedocs.io\n\n4.2.0 (2017-09-23)\n==================\n\n- Add support for Python 3.6.\n\n- Drop support for Python 3.3.\n\n- Drop support for ``python setup.py test``.\n\n4.1.0 (2016-08-05)\n==================\n\n- Add support for Python 3.5.\n\n- Drop support for Python 2.6.\n\n- Gracefully handle ``UnicodeEncodeError`` that can be produced when\n doing attribute lookup on Python 2 by instead raising a ``LocationError``.\n\n4.0.0 (2014-03-21)\n==================\n\n- Add support for Python 3.4.\n\n\n4.0.0a3 (2013-03-12)\n====================\n\n- Add support for PyPy.\n\n\n4.0.0a2 (2013-02-21)\n====================\n\n- Remove ``zope.container`` testing dependency to break another circular\n dependency.\n\n- Remove ``zope.pagetemplate`` testing dependency to break another circular\n dependency.\n\n- Remove ``zope.browserpage`` (ZCML) dependency by using low-level directives.\n\n- Remove ``zope.site`` testing dependency.\n\n\n4.0.0a1 (2013-02-20)\n====================\n\n- Replace deprecated ``zope.component.adapts`` usage with equivalent\n ``zope.component.adapter`` decorator.\n\n- Replace deprecated ``zope.interface.implements`` usage with equivalent\n ``zope.interface.implementer`` decorator.\n\n- Drop support for Python 2.4 and 2.5.\n\n- Add support for Python 3.3.\n\n- Fix dependencies : removed ``zope.tal`` and added ``zope.browserpage``.\n\n\n3.14.0 (2011-03-02)\n===================\n\n- Re-release of 3.13.1 as a feature version as it introduces dependencies on\n new feature releases.\n\n3.13.1 (2010-12-14)\n===================\n\n- Fix ZCML-related dependencies.\n\n3.13 (2010-07-09)\n=================\n\n- When a ``__parent__`` attribute is available on an object, it is\n always used for absolute URL construction, and no ILocation adapter\n lookup is performed for it. This was the previous behavior but was\n broken (around 3.5?) due to dependency refactoring.\n\n If the object provides no ``__parent__`` then an ILocation adapter\n lookup will be performed. This will always succeed as zope.location\n provides a default LocationProxy for everything, but more specific\n ILocation adapters can also be provided.\n\n3.12.1 (2010-04-30)\n===================\n\n- Remove use of ``zope.testing.doctestunit`` in favor of stdlib's doctest.\n\n3.12.0 (2009-12-29)\n===================\n\n- Avoid testing dependencies on ``zope.securitypolicies`` and\n ``zope.principalregistry``.\n\n3.11.0 (2009-12-27)\n===================\n\n- Remove testing dependency on ``zope.app.publication``.\n\n3.10.0 (2009-12-16)\n===================\n\n- Remove stray test claiming a no longer existing dependency on\n ``zope.app.applicationcontrol``.\n\n- Refactor functional tests to loose dependency on both\n ``zope.app.appsetup`` and ``zope.app.testing``.\n\n- Simplify tests for the ``browser`` sub-package by using ``PlacelessSetup``\n from ``zope.component.testing`` instead of ``zope.app.testing``.\n\n- Simplify ``test_dependencies`` module by using ``zope.configuration``\n instead of ``zope.app.testing.functional``.\n\n- Remove testing dependency on ``zope.app.publisher``.\n\n- Replace testing dependency on ``zope.app.security`` with\n ``zope.securitypolicy``.\n\n- Remove testing dependency on ``zope.app.zcmlfiles`` in favor of more\n explicit dependencies.\n\n- Remove testing dependency on ``zope.app.component``.\n\n- Replace a test dependency on ``zope.app.zptpage`` with a dependency on\n ``zope.pagetemplate``.\n\n3.9.0 (2009-12-15)\n==================\n\n- Move ``IBeforeTraverseEvent`` here from ``zope.app.publication``,\n as we already deal with publication traversal.\n\n3.8.0 (2009-09-29)\n==================\n\n- In ``zope.traversing.api.getParent()``, try to delegate to\n ``zope.location.interfaces.ILocationInfo.getParent()``, analogous to\n ``getParents()``. Keep returning the traversal parent as a fallback.\n\n- Bring ``ITraverser`` back from ``zope.location`` where it had been moved\n to invert the package interdependency, but where it is now no longer used.\n\n3.7.2 (2009-08-29)\n==================\n\n- Make virtual hosting tests compatible with ``zope.publisher`` 3.9.\n Redirecting to a different host requires an explicit ``trusted``\n redirect now.\n\n3.7.1 (2009-06-16)\n==================\n\n- ``AbsoluteURL`` now implements the fact that ``__call__`` returns the same\n as ``__str__`` in a manner that it applies for subclasses, too, so they only\n have to override ``__str__`` and not both.\n\n3.7.0 (2009-05-23)\n==================\n\n- Move the ``publicationtraverse`` module to ``zope.traversing``, removing the\n ``zope.app.publisher`` -> ``zope.app.publication`` dependency (which was a\n cycle).\n\n- Look up the application controller through a utility registration\n rather than a direct reference.\n\n3.6.0 (2009-04-06)\n==================\n\n- Change ``configure.zcml`` not to depend on ``zope.app.component``.\n\n- This release includes the BBB-incompatible ``zope.publisher.skinnable``\n change from 3.5.3.\n\n3.5.4 (2009-04-06)\n==================\n\n- Revert BBB-incompatible use of ``zope.publisher.skinnable``: that\n change belongs in a 3.6.0 release, because it requires a BBB-incompatible\n version of ``zope.publisher``.\n\n3.5.3 (2009-03-10)\n==================\n\n- Use applySkin from new location. zope.publisher.skinnable instead of\n zope.publisher.browser.\n\n- Use IAbsoluteURL lookup instead of the \"absolute_url\" view in the\n recursive AbsoluteURL adapters (LP: #338101).\n\n3.5.2 (2009-02-04)\n==================\n\n- ``RootPhysicallyLocatable`` is not the same as\n ``LocationPhysicallyLocatable`` (now in ``zope.location``).\n Fix the import and testing setups.\n\n3.5.1 (2009-02-02)\n==================\n\n- Obsolete the ``RootPhysicallyLocatable`` adapter, which has been superseded\n by the refactored ``zope.location.traversing.LocationPhysicallyLocatable``\n that we depend on since 3.5.0a4.\n\n Remove the adapter and its registration, and making its import place\n pointing to ``zope.location.traversing.LocationPhysicallyLocatable``\n to maintain backward-compatibility.\n\n This also fixes a bug introduced in version 3.5.0a4 when trying to\n call ``getParents`` function for the root object.\n\n- Use direct imports instead of compatibility ones for things that were\n moved to ``zope.location``.\n\n- Remove the ``zope.traversing.interfaces.INamespaceHandler`` interface,\n as it seems not to be used for years.\n\n- Change package's mailing list address to zope-dev at zope.org instead\n of retired zope3-dev at zope.org\n\n3.5.0 (2009-01-31)\n==================\n\n- Use zope.container instead of ``zope.app.container``.\n\n- Use zope.site instead of ``zope.app.folder`` in the unit tests.\n\n- Reduce, but not eliminate, test dependencies on ``zope.app.component``.\n\n3.5.0a4 (2008-08-01)\n====================\n\n- Reverse dependencies between ``zope.location`` and ``zope.traversing``.\n\n- Update (test) dependencies and tests to expect and work with a spec\n compliant TAL interpreter as available in ``zope.tal`` >= 3.5.0.\n\n- Fix deprecation warning caused by using an old module name for\n ``ZopeSecurityPolicy`` in ``ftesting.zcml``.\n\n- Ensure traversing doesn't raise an TypeError but a TraversalError when the\n traversal step before yielded a string.\n\n\n3.5.0a3 (2007-12-28)\n====================\n\n- Back out the controversial ``++skin++`` traverser for XML-RPC.\n\n\n3.5.0a2 (2007-11-28)\n====================\n\n- Port 3.4.1a1 to trunk\n\n - Do not use unicode strings to set the application server in the virtual\n host namespace. This caused ``absolute_url`` to create unicode URL's.\n\n- Add a traverer for ``++skin++`` for XMLRPC skins (``IXMLRPCSkinType``).\n This also means that the normal ``++skin++`` namespace handler is only\n bound to ``IBrowserRequest``.\n\n- Resolve the dependency on ``zope.app.applicationcontrol`` by importing the\n application controller only if the package is available.\n\n\n3.4.1 (2008-07-30)\n==================\n\n- Fix deprecation warning caused by using an old module name for\n ``ZopeSecurityPolicy`` in ``ftesting.zcml``.\n\n\n3.4.1a1 (2007-11-13)\n====================\n\n- Do not use unicode strings to set the application server in the virtual\n host namespace. This caused absolute_url to create unicode URL's.\n\n\n3.4.0 (2007-09-29)\n==================\n\nNo further changes since 3.4.0a1.\n\n3.4.0a1 (2007-04-22)\n====================\n\nInitial release as a separate project, corresponds to ``zope.traversing``\nfrom Zope 3.4.0a1\n",
"bugtrack_url": null,
"license": "ZPL 2.1",
"summary": "Resolving paths in the object hierarchy",
"version": "5.0",
"split_keywords": [
"zope",
"traversal",
"route",
"url",
"view"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d94734fdb495867649747ddea10d7c9e83f7a1d8bcecdf86eeb4d46ed123faed",
"md5": "6ff3d2de59e888f3ac8bc317ef46b0ea",
"sha256": "1c26c8f0067821e2ad198553b3a548d7edb352e0969d4f283e635e67d4c2874e"
},
"downloads": -1,
"filename": "zope.traversing-5.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ff3d2de59e888f3ac8bc317ef46b0ea",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 47610,
"upload_time": "2023-03-27T11:43:13",
"upload_time_iso_8601": "2023-03-27T11:43:13.976450Z",
"url": "https://files.pythonhosted.org/packages/d9/47/34fdb495867649747ddea10d7c9e83f7a1d8bcecdf86eeb4d46ed123faed/zope.traversing-5.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "baeb4fb91cde93ef76be16b958a8b48045892c94c3fca0834d29656f174ef70a",
"md5": "8aa7403a907e48d0238296b3ce5ab5ba",
"sha256": "f11c4622526cd328f3ab5cf6cc34c0226dc2137d26af9c11b34c507da11c44f5"
},
"downloads": -1,
"filename": "zope.traversing-5.0.tar.gz",
"has_sig": false,
"md5_digest": "8aa7403a907e48d0238296b3ce5ab5ba",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 42671,
"upload_time": "2023-03-27T11:43:16",
"upload_time_iso_8601": "2023-03-27T11:43:16.834138Z",
"url": "https://files.pythonhosted.org/packages/ba/eb/4fb91cde93ef76be16b958a8b48045892c94c3fca0834d29656f174ef70a/zope.traversing-5.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-03-27 11:43:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "zopefoundation",
"github_project": "zope.traversing",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "zope.traversing"
}
JSON
