feat: add !user command

Author: lcook

README.md

@@ -17,6 +17,7 @@ that forwards commits of the FreeBSD GitHub repositories to Discord.
 | !role <role> | Allows users the ability to assign themselves roles |
 | !bug <id> | Sends a message embed detailing a problem report from Bugzilla. Additionally, messages matching the FreeBSD Bugzilla URL will trigger this event |
 | !review <id> | Sends a message embed detailing a Differntial revision from Phabricator. Additionally, messages matching the FreeBSD Phabricator URL will trigger this event |
+| !user <id> | Sends a message embed detailing a user |
 
 Key events on Discord including message updates, deletions, member
 removals and bans are logged in a public channel to ensure transparency

config.yaml.example

@@ -17,7 +17,7 @@ bot:
   # Prefix that triggers bot commands (e.g, "!role").
   discord_prefix: "!"
   # List of enabled bot commands.
-  discord_commands: ["help", "role", "bug", "review", "status"]
+  discord_commands: ["help", "role", "bug", "review", "status", "user"]
   # Channel where audit events (message edits, deletes, AutoMod actions, etc)
   # are posted.
   discord_log_channel_id: ""

internal/bot/handler/command/command.go

@@ -46,6 +46,11 @@ func New(settings config.Settings) *Handler {
 			"Display information of a Phabricator differential revision providing an ID",
 			h.Review,
 		},
+		"user": {
+			"user",
+			"Display user information of a provided ID",
+			h.User,
+		},
 	}
 
 	for _, name := range settings.Commands {

internal/bot/handler/command/user.go

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: BSD-2-Clause
+//
+// Copyright (c) Lewis Cook <[email protected]>
+package command
+
+import (
+	"strings"
+
+	"github.com/bwmarrin/discordgo"
+)
+
+func (h *Handler) User(s *discordgo.Session, m *discordgo.MessageCreate) {
+	if m.Author.Bot || m.Author.ID == s.State.User.ID {
+		return
+	}
+
+	if directMessage(s, m) {
+		return
+	}
+
+	if !strings.HasPrefix(m.Content, h.Settings.Prefix+"user") {
+		return
+	}
+
+	id := strings.Split(m.Content, " ")
+	if len(id) == 1 {
+		return
+	}
+
+	user, err := s.User(id[1])
+	if err != nil {
+		return
+	}
+
+	var fields []*discordgo.MessageEmbedField
+
+	fields = append(fields, &discordgo.MessageEmbedField{
+		Name:   "Username",
+		Value:  user.Username,
+		Inline: true,
+	})
+
+	fields = append(fields, &discordgo.MessageEmbedField{
+		Name:   "Global name",
+		Value:  user.GlobalName,
+		Inline: true,
+	})
+
+	fields = append(fields, &discordgo.MessageEmbedField{
+		Name: "Account created",
+		Value: func() string {
+			created, _ := discordgo.SnowflakeTimestamp(user.ID)
+			return created.String()
+		}(),
+	})
+
+	member, err := s.GuildMember(m.GuildID, user.ID)
+	if err == nil {
+		fields = append(fields, &discordgo.MessageEmbedField{
+			Name:  "Member joined",
+			Value: member.JoinedAt.String(),
+		})
+
+		if member.Nick != "" {
+			fields = append(fields, &discordgo.MessageEmbedField{
+				Name:   "Member nickname",
+				Value:  member.Nick,
+				Inline: true,
+			})
+		}
+
+		fields = append(fields, &discordgo.MessageEmbedField{
+			Name: "Pending",
+			Value: func() string {
+				if member.Pending {
+					return "true"
+				}
+
+				return "false"
+			}(),
+			Inline: true,
+		})
+
+		guildRoles, err := s.GuildRoles(m.GuildID)
+		if err != nil {
+			return
+		}
+
+		rolesMap := make(map[string]*discordgo.Role, len(guildRoles))
+		for _, role := range guildRoles {
+			rolesMap[role.ID] = role
+		}
+
+		var roles []string
+
+		for _, roleID := range member.Roles {
+			if role, exists := rolesMap[roleID]; exists {
+				roles = append(roles, role.Mention())
+			}
+		}
+
+		if len(roles) >= 1 {
+			fields = append(fields, &discordgo.MessageEmbedField{
+				Name:   "Roles",
+				Value:  strings.Join(roles, " "),
+				Inline: true,
+			})
+		}
+	}
+
+	s.ChannelMessageSendEmbedReply(
+		m.ChannelID,
+		&discordgo.MessageEmbed{
+			Fields: fields,
+			Image: &discordgo.MessageEmbedImage{
+				URL: user.BannerURL("512"),
+			},
+			Thumbnail: &discordgo.MessageEmbedThumbnail{
+				URL: user.AvatarURL("512"),
+			},
+			Footer: &discordgo.MessageEmbedFooter{
+				Text: "ID: " + user.ID,
+			},
+			Color: user.AccentColor,
+		},
+		m.Reference(),
+	)
+}