defmodule Mix.Tasks.Ecto.Rollback do use Mix.Task import Mix.Ecto @shortdoc "Rollback migrations from a repo" @moduledoc """ Reverts applied migrations in the given repository. By default, migrations are expected at "priv/YOUR_REPO/migrations" directory of the current application but it can be configured by specify the `:priv` key under the repository configuration. Runs the latest applied migration by default. To roll back to to a version number, supply `--to version_number`. To roll back a specific number of times, use `--step n`. To undo all applied migrations, provide `--all`. If the repository has not been started yet, one will be started outside our application supervision tree and shutdown afterwards. ## Examples mix ecto.rollback mix ecto.rollback -r Custom.Repo mix ecto.rollback -n 3 mix ecto.rollback --step 3 mix ecto.rollback -v 20080906120000 mix ecto.rollback --to 20080906120000 ## Command line options * `-r`, `--repo` - the repo to rollback (defaults to `YourApp.Repo`) * `--all` - revert all applied migrations * `--step` / `-n` - rever n number of applied migrations * `--to` / `-v` - revert all migrations down to and including version """ @doc false def run(args, migrator \\ &Ecto.Migrator.run/4) do repo = parse_repo(args) {opts, _, _} = OptionParser.parse args, switches: [all: :boolean, step: :integer, to: :integer, start: :boolean], aliases: [n: :step, v: :to] ensure_repo(repo, args) {:ok, pid} = ensure_started(repo) unless opts[:to] || opts[:step] || opts[:all] do opts = Keyword.put(opts, :step, 1) end migrator.(repo, migrations_path(repo), :down, opts) ensure_stopped(pid) end end