buvis-pybase Documentation

Foundation library for BUVIS Python projects. Provides configuration management, filesystem utilities, adapters for external tools, and string manipulation.

Getting Started

Configuration is the recommended entry point. It defines how your tools load settings from CLI arguments, environment variables, YAML files, and defaults.

Quick Example

import click
from buvis.pybase.configuration import buvis_options, get_settings

@click.command()
@buvis_options
@click.pass_context
def main(ctx: click.Context) -> None:
    settings = get_settings(ctx)
    if settings.debug:
        click.echo("Debug mode")

See Configuration for custom settings classes, YAML configuration, environment variables, and migration guides.