---
title: "una migrate"
url: https://una-lang.org/en/docs/cli/migrate/
release: v0.4.0
---

# una migrate

Move a package from una.toml to ita.una and ita.lock, edition 0.4.

```text
una migrate [OPTIONS] [PATH]
```

## Examples

```sh
una migrate .
```

Move the package in the current directory to edition `0.4`.

## Arguments

| Argument | What it does | Default |
| --- | --- | --- |
| `[PATH]` | The package directory | `.` |

## Options

| Option | What it does | Default |
| --- | --- | --- |
| `--dry-run` | Print the files and the diagnostics, and write nothing |  |
| `--json` | Print machine output as JSON on stdout, and nothing else on stdout |  |
| `--color <WHEN>` | When to use colors in human output. Values: `never`: Never use colors; `auto`: Use colors when the output is a terminal; `always`: Always use colors. | `auto` |
| `--name <NAME>` | The package's name in ita.una, when its una.toml name is not one |  |

## Specification

The normative rules, from spec/13 §5:

| Command | Meaning |
| --- | --- |
| `una migrate [path]` | (v0.4, ADR 0122) Move a package from `una.toml` and `verification.lock` to `ita.una` and `ita.lock` of edition `0.4`; `--dry-run` writes nothing; `--name <name>` (`spec/30 §8`) |




## Help text

As `una migrate --help` prints it at v0.4.0:

```text
Move a package from una.toml to ita.una and ita.lock, edition 0.4

Usage: una migrate [OPTIONS] [PATH]

Arguments:
  [PATH]
          The package directory

          [default: .]

Options:
      --dry-run
          Print the files and the diagnostics, and write nothing

      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

      --name <NAME>
          The package's name in ita.una, when its una.toml name is not one

  -h, --help
          Print help (see a summary with '-h')
```
