auto-rest-api 0.1.2__tar.gz → 0.1.4__tar.gz

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: auto-rest-api
-Version: 0.1.2
+Version: 0.1.4
 Summary: Automatically map database schemas and deploy per-table REST API endpoints.
 License: GPL-3.0-only
 Keywords: Better,HPC,automatic,rest,api
@@ -34,7 +34,7 @@ Description-Content-Type: text/markdown
 
 # Auto-REST
 
-A command line tool for deploying dynamically generated REST APIs against relational databases.
+A light-weight CLI tool for deploying dynamically generated REST APIs against relational databases.
 See the [project documentation](https://better-hpc.github.io/auto-rest/) for detailed usage instructions.
 
 ## Supported Databases
@@ -70,10 +70,6 @@ Launch an API by providing connection arguments to a database of your choice.
 
 ```shell
 auto-rest \
-  # Enable optional endpoints / functionality
-  --enable-docs \
-  --enable-write \
-  # Define the database type and connection arguments
   --psql 
   --db-host localhost
   --db-port 5432

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/README.md

@@ -1,6 +1,6 @@
 # Auto-REST
 
-A command line tool for deploying dynamically generated REST APIs against relational databases.
+A light-weight CLI tool for deploying dynamically generated REST APIs against relational databases.
 See the [project documentation](https://better-hpc.github.io/auto-rest/) for detailed usage instructions.
 
 ## Supported Databases
@@ -36,10 +36,6 @@ Launch an API by providing connection arguments to a database of your choice.
 
 ```shell
 auto-rest \
-  # Enable optional endpoints / functionality
-  --enable-docs \
-  --enable-write \
-  # Define the database type and connection arguments
   --psql 
   --db-host localhost
   --db-port 5432

auto_rest_api-0.1.4/auto_rest/__main__.py

@@ -0,0 +1,70 @@
+"""Application entrypoint triggered by calling the packaged CLI command."""
+
+import logging
+
+from .app import *
+from .cli import *
+from .models import *
+from .routers import *
+
+__all__ = ["main", "run_application"]
+
+logger = logging.getLogger("auto-rest")
+
+
+def main() -> None:  # pragma: no cover
+    """Application entry point called when executing the command line interface.
+
+    This is a wrapper around the `run_application` function used to provide
+    graceful error handling.
+    """
+
+    try:
+        run_application()
+
+    except KeyboardInterrupt:
+        pass
+
+    except Exception as e:
+        logger.critical(str(e), exc_info=True)
+
+
+def run_application(cli_args: list[str] = None, /) -> None:  # pragma: no cover
+    """Run an Auto-REST API server.
+
+    This function is equivalent to launching an API server from the command line
+    and accepts the same arguments as those provided in the CLI. Arguments are
+    parsed from STDIN by default, unless specified in the function call.
+
+    Args:
+        A list of commandline arguments used to run the application.
+    """
+
+    # Parse application arguments
+    args = create_cli_parser().parse_args(cli_args)
+    configure_cli_logging(args.log_level)
+
+    logger.info(f"Resolving database connection settings.")
+    db_kwargs = parse_db_settings(args.db_config)
+    db_url = create_db_url(
+        driver=args.db_driver,
+        host=args.db_host,
+        port=args.db_port,
+        database=args.db_name,
+        username=args.db_user,
+        password=args.db_pass
+    )
+
+    logger.info("Mapping database schema.")
+    db_conn = create_db_engine(db_url, **db_kwargs)
+    db_meta = create_db_metadata(db_conn)
+
+    logger.info("Creating application.")
+    app = create_app(args.app_title, args.app_version)
+    app.include_router(create_welcome_router(), prefix="")
+    app.include_router(create_meta_router(db_conn, db_meta, args.app_title, args.app_version), prefix="/meta")
+    for table_name, table in db_meta.tables.items():
+        app.include_router(create_table_router(db_conn, table), prefix=f"/db/{table_name}")
+
+    logger.info(f"Launching server on http://{args.server_host}:{args.server_port}.")
+    run_server(app, args.server_host, args.server_port)

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/app.py

@@ -8,20 +8,42 @@ deploying Fast-API applications.
     ```python
     from auto_rest.app import create_app, run_server
 
-    app = create_app(app_title="My Application", app_version="1.2.3", enable_docs=True)
+    app = create_app(app_title="My Application", app_version="1.2.3")
     ... # Add endpoints to the application here
     run_server(app, host="127.0.0.1", port=8081)
     ```
 """
 
+import logging
+
 import uvicorn
-from fastapi import FastAPI
+from fastapi import FastAPI, Request
 from fastapi.middleware.cors import CORSMiddleware
+from starlette.responses import Response
 
 __all__ = ["create_app", "run_server"]
 
+logger = logging.getLogger("auto-rest")
+
+
+async def logging_middleware(request: Request, call_next: callable) -> Response:
+    """FastAPI middleware for the logging response status codes.
+
+    Args:
+        request: The incoming HTTP request.
+        call_next: The next middleware in the middleware chain.
+
+    Returns:
+        The outgoing HTTP response.
+    """
+
+    response = await call_next(request)
+    level = logging.INFO if response.status_code < 400 else logging.ERROR
+    logger.log(level, f"{request.method} ({response.status_code}) {request.client.host} - {request.url.path}")
+    return response
 
-def create_app(app_title: str, app_version: str, enable_docs: bool) -> FastAPI:
+
+def create_app(app_title: str, app_version: str) -> FastAPI:
     """Create and configure a FastAPI application instance.
 
     This function initializes a FastAPI app with a customizable title, version,
@@ -31,7 +53,6 @@ def create_app(app_title: str, app_version: str, enable_docs: bool) -> FastAPI:
     Args:
         app_title: The title of the FastAPI application.
         app_version: The version of the FastAPI application.
-        enable_docs: Whether to enable the `/docs/` endpoint.
 
     Returns:
         FastAPI: A configured FastAPI application instance.
@@ -40,14 +61,15 @@ def create_app(app_title: str, app_version: str, enable_docs: bool) -> FastAPI:
     app = FastAPI(
         title=app_title,
         version=app_version,
-        docs_url="/docs/" if enable_docs else None,
+        docs_url="/docs/",
         redoc_url=None,
     )
 
+    app.middleware("http")(logging_middleware)
     app.add_middleware(
         CORSMiddleware,
-        allow_origins=["*"],
         allow_credentials=True,
+        allow_origins=["*"],
         allow_methods=["*"],
         allow_headers=["*"],
     )
@@ -55,7 +77,7 @@ def create_app(app_title: str, app_version: str, enable_docs: bool) -> FastAPI:
     return app
 
 
-def run_server(app: FastAPI, host: str, port: int) -> None: # pragma: no cover
+def run_server(app: FastAPI, host: str, port: int) -> None:  # pragma: no cover
     """Deploy a FastAPI application server.
 
     Args:
@@ -64,4 +86,5 @@ def run_server(app: FastAPI, host: str, port: int) -> None: # pragma: no cover
         port: The port number for the server to listen on.
     """
 
-    uvicorn.run(app, host=host, port=port, log_level="error")
+    # Uvicorn overwrites its logging level when run and needs to be manually disabled here.
+    uvicorn.run(app, host=host, port=port, log_level=1000)

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/cli.py

@@ -62,11 +62,13 @@ def configure_cli_logging(level: str) -> None:
     handler.setFormatter(DefaultFormatter(fmt="%(levelprefix)s %(message)s"))
     logging.basicConfig(
         force=True,
-        level=level,
         format="%(levelprefix)s %(message)s",
         handlers=[handler],
     )
 
+    logging.getLogger("auto-rest").setLevel(level)
+    logging.getLogger("sqlalchemy").setLevel(1000)
+
 
 def create_cli_parser(exit_on_error: bool = True) -> ArgumentParser:
     """Create a command-line argument parser with preconfigured arguments.
@@ -95,10 +97,6 @@ def create_cli_parser(exit_on_error: bool = True) -> ArgumentParser:
         help="Set the logging level."
     )
 
-    features = parser.add_argument_group(title="API features")
-    features.add_argument("--enable-docs", action="store_true", help="enable the 'docs' endpoint.")
-    features.add_argument("--enable-write", action="store_true", help="enable support for write operations.")
-
     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.")

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/handlers.py

@@ -51,16 +51,15 @@ This makes it easy to incorporate handlers into a FastAPI application.
 """
 
 import logging
-from typing import Awaitable, Callable
+from typing import Awaitable, Callable, Literal, Optional
 
-from fastapi import Depends, Response
+from fastapi import Depends, Query, Response
 from pydantic import create_model
 from pydantic.main import BaseModel as PydanticModel
 from sqlalchemy import insert, MetaData, select, Table
 
 from .interfaces import *
 from .models import *
-from .params import *
 from .queries import *
 
 __all__ = [
@@ -76,7 +75,7 @@ __all__ = [
     "create_welcome_handler",
 ]
 
-logger = logging.getLogger(__name__)
+logger = logging.getLogger("auto-rest")
 
 
 def create_welcome_handler() -> Callable[[], Awaitable[PydanticModel]]:
@@ -192,21 +191,30 @@ def create_list_records_handler(engine: DBEngine, table: Table) -> Callable[...,
     """
 
     interface = create_interface(table)
+    interface_opt = create_interface(table, mode="optional")
+    columns = tuple(table.columns.keys())
 
     async def list_records_handler(
         response: Response,
         session: DBSession = Depends(create_session_iterator(engine)),
-        pagination_params: dict[str, int] = create_pagination_dependency(table),
-        ordering_params: dict[str, int] = create_ordering_dependency(table),
+        _limit_: int = Query(0, ge=0, description="The maximum number of records to return."),
+        _offset_: int = Query(0, ge=0, description="The starting index of the returned records."),
+        _order_by_: Optional[Literal[*columns]] = Query(None, description="The field name to sort by."),
+        _direction_: Literal["asc", "desc"] = Query("asc", description="Sort results in 'asc' or 'desc' order.")
     ) -> list[interface]:
         """Fetch a list of records from the database.
 
         URL query parameters are used to enable filtering, ordering, and paginating returned values.
         """
 
+        response.headers["X-Pagination-Limit"] = str(_limit_)
+        response.headers["X-Pagination-Offset"] = str(_offset_)
+        response.headers["X-Order-By"] = str(_order_by_)
+        response.headers["X-Order-Direction"] = str(_direction_)
+
         query = select(table)
-        query = apply_pagination_params(query, pagination_params, response)
-        query = apply_ordering_params(query, ordering_params, response)
+        query = apply_pagination_params(query, _limit_, _offset_)
+        query = apply_ordering_params(query, _order_by_, _direction_)
 
         result = await execute_session_query(session, query)
         return [row._mapping for row in result.all()]

auto_rest_api-0.1.4/auto_rest/interfaces.py

@@ -0,0 +1,115 @@
+"""Pydantic models are used to facilitate data validation and to define
+interfaces for FastAPI endpoint handlers. The `interfaces` module
+provides utility functions for converting SQLAlchemy models into
+Pydantic interfaces. Interfaces can be created using different modes
+which force interface fields to be optional or read only.
+
+!!! example "Example: Creating an Interface"
+
+    The `create_interface_default` method creates an interface class
+    based on a SQLAlchemy table.
+
+    ```python
+    default_interface = create_interface(database_model)
+    required_interface = create_interface(database_model, mode="required")
+    optional_interface = create_interface(database_model, mode="optional")
+    ```
+"""
+
+from typing import Any, Iterator, Literal
+
+from pydantic import BaseModel as PydanticModel, create_model
+from sqlalchemy import Column, Table
+
+__all__ = ["create_interface"]
+
+MODE_TYPE = Literal["default", "required", "optional"]
+
+
+def iter_columns(table: Table, pk_only: bool = False) -> Iterator[Column]:
+    """Iterate over the columns of a SQLAlchemy model.
+
+    Args:
+        table: The table to iterate columns over.
+        pk_only: If True, only iterate over primary key columns.
+
+    Yields:
+        A column of the SQLAlchemy model.
+    """
+
+    for column in table.columns.values():
+        if column.primary_key or not pk_only:
+            yield column
+
+
+def create_field_definition(col: Column, mode: MODE_TYPE = "default") -> tuple[type[any], any]:
+    """Return a tuple with the type and default value for a database table column.
+
+    The returned tuple is compatible for use with Pydantic as a field definition
+    during dynamic model generation. The `mode` argument modifies returned
+    values to enforce different behavior in the generated Pydantic interface.
+
+    Modes:
+        default: Values are marked as (not)required based on the column schema.
+        required: Values are always marked required.
+        required: Values are always marked optional.
+
+    Args:
+        col: The column to return values for.
+        mode: The mode to use when determining the default value.
+
+    Returns:
+        The default value for the column.
+    """
+
+    try:
+        col_type = col.type.python_type
+
+    except NotImplementedError:
+        col_type = Any
+
+    col_default = getattr(col.default, "arg", col.default)
+
+    if mode == "required":
+        return col_type, ...
+
+    elif mode == "optional":
+        return col_type | None, col_default
+
+    elif mode == "default" and (col.nullable or col.default):
+        return col_type | None, col_default
+
+    elif mode == "default":
+        return col_type, ...
+
+    raise RuntimeError(f"Unknown mode: {mode}")
+
+
+def create_interface(table: Table, pk_only: bool = False, mode: MODE_TYPE = "default") -> type[PydanticModel]:
+    """Create a Pydantic interface for a SQLAlchemy model where all fields are required.
+
+    Modes:
+        default: Values are marked as (not)required based on the column schema.
+        required: Values are always marked required.
+        required: Values are always marked optional.
+
+    Args:
+        table: The SQLAlchemy table to create an interface for.
+        pk_only: If True, only include primary key columns.
+        mode: Whether to force fields to all be optional or required.
+
+    Returns:
+        A dynamically generated Pydantic model with all fields required.
+    """
+
+    # Map field names to the column type and default value.
+    fields = {
+        col.name: create_field_definition(col, mode) for col in iter_columns(table, pk_only)
+    }
+
+    # Create a unique name for the interface
+    name = f"{table.name}-{mode.title()}"
+    if pk_only:
+        name += '-PK'
+
+    return create_model(name, __config__={'arbitrary_types_allowed': True}, **fields)

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/models.py

@@ -34,6 +34,7 @@ import logging
 from pathlib import Path
 from typing import Callable
 
+import yaml
 from sqlalchemy import create_engine, Engine, MetaData, URL
 from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession, create_async_engine
 from sqlalchemy.orm import Session
@@ -45,15 +46,34 @@ __all__ = [
     "create_db_metadata",
     "create_db_url",
     "create_session_iterator",
+    "parse_db_settings"
 ]
 
-logger = logging.getLogger(__name__)
+logger = logging.getLogger("auto-rest")
 
 # Base classes and typing objects.
 DBEngine = Engine | AsyncEngine
 DBSession = Session | AsyncSession
 
 
+def parse_db_settings(path: Path | None) -> dict[str, any]:
+    """Parse engine configuration settings from a given file path.
+
+    Args:
+        path: Path to the configuration file.
+
+    Returns:
+        Engine configuration settings.
+    """
+
+    if path is not None:
+        logger.debug(f"Parsing engine configuration from {path}.")
+        return yaml.safe_load(path.read_text()) or dict()
+
+    logger.debug("No connection file specified.")
+    return {}
+
+
 def create_db_url(
     driver: str,
     database: str,
@@ -76,21 +96,23 @@ def create_db_url(
         A fully qualified database URL.
     """
 
-    logger.debug("Resolving database URL.")
-
     # Handle special case where SQLite uses file paths.
     if "sqlite" in driver:
         path = Path(database).resolve()
-        return URL.create(drivername=driver, database=str(path))
-
-    return URL.create(
-        drivername=driver,
-        username=username,
-        password=password,
-        host=host,
-        port=port,
-        database=database,
-    )
+        url = URL.create(drivername=driver, database=str(path))
+
+    else:
+        url = URL.create(
+            drivername=driver,
+            username=username,
+            password=password,
+            host=host,
+            port=port,
+            database=database,
+        )
+
+    logger.debug(f"Resolved URL: {url}")
+    return url
 
 
 def create_db_engine(url: URL, **kwargs: dict[str: any]) -> DBEngine:

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/queries.py

@@ -20,14 +20,18 @@ handling and provides a streamlined interface for database interactions.
     ```
 """
 
+from typing import Literal
+
 from fastapi import HTTPException
-from sqlalchemy import Executable, Result
+from sqlalchemy import asc, desc, Executable, Result, Select
 from sqlalchemy.ext.asyncio import AsyncSession
 from starlette import status
 
 from auto_rest.models import DBSession
 
 __all__ = [
+    "apply_ordering_params",
+    "apply_pagination_params",
     "commit_session",
     "delete_session_record",
     "execute_session_query",
@@ -35,6 +39,64 @@ __all__ = [
 ]
 
 
+def apply_ordering_params(
+    query: Select,
+    order_by: str | None = None,
+    direction: Literal["desc", "asc"] = "asc"
+) -> Select:
+    """Apply ordering to a database query.
+
+    Returns a copy of the provided query with ordering parameters applied.
+
+    Args:
+        query: The database query to apply parameters to.
+        order_by: The name of the column to order by.
+        direction: The direction to order by (defaults to "asc").
+
+    Returns:
+        A copy of the query modified to return ordered values.
+    """
+
+    if order_by is None:
+        return query
+
+    if order_by not in query.columns:
+        raise ValueError(f"Invalid column name: {order_by}")
+
+    # Default to ascending order for an invalid ordering direction
+    if direction == "desc":
+        return query.order_by(desc(order_by))
+
+    elif direction == "asc":
+        return query.order_by(asc(order_by))
+
+    raise ValueError(f"Invalid direction, use 'asc' or 'desc': {direction}")
+
+
+def apply_pagination_params(query: Select, limit: int = 0, offset: int = 0) -> Select:
+    """Apply pagination to a database query.
+
+    Returns a copy of the provided query with offset and limit parameters applied.
+
+    Args:
+        query: The database query to apply parameters to.
+        limit: The number of results to return.
+        offset: The offset to start with.
+
+    Returns:
+        A copy of the query modified to only return the paginated values.
+    """
+
+    if offset < 0 or limit < 0:
+        raise ValueError("Pagination parameters cannot be negative")
+
+    # Do not apply pagination if not requested
+    if limit == 0:
+        return query
+
+    return query.offset(offset or 0).limit(limit)
+
+
 async def commit_session(session: DBSession) -> None:
     """Commit a SQLAlchemy session.
 

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/auto_rest/routers.py

@@ -23,6 +23,8 @@ routers to be added directly to an API application instance.
     ```
 """
 
+import logging
+
 from fastapi import APIRouter
 from sqlalchemy import MetaData, Table
 from starlette import status
@@ -36,6 +38,8 @@ __all__ = [
     "create_welcome_router",
 ]
 
+logger = logging.getLogger("auto-rest")
+
 
 def create_welcome_router() -> APIRouter:
     """Create an API router for returning a welcome message.
@@ -44,6 +48,8 @@ def create_welcome_router() -> APIRouter:
         An `APIRouter` with a single route for retrieving a welcome message.
     """
 
+    logger.debug("Creating welcome endpoint.")
+
     router = APIRouter()
     router.add_api_route(
         path="/",
@@ -71,6 +77,8 @@ def create_meta_router(engine: DBEngine, metadata: MetaData, name: str, version:
         An `APIRouter` with a routes for retrieving application metadata.
     """
 
+    logger.debug("Creating metadata endpoints.")
+
     router = APIRouter()
     tags = ["Application Metadata"]
 
@@ -101,25 +109,25 @@ def create_meta_router(engine: DBEngine, metadata: MetaData, name: str, version:
     return router
 
 
-def create_table_router(engine: DBEngine, table: Table, writeable: bool = False) -> APIRouter:
+def create_table_router(engine: DBEngine, table: Table) -> APIRouter:
     """Create an API router with endpoint handlers for a given database table.
 
     Args:
         engine: The SQLAlchemy engine connected to the database.
         table: The database table to create API endpoints for.
-        writeable: Whether the router should include support for write operations.
 
     Returns:
         An APIRouter instance with routes for database operations on the table.
     """
 
+    logger.debug(f"Creating endpoints for table `{table.name}`.")
     router = APIRouter()
 
     # Construct path parameters from primary key columns
     pk_columns = sorted(column.name for column in table.primary_key.columns)
     path_params_url = "/".join(f"{{{col_name}}}" for col_name in pk_columns)
 
-    # Add route for read operations against the table
+    # Add routes for operations against the table
     router.add_api_route(
         path="/",
         methods=["GET"],
@@ -129,16 +137,14 @@ def create_table_router(engine: DBEngine, table: Table, writeable: bool = False)
         tags=[table.name],
     )
 
-    # Add route for write operations against the table
-    if writeable:
-        router.add_api_route(
-            path="/",
-            methods=["POST"],
-            endpoint=create_post_record_handler(engine, table),
-            status_code=status.HTTP_201_CREATED,
-            summary="Create a new record.",
-            tags=[table.name],
-        )
+    router.add_api_route(
+        path="/",
+        methods=["POST"],
+        endpoint=create_post_record_handler(engine, table),
+        status_code=status.HTTP_201_CREATED,
+        summary="Create a new record.",
+        tags=[table.name],
+    )
 
     # Add route for read operations against individual records
     if pk_columns:
@@ -151,8 +157,6 @@ def create_table_router(engine: DBEngine, table: Table, writeable: bool = False)
             tags=[table.name],
         )
 
-    # Add routes for write operations against individual records
-    if pk_columns and writeable:
         router.add_api_route(
             path=f"/{path_params_url}/",
             methods=["PUT"],

{auto_rest_api-0.1.2 → auto_rest_api-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "auto-rest-api"
-version = "0.1.2"
+version = "0.1.4"
 readme = "README.md"
 description = "Automatically map database schemas and deploy per-table REST API endpoints."
 authors = [{ name = "Better HPC LLC" }]
@@ -45,7 +45,6 @@ packages = [
     { include = "auto_rest" },
 ]
 
-
 [tool.poetry.group.tests.dependencies]
 coverage = "*"
 
@@ -56,3 +55,8 @@ mkdocstrings-python = "^1.13.0"
 
 [tool.poetry.scripts]
 auto-rest = "auto_rest.__main__:main"
+
+[tool.coverage.run]
+branch = true
+source = ["auto_rest"]
+omit = ["tests/*"]

auto_rest_api-0.1.2/auto_rest/__main__.py

@@ -1,94 +0,0 @@
-"""Application entrypoint triggered by calling the packaged CLI command."""
-
-import logging
-from pathlib import Path
-
-import yaml
-
-from .app import *
-from .cli import *
-from .models import *
-from .routers import *
-
-__all__ = ["main", "run_application"]
-
-logger = logging.getLogger(__name__)
-
-
-def main() -> None:  # pragma: no cover
-    """Parse command-line arguments and launch an API server."""
-
-    try:
-        parser = create_cli_parser()
-        args = vars(parser.parse_args())
-        log_level = args.pop("log_level")
-
-        configure_cli_logging(log_level)
-        run_application(**args)
-
-    except KeyboardInterrupt:
-        pass
-
-    except Exception as e:
-        logger.critical(str(e), exc_info=True)
-
-
-def run_application(
-    enable_docs: bool,
-    enable_write: bool,
-    db_driver: str,
-    db_host: str,
-    db_port: int,
-    db_name: str,
-    db_user: str,
-    db_pass: str,
-    db_config: Path | None,
-    server_host: str,
-    server_port: int,
-    app_title: str,
-    app_version: str,
-) -> None:  # pragma: no cover
-    """Run an Auto-REST API server.
-
-    This function is equivalent to launching an API server from the command line
-    and accepts the same arguments as those provided in the CLI.
-
-    Args:
-        enable_docs: Whether to enable the 'docs' API endpoint.
-        enable_write: Whether to enable support for write operations.
-        db_driver: SQLAlchemy-compatible database driver.
-        db_host: Database host address.
-        db_port: Database port number.
-        db_name: Database name.
-        db_user: Database authentication username.
-        db_pass: Database authentication password.
-        db_config: Path to a database configuration file.
-        server_host: API server host address.
-        server_port: API server port number.
-        app_title: title for the generated OpenAPI schema.
-        app_version: version number for the generated OpenAPI schema.
-    """
-
-    logger.info(f"Mapping database schema for {db_name}.")
-
-    # Resolve database connection settings
-    db_url = create_db_url(driver=db_driver, host=db_host, port=db_port, database=db_name, username=db_user, password=db_pass)
-    db_kwargs = yaml.safe_load(db_config.read_text()) if db_config else {}
-
-    # Connect to and map the database.
-    db_conn = create_db_engine(db_url, **db_kwargs)
-    db_meta = create_db_metadata(db_conn)
-
-    # Build an empty application and dynamically add the requested functionality.
-    logger.info("Creating API application.")
-    app = create_app(app_title, app_version, enable_docs)
-    app.include_router(create_welcome_router(), prefix="")
-    app.include_router(create_meta_router(db_conn, db_meta, app_title, app_version), prefix="/meta")
-
-    for table_name, table in db_meta.tables.items():
-        logger.info(f"Adding `/db/{table_name}` endpoint.")
-        app.include_router(create_table_router(db_conn, table, enable_write), prefix=f"/db/{table_name}")
-
-    # Launch the API server.
-    logger.info(f"Launching API server on http://{server_host}:{server_port}.")
-    run_server(app, server_host, server_port)

auto_rest_api-0.1.2/auto_rest/interfaces.py

@@ -1,126 +0,0 @@
-"""Pydantic models are used to facilitate data validation and to define
-interfaces for FastAPI endpoint handlers. The `interfaces` module
-provides utility functions for converting SQLAlchemy models into
-Pydantic interfaces. Interfaces can be created using different modes
-which force interface fields to be optional or read only.
-
-!!! example "Example: Creating an Interface"
-
-    The `create_interface_default` method creates an interface class
-    based on a SQLAlchemy table.
-
-    ```python
-    default_interface = create_interface_default(database_model)
-    required_interface = create_interface_required(database_model, mode="required")
-    optional_interface = create_interface_optional(database_model, mode="optional")
-    ```
-"""
-from typing import Iterator, Literal
-
-from pydantic import BaseModel as PydanticModel, create_model
-from sqlalchemy import Column, Table
-
-__all__ = ["create_interface"]
-
-from sqlalchemy.sql.schema import ScalarElementColumnDefault
-
-MODES = Literal["default", "required", "optional"]
-
-
-def iter_columns(table: Table, pk_only: bool = False) -> Iterator[Column]:
-    """Iterate over the columns of a SQLAlchemy model.
-
-    Args:
-        table: The table to iterate columns over.
-        pk_only: If True, only iterate over primary key columns.
-
-    Yields:
-        A column of the SQLAlchemy model.
-    """
-
-    for column in table.columns:
-        if column.primary_key or not pk_only:
-            yield column
-
-
-def get_column_type(col: Column) -> type[any]:
-    """Return the Python type corresponding to a column's DB datatype.
-
-    Returns the `any` type for DBMS drivers that do not support mapping DB
-    types to Python primitives,
-
-    Args:
-        col: The column to determine a type for.
-
-    Returns:
-        The equivalent Python type for the column data.
-    """
-
-    try:
-        return col.type.python_type
-
-    # Catch any error, but list the expected ones explicitly
-    except (NotImplementedError, Exception):
-        return any
-
-
-def get_column_default(col: Column, mode: MODES) -> any:
-    """Return the default value for a column.
-
-    Args:
-        col: The column to determine a default value for.
-        mode: The mode to use when determining the default value.
-
-    Returns:
-        The default value for the column.
-    """
-
-    # Extract the default value from the SQLAlchemy wrapper class
-    sqla_default = col.default
-    default = getattr(sqla_default, "arg", None) or sqla_default
-
-    if mode == "required":
-        return ...
-
-    elif mode == "optional":
-        return default
-
-    elif mode == "default":
-        if col.nullable or (col.default is not None):
-            return default
-
-        return ...
-
-    raise RuntimeError(f"Unknown mode: {mode}")
-
-
-def create_interface(
-    table: Table,
-    pk_only: bool = False,
-    mode: MODES = "default"
-) -> type[PydanticModel]:
-    """Create a Pydantic interface for a SQLAlchemy model where all fields are required.
-
-    Args:
-        table: The SQLAlchemy table to create an interface for.
-        pk_only: If True, only include primary key columns.
-        mode: Whether to force fields to all be optional or required.
-
-    Returns:
-        A dynamically generated Pydantic model with all fields required.
-    """
-
-    # Map field names to the column type and default value.
-    columns = iter_columns(table, pk_only)
-    fields = {
-        col.name: (get_column_type(col), get_column_default(col, mode))
-        for col in columns
-    }
-
-    # Dynamically create a unique name for the interface
-    name_parts = [table.name, mode.title()]
-    if pk_only:
-        name_parts.insert(1, 'PK')
-
-    interface_name = '-'.join(name_parts)
-    return create_model(interface_name, **fields)

auto_rest_api-0.1.2/auto_rest/params.py

@@ -1,174 +0,0 @@
-"""
-The `params` module provides utilities for extracting and applying query
-parameters from incoming HTTP requests. These utilities ensure the consistent
-parsing, validation, and application of query parameters, and automatically
-update HTTP response headers to reflect applied query options.
-
-Parameter functions are designed in pairs of two. The first function is a
-factory for creating an injectable FastAPI dependency. The dependency
-is used to parse parameters from incoming requests and applies high level
-validation against the parsed values. The second function to applies the
-validated arguments onto a SQLAlchemy query and returns the updated query.
-
-!!! example "Example: Parameter Parsing and Application"
-
-    ```python
-    from fastapi import FastAPI, Response
-    from sqlalchemy import select
-    from auto_rest.query_params import create_pagination_dependency, apply_pagination_params
-
-    app = FastAPI()
-
-    @app.get("/items/")
-    async def list_items(
-        pagination_params: dict = create_pagination_dependency(model),
-        response: Response
-    ):
-        query = select(model)
-        query = apply_pagination_params(query, pagination_params, response)
-        return ...  # Logic to further process and execute the query goes here
-    ```
-"""
-
-from collections.abc import Callable
-from typing import Literal, Optional
-
-from fastapi import Depends, Query
-from sqlalchemy import asc, desc, Table
-from sqlalchemy.sql.selectable import Select
-from starlette.responses import Response
-
-__all__ = [
-    "apply_ordering_params",
-    "apply_pagination_params",
-    "create_ordering_dependency",
-    "create_pagination_dependency",
-]
-
-
-def create_ordering_dependency(table: Table) -> Callable[..., dict]:
-    """Create an injectable dependency for fetching ordering arguments from query parameters.
-
-    Args:
-        table: The database table to create the dependency for.
-
-    Returns:
-        An injectable FastAPI dependency.
-    """
-
-    columns = tuple(table.columns.keys())
-
-    def get_ordering_params(
-        _order_by_: Optional[Literal[*columns]] = Query(None, description="The field name to sort by."),
-        _direction_: Optional[Literal["asc", "desc"]] = Query(None, description="Sort results in 'asc' or 'desc' order.")
-    ) -> dict:
-        """Extract ordering parameters from request query parameters.
-
-        Args:
-            _order_by_: The field to order by.
-            _direction_: The direction to order by.
-
-        Returns:
-            dict: A dictionary containing the `order_by` and `direction` values.
-        """
-
-        return {"order_by": _order_by_, "direction": _direction_}
-
-    return Depends(get_ordering_params)
-
-
-def apply_ordering_params(query: Select, params: dict, response: Response) -> Select:
-    """Apply ordering to a database query.
-
-    Returns a copy of the provided query with ordering parameters applied.
-    This method is compatible with parameters returned by the `get_ordering_params` method.
-    Ordering is not applied for invalid params, but response headers are still set.
-
-    Args:
-        query: The database query to apply parameters to.
-        params: A dictionary containing parsed URL parameters.
-        response: The outgoing HTTP response object.
-
-    Returns:
-        A copy of the query modified to return ordered values.
-    """
-
-    order_by = params.get("order_by")
-    direction = params.get("direction")
-
-    # Set common response headers
-    response.headers["X-Order-By"] = str(order_by)
-    response.headers["X-Order-Direction"] = str(direction)
-
-    if order_by is None:
-        response.headers["X-Order-Applied"] = "false"
-        return query
-
-    # Default to ascending order for an invalid ordering direction
-    response.headers["X-Order-Applied"] = "true"
-    if direction == "desc":
-        return query.order_by(desc(order_by))
-
-    else:
-        return query.order_by(asc(order_by))
-
-
-def create_pagination_dependency(table: Table) -> Callable[..., dict]:
-    """Create an injectable dependency for fetching pagination arguments from query parameters.
-
-    Args:
-        table: The database table to create the dependency for.
-
-    Returns:
-        An injectable FastAPI dependency.
-    """
-
-    def get_pagination_params(
-        _limit_: Optional[int] = Query(None, ge=0, description="The maximum number of records to return."),
-        _offset_: Optional[int] = Query(None, ge=0, description="The starting index of the returned records."),
-    ) -> dict[str, int]:
-        """Extract pagination parameters from request query parameters.
-
-        Args:
-            _limit_: The maximum number of records to return.
-            _offset_: The starting index of the returned records.
-
-        Returns:
-            dict: A dictionary containing the `limit` and `offset` values.
-        """
-
-        return {"limit": _limit_, "offset": _offset_}
-
-    return Depends(get_pagination_params)
-
-
-def apply_pagination_params(query: Select, params: dict[str, int], response: Response) -> Select:
-    """Apply pagination to a database query.
-
-    Returns a copy of the provided query with offset and limit parameters applied.
-    This method is compatible with parameters returned by the `get_pagination_params` method.
-    Pagination is not applied for invalid params, but response headers are still set.
-
-    Args:
-        query: The database query to apply parameters to.
-        params: A dictionary containing parsed URL parameters.
-        response: The outgoing HTTP response object.
-
-    Returns:
-        A copy of the query modified to only return the paginated values.
-    """
-
-    limit = params.get("limit")
-    offset = params.get("offset")
-
-    # Set common response headers
-    response.headers["X-Pagination-Limit"] = str(limit)
-    response.headers["X-Pagination-Offset"] = str(offset)
-
-    # Do not apply pagination if not requested
-    if limit in (0, None):
-        response.headers["X-Pagination-Applied"] = "false"
-        return query
-
-    response.headers["X-Pagination-Applied"] = "true"
-    return query.offset(offset or 0).limit(limit)