Struct HookDef 

pub struct HookDef {
    pub name: String,
    pub visibility: Visibility,
    pub order: i32,
    /* private fields */
}

A hook.toml.

Fields

name: String

visibility: Visibility

order: i32

Implementations

impl HookDef

pub fn output( &self, target: &Target, native_hook_text: Option<&str>, origin: Origin, tokens: &Tokens<'_>, ) -> Result<HookOutput, NativeHookError>

What this hook installs on target: [hooks] rendered (unless the target is in skip-targets) and the native hook laid over it. native_hook_text is the native hook’s file, read by the caller when the hook declares one for the target.

On a merge target the native hook is an event-keyed JSON object, optionally wrapped as {"hooks": …, "version"?, "description"?}, whose events the target lists (unless its table is unchecked) and whose values are arrays. It replaces only the events it declares, so one with an empty array turns that event off. On a file target it is opaque text.

pub fn plugin_output( &self, target: &Target, shared: Option<&Profile>, native_hook_text: Option<&str>, origin: Origin, tokens: &Tokens<'_>, ) -> Result<HookOutput, NativeHookError>

What this hook puts in a plugin build’s tree for target. A tree whose hook file another harness also reads passes shared (the Claude tree: targets::PLUGIN_CLAUDE_TREE): Codex rejects the whole hooks/hooks.json over one handler it cannot parse, so everything that reaches the file, [hooks] and native hook alike, is rendered under shared and conformed to Codex’s rules while keeping its events. Any other tree passes None and takes what Self::output gives.

pub fn check_native_hook( &self, target: &Target, native_hook_text: Option<&str>, origin: Origin, ) -> Result<(), NativeHookError>

Whether the hook’s native hook for target loads, as Self::output would lay it. A file target’s native hook is opaque, and [hooks] never fails to render.

impl HookDef

pub fn native_hook(&self, target_root: &str) -> Option<&NativeHook>

The native hook table this hook declares for target_root.

pub fn native_hooks(&self) -> impl Iterator<Item = (&str, &NativeHook)>

Every declared native hook table, by target root.

pub fn portable(&self) -> Option<&PortableHooks>

The [hooks] table, if the hook has one.

pub fn select<'a>(&'a self, managed_targets: &'a [String]) -> Vec<&'a str>

The managed target roots this hook is installed for: those where [hooks] renders at least one event (unless in skip-targets) and those with a native hook table. A native hook on a skipped target still installs; skip-targets only turns the generated entries off.

pub fn skips_for(&self, target_root: &str) -> Vec<Skip>

What [hooks] leaves out on target_root when nothing there overrides it; empty for a target in skip-targets and for a hook with no [hooks].

Trait Implementations

impl Clone for HookDef

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HookDef

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.