class CmdShout(Command):
    key = "shout"
    aliases = ["yell", "!"]
    locks = "cmd:all()"

    # don't require a space after `shout/!!/yell`
    arg_regex = None

    def func(self):
        """Run the shout command"""

        caller = self.caller

        if not self.args:
            caller.msg("What are you yelling about?")
            return

        speech = self.args

        # Calling the at_pre_say hook on the character
        speech = caller.at_pre_say(speech)

        # If speech is empty, stop here
        if not speech:
            return

        # Call the at_post_say hook on the character
        caller.at_say(speech, msg_self=True, loud=True)

# none of the args change
def at_say(self, message, msg_self=None, msg_location=None, receivers=None, msg_receivers=None, **kwargs,):

#  . . .

# this goes in the same place as the whisper code
        if kwargs.get("loud", False):
            # the "loud" kwarg is passed into msg_type which is already used by whisper
            # so nothing else in at_say needs to change
            msg_type = "loud"
            volume = True
            msg_self = '{self} shout, "|n{speech}|n"' if msg_self is True else msg_self
            msg_location = msg_location or '{object} shouts, "{speech}"'
            msg_receivers = msg_receivers or message

class Exit(ObjectParent, DefaultExit):
    def msg(self, text, from_obj=None, **kwargs):
        # ignore any message that would throw an error when we check for the "type" passed from at_say
        if "type" in text[1]:
            # check if the message is loud
            if text[1]["type"] == "loud":
                # check if the message is in character speech format (Alice yells, "Help!")
                if '"' in text[0]:
                    # reformat string (You hear someone yell "Help!" from Alice's house!)
                    yell = text[0].split('"')[1]
                    text = 'You hear someone yell "' + yell + '" from ' + self.location.key + '!'
                else:
                    # if message is not in character speech format, just announce that there has been a loud noise
                    text = f"You hear a loud noise from {self.location.key}!"
                # "type": "distant" is just there if you want to use it to pass the message further at different volumes
                self.destination.msg_contents((text, {"type": "distant"}), from_obj=self.location)