Includes mmctl into the mono-repo (#23091)

* Includes mmctl into the mono-repo

* Update to use the new public module paths

* Adds docs check to the mmctl CI

* Fix public utils import path

* Tidy up modules

* Fix linter

* Update CI tasks to use the new file structure

* Update CI references

server/cmd/mmctl/commands/channel_users.go

@@ -0,0 +1,135 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+
+package commands
+
+import (
+	"fmt"
+
+	"github.com/hashicorp/go-multierror"
+
+	"github.com/mattermost/mattermost-server/server/v8/cmd/mmctl/client"
+	"github.com/mattermost/mattermost-server/server/v8/cmd/mmctl/printer"
+
+	"github.com/mattermost/mattermost-server/server/public/model"
+	"github.com/pkg/errors"
+	"github.com/spf13/cobra"
+)
+
+var ChannelUsersCmd = &cobra.Command{
+	Use:   "users",
+	Short: "Management of channel users",
+}
+
+var ChannelUsersAddCmd = &cobra.Command{
+	Use:     "add [channel] [users]",
+	Short:   "Add users to channel",
+	Long:    "Add some users to channel",
+	Example: "  channel users add myteam:mychannel user@example.com username",
+	RunE:    withClient(channelUsersAddCmdF),
+}
+
+var ChannelUsersRemoveCmd = &cobra.Command{
+	Use:   "remove [channel] [users]",
+	Short: "Remove users from channel",
+	Long:  "Remove some users from channel",
+	Example: `  channel users remove myteam:mychannel user@example.com username
+  channel users remove myteam:mychannel --all-users`,
+	RunE: withClient(channelUsersRemoveCmdF),
+}
+
+func init() {
+	ChannelUsersRemoveCmd.Flags().Bool("all-users", false, "Remove all users from the indicated channel.")
+
+	ChannelUsersCmd.AddCommand(
+		ChannelUsersAddCmd,
+		ChannelUsersRemoveCmd,
+	)
+
+	ChannelCmd.AddCommand(ChannelUsersCmd)
+}
+
+func channelUsersAddCmdF(c client.Client, cmd *cobra.Command, args []string) error {
+	if len(args) < 2 {
+		return errors.New("not enough arguments")
+	}
+
+	channel := getChannelFromChannelArg(c, args[0])
+	if channel == nil {
+		return errors.Errorf("unable to find channel %q", args[0])
+	}
+
+	users := getUsersFromUserArgs(c, args[1:])
+	for i, user := range users {
+		addUserToChannel(c, channel, user, args[i+1])
+	}
+
+	return nil
+}
+
+func addUserToChannel(c client.Client, channel *model.Channel, user *model.User, userArg string) {
+	if user == nil {
+		printer.PrintError("Can't find user '" + userArg + "'")
+		return
+	}
+	if _, _, err := c.AddChannelMember(channel.Id, user.Id); err != nil {
+		printer.PrintError("Unable to add '" + userArg + "' to " + channel.Name + ". Error: " + err.Error())
+	}
+}
+
+func channelUsersRemoveCmdF(c client.Client, cmd *cobra.Command, args []string) error {
+	allUsers, _ := cmd.Flags().GetBool("all-users")
+
+	if allUsers && len(args) != 1 {
+		return errors.New("individual users must not be specified in conjunction with the --all-users flag")
+	}
+
+	if !allUsers && len(args) < 2 {
+		return errors.New("you must specify some users to remove from the channel, or use the --all-users flag to remove them all")
+	}
+
+	channel := getChannelFromChannelArg(c, args[0])
+	if channel == nil {
+		return errors.Errorf("unable to find channel %q", args[0])
+	}
+
+	if allUsers {
+		if err := removeAllUsersFromChannel(c, channel); err != nil {
+			return err
+		}
+	} else {
+		for i, user := range getUsersFromUserArgs(c, args[1:]) {
+			removeUserFromChannel(c, channel, user, args[i+1])
+		}
+	}
+
+	return nil
+}
+
+func removeUserFromChannel(c client.Client, channel *model.Channel, user *model.User, userArg string) {
+	if user == nil {
+		printer.PrintError("Can't find user '" + userArg + "'")
+		return
+	}
+	if _, err := c.RemoveUserFromChannel(channel.Id, user.Id); err != nil {
+		printer.PrintError("Unable to remove '" + userArg + "' from " + channel.Name + ". Error: " + err.Error())
+	}
+}
+
+func removeAllUsersFromChannel(c client.Client, channel *model.Channel) error {
+	var result *multierror.Error
+	members, _, err := c.GetChannelMembers(channel.Id, 0, 10000, "")
+	if err != nil {
+		printer.PrintError("Unable to remove all users from " + channel.Name + ". Error: " + err.Error())
+		return fmt.Errorf("unable to remove all users from %q: %w", channel.Name, err)
+	}
+
+	for _, member := range members {
+		if _, err := c.RemoveUserFromChannel(channel.Id, member.UserId); err != nil {
+			result = multierror.Append(result, fmt.Errorf("unable to remove %q from %q Error: %w", member.UserId, channel.Name, err))
+			printer.PrintError("Unable to remove '" + member.UserId + "' from " + channel.Name + ". Error: " + err.Error())
+		}
+	}
+
+	return result.ErrorOrNil()
+}