# Validator architecture

Validator applies automated interactive tests to a stateful library such as
Inspect or file systems - an interactive golden file framework.

The Validator architecture includes:

- A set of tests to validate functionality.
- A FIDL protocol to invoke operations to be tested.
- One or more puppet programs, which receive FIDL commands and invoke library calls.
- A reference implementation or simulation of the desired behavior.
- Analysis of puppet results, comparison to local results, and reporting.

## Inspect validator

The Inspect Validator implementation includes:

- [Core Validator program](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src)
  - [Tests](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/trials.rs)
  - [FIDL](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/fidl/inspect_puppet.fidl)
  - [Reading the puppet's output](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/data/scanner.rs)
  - [Reference Behavior and comparison](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/data.rs)
  - [Analysis](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/runner.rs) and [more analysis](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/metrics.rs)
  - [Reporting](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/src/results.rs)
- [Rust Puppet](https://cs.opensource.google/fuchsia/fuchsia/+/main:/src/diagnostics/validator/inspect/lib/rust/src/main.rs).

See also [Inspect Validator Puppet Architecture](https://fuchsia.dev/fuchsia-src/reference/diagnostics/inspect/validator/puppet)
[](https://issues.fuchsia.dev/issues/new?component=1439230&template=1881640&description=Issue+on:+https://fuchsia.dev/docs/reference/diagnostics/inspect/validator/README.md "Report a bug or suggest improvements on this page") [](https://cs.opensource.google/fuchsia/fuchsia/+/main:docs/reference/diagnostics/inspect/validator/README.md "View the source code of this page") [](https://ci.android.com/edit?repo=fuchsia/fuchsia/main&file=docs/reference/diagnostics/inspect/validator/README.md&cloneRepo=fuchsia/fuchsia:refs/heads/main&fullPath=fuchsia/docs/reference/diagnostics/inspect/validator/README.md "Edit the source code of this page")