auto_rest.cli

The cli module manages input/output operations for the application's command line interface (CLI). Application inputs are parsed using the built-in argparse module while output messages are handled using the Python logging library.

Example: Parsing Arguments

The create_argument_parser function returns an ArgumentParser instance with pre-populated argument definitions.

from auto_rest.cli import create_argument_parser

parser = create_argument_parser()
args = parser.parse_args()
print(vars(args))

Example: Enabling Console Logging

The configure_cli_logging method overrides any existing logging configurations and enables console logging according to the provided log level.

from auto_rest.cli import configure_cli_logging

configure_cli_logging(log_level="INFO")

configure_cli_logging(level)

Enable console logging with the specified application log level.

Calling this method overrides and removes all previously configured logging configurations.

Parameters:

Name	Type	Description	Default
level	str	The Python logging level.	required

Source code in auto_rest/cli.py

def configure_cli_logging(level: str) -> None:
    """Enable console logging with the specified application log level.

    Calling this method overrides and removes all previously configured
    logging configurations.

    Args:
        level: The Python logging level.
    """

    # Normalize and validate the logging level.
    level = level.upper()
    if level not in ("DEBUG", "INFO", "WARNING", "ERROR", "CRITICAL"):
        raise ValueError(f"Invalid logging level: {level}")

    # Set up logging with a stream handler.
    handler = logging.StreamHandler()
    handler.setFormatter(DefaultFormatter(fmt="%(levelprefix)s %(message)s"))
    logging.basicConfig(
        force=True,
        format="%(levelprefix)s %(message)s",
        handlers=[handler],
    )

    logging.getLogger("auto-rest").setLevel(level)
    logging.getLogger("sqlalchemy").setLevel(1000)

create_cli_parser(exit_on_error=True)

Create a command-line argument parser with preconfigured arguments.

Parameters:

Name	Type	Description	Default
exit_on_error	bool	Whether to exit the program on a parsing error.	True

Returns:

Type	Description
ArgumentParser	An argument parser instance.

Source code in auto_rest/cli.py

def create_cli_parser(exit_on_error: bool = True) -> ArgumentParser:
    """Create a command-line argument parser with preconfigured arguments.

    Args:
        exit_on_error: Whether to exit the program on a parsing error.

    Returns:
        An argument parser instance.
    """

    formatter = lambda prog: HelpFormatter(prog, max_help_position=29)
    parser = ArgumentParser(
        prog="auto-rest",
        description="Automatically map database schemas and deploy per-table REST API endpoints.",
        exit_on_error=exit_on_error,
        formatter_class=formatter
    )

    parser.add_argument("--version", action="version", version=VERSION)
    parser.add_argument(
        "--log-level",
        default="INFO",
        type=lambda x: x.upper(),
        choices=["DEBUG", "INFO", "WARNING", "ERROR"],
        help="Set the logging level."
    )

    driver = parser.add_argument_group("database type")
    db_type = driver.add_mutually_exclusive_group(required=True)
    db_type.add_argument("--sqlite", action="store_const", dest="db_driver", const="sqlite+aiosqlite", help="use a SQLite database driver.")
    db_type.add_argument("--psql", action="store_const", dest="db_driver", const="postgresql+asyncpg", help="use a PostgreSQL database driver.")
    db_type.add_argument("--mysql", action="store_const", dest="db_driver", const="mysql+asyncmy", help="use a MySQL database driver.")
    db_type.add_argument("--oracle", action="store_const", dest="db_driver", const="oracle+oracledb", help="use an Oracle database driver.")
    db_type.add_argument("--mssql", action="store_const", dest="db_driver", const="mssql+aiomysql", help="use a Microsoft database driver.")
    db_type.add_argument("--driver", action="store", dest="db_driver", help="use a custom database driver.")

    database = parser.add_argument_group("database settings")
    database.add_argument("--db-host", help="database address to connect to.")
    database.add_argument("--db-port", type=int, help="database port to connect to.")
    database.add_argument("--db-name", required=True, help="database name or file path to connect to.")
    database.add_argument("--db-user", help="username to authenticate with.")
    database.add_argument("--db-pass", help="password to authenticate with.")
    database.add_argument("--db-config", action="store", type=Path, help="path to a database configuration file.")

    server = parser.add_argument_group(title="server settings")
    server.add_argument("--server-host", default="127.0.0.1", help="API server host address.")
    server.add_argument("--server-port", type=int, default=8081, help="API server port number.")

    schema = parser.add_argument_group(title="application settings")
    schema.add_argument("--app-title", default="Auto-REST", help="application title.")
    schema.add_argument("--app-version", default=VERSION, help="application version number.")

    return parser