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.32.tar.gz (13.1 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.32-py3-none-any.whl (26.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nlbone-0.1.32.tar.gz
  • Upload date:
  • Size: 13.1 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.32.tar.gz
Algorithm Hash digest
SHA256 f3bdbc1149aef7805337152e08fa739d36b15dc33cca6c165f1e776adcf3af21
MD5 b0467ac644b5e343a34c0b37a8b5be44
BLAKE2b-256 46a38a98d6b92710bd709e753458d86346e6f35532c8321c21a1a5914f0b8b5c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nlbone-0.1.32-py3-none-any.whl
  • Upload date:
  • Size: 26.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.32-py3-none-any.whl
Algorithm Hash digest
SHA256 8ba68511daafefddd8164013f4b525fbb246fcdeb84565bf94d1f4bea2d1cf30
MD5 fe56d4ed260f3e4dae2326c3bfa25846
BLAKE2b-256 b7f7e163c1769b7281377ecea72dd6c04dd958eaca7fddc4584b97ae849c9b31

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