Versions syntax for migration

[smutel]

Hello,

Could you please give me some examples of versions syntax specified in migration commands ?

Thanks.

[sisp]

Any PEP 440 compliant version works. Is there a specific problem you're facing? Any error message or reproducible example you could share?

[smutel]

Yes ...

With:

_migrations:
  - command: |
      rm Makefile || echo "-> file Makefile already deleted"
    when: "{{ _stage == 'before' }}"
    version: "<= v0.12.1"

I have these errors:

Traceback (most recent call last):
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/bin/copier", line 7, in <module>
    sys.exit(copier_app_run())
             ^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/plumbum/cli/application.py", line 640, in run
    inst, retcode = subapp.run(argv, exit=False)
                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/plumbum/cli/application.py", line 635, in run
    retcode = inst.main(*tailargs)
              ^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/cli.py", line 425, in main
    return _handle_exceptions(inner)
           ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/cli.py", line 70, in _handle_exceptions
    method()
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/cli.py", line 415, in inner
    with self._worker(
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/main.py", line 268, in __exit__
    raise value
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/cli.py", line 423, in inner
    worker.run_update()
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/main.py", line 95, in _wrapper
    return func(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/main.py", line 1075, in run_update
    self._apply_update()
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/main.py", line 1112, in _apply_update
    self.template.migration_tasks("before", self.subproject.template)  # type: ignore[arg-type]
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/copier/template.py", line 436, in migration_tasks
    current = parse(migration["version"])
              ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/packaging/version.py", line 56, in parse
    return Version(version)
           ^^^^^^^^^^^^^^^^
  File "/home/runner/.local/share/mise/installs/pipx-copier-org-copier/v9.6.0/venvs/copier/lib/python3.11/site-packages/packaging/version.py", line 202, in __init__
    raise InvalidVersion(f"Invalid version: {version!r}")
packaging.version.InvalidVersion: Invalid version: '<= v0.12.1'

[sisp]

Omit the specifier <=, it's implied.