Skip to main content

Backbone package for interfaces and infrastructure in Python projects

Project description

nlbone

nlbone (NumberLand Backbone) is a lightweight Python package that provides the foundational interfaces and infrastructure for NumberLand projects.
It follows a clean architecture style (ports & adapters) so that domain logic is separated from infrastructure concerns.


✨ Features

  • Domain interfaces
  • Immutable domain models
  • Application services (use cases) independent of infrastructure.
  • Infrastructure adapters (DB, HTTP, etc.).
  • Config management with pydantic-settings.
  • Dependency injection container for easy wiring.
  • Testing ready with pytest + pytest-asyncio.
  • Dev tools: Ruff (lint), Mypy (typing), Pre-commit hooks.

📦 Installation

pip install nlbone

🛠 For development:

git clone https://github.com/your-org/nlbone.git
cd nlbone
python -m venv .venv
source .venv/bin/activate   # (Linux/macOS)
# .venv\Scripts\activate    # (Windows)

pip install -e ".[dev]"

python -m pip install build twine
python -m build

🚀 Quick Example

import anyio
from nlbone import build_container


async def main():
    container = build_container()
    user = await container.register_user("me@numberland.com")
    print(user)


anyio.run(main)

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

nlbone-0.1.24.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nlbone-0.1.24-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

Details for the file nlbone-0.1.24.tar.gz.

File metadata

  • Download URL: nlbone-0.1.24.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for nlbone-0.1.24.tar.gz
Algorithm Hash digest
SHA256 38beb558630b7c2134d8b88b496eb21fda8a77d5e5325288523e78440fe37857
MD5 7cb0d3b3537dcba691bbce8450ef66cf
BLAKE2b-256 54c1a666b92b5e41ca82207d355d52a9137cbb2097d619525439035b347ddf59

See more details on using hashes here.

File details

Details for the file nlbone-0.1.24-py3-none-any.whl.

File metadata

  • Download URL: nlbone-0.1.24-py3-none-any.whl
  • Upload date:
  • Size: 21.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for nlbone-0.1.24-py3-none-any.whl
Algorithm Hash digest
SHA256 d5e14a7c485f722663abd8fd62bb03ca7b96d3685246235c1506a76883184522
MD5 b4b9028451b6b906703e3ea2bf7969f7
BLAKE2b-256 ab233db5d81287773f70ae1c581d91deddc7466fc2a9fad1150f870916b5398e

See more details on using hashes here.

Supported by

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