aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--bot/exts/moderation/clean.py10
1 files changed, 8 insertions, 2 deletions
diff --git a/bot/exts/moderation/clean.py b/bot/exts/moderation/clean.py
index d7c2c7673..748c018d2 100644
--- a/bot/exts/moderation/clean.py
+++ b/bot/exts/moderation/clean.py
@@ -627,12 +627,18 @@ class Clean(Cog):
@command()
async def purge(self, ctx: Context, users: Greedy[User], age: Optional[Union[Age, ISODateTime]] = None) -> None:
"""
- Clean messages of users from all public channels up to a certain message age (10 minutes by default).
+ Clean messages of `users` from all public channels up to a certain message `age` (10 minutes by default).
- The age is *exclusive*, meaning that `10s` won't delete a message exactly 10 seconds old.
+ Requires 1 or more users to be specified. For channel-based cleaning, use `clean` instead.
+
+ `age` can be a duration or an ISO 8601 timestamp.
"""
+ if not users:
+ raise BadArgument("At least one user must be specified.")
+
if age is None:
age = await Age().convert(ctx, "10M")
+
await self._clean_messages(ctx, channels="*", users=users, first_limit=age)
# endregion