Skip to content

ontocast.cli.http_parse

Shared HTTP query/body parsing for CLI server routes.

parse_llm_graph_format_param(value, default)

Parse optional llm_graph_format override from request params.

Source code in ontocast/cli/http_parse.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
def parse_llm_graph_format_param(
    value: str | LLMGraphFormat | None,
    default: LLMGraphFormat,
) -> LLMGraphFormat:
    """Parse optional ``llm_graph_format`` override from request params."""
    if value is None:
        return default
    if isinstance(value, LLMGraphFormat):
        return value
    if isinstance(value, str):
        normalized = value.lower().strip()
        try:
            return LLMGraphFormat(normalized)
        except ValueError:
            logger.warning(
                "Invalid llm_graph_format '%s', using default '%s'",
                value,
                default.value,
            )
    return default

parse_max_visits_param(value, default)

Parse optional max_visits override from query/form/json metadata.

Source code in ontocast/cli/http_parse.py 
102
103
104
105
106
107
108
109
110
111
112
def parse_max_visits_param(value: str | int | None, default: int) -> int:
    """Parse optional ``max_visits`` override from query/form/json metadata."""
    if value is None:
        return default
    try:
        parsed = int(str(value).strip())
    except (TypeError, ValueError) as exc:
        raise ValueError("max_visits must be an integer >= 1") from exc
    if parsed < 1:
        raise ValueError("max_visits must be an integer >= 1")
    return parsed

parse_strip_provenance_param(value)

Parse strip_provenance query/form value.

Source code in ontocast/cli/http_parse.py 
86
87
88
89
90
91
92
93
94
95
96
97
98
99
def parse_strip_provenance_param(value: str | None) -> bool:
    """Parse ``strip_provenance`` query/form value."""
    if value is None:
        return False
    normalized = str(value).strip().lower()
    if normalized in {"", "0", "false", "no", "off"}:
        return False
    if normalized in {"1", "true", "yes", "on"}:
        return True
    logger.warning(
        "Invalid strip_provenance %r, treating as false",
        value,
    )
    return False

resolve_ontology_context_mode(requested_mode, fixed_ontology_id)

Resolve effective ontology context mode for a request.

A non-empty ontology_context_fixed_ontology_id forces fixed catalog mode. This allows clients to pick fixed ontology context per request even when the server default mode differs.

Source code in ontocast/cli/http_parse.py 
71
72
73
74
75
76
77
78
79
80
81
82
83
def resolve_ontology_context_mode(
    requested_mode: OntologyContextMode,
    fixed_ontology_id: str,
) -> OntologyContextMode:
    """Resolve effective ontology context mode for a request.

    A non-empty ``ontology_context_fixed_ontology_id`` forces fixed catalog mode.
    This allows clients to pick fixed ontology context per request even when the
    server default mode differs.
    """
    if fixed_ontology_id.strip():
        return OntologyContextMode.FIXED_SINGLE_ONTOLOGY
    return requested_mode