Dependency injection stuff for Pyramid
Project description
pyramid_di
Easier service location and dependency injection for Pyramid.
Usage
Define services:
# app/services/__init__.py
from .my import MyService
from .another import AnotherService
# app/services/my.py
from pyramid_di import service, RequestScopedBaseService, autowired
@service()
class MyService(RequestScopedBaseService):
def my_method(self):
return 'foobar'
# app/services/another.py
from pyramid_di import service, RequestScopedBaseService, autowired
from .my import MyService
@service()
class AnotherService(RequestScopedBaseService):
dependency = autowired(MyService)
def another_method(self):
return self.dependency.my_method()
Setup when creating the Pyramid app:
# Pyramid setup code:
from pyramid.config import Configurator
with Configurator() as config:
config.include('pyramid_di')
config.scan_services('app.services')
Use in views:
from pyramid_di import autowired
from pyramid.view import view_config
from my.services import AnotherService
class MyViews:
service = autowired(AnotherService)
def __init__(self, request):
# self.request is required for autowired to work
self.request = request
@view_config(route_name='some_view', renderer='json')
def some_view(self):
return self.service.another_method() # 'foobar'
# alternatively, without class-based views:
@view_config(route_name='some_view')
def some_view(request):
service = request.find_service(AnotherService)
service.another_method() # 'foobar'
Mocking services for testing
class MockService:
def another_method(self):
return 'mocked'
def test_views():
request = DummyRequest()
my_views = MyViews(request)
my_views.service = MockService()
assert my_views.some_view() == 'mocked'
Development
Dev setup:
$ python3 -m venv venv
$ pip install -e '.[dev]'
Tests are run with pytest:
$ pytest
Changes
0.4.2
- 2023-05-28 Change from TravisCI to Github Actions, update testing matrix to cover Python 3.10 and Pyramid 2.0+.
0.4.1
- 2021-03-19 The request-scoped services were not quite correct as they could have been instantiated twice
- once in the traversal-time and the other time after context was set. Now the context is forced to None for the request-scoped services.
0.4.0
- 2020-11-25 Python 3.6+ only; better test coverage, fixes for scoped services, deprecations and so forth.
0.3.dev0
- 2020-11 Unreleased development version
0.2.dev0
- 2020-11-04 Require Python 3 for cleaner code
0.1
- 2018-03-26 Initial release
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pyramid_di-0.4.2.tar.gz
(5.9 kB
view details)
Built Distribution
File details
Details for the file pyramid_di-0.4.2.tar.gz
.
File metadata
- Download URL: pyramid_di-0.4.2.tar.gz
- Upload date:
- Size: 5.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3b58dd76e2c6fa06b9574afdce2cf05a24611f52988455502e7a230d0aeff14b |
|
MD5 | c00e5b469f227183ac2dcc31835140c1 |
|
BLAKE2b-256 | 08384be3f8fcfd661a72bcd3b2e32f35f25cbc3d99dac8296757c6c458e90fd9 |
File details
Details for the file pyramid_di-0.4.2-py3-none-any.whl
.
File metadata
- Download URL: pyramid_di-0.4.2-py3-none-any.whl
- Upload date:
- Size: 4.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.3
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 16e88b53b36a53953a69b0ba847ab12e4f1591a7459771fd9f763eff04e99db6 |
|
MD5 | 76903e4ec96fc8a023a33fca89ad1519 |
|
BLAKE2b-256 | 4e669335d0afb5bb926957a66bfc2fa41848b3528f1654de544f0b7822d300d8 |