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.21.tar.gz (9.7 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.21-py3-none-any.whl (20.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nlbone-0.1.21.tar.gz
  • Upload date:
  • Size: 9.7 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.21.tar.gz
Algorithm Hash digest
SHA256 cc4f0b817de1b344503e49b3f206b2ddeca6843e2adea4aa75bea41eab1c4bd9
MD5 ad3bc178cd898bc59aa6abf4afcd4949
BLAKE2b-256 2f69ea25d9041c7a7987846470e1fb0c29440777a0ffb95ee58ba83f2e3bcc9d

See more details on using hashes here.

File details

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

File metadata

  • Download URL: nlbone-0.1.21-py3-none-any.whl
  • Upload date:
  • Size: 20.1 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.21-py3-none-any.whl
Algorithm Hash digest
SHA256 a4ee859710cdb6a311abac870c6849a86401115bda9efe4eb12330f9c4ad055a
MD5 dd7218b94491b7206de761f3a9012e99
BLAKE2b-256 214feaf8c47380b708ba516b438fa98139aacf3b1eee10eb4a61b003edb95b33

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