Skip to main content

Dependency injection framework designed with Python in mind.

Project description

PyPI - License PyPI - Version PyPI - Python Versions PyPI - Downloads

Picobox is opinionated dependency injection framework designed to be clean, pragmatic and with Python in mind. No complex graphs, no implicit injections, no type bindings – just picoboxes, and explicit demands!

Why?

Because we usually want to decouple our code and Python lack of clean and pragmatic solutions (even third parties).

Features

  • Support both values and factories.

  • Support scopes (e.g. singleton, threadlocal, contextvars).

  • Push boxes on stack, and use the top one to access values.

  • Thread-safe.

  • Lightweight (~500 LOC including scopes).

  • Zero dependencies.

  • Pure Python.

  • Annotated with types.

Quickstart

First

$ [sudo] python -m pip install picobox

and then

import picobox
import requests


@picobox.pass_("conf")
@picobox.pass_("requests", as_="session")
def get_resource(uri, session, conf):
    return session.get(conf["base_uri"] + uri)


box = picobox.Box()
box.put("conf", {"base_uri": "http://example.com"})
box.put("requests", factory=requests.Session, scope=picobox.threadlocal)

with picobox.push(box):
    get_resource("/resource", requests.Session(), {})
    get_resource("/resource", requests.Session())
    get_resource("/resource")

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

picobox-4.0.0.tar.gz (22.7 kB view details)

Uploaded Source

Built Distribution

picobox-4.0.0-py3-none-any.whl (11.6 kB view details)

Uploaded Python 3

File details

Details for the file picobox-4.0.0.tar.gz.

File metadata

  • Download URL: picobox-4.0.0.tar.gz
  • Upload date:
  • Size: 22.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for picobox-4.0.0.tar.gz
Algorithm Hash digest
SHA256 114da1b5606b2f615e8b0eb68d04198ad9de75af5adbcf5b36fe4f664ab927b6
MD5 16d98d674a150245ca0fef14331a031e
BLAKE2b-256 0fb1830714dd6778c1cb45826722b4e9bd21c94b33cca5df9ef2cc0b80c81b25

See more details on using hashes here.

File details

Details for the file picobox-4.0.0-py3-none-any.whl.

File metadata

  • Download URL: picobox-4.0.0-py3-none-any.whl
  • Upload date:
  • Size: 11.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.12

File hashes

Hashes for picobox-4.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4c27eb689fe45dabd9e64c382e04418147d0b746d155b4e80057dbb7ff82027e
MD5 21dc55602c64d0517eb7664bb0cb8800
BLAKE2b-256 2dc6fd64ffd75d47c4fcf6c65808cc5c5c75e5d4357c197d3741ee1339e91257

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page