The Documentation is missing instructions for registering "IHookExecutor"

[metacoder-feff]

The Documentation is missing instructions for registering IHookExecutor:

I have tried

[assembly: HookExecutor<LoggingHookExecutor>]

But it does not work.

[thomhurst]

Thanks for reporting this! The docs were indeed missing the registration section for IHookExecutor.

There are two ways to register a hook executor:

1. [HookExecutor<T>] attribute

Apply it directly to your hook methods, class, or assembly:

// On a specific hook method
[Before(Test)]
[HookExecutor<LoggingHookExecutor>]
public async Task SetUp(TestContext context)
{
    // This hook runs through the custom executor
}

// Or at class level (applies to all hooks in the class)
[HookExecutor<LoggingHookExecutor>]
public class MyTestClass { }

// Or at assembly level
[assembly: HookExecutor<LoggingHookExecutor>]

2. SetHookExecutor programmatically

Via ITestRegisteredEventReceiver — useful when you want the same executor for both tests and hooks:

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
public class DispatchAttribute : Attribute, ITestRegisteredEventReceiver
{
    public int Order => 0;

    public ValueTask OnTestRegistered(TestRegisteredContext context)
    {
        var executor = new MyCustomExecutor();
        context.SetTestExecutor(executor);
        context.SetHookExecutor(executor);
        return default;
    }
}

Note: SetHookExecutor applies to test-level hooks ([Before(Test)]/[After(Test)]). For session, assembly, or class-level hooks, use the [HookExecutor<T>] attribute directly on the hook method.

I've updated the docs to include this information.