rename
Description
Renames an existing project, package, or a specific package version.
Keep in mind that every project/package name combination must be unique on the level of each package store.
New project and package names should not clash with any of the existing name combinations in the same package store.
In other words, you can't rename my-project/package-one into my-project/package-two if the latter already exists in the package store.
Usage
rl-secure rename <from> <to> [<rl-store>]
rl-secure rename --from=<from> --to=<to> --rl-store=[<rl-store>]
Options
| Option | Description |
|---|---|
| --from | Required. Current package URL to rename, in the format [pkg:type/]<project>[/<package>[@<version>]] |
| --to | Required. New package URL to rename, in the format [pkg:type/]<project>[/<package>[@<version>]] |
| -h, --help | Display usage information and exit. |
| -s, --rl-store | Path to an initialized package store containing the package to rename. If not provided, the current directory is used. |
Examples
Change the package version
This example renames a specific package version in a project. It's a subtle change - increasing part of the version number. You can use any of the two supported syntax approaches (simplified or extended).
The command expects the package store to exist in the current directory.
Use the -s or --rl-store options to provide an alternative path to the package store.
- Simplified input
- Extended input
- Output
rl-secure rename pkg:rl/my-project/my-package@1.0.1 pkg:rl/my-project/my-package@1.0.2
rl-secure rename --from=pkg:rl/my-project/my-package@1.0.1 --to=pkg:rl/my-project/my-package@1.0.2 --rl-store=/home/armando/my-repository/
Renamed pkg:rl/my-project/my-package@1.0.1 to pkg:rl/my-project/my-package@1.0.2
Change a project name
This example renames an existing project in a previously initialized package store. You can use any of the two supported syntax approaches (simplified or extended).
The command expects the package store to exist in the current directory.
Use the -s option to provide an alternative path to the package store.
- Simplified input
- Extended input
- Output
rl-secure rename pkg:rl/my-project pkg:rl/my-releases
rl-secure rename --from=pkg:rl/my-project --to=pkg:rl/my-releases
Renamed pkg:rl/my-project to pkg:rl/my-releases