@spec create_language_dir(atom()) :: :ok

Create a fixture directory structure for a language.

Examples

iex> FixtureHelper.create_language_dir(:python)
:ok

@spec fixture_path(atom(), String.t()) :: String.t()

Get the full path to a fixture file.

Examples

iex> FixtureHelper.fixture_path(:python, "test.py")
"/path/to/test/fixtures/python/test.py"

@spec fixtures_dir() :: String.t()

Get the base fixtures directory path.

@spec language_dir(atom()) :: String.t()

Get the fixtures directory for a specific language.

Examples

iex> FixtureHelper.language_dir(:python)
"/path/to/test/fixtures/python"

@spec load_all() :: %{required(atom()) => [map()]}

Load all fixtures across all languages.

Returns a map of language => list of fixtures.

Examples

iex> all = FixtureHelper.load_all()
iex> is_map(all)
true

@spec load_fixture(atom(), String.t()) ::
  {:ok, map()} | {:error, :not_found | :invalid_fixture}

Load a specific fixture.

Returns a map with:

• :name - Fixture name (without extension)
• :source_file - Full path to source file
• :source - Source code content
• :expected_ast - Expected MetaAST (if exists)
• :language - Language atom

Examples

iex> {:ok, fixture} = FixtureHelper.load_fixture(:python, "simple_arithmetic")
iex> fixture.name
"simple_arithmetic"
iex> is_binary(fixture.source)
true

@spec load_language(atom()) :: [map()]

Load all fixtures for a language.

Returns a list of fixture maps.

Examples

iex> fixtures = FixtureHelper.load_language(:python)
iex> is_list(fixtures)
true

@spec save_fixture(atom(), String.t(), String.t(), term() | nil) :: :ok

Save a fixture file and optionally its expected AST.

Examples

iex> FixtureHelper.save_fixture(:python, "test", "x + 5")
:ok

iex> ast = {:binary_op, :arithmetic, :+, {:variable, "x"}, {:literal, :integer, 5}}
iex> FixtureHelper.save_fixture(:python, "test", "x + 5", ast)
:ok

@spec stats() :: map()

Get statistics about available fixtures.

Examples

iex> stats = FixtureHelper.stats()
iex> stats.total_fixtures
42

@spec validate_fixture(map(), term()) :: :ok | {:error, {:mismatch, term(), term()}}

Validate that a fixture's expected AST matches actual parsing result.

Examples

iex> {:ok, fixture} = FixtureHelper.load_fixture(:python, "test")
iex> FixtureHelper.validate_fixture(fixture, actual_ast)
:ok