Add CLI commands for global permission management (#2091)

Add CLI commands for permission management for users and groups.

Co-authored-by: Konstantin Schaper <konstantin.schaper@cloudogu.com>

scm-webapp/src/test/java/sonia/scm/group/cli/GroupAddMemberCommandTest.java

@@ -117,6 +117,6 @@ class GroupAddMemberCommandTest {
     assertThat(testRenderer.getStdOut())
       .isEmpty();
     assertThat(testRenderer.getStdErr())
-      .isEqualTo("Could not find group");
+      .isEqualTo("Could not find group\n");
   }
 }

scm-webapp/src/test/java/sonia/scm/group/cli/GroupGetCommandTest.java

@@ -90,6 +90,6 @@ class GroupGetCommandTest {
     assertThat(testRenderer.getStdOut())
       .isEmpty();
     assertThat(testRenderer.getStdErr())
-      .contains("Could not find group");
+      .contains("Could not find group\n");
   }
 }

scm-webapp/src/test/java/sonia/scm/group/cli/GroupModifyCommandTest.java

@@ -175,6 +175,6 @@ class GroupModifyCommandTest {
     assertThat(testRenderer.getStdOut())
       .isEmpty();
     assertThat(testRenderer.getStdErr())
-      .isEqualTo("Could not find group");
+      .isEqualTo("Could not find group\n");
   }
 }

scm-webapp/src/test/java/sonia/scm/group/cli/GroupPermissionAddCommandTest.java

@@ -0,0 +1,102 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.group.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.group.Group;
+import sonia.scm.group.GroupManager;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class GroupPermissionAddCommandTest {
+  private final GroupTemplateTestRenderer testRenderer = new GroupTemplateTestRenderer();
+
+  @Mock
+  private GroupManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private GroupPermissionAddCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new GroupPermissionAddCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownGroup() {
+    when(manager.get(any())).thenReturn(null);
+    command.setName("mygroup");
+    command.setAddedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find group");
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownPermission() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("mygroup");
+    command.setAddedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Unknown permission: hitchhiker");
+  }
+
+  @Test
+  void shouldAddPermissions() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("mygroup");
+    command.setAddedPermissions(new String[]{"hitchhiker", "heartOfGold"});
+    when(permissionAssigner.getAvailablePermissions())
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("heartOfGold")));
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForGroup(eq("mygroup"), argThat(arg -> {
+      assertThat(arg.stream().map(PermissionDescriptor::getValue)).containsExactly("hitchhiker", "heartOfGold");
+      return true;
+    }));
+  }
+
+}

scm-webapp/src/test/java/sonia/scm/group/cli/GroupPermissionAvailableCommandTest.java

@@ -0,0 +1,72 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.group.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.PermissionDescriptionResolver;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+
+import java.util.List;
+import java.util.Optional;
+
+import static org.assertj.core.api.AssertionsForClassTypes.assertThat;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class GroupPermissionAvailableCommandTest {
+  private final GroupTemplateTestRenderer testRenderer = new GroupTemplateTestRenderer();
+
+  @Mock
+  private PermissionAssigner permissionAssigner;
+  @Mock
+  private PermissionDescriptionResolver descriptionResolver;
+
+  private GroupPermissionAvailableCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new GroupPermissionAvailableCommand(testRenderer.getTemplateRenderer(), permissionAssigner, descriptionResolver);
+  }
+
+  @Test
+  void shouldRenderAvailablePermissions() {
+    when(permissionAssigner.getAvailablePermissions())
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("explorer")));
+    when(descriptionResolver.getGlobalDescription("hitchhiker")).thenReturn(Optional.of("Hitchhikers Permission to the Galaxy"));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).contains(
+      "VALUE      DESCRIPTION",
+      "hitchhiker Hitchhikers Permission to the Galaxy",
+      "explorer   explorer"
+    );
+  }
+}

scm-webapp/src/test/java/sonia/scm/group/cli/GroupPermissionClearCommandTest.java

@@ -0,0 +1,83 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.group.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.group.Group;
+import sonia.scm.group.GroupManager;
+import sonia.scm.security.PermissionAssigner;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class GroupPermissionClearCommandTest {
+
+  private final GroupTemplateTestRenderer testRenderer = new GroupTemplateTestRenderer();
+
+  @Mock
+  private GroupManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private GroupPermissionClearCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new GroupPermissionClearCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownUser() {
+    when(manager.get(any())).thenReturn(null);
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).isEqualTo("Could not find group\n");
+  }
+
+  @Test
+  void shouldClearAllUserPermissions() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("hitchhikers");
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForGroup(eq("hitchhikers"), argThat(arg -> {
+      assertThat(arg).isEmpty();
+      return true;
+    }));
+  }
+}

scm-webapp/src/test/java/sonia/scm/group/cli/GroupPermissionListCommandTest.java

@@ -0,0 +1,99 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.group.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.cli.PermissionDescriptionResolver;
+import sonia.scm.group.Group;
+import sonia.scm.group.GroupManager;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+
+import java.util.List;
+import java.util.Optional;
+
+import static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+
+@ExtendWith(MockitoExtension.class)
+class GroupPermissionListCommandTest {
+
+  private final GroupTemplateTestRenderer testRenderer = new GroupTemplateTestRenderer();
+
+  @Mock
+  private GroupManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+  @Mock
+  private PermissionDescriptionResolver descriptionResolver;
+
+  private GroupPermissionListCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new GroupPermissionListCommand(testRenderer.getTemplateRenderer(), permissionAssigner, descriptionResolver, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownGroup() {
+    when(manager.get(any())).thenReturn(null);
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find group");
+  }
+
+  @Test
+  void shouldRenderPermissionDescription() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("mygroup");
+    when(permissionAssigner.readPermissionsForGroup("mygroup")).thenReturn(List.of(new PermissionDescriptor("hitchhiker")));
+    when(descriptionResolver.getGlobalDescription("hitchhiker")).thenReturn(Optional.of("The Hitchhikers Permission to the Galaxy"));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).contains("The Hitchhikers Permission to the Galaxy");
+  }
+
+  @Test
+  void shouldRenderPermissionKeys() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("mygroup");
+    command.setKeys(true);
+    when(permissionAssigner.readPermissionsForGroup("mygroup")).thenReturn(List.of(new PermissionDescriptor("hitchhiker")));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).isEqualTo("hitchhiker\n");
+  }
+}

scm-webapp/src/test/java/sonia/scm/group/cli/GroupPermissionRemoveCommandTest.java

@@ -0,0 +1,91 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.group.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.group.Group;
+import sonia.scm.group.GroupManager;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class GroupPermissionRemoveCommandTest {
+
+  private final GroupTemplateTestRenderer testRenderer = new GroupTemplateTestRenderer();
+
+  @Mock
+  private GroupManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private GroupPermissionRemoveCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new GroupPermissionRemoveCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownUser() {
+    when(manager.get(any())).thenReturn(null);
+    command.setName("mygroup");
+    command.setRemovedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find group");
+  }
+
+  @Test
+  void shouldRemovePermissions() {
+    when(manager.get(any())).thenReturn(new Group());
+    command.setName("mygroup");
+    command.setRemovedPermissions(new String[]{"hitchhiker", "heartOfGold"});
+    when(permissionAssigner.readPermissionsForGroup("mygroup"))
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("heartOfGold"), new PermissionDescriptor("puzzle42")));
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForGroup(eq("mygroup"), argThat(arg -> {
+      assertThat(arg.stream().map(PermissionDescriptor::getValue)).containsExactly("puzzle42");
+      return true;
+    }));
+  }
+}

scm-webapp/src/test/java/sonia/scm/group/cli/GroupRemoveMemberCommandTest.java

@@ -117,6 +117,6 @@ class GroupRemoveMemberCommandTest {
     assertThat(testRenderer.getStdOut())
       .isEmpty();
     assertThat(testRenderer.getStdErr())
-      .isEqualTo("Could not find group");
+      .isEqualTo("Could not find group\n");
   }
 }

scm-webapp/src/test/java/sonia/scm/user/cli/UserPermissionAddCommandTest.java

@@ -0,0 +1,102 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.user.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+import sonia.scm.user.User;
+import sonia.scm.user.UserManager;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class UserPermissionAddCommandTest {
+
+  private final UserTemplateTestRenderer testRenderer = new UserTemplateTestRenderer();
+
+  @Mock
+  private UserManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private UserPermissionAddCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new UserPermissionAddCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownUser() {
+    when(manager.get(any())).thenReturn(null);
+    command.setName("trillian");
+    command.setAddedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find user");
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownPermission() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+    command.setAddedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Unknown permission: hitchhiker");
+  }
+
+  @Test
+  void shouldAddPermissions() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+    command.setAddedPermissions(new String[]{"hitchhiker", "heartOfGold"});
+    when(permissionAssigner.getAvailablePermissions())
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("heartOfGold")));
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForUser(eq("trillian"), argThat(arg -> {
+      assertThat(arg.stream().map(PermissionDescriptor::getValue)).containsExactly("hitchhiker", "heartOfGold");
+      return true;
+    }));
+  }
+}

scm-webapp/src/test/java/sonia/scm/user/cli/UserPermissionAvailableCommandTest.java

@@ -0,0 +1,73 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.user.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.PermissionDescriptionResolver;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+
+import java.util.List;
+import java.util.Optional;
+
+import static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class UserPermissionAvailableCommandTest {
+
+  private final UserTemplateTestRenderer testRenderer = new UserTemplateTestRenderer();
+
+  @Mock
+  private PermissionAssigner permissionAssigner;
+  @Mock
+  private PermissionDescriptionResolver descriptionResolver;
+
+  private UserPermissionAvailableCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new UserPermissionAvailableCommand(testRenderer.getTemplateRenderer(), permissionAssigner, descriptionResolver);
+  }
+
+  @Test
+  void shouldRenderAvailablePermissions() {
+    when(permissionAssigner.getAvailablePermissions())
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("explorer")));
+    when(descriptionResolver.getGlobalDescription("hitchhiker")).thenReturn(Optional.of("Hitchhikers Permission to the Galaxy"));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).contains(
+      "VALUE      DESCRIPTION",
+      "hitchhiker Hitchhikers Permission to the Galaxy",
+      "explorer   explorer"
+    );
+  }
+}

scm-webapp/src/test/java/sonia/scm/user/cli/UserPermissionClearCommandTest.java

@@ -0,0 +1,83 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.user.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.user.User;
+import sonia.scm.user.UserManager;
+
+import static org.assertj.core.api.AssertionsForInterfaceTypes.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class UserPermissionClearCommandTest {
+
+  private final UserTemplateTestRenderer testRenderer = new UserTemplateTestRenderer();
+
+  @Mock
+  private UserManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private UserPermissionClearCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new UserPermissionClearCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownUser() {
+    when(manager.get(any())).thenReturn(null);
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).isEqualTo("Could not find user\n");
+  }
+
+  @Test
+  void shouldClearAllUserPermissions() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForUser(eq("trillian"), argThat(arg -> {
+      assertThat(arg).isEmpty();
+      return true;
+    }));
+  }
+}

scm-webapp/src/test/java/sonia/scm/user/cli/UserPermissionListCommandTest.java

@@ -0,0 +1,98 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.user.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.cli.PermissionDescriptionResolver;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+import sonia.scm.user.User;
+import sonia.scm.user.UserManager;
+
+import java.util.List;
+import java.util.Optional;
+
+import static org.assertj.core.api.AssertionsForClassTypes.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class UserPermissionListCommandTest {
+
+  private final UserTemplateTestRenderer testRenderer = new UserTemplateTestRenderer();
+
+  @Mock
+  private UserManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+  @Mock
+  private PermissionDescriptionResolver descriptionResolver;
+
+  private UserPermissionListCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new UserPermissionListCommand(testRenderer.getTemplateRenderer(), permissionAssigner, descriptionResolver, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownGroup() {
+    when(manager.get(any())).thenReturn(null);
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find user");
+  }
+
+  @Test
+  void shouldRenderPermissionDescription() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+    when(permissionAssigner.readPermissionsForUser("trillian")).thenReturn(List.of(new PermissionDescriptor("hitchhiker")));
+    when(descriptionResolver.getGlobalDescription("hitchhiker")).thenReturn(Optional.of("The Hitchhikers Permission to the Galaxy"));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).contains("The Hitchhikers Permission to the Galaxy");
+  }
+
+  @Test
+  void shouldRenderPermissionKeys() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+    command.setKeys(true);
+    when(permissionAssigner.readPermissionsForUser("trillian")).thenReturn(List.of(new PermissionDescriptor("hitchhiker")));
+
+    command.run();
+
+    assertThat(testRenderer.getStdOut()).isEqualTo("hitchhiker\n");
+  }
+}

scm-webapp/src/test/java/sonia/scm/user/cli/UserPermissionRemoveCommandTest.java

@@ -0,0 +1,91 @@
+/*
+ * MIT License
+ *
+ * Copyright (c) 2020-present Cloudogu GmbH and Contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+package sonia.scm.user.cli;
+
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+import sonia.scm.cli.CliExitException;
+import sonia.scm.security.PermissionAssigner;
+import sonia.scm.security.PermissionDescriptor;
+import sonia.scm.user.User;
+import sonia.scm.user.UserManager;
+
+import java.util.List;
+
+import static org.assertj.core.api.Assertions.assertThat;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@ExtendWith(MockitoExtension.class)
+class UserPermissionRemoveCommandTest {
+
+  private final UserTemplateTestRenderer testRenderer = new UserTemplateTestRenderer();
+
+  @Mock
+  private UserManager manager;
+  @Mock
+  private PermissionAssigner permissionAssigner;
+
+  private UserPermissionRemoveCommand command;
+
+  @BeforeEach
+  void initCommand() {
+    command = new UserPermissionRemoveCommand(testRenderer.getTemplateRenderer(), permissionAssigner, manager);
+  }
+
+  @Test
+  void shouldRenderErrorForUnknownUser() {
+    when(manager.get(any())).thenReturn(null);
+    command.setName("trillian");
+    command.setRemovedPermissions(new String[]{"hitchhiker"});
+
+    assertThrows(CliExitException.class, () -> command.run());
+
+    assertThat(testRenderer.getStdErr()).contains("Could not find user");
+  }
+
+  @Test
+  void shouldRemovePermissions() {
+    when(manager.get(any())).thenReturn(new User());
+    command.setName("trillian");
+    command.setRemovedPermissions(new String[]{"hitchhiker", "puzzle42"});
+    when(permissionAssigner.readPermissionsForUser("trillian"))
+      .thenReturn(List.of(new PermissionDescriptor("hitchhiker"), new PermissionDescriptor("heartOfGold"), new PermissionDescriptor("puzzle42")));
+
+    command.run();
+
+    verify(permissionAssigner).setPermissionsForUser(eq("trillian"), argThat(arg -> {
+      assertThat(arg.stream().map(PermissionDescriptor::getValue)).containsExactly("heartOfGold");
+      return true;
+    }));
+  }
+}