svcs-pyramid 26.1.0

A Flexible Service Locator for Pyramid

svcs Integration for Pyramid.

svcs-pyramid is the svcs integration for Pyramid.

svcs (pronounced services) is a dependency container for Python. It gives you a central place to register factories for types/interfaces and then imperatively acquire instances of those types with automatic cleanup and health checks.

svcs-pyramid wires that up for Pyramid: it stores the svcs registry in Pyramid's own registry (yes, unfortunate name clash) and uses a tween to attach a fresh container to every request – and to close it when the request is done.

import svcs_pyramid


def make_app():
    with Configurator(settings=settings) as config:
        svcs_pyramid.init(config)
        svcs_pyramid.register_factory(config, Database, db_factory)

        return config.make_wsgi_app()


@view_config(route_name="index")
def view(request):
    db, api, cache = svcs_pyramid.get(request, Database, WebAPIClient, Cache)

To a type checker, db has the type Database, api has the type WebAPIClient, and cache has the type Cache. db, api, and cache will be automatically cleaned up when the request ends – it's context managers all the way down.

Read on in svcs's Why? if you're intrigued.

Project links

• svcs itself
• PyPI
• GitHub
• Documentation
• Changelog
• Funding

Release Information

Deprecated

• svcs_pyramid.get_abstract() is carried over from svcs.pyramid so that the rename is the only change you have to make, but it's deprecated. Thanks to PEP 747, svcs_pyramid.get() does the same thing. There are no deprecation warnings or plans to remove it for now.

Added

• Initial release. svcs-pyramid is the extraction of svcs's svcs.pyramid module into its own package.

Changed

• The import name is svcs_pyramid instead of svcs.pyramid. Nothing else changed, so migrating is a pure rename:

  import svcs           →  import svcs_pyramid
  svcs.pyramid.init(…)  →  svcs_pyramid.init(…)
  

  The registry and the container are still stored under the svcs_registry and svcs_container keys, so svcs_pyramid is a drop-in replacement for svcs.pyramid.

---

Full Changelog →

Credits

svcs-pyramid is written by Hynek Schlawack and distributed under the terms of the MIT license.

It started out as the svcs.pyramid module inside of svcs and has been extracted into its own package.

The development is kindly supported by my employer Variomedia AG and all my fabulous GitHub Sponsors.

The Bestagon radar logo is made by Lynn Root, based on a Font Awesome icon.