@spec all_modules(graph()) :: [module()]

Returns all modules known in the graph.

@spec build_graph(
  atom() | :all,
  keyword()
) :: graph()

Returns the dependency graph for the given OTP application (or all loaded modules if app is :all).

The graph is cached in :persistent_term after the first call. Pass force: true to bypass the cache and rebuild.

Options

• :app — OTP app atom or :all (default :all)
• :force — boolean, bypass cache (default false)

@spec build_graph_from_path(
  String.t(),
  keyword()
) :: graph()

Builds a dependency graph from a specific BEAM directory path.

Useful for testing against a pre-compiled application without registering it as an OTP application.

Options

• :force — boolean, bypass cache (default false)

Example

ebin = "test/support/fixture_app/_build/dev/lib/fixture_app/ebin"
graph = ArchTest.Collector.build_graph_from_path(ebin)

@spec cycles(graph()) :: [[module()]]

Returns all dependency cycles found in the given modules.

Each cycle is a list of modules forming a circular dependency chain.

@spec dependencies_of(graph(), module()) :: [module()]

Returns the direct dependencies of module (modules it calls).

@spec dependents_of(graph(), module()) :: [module()]

Returns all modules that directly depend on module (callers of it).

@spec transitive_dependencies_of(graph(), module(), pos_integer() | :infinity) :: [
  module()
]

Computes transitive dependencies of module up to max_depth hops (default: unlimited).