Ragex.Analysis.ASTLocationExtractor
(Ragex v0.10.0)
View Source
Extracts location information from language-specific ASTs before MetaAST transformation.
DEPRECATED: MetaAST nodes now carry :line and :col metadata natively.
This module is no longer needed and will be removed in a future release.
Use Ragex.Analysis.LocationEnricher for knowledge-graph-based location
enrichment, or read locations directly from MetaAST node metadata.
Purpose (historical)
Phase 1 of comprehensive location solution: Extract line/column information from native AST representations before Metastatic abstracts them into MetaAST.
This module provides language-specific extractors that traverse the original AST and build a location map that can be correlated with analysis results.
Supported Languages
- Elixir: Extracts from
{:atom, metadata, args}tuples - Erlang: Extracts from erl_parse metadata
- Python: Extracts from ast.AST node attributes (via Metastatic adapter)
- Ruby: Supported via MetaAST node metadata (Metastatic Ruby adapter)
- Haskell: Supported via MetaAST node metadata
Usage
alias Ragex.Analysis.ASTLocationExtractor
# Extract from Elixir code
{:ok, ast} = Code.string_to_quoted(source)
location_map = ASTLocationExtractor.extract_elixir(ast)
# Extract from file content (auto-detect language)
{:ok, location_map} = ASTLocationExtractor.extract_from_file(path)Location Map Structure
The location map stores node identifiers mapped to location information:
%{
"Module.function/2" => %{line: 42, column: 5},
"SomeModule" => %{line: 10, column: 1}
}Summary
Functions
Extracts location information from Elixir AST.
Extracts location information from source code content.
Extracts location information from a file.
Types
@type location() :: %{ line: non_neg_integer(), column: non_neg_integer() | nil, end_line: non_neg_integer() | nil, end_column: non_neg_integer() | nil }
Functions
@spec extract_elixir(Macro.t()) :: location_map()
Extracts location information from Elixir AST.
Traverses the Elixir AST tuple structure and extracts line/column from metadata.
Examples
iex> ast = quote do
...> defmodule MyModule do
...> def hello(name), do: "Hello #{name}"
...> end
...> end
iex> locations = ASTLocationExtractor.extract_elixir(ast)
iex> is_map(locations)
true@spec extract_from_content(String.t(), atom()) :: {:ok, location_map()} | {:error, term()}
Extracts location information from source code content.
Parameters
content- Source code stringlanguage- Language atom (:elixir,:erlang,:python, etc.)
Returns
{:ok, location_map}- Map of identifiers to locations{:error, reason}- Extraction failed
@spec extract_from_file( String.t(), keyword() ) :: {:ok, location_map()} | {:error, term()}
Extracts location information from a file.
Auto-detects language and uses appropriate extractor.
Parameters
path- File pathopts- Keyword options:language- Override language detection
Returns
{:ok, location_map}- Map of identifiers to locations{:error, reason}- Extraction failed