introspect command
Output machine-readable JSON describing the project structure.
bash
fobis introspect [options]How to use it, with examples: Building, CI and machine output.
All options
| Option | Value | Default | Description |
|---|---|---|---|
--fobos, -f | TEXT | Specify a "fobos" file named differently from "fobos" | |
--fci | Assume fobos inputs as case insensitive | ||
--mode | TEXT | Select a mode defined into a fobos file | |
--shadow | TEXT | Rebuild the mode as a shadow (checks, sanitize or strict): the mode's settings with checking flags, in its own build directory (.fobis/shadow/<mode>-<shadow>/). | |
--sources | Show source files | ||
--compiler | Show compiler info | ||
--dependencies | Show declared dependencies | ||
--targets | Show build targets | ||
--include-dirs | Show include directories | ||
--buildoptions | Show all fobos mode options | ||
--projectinfo | Show [project] section metadata | ||
--varsets | Show available [varset:NAME] sections and their bindings | ||
--all | Show all introspection data | ||
--compile-commands | Print the compilation database of the mode's build (what fobis build writes in compile_commands.json) and compile nothing; not combinable with the other sections | ||
--write | Write individual intro-*.json files into .fobis-info/ | ||
--format | TEXT | json | Output format: json (default) or toml |
--varset | TEXT | Apply one or more [varset:NAME] sections' $variable bindings (comma- or space-separated; last write wins) before resolving introspection data. |