trafficmorph 0.3.0__py3-none-any.whl

trafficmorph/api/domains/verify_dns.py

@@ -0,0 +1,124 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+
+
+
+def _get_kwargs(
+    id: int,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/api/v1/domains/{id}/verify/dns".format(id=quote(str(id), safe=""),),
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Any | None:
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[Any]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Run the DNS-TXT verification check
+
+     Looks up the configured TXT record at `_trafficmorph-verify.{domain}` and matches it against the
+    challenge value issued when the domain was added. On match, the domain flips to `VERIFIED` and can
+    be used as a profile target. **On miss**, returns 400 with a remediation message — the call is
+    treated as a failed verification attempt rather than a polling no-op, so CI flows fail fast instead
+    of looping on always-`PENDING` 200s.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Run the DNS-TXT verification check
+
+     Looks up the configured TXT record at `_trafficmorph-verify.{domain}` and matches it against the
+    challenge value issued when the domain was added. On match, the domain flips to `VERIFIED` and can
+    be used as a profile target. **On miss**, returns 400 with a remediation message — the call is
+    treated as a failed verification attempt rather than a polling no-op, so CI flows fail fast instead
+    of looping on always-`PENDING` 200s.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+

trafficmorph/api/domains/verify_http.py

@@ -0,0 +1,122 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+
+
+
+def _get_kwargs(
+    id: int,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "post",
+        "url": "/api/v1/domains/{id}/verify/http".format(id=quote(str(id), safe=""),),
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Any | None:
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[Any]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Run the HTTP-token verification check
+
+     Fetches `https://{domain}/.well-known/trafficmorph-verify.txt` (falling back to HTTP if HTTPS fails)
+    and matches its body against the challenge token. Alternative to DNS verification for users without
+    DNS control. **On miss**, returns 400 with a remediation message — same fail-fast contract as
+    `/verify/dns`.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Run the HTTP-token verification check
+
+     Fetches `https://{domain}/.well-known/trafficmorph-verify.txt` (falling back to HTTP if HTTPS fails)
+    and matches its body against the challenge token. Alternative to DNS verification for users without
+    DNS control. **On miss**, returns 400 with a remediation message — same fail-fast contract as
+    `/verify/dns`.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+

trafficmorph/api/history/__init__.py

@@ -0,0 +1 @@
+""" Contains endpoint functions for accessing the API """

trafficmorph/api/history/get_history_item.py

@@ -0,0 +1,122 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+
+
+
+def _get_kwargs(
+    id: int,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/history/{id}".format(id=quote(str(id), safe=""),),
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Any | None:
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[Any]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Get a single run's full detail
+
+     Returns the run's complete metric set: response-code distribution, latency quantiles, RPS / latency
+    time series, secondary stats from response scripts, the auto-comparison snapshot against baseline,
+    and the verdict reasoning. This is the endpoint a CI step polls after `/profiles/{id}/start` to
+    decide pass/fail.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio_detailed(
+    id: int,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[Any]:
+    """ Get a single run's full detail
+
+     Returns the run's complete metric set: response-code distribution, latency quantiles, RPS / latency
+    time series, secondary stats from response scripts, the auto-comparison snapshot against baseline,
+    and the verdict reasoning. This is the endpoint a CI step polls after `/profiles/{id}/start` to
+    decide pass/fail.
+
+    Args:
+        id (int):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+

trafficmorph/api/history/list_history.py

@@ -0,0 +1,210 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...types import UNSET, Unset
+from dateutil.parser import isoparse
+from typing import cast
+import datetime
+
+
+
+def _get_kwargs(
+    *,
+    page: int | Unset = 0,
+    size: int | Unset = 20,
+    profile_id: int | Unset = UNSET,
+    triggered_by: str | Unset = UNSET,
+    region: str | Unset = UNSET,
+    auto_verdict: str | Unset = UNSET,
+    tag: str | Unset = UNSET,
+    from_: datetime.datetime | Unset = UNSET,
+    to: datetime.datetime | Unset = UNSET,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    params: dict[str, Any] = {}
+
+    params["page"] = page
+
+    params["size"] = size
+
+    params["profileId"] = profile_id
+
+    params["triggeredBy"] = triggered_by
+
+    params["region"] = region
+
+    params["autoVerdict"] = auto_verdict
+
+    params["tag"] = tag
+
+    json_from_: str | Unset = UNSET
+    if not isinstance(from_, Unset):
+        json_from_ = from_.isoformat()
+    params["from"] = json_from_
+
+    json_to: str | Unset = UNSET
+    if not isinstance(to, Unset):
+        json_to = to.isoformat()
+    params["to"] = json_to
+
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/history",
+        "params": params,
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Any | None:
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[Any]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    page: int | Unset = 0,
+    size: int | Unset = 20,
+    profile_id: int | Unset = UNSET,
+    triggered_by: str | Unset = UNSET,
+    region: str | Unset = UNSET,
+    auto_verdict: str | Unset = UNSET,
+    tag: str | Unset = UNSET,
+    from_: datetime.datetime | Unset = UNSET,
+    to: datetime.datetime | Unset = UNSET,
+
+) -> Response[Any]:
+    """ List past runs with optional filters
+
+     Paginated run history. Filters narrow by profile, trigger source (`api` / `ui` / `scheduled`),
+    region, regression verdict (`PASS` / `WARN` / `FAIL` / `NO_BASELINE`), tag, and date range. All
+    filters are AND-combined. Use `autoVerdict=FAIL` to fetch the runs a CI gate should care about.
+
+    Args:
+        page (int | Unset):  Default: 0.
+        size (int | Unset):  Default: 20.
+        profile_id (int | Unset):
+        triggered_by (str | Unset):
+        region (str | Unset):
+        auto_verdict (str | Unset):
+        tag (str | Unset):
+        from_ (datetime.datetime | Unset):
+        to (datetime.datetime | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        page=page,
+size=size,
+profile_id=profile_id,
+triggered_by=triggered_by,
+region=region,
+auto_verdict=auto_verdict,
+tag=tag,
+from_=from_,
+to=to,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    page: int | Unset = 0,
+    size: int | Unset = 20,
+    profile_id: int | Unset = UNSET,
+    triggered_by: str | Unset = UNSET,
+    region: str | Unset = UNSET,
+    auto_verdict: str | Unset = UNSET,
+    tag: str | Unset = UNSET,
+    from_: datetime.datetime | Unset = UNSET,
+    to: datetime.datetime | Unset = UNSET,
+
+) -> Response[Any]:
+    """ List past runs with optional filters
+
+     Paginated run history. Filters narrow by profile, trigger source (`api` / `ui` / `scheduled`),
+    region, regression verdict (`PASS` / `WARN` / `FAIL` / `NO_BASELINE`), tag, and date range. All
+    filters are AND-combined. Use `autoVerdict=FAIL` to fetch the runs a CI gate should care about.
+
+    Args:
+        page (int | Unset):  Default: 0.
+        size (int | Unset):  Default: 20.
+        profile_id (int | Unset):
+        triggered_by (str | Unset):
+        region (str | Unset):
+        auto_verdict (str | Unset):
+        tag (str | Unset):
+        from_ (datetime.datetime | Unset):
+        to (datetime.datetime | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[Any]
+     """
+
+
+    kwargs = _get_kwargs(
+        page=page,
+size=size,
+profile_id=profile_id,
+triggered_by=triggered_by,
+region=region,
+auto_verdict=auto_verdict,
+tag=tag,
+from_=from_,
+to=to,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+

trafficmorph/api/profiles/__init__.py

@@ -0,0 +1 @@
+""" Contains endpoint functions for accessing the API """