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.25.tar.gz (10.9 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.25-py3-none-any.whl (21.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nlbone-0.1.25.tar.gz
  • Upload date:
  • Size: 10.9 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.25.tar.gz
Algorithm Hash digest
SHA256 b911dd2fbcbd649d73d8d842e7d3820d4739a050edb0c6784186e11122e8beef
MD5 92d6d3183a70b88593fadd873b5ca3e1
BLAKE2b-256 46c0a2d6e8a7e6c9e8b51f22490385b13d48d997aef4e40cdeb5e05235c6c457

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nlbone-0.1.25-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.25-py3-none-any.whl
Algorithm Hash digest
SHA256 4dbb8f64ea6351b5a995bc055c15d1b80fae381d9cfeea8ee5b85afb9af26f16
MD5 465e49d55c9b534ab029d048cb4353ea
BLAKE2b-256 b0dedd54c7d8a09ef7231a2fbf549d080cde2bdd729a8882a566d9f134c8bd08

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