Skip to content
ocx
install

AnnounceReport (1 of 2)

AnnounceReportclassdataclass#

Re-exported from ocx_sdk._resultsView source
class AnnounceReport(package: str, status: str, desc_status: str, forge: str, transport: str, credential_kind: str, push_credential_kind: str | None, branch: str | None, pull_request_url: str | None, pull_request_number: int | None, fork: str | None, written_paths: tuple[str, ...], capability_checks: tuple[CapabilityCheck, ...], reserved_tags_dropped: tuple[str, ...])

ocx package announce — what reached the index (C-061).

Payload is bare (D11). Every one of the fourteen keys is always on the wire; the nullable ones are null rather than absent, so all are read with _need and typed | None where upstream is Option.

Attributes

NameTypeDescription
packagestrThe announced <namespace>/<package>.
statusstr"updated" when a rebuilt root was committed, "unchanged" when it was byte-identical to the committed one. An unchanged run can still report a pull request it ensured.
desc_statusstr"updated" when the package’s __ocx.desc artifact moved, else "unchanged".
forgestr"github" or "gitlab", as resolved.
transportstr"api" or "git".
credential_kindstr"job-token", "token" or "none" — what the identity ladder resolved for the API credential.
push_credential_kindstr | None"job-token", "token", "git-helper", or None under the api transport, which pushes nothing.
branchstr | NoneThe announce branch, or None under --out.
pull_request_urlstr | NoneThe request’s URL, when one was opened or ensured.
pull_request_numberint | NoneIts number, likewise.
forkstr | NoneThe fork the request came from, when --fork was given.
written_pathstuple[str, ...]Files written under --out; empty otherwise.
capability_checkstuple[CapabilityCheck, ...]The forge probes, in CapabilityName order.
reserved_tags_droppedtuple[str, ...]__ocx and legacy sha256.<hex> tags named on the command line and dropped: a reported fact of a successful run, never a failure.

branchattributeinstance attribute#

branch: str | None

capability_checksattributeinstance attribute#

capability_checks: tuple[CapabilityCheck, ...]

credential_kindattributeinstance attribute#

credential_kind: str

desc_statusattributeinstance attribute#

desc_status: str

packageattributeinstance attribute#

package: str

pull_request_numberattributeinstance attribute#

pull_request_number: int | None

pull_request_urlattributeinstance attribute#

pull_request_url: str | None