defmodule Mix.Tasks.ExAst.Replace do @shortdoc "Replace Elixir code by AST pattern" @moduledoc """ Replaces AST pattern matches in Elixir source files. ## Usage mix ex_ast.replace 'pattern' 'replacement' [path ...] ## Options * `--dry-run` — show changes without writing files ## Examples mix ex_ast.replace 'IO.inspect(expr, _)' 'expr' lib/ mix ex_ast.replace 'dbg(expr)' 'expr' mix ex_ast.replace --dry-run '%Step{id: "subject"}' 'SharedSteps.subject_step(@opts)' """ use Mix.Task @impl Mix.Task def run(args) do {opts, positional, _} = OptionParser.parse(args, strict: [dry_run: :boolean]) case positional do [pattern, replacement | paths] -> paths = if paths == [], do: ["lib/"], else: paths dry_run = opts[:dry_run] || false do_replace(paths, pattern, replacement, dry_run) _ -> Mix.raise("Usage: mix ex_ast.replace 'pattern' 'replacement' [path ...]") end end defp do_replace(paths, pattern, replacement, dry_run) do validate_syntax!(pattern, "pattern") validate_syntax!(replacement, "replacement") results = ExAST.replace(paths, pattern, replacement, dry_run: dry_run) case results do [] -> IO.puts("No matches found.") files -> total = files |> Enum.map(&elem(&1, 1)) |> Enum.sum() verb = if dry_run, do: "Would update", else: "Updated" for {file, count} <- files do IO.puts("#{verb} #{file} (#{count} replacement(s))") end IO.puts("\n#{total} replacement(s) in #{length(files)} file(s)") end end defp validate_syntax!(code, label) do Code.string_to_quoted!(code) rescue e in [SyntaxError, TokenMissingError, MismatchedDelimiterError] -> Mix.raise("Invalid #{label}: #{Exception.message(e)}") end end