Interface FlowrAnalysisProvider

flowrConfig

context

• context(): FlowrAnalyzerContext

  Returns project context information. If you are a user that wants to inspect the context, prefer inspectContext instead. Please be aware that modifications to the context may break analyzer assumptions.

  Returns FlowrAnalyzerContext

controlflow

• controlflow(
      simplifications?: readonly (
          | "unique-cf-sets"
          | "analyze-dead-code"
          | "remove-dead-code"
          | "to-basic-blocks"
      )[],
      kind?: CfgKind,
      force?: boolean,
  ): Promise<ControlFlowInformation<CfgSimpleVertex>>

  Get the control flow graph (CFG) for the request.

  Parameters

  • Optionalsimplifications: readonly (
        | "unique-cf-sets"
        | "analyze-dead-code"
        | "remove-dead-code"
        | "to-basic-blocks"
    )[]

    Simplification passes to be applied to the CFG.
  • Optionalkind: CfgKind

    The kind of CFG that is requested. By default, the CFG without dataflow information is returned.
  • Optionalforce: boolean

    Do not use the cache, instead force new analyses.

  Returns Promise<ControlFlowInformation<CfgSimpleVertex>>

dataflow

• dataflow(
      force?: boolean,
  ): Promise<DataflowInformation & PipelinePerStepMetaInformation>

  Get the dataflow graph for the request.

  Parameters

  • Optionalforce: boolean

    Do not use the cache, instead force new analyses.

  Returns Promise<DataflowInformation & PipelinePerStepMetaInformation>

inspectContext

• inspectContext(): ReadOnlyFlowrAnalyzerContext

  Returns a read-only version of the project context information. This is the preferred method for users that want to inspect the context.

  Returns ReadOnlyFlowrAnalyzerContext

normalize

• normalize(
      force?: boolean,
  ): Promise<
      NormalizedAst<ParentInformation, RNode<ParentInformation>> & PipelinePerStepMetaInformation,
  >

  Get the normalized abstract syntax tree for the request.

  Parameters

  • Optionalforce: boolean

    Do not use the cache, instead force new analyses.

  Returns Promise<
      NormalizedAst<ParentInformation, RNode<ParentInformation>> & PipelinePerStepMetaInformation,
  >

parse

• parse(
      force?: boolean,
  ): Promise<ParseStepOutput<string | Tree> & PipelinePerStepMetaInformation>

  Get the parse output for the request.

  The parse result type depends on the KnownParser used by the analyzer.

  Parameters

  • Optionalforce: boolean

    Do not use the cache, instead force a new parse.

  Returns Promise<ParseStepOutput<string | Tree> & PipelinePerStepMetaInformation>

parserInformation

• parserInformation(): Promise<TreeSitterInformation | RShellInformation>

  Get the name of the parser used by the analyzer.

  Returns Promise<TreeSitterInformation | RShellInformation>

query

• query<
      Types extends
          | "search"
          | "config"
          | "origin"
          | "dataflow"
          | "call-context"
          | "control-flow"
          | "dataflow-lens"
          | "df-shape"
          | "normalized-ast"
          | "id-map"
          | "dataflow-cluster"
          | "static-slice"
          | "lineage"
          | "dependencies"
          | "location-map"
          | "happens-before"
          | "inspect-higher-order"
          | "resolve-value"
          | "project"
          | "linter" = | "search"
      | "config"
      | "origin"
      | "dataflow"
      | "call-context"
      | "control-flow"
      | "dataflow-lens"
      | "df-shape"
      | "normalized-ast"
      | "id-map"
      | "dataflow-cluster"
      | "static-slice"
      | "lineage"
      | "dependencies"
      | "location-map"
      | "happens-before"
      | "inspect-higher-order"
      | "resolve-value"
      | "project"
      | "linter",
  >(
      query: Queries<Types>,
  ): Promise<QueryResults<Types>>

  Access the query API for the request.

  Type Parameters

  • Types extends
        | "search"
        | "config"
        | "origin"
        | "dataflow"
        | "call-context"
        | "control-flow"
        | "dataflow-lens"
        | "df-shape"
        | "normalized-ast"
        | "id-map"
        | "dataflow-cluster"
        | "static-slice"
        | "lineage"
        | "dependencies"
        | "location-map"
        | "happens-before"
        | "inspect-higher-order"
        | "resolve-value"
        | "project"
        | "linter" =
        | "search"
        | "config"
        | "origin"
        | "dataflow"
        | "call-context"
        | "control-flow"
        | "dataflow-lens"
        | "df-shape"
        | "normalized-ast"
        | "id-map"
        | "dataflow-cluster"
        | "static-slice"
        | "lineage"
        | "dependencies"
        | "location-map"
        | "happens-before"
        | "inspect-higher-order"
        | "resolve-value"
        | "project"
        | "linter"

  Parameters

  • query: Queries<Types>

    The list of queries.

  Returns Promise<QueryResults<Types>>

reset

• reset(): void

  Reset all caches used by the analyzer and effectively force all analyses to be redone.

  Returns void

runFull

• runFull(force?: boolean): Promise<void>

  This executes all steps of the core analysis (parse, normalize, dataflow).

  Parameters

  • Optionalforce: boolean

  Returns Promise<void>

runSearch

• runSearch<Search extends FlowrSearchLike>(
      search: Search,
  ): Promise<GetSearchElements<SearchOutput<Search>>>

  Run a search on the current analysis.

  Type Parameters

  • Search extends FlowrSearchLike

  Parameters

  • search: Search

  Returns Promise<GetSearchElements<SearchOutput<Search>>>

sendCommandWithOutput

• sendCommandWithOutput(
      command: string,
      addonConfig?: Partial<OutputCollectorConfiguration>,
  ): Promise<string[]>

  Sends a command to the underlying R engine and collects the output.

  Parameters

  • command: string

    The command to send to the R engine.
  • OptionaladdonConfig: Partial<OutputCollectorConfiguration>

    Additional configuration for the output collector.

  Returns Promise<string[]>