Provides the ability to rename a project.
There are a few caveats:
You cannot rename projects that use “submodule subscription”
Projects that use submodule subscription cannot be renamed. Remove the submodule registration before attempting to rename the project.
You cannot rename projects that have any child projects
Projects that have child projects cannot be renamed. Currently, the plugin does not support rename of parent projects.
You cannot rename using a project name that already exists
If choosing a name that already exists, you cannot rename the project.
You cannot rename the “All-Projects” project
If choosing to rename “All-Projects”, you cannot rename the project as this action is prohibited.
You cannot rename the “All-Users” project
If choosing to rename “All-Users”, you cannot rename the project as this action is prohibited.
You cannot rename projects that are watched by users
If you rename a project that is actively watched by users, the watches are not updated to the new project name, leading to the loss of the notifications by all users that were watching the original project.
You should limit project renames to administrator users
Because of all the above caveats, it is not recommended to allow any non-admin user to perform any project rename.
This plugin does not replicate any project renamings itself, but it triggers an event when a project is renamed. The [replication plugin] (https://gerrit-review.googlesource.com/#/admin/projects/plugins/replication) is configured to listen to the event of type PluginEvent, which provides replication plugin with the required information in order to replicate the project rename functionality. Rename-project does not provide any custom event. Instead, it uses the existing PluginEvent which allows communication between two plugins directly.
To be allowed to rename arbitrary projects, a user must be a member of a group that is granted the ‘Rename Project’ capability (provided by this plugin) or the ‘Administrate Server’ capability. Project owners are allowed to rename their own projects if they are members of a group that is granted the ‘Rename Own Project’ capability (provided by this plugin). However, because of all the caveats of this plugin, it is not recommended to delegate the ‘Rename Project’ capability to any non-admin user.