server/app.py

# Copyright (c) Meta Platforms, Inc. and affiliates.
# All rights reserved.
#
# This source code is licensed under the BSD-style license found in the
# LICENSE file in the root directory of this source tree.

"""FastAPI application for the CyberSecurity_OWASP OpenEnv server."""

try:
    from openenv.core.env_server.http_server import create_app
except Exception as e:  # pragma: no cover
    raise ImportError(
        "openenv is required for the web interface. Install dependencies with '\n    uv sync\n'"
    ) from e

try:
    from ..models import CyberSecurityOWASPAction, CyberSecurityOWASPObservation
    from .CyberSecurity_OWASP_environment import CybersecurityOwaspEnvironment
except ModuleNotFoundError:
    from models import CyberSecurityOWASPAction, CyberSecurityOWASPObservation
    from server.CyberSecurity_OWASP_environment import CybersecurityOwaspEnvironment


# Create the app with web interface and README integration
app = create_app(
    CybersecurityOwaspEnvironment,
    CyberSecurityOWASPAction,
    CyberSecurityOWASPObservation,
    env_name="CyberSecurity_OWASP",
    max_concurrent_envs=4,
)


def main(host: str = "0.0.0.0", port: int = 8000):
    """
    Entry point for direct execution via uv run or python -m.

    This function enables running the server without Docker:
        uv run --project . server
        uv run --project . server --port 8001
        python -m CyberSecurity_OWASP.server.app

    Args:
        host: Host address to bind to (default: "0.0.0.0")
        port: Port number to listen on (default: 8000)

    For production deployments, consider using uvicorn directly with
    multiple workers:
        uvicorn CyberSecurity_OWASP.server.app:app --workers 4
    """
    import uvicorn

    uvicorn.run(app, host=host, port=port)


if __name__ == "__main__":
    import argparse

    parser = argparse.ArgumentParser()
    parser.add_argument("--port", type=int, default=8000)
    args = parser.parse_args()
    main(port=args.port)