=======
plaster
=======
.. image:: https://img.shields.io/pypi/v/plaster.svg
:target: https://pypi.python.org/pypi/plaster
.. image:: https://github.com/Pylons/plaster/workflows/Build%20and%20test/badge.svg?branch=master
:target: https://github.com/Pylons/plaster/actions?query=workflow%3A%22Build+and+test%22
:alt: master CI Status
.. image:: https://readthedocs.org/projects/plaster/badge/?version=latest
:target: https://readthedocs.org/projects/plaster/?badge=latest
:alt: Documentation Status
``plaster`` is a loader interface around multiple config file formats. It
exists to define a common API for applications to use when they wish to load
configuration. The library itself does not aim to handle anything except
a basic API that applications may use to find and load configuration settings.
Any specific constraints should be implemented in a pluggable loader which can
be registered via an entrypoint.
See https://docs.pylonsproject.org/projects/plaster/en/latest/ or
``docs/index.rst`` in this distribution for detailed documentation.
1.1.2 (2022-11-20)
==================
- Fix a bug in which plaster would crash harder than expected if a URI
is specified to a distribution that does not have the specified entry points.
Now a LoaderNotFound exception will be raised instead of a bad unpacking
of tuples.
1.1.1 (2022-11-20)
==================
- Add support for Python 3.11.
- Fix an bug introduced in 1.1 on some systems where
``plaster.exceptions.MultipleLoadersFound`` would be raised due to
``lib`` and ``lib64`` being symlinked to each other and both added to the
``sys.path``.
See https://github.com/Pylons/plaster/pull/27
1.1 (2022-10-06)
================
- Drop support for Python 2.7, 3.4, 3.5, 3.6.
- Add support for Python 3.8, 3.9, 3.10.
- Drop runtime dependency on setuptools / pkg_resources by switching to
``importlib.metadata``.
1.0 (2017-10-11)
================
- Improve the exception message for ``InvalidURI`` to show the ``config_uri``.
See https://github.com/Pylons/plaster/pull/17
0.5 (2017-06-02)
================
- When a scheme is not supplied, ``plaster.parse_uri`` will now autogenerate
a scheme from the file extension with the format ``file+<ext>`` instead of
simply ``<ext>`` (for example, ``file+ini`` instead of ``ini``).
See https://github.com/Pylons/plaster/pull/16
- Absolute lookups are now pulled from the start of the scheme instead of
the end. This means that if you want to explicitly define the package that
the loader is pulled from, use ``package+scheme`` instead of
``scheme+package``.
See https://github.com/Pylons/plaster/pull/16
0.4 (2017-03-30)
================
- Removed the ``plaster.NoSectionError`` exception. It's expected that
individual loaders should return an empty dictionary of settings in the
case that a section cannot be found.
See https://github.com/Pylons/plaster/pull/12
- Expect the ``wsgi`` protocol to raise ``LookupError`` exceptions when
a named wsgi component cannot be found.
See https://github.com/Pylons/plaster/pull/12
0.3 (2017-03-27)
================
- Lookup now works differently. First "foo+bar" looks for an installed project
distribution named "bar" with a loader named "foo". If this fails then it
looks for any loader named "foo+bar".
- Rename the loader entry point to ``plaster.loader_factory``.
- Add the concept of protocols to ``plaster.get_loader`` and
``plaster.find_loaders``.
- ``plaster.find_loaders`` now works on just schemes and protocols
instead of full ``PlasterURL`` objects and implements the lookup
algorithm for finding loader factories.
- Change the ``ILoaderInfo`` interface to avoid being coupled to a
particular uri. ``ILoaderInfo.load`` now takes a ``config_uri``
parameter.
- Add a ``options`` dictionary to ``PlasterURL`` containing any arguments
decoded from the query string. Loaders may use these for whatever they wish
but one good option is default values in a config file.
- Define the ``IWSGIProtocol`` interface which addons can use to implement
a loader that can return full wsgi apps, servers and filters.
- The scheme is now case-insensitive.
0.2 (2016-06-15)
================
- Allow ``config_uri`` syntax ``scheme:path`` alongside ``scheme://path``.
See https://github.com/Pylons/plaster/issues/3
- Improve errors to show the user-supplied values in the error message.
See https://github.com/Pylons/plaster/pull/4
- Add ``plaster.find_loaders`` which can be used by people who need a way
to recover when ambiguous loaders are discovered via ``plaster.get_loader``.
See https://github.com/Pylons/plaster/pull/5
- Rename ``plaster.Loader`` to ``plaster.ILoader`` to signify its purpose
as an interface with no actual implementation.
See https://github.com/Pylons/plaster/pull/5
- Introduce ``plaster.ILoaderFactory`` to document what the entry point targets
are expected to implement.
See https://github.com/Pylons/plaster/pull/5
0.1 (2016-06-12)
================
- Initial release.
Raw data
{
"_id": null,
"home_page": "https://docs.pylonsproject.org/projects/plaster/en/latest/",
"name": "plaster",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "plaster,pastedeploy,ini,config",
"author": "Michael Merickel",
"author_email": "pylons-discuss@googlegroups.com",
"download_url": "https://files.pythonhosted.org/packages/26/93/66df0f87f1442d8afea8531ae8a4a9eca656006a54eac2b4489427e92c10/plaster-1.1.2.tar.gz",
"platform": null,
"description": "=======\nplaster\n=======\n\n.. image:: https://img.shields.io/pypi/v/plaster.svg\n :target: https://pypi.python.org/pypi/plaster\n\n.. image:: https://github.com/Pylons/plaster/workflows/Build%20and%20test/badge.svg?branch=master\n :target: https://github.com/Pylons/plaster/actions?query=workflow%3A%22Build+and+test%22\n :alt: master CI Status\n\n.. image:: https://readthedocs.org/projects/plaster/badge/?version=latest\n :target: https://readthedocs.org/projects/plaster/?badge=latest\n :alt: Documentation Status\n\n``plaster`` is a loader interface around multiple config file formats. It\nexists to define a common API for applications to use when they wish to load\nconfiguration. The library itself does not aim to handle anything except\na basic API that applications may use to find and load configuration settings.\nAny specific constraints should be implemented in a pluggable loader which can\nbe registered via an entrypoint.\n\nSee https://docs.pylonsproject.org/projects/plaster/en/latest/ or\n``docs/index.rst`` in this distribution for detailed documentation.\n\n1.1.2 (2022-11-20)\n==================\n\n- Fix a bug in which plaster would crash harder than expected if a URI\n is specified to a distribution that does not have the specified entry points.\n Now a LoaderNotFound exception will be raised instead of a bad unpacking\n of tuples.\n\n1.1.1 (2022-11-20)\n==================\n\n- Add support for Python 3.11.\n\n- Fix an bug introduced in 1.1 on some systems where\n ``plaster.exceptions.MultipleLoadersFound`` would be raised due to\n ``lib`` and ``lib64`` being symlinked to each other and both added to the\n ``sys.path``.\n See https://github.com/Pylons/plaster/pull/27\n\n1.1 (2022-10-06)\n================\n\n- Drop support for Python 2.7, 3.4, 3.5, 3.6.\n\n- Add support for Python 3.8, 3.9, 3.10.\n\n- Drop runtime dependency on setuptools / pkg_resources by switching to\n ``importlib.metadata``.\n\n1.0 (2017-10-11)\n================\n\n- Improve the exception message for ``InvalidURI`` to show the ``config_uri``.\n See https://github.com/Pylons/plaster/pull/17\n\n0.5 (2017-06-02)\n================\n\n- When a scheme is not supplied, ``plaster.parse_uri`` will now autogenerate\n a scheme from the file extension with the format ``file+<ext>`` instead of\n simply ``<ext>`` (for example, ``file+ini`` instead of ``ini``).\n See https://github.com/Pylons/plaster/pull/16\n\n- Absolute lookups are now pulled from the start of the scheme instead of\n the end. This means that if you want to explicitly define the package that\n the loader is pulled from, use ``package+scheme`` instead of\n ``scheme+package``.\n See https://github.com/Pylons/plaster/pull/16\n\n0.4 (2017-03-30)\n================\n\n- Removed the ``plaster.NoSectionError`` exception. It's expected that\n individual loaders should return an empty dictionary of settings in the\n case that a section cannot be found.\n See https://github.com/Pylons/plaster/pull/12\n\n- Expect the ``wsgi`` protocol to raise ``LookupError`` exceptions when\n a named wsgi component cannot be found.\n See https://github.com/Pylons/plaster/pull/12\n\n0.3 (2017-03-27)\n================\n\n- Lookup now works differently. First \"foo+bar\" looks for an installed project\n distribution named \"bar\" with a loader named \"foo\". If this fails then it\n looks for any loader named \"foo+bar\".\n\n- Rename the loader entry point to ``plaster.loader_factory``.\n\n- Add the concept of protocols to ``plaster.get_loader`` and\n ``plaster.find_loaders``.\n\n- ``plaster.find_loaders`` now works on just schemes and protocols\n instead of full ``PlasterURL`` objects and implements the lookup\n algorithm for finding loader factories.\n\n- Change the ``ILoaderInfo`` interface to avoid being coupled to a\n particular uri. ``ILoaderInfo.load`` now takes a ``config_uri``\n parameter.\n\n- Add a ``options`` dictionary to ``PlasterURL`` containing any arguments\n decoded from the query string. Loaders may use these for whatever they wish\n but one good option is default values in a config file.\n\n- Define the ``IWSGIProtocol`` interface which addons can use to implement\n a loader that can return full wsgi apps, servers and filters.\n\n- The scheme is now case-insensitive.\n\n0.2 (2016-06-15)\n================\n\n- Allow ``config_uri`` syntax ``scheme:path`` alongside ``scheme://path``.\n See https://github.com/Pylons/plaster/issues/3\n\n- Improve errors to show the user-supplied values in the error message.\n See https://github.com/Pylons/plaster/pull/4\n\n- Add ``plaster.find_loaders`` which can be used by people who need a way\n to recover when ambiguous loaders are discovered via ``plaster.get_loader``.\n See https://github.com/Pylons/plaster/pull/5\n\n- Rename ``plaster.Loader`` to ``plaster.ILoader`` to signify its purpose\n as an interface with no actual implementation.\n See https://github.com/Pylons/plaster/pull/5\n\n- Introduce ``plaster.ILoaderFactory`` to document what the entry point targets\n are expected to implement.\n See https://github.com/Pylons/plaster/pull/5\n\n0.1 (2016-06-12)\n================\n\n- Initial release.\n",
"bugtrack_url": null,
"license": "",
"summary": "A loader interface around multiple config file formats.",
"version": "1.1.2",
"project_urls": {
"Homepage": "https://docs.pylonsproject.org/projects/plaster/en/latest/"
},
"split_keywords": [
"plaster",
"pastedeploy",
"ini",
"config"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e78b3f98db1448e3b4d2d142716874a7e02f6101685fdaa0f55a8668e9ffa048",
"md5": "5ce2c34c782a115e132c833720be413b",
"sha256": "42992ab1f4865f1278e2ad740e8ad145683bb4022e03534265528f0c23c0df2d"
},
"downloads": -1,
"filename": "plaster-1.1.2-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "5ce2c34c782a115e132c833720be413b",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.7",
"size": 11554,
"upload_time": "2022-11-21T01:44:52",
"upload_time_iso_8601": "2022-11-21T01:44:52.984107Z",
"url": "https://files.pythonhosted.org/packages/e7/8b/3f98db1448e3b4d2d142716874a7e02f6101685fdaa0f55a8668e9ffa048/plaster-1.1.2-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "269366df0f87f1442d8afea8531ae8a4a9eca656006a54eac2b4489427e92c10",
"md5": "b81c4d828a78c05a099b43285c62b66d",
"sha256": "f8befc54bf8c1147c10ab40297ec84c2676fa2d4ea5d6f524d9436a80074ef98"
},
"downloads": -1,
"filename": "plaster-1.1.2.tar.gz",
"has_sig": false,
"md5_digest": "b81c4d828a78c05a099b43285c62b66d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 33232,
"upload_time": "2022-11-21T01:44:54",
"upload_time_iso_8601": "2022-11-21T01:44:54.490549Z",
"url": "https://files.pythonhosted.org/packages/26/93/66df0f87f1442d8afea8531ae8a4a9eca656006a54eac2b4489427e92c10/plaster-1.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-11-21 01:44:54",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "plaster"
}
JSON