matthew/enhanced-discord.py
1
0
Fork 0
Code Issues 4 Pull Requests 21 Projects Releases Wiki Activity

slash_commands_guilds param re-named to guilds.

Browse Source
This commit is contained in:
Sengolda 2021-09-30 17:09:35 +05:30
parent f0bef378f2
commit 32e020ae09
1 changed files with 174 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

228
discord/ext/commands/core.py
View File

@ -53,7 +53,13 @@ from operator import itemgetter
import discord import discord
from .errors import * from .errors import *
from .cooldowns import Cooldown, BucketType, CooldownMapping, MaxConcurrency, DynamicCooldownMapping from .cooldowns import (
Cooldown,
BucketType,
CooldownMapping,
MaxConcurrency,
DynamicCooldownMapping,
)
from .converter import ( from .converter import (
CONVERTER_MAPPING, CONVERTER_MAPPING,
Converter, Converter,
@ -74,7 +80,10 @@ if TYPE_CHECKING:
from typing_extensions import Concatenate, ParamSpec, TypeGuard from typing_extensions import Concatenate, ParamSpec, TypeGuard
from discord.message import Message from discord.message import Message
from discord.types.interactions import EditApplicationCommand, ApplicationCommandInteractionDataOption from discord.types.interactions import (
EditApplicationCommand,
ApplicationCommandInteractionDataOption,
)
from ._types import ( from ._types import (
Coro, Coro,
@ -330,10 +339,10 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
This overwrites the global ``slash_commands`` parameter of :class:`.Bot`. This overwrites the global ``slash_commands`` parameter of :class:`.Bot`.
.. versionadded:: 2.0 .. versionadded:: 2.0
slash_command_guilds: Optional[List[:class:`int`]] guilds: Optional[List[:class:`int`]]
If this is set, only upload this slash command to these guild IDs. If this is set, only upload this slash command to these guild IDs.
This overwrites the global ``slash_command_guilds`` parameter of :class:`.Bot`. This overwrites the global ``guilds`` parameter of :class:`.Bot`.
.. versionadded:: 2.0 .. versionadded:: 2.0
@ -382,7 +391,7 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
self.slash_command: Optional[bool] = kwargs.get("slash_command", None) self.slash_command: Optional[bool] = kwargs.get("slash_command", None)
self.message_command: Optional[bool] = kwargs.get("message_command", None) self.message_command: Optional[bool] = kwargs.get("message_command", None)
self.slash_command_guilds: Optional[Iterable[int]] = kwargs.get("slash_command_guilds", None) self.slash_command_guilds: Optional[Iterable[int]] = kwargs.get("guilds", None)
help_doc = kwargs.get("help") help_doc = kwargs.get("help")
if help_doc is not None: if help_doc is not None:
@ -401,7 +410,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
self.extras: Dict[str, Any] = kwargs.get("extras", {}) self.extras: Dict[str, Any] = kwargs.get("extras", {})
if not isinstance(self.aliases, (list, tuple)): if not isinstance(self.aliases, (list, tuple)):
raise TypeError("Aliases of a command must be a list or a tuple of strings.") raise TypeError(
"Aliases of a command must be a list or a tuple of strings."
)
self.description: str = inspect.cleandoc(kwargs.get("description", "")) self.description: str = inspect.cleandoc(kwargs.get("description", ""))
self.hidden: bool = kwargs.get("hidden", False) self.hidden: bool = kwargs.get("hidden", False)
@ -427,7 +438,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
elif isinstance(cooldown, CooldownMapping): elif isinstance(cooldown, CooldownMapping):
buckets = cooldown buckets = cooldown
else: else:
raise TypeError("Cooldown must be a an instance of CooldownMapping or None.") raise TypeError(
"Cooldown must be a an instance of CooldownMapping or None."
)
self.checks: List[Check] = checks self.checks: List[Check] = checks
self._buckets: CooldownMapping = buckets self._buckets: CooldownMapping = buckets
@ -468,7 +481,10 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
@property @property
def callback( def callback(
self, self,
) -> Union[Callable[Concatenate[CogT, Context, P], Coro[T]], Callable[Concatenate[Context, P], Coro[T]],]: ) -> Union[
Callable[Concatenate[CogT, Context, P], Coro[T]],
Callable[Concatenate[Context, P], Coro[T]],
]:
return self._callback return self._callback
@callback.setter @callback.setter
@ -488,7 +504,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
except AttributeError: except AttributeError:
globalns = {} globalns = {}
self.params, self.option_descriptions = get_signature_parameters(function, globalns) self.params, self.option_descriptions = get_signature_parameters(
function, globalns
)
def _update_attrs(self, **command_attrs: Any): def _update_attrs(self, **command_attrs: Any):
for key, value in command_attrs.items(): for key, value in command_attrs.items():
@ -622,7 +640,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
required = param.default is param.empty required = param.default is param.empty
converter = get_converter(param) converter = get_converter(param)
consume_rest_is_special = param.kind == param.KEYWORD_ONLY and not self.rest_is_raw consume_rest_is_special = (
param.kind == param.KEYWORD_ONLY and not self.rest_is_raw
)
view = ctx.view view = ctx.view
view.skip_ws() view.skip_ws()
@ -630,9 +650,13 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
# it undos the view ready for the next parameter to use instead # it undos the view ready for the next parameter to use instead
if isinstance(converter, Greedy): if isinstance(converter, Greedy):
if param.kind in (param.POSITIONAL_OR_KEYWORD, param.POSITIONAL_ONLY): if param.kind in (param.POSITIONAL_OR_KEYWORD, param.POSITIONAL_ONLY):
return await self._transform_greedy_pos(ctx, param, required, converter.converter) return await self._transform_greedy_pos(
ctx, param, required, converter.converter
)
elif param.kind == param.VAR_POSITIONAL: elif param.kind == param.VAR_POSITIONAL:
return await self._transform_greedy_var_pos(ctx, param, converter.converter) return await self._transform_greedy_var_pos(
ctx, param, converter.converter
)
else: else:
# if we're here, then it's a KEYWORD_ONLY param type # if we're here, then it's a KEYWORD_ONLY param type
# since this is mostly useless, we'll helpfully transform Greedy[X] # since this is mostly useless, we'll helpfully transform Greedy[X]
@ -645,7 +669,10 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
if required: if required:
if self._is_typing_optional(param.annotation): if self._is_typing_optional(param.annotation):
return None return None
if hasattr(converter, "__commands_is_flag__") and converter._can_be_constructible(): if (
hasattr(converter, "__commands_is_flag__")
and converter._can_be_constructible()
):
return await converter._construct_default(ctx) return await converter._construct_default(ctx)
raise MissingRequiredArgument(param) raise MissingRequiredArgument(param)
return param.default return param.default
@ -690,7 +717,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
return param.default return param.default
return result return result
async def _transform_greedy_var_pos(self, ctx: Context, param: inspect.Parameter, converter: Any) -> Any: async def _transform_greedy_var_pos(
self, ctx: Context, param: inspect.Parameter, converter: Any
) -> Any:
view = ctx.view view = ctx.view
previous = view.index previous = view.index
try: try:
@ -804,13 +833,17 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
try: try:
next(iterator) next(iterator)
except StopIteration: except StopIteration:
raise discord.ClientException(f'Callback for {self.name} command is missing "self" parameter.') raise discord.ClientException(
f'Callback for {self.name} command is missing "self" parameter.'
)
# next we have the 'ctx' as the next parameter # next we have the 'ctx' as the next parameter
try: try:
next(iterator) next(iterator)
except StopIteration: except StopIteration:
raise discord.ClientException(f'Callback for {self.name} command is missing "ctx" parameter.') raise discord.ClientException(
f'Callback for {self.name} command is missing "ctx" parameter.'
)
for name, param in iterator: for name, param in iterator:
ctx.current_parameter = param ctx.current_parameter = param
@ -837,7 +870,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
break break
if not self.ignore_extra and not view.eof: if not self.ignore_extra and not view.eof:
raise TooManyArguments("Too many arguments passed to " + self.qualified_name) raise TooManyArguments(
"Too many arguments passed to " + self.qualified_name
)
async def call_before_hooks(self, ctx: Context) -> None: async def call_before_hooks(self, ctx: Context) -> None:
# now that we're done preparing we can call the pre-command hooks # now that we're done preparing we can call the pre-command hooks
@ -897,7 +932,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
ctx.command = self ctx.command = self
if not await self.can_run(ctx): if not await self.can_run(ctx):
raise CheckFailure(f"The check functions for command {self.qualified_name} failed.") raise CheckFailure(
f"The check functions for command {self.qualified_name} failed."
)
if self._max_concurrency is not None: if self._max_concurrency is not None:
# For this application, context can be duck-typed as a Message # For this application, context can be duck-typed as a Message
@ -1106,7 +1143,9 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
return self.help.split("\n", 1)[0] return self.help.split("\n", 1)[0]
return "" return ""
def _is_typing_optional(self, annotation: Union[T, Optional[T]]) -> TypeGuard[Optional[T]]: def _is_typing_optional(
self, annotation: Union[T, Optional[T]]
) -> TypeGuard[Optional[T]]:
return getattr(annotation, "__origin__", None) is Union and type(None) in annotation.__args__ # type: ignore return getattr(annotation, "__origin__", None) is Union and type(None) in annotation.__args__ # type: ignore
@property @property
@ -1137,13 +1176,24 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
origin = getattr(annotation, "__origin__", None) origin = getattr(annotation, "__origin__", None)
if origin is Literal: if origin is Literal:
name = "|".join(f'"{v}"' if isinstance(v, str) else str(v) for v in annotation.__args__) name = "|".join(
f'"{v}"' if isinstance(v, str) else str(v)
for v in annotation.__args__
)
if param.default is not param.empty: if param.default is not param.empty:
# We don't want None or '' to trigger the [name=value] case and instead it should # We don't want None or '' to trigger the [name=value] case and instead it should
# do [name] since [name=None] or [name=] are not exactly useful for the user. # do [name] since [name=None] or [name=] are not exactly useful for the user.
should_print = param.default if isinstance(param.default, str) else param.default is not None should_print = (
param.default
if isinstance(param.default, str)
else param.default is not None
)
if should_print: if should_print:
result.append(f"[{name}={param.default}]" if not greedy else f"[{name}={param.default}]...") result.append(
f"[{name}={param.default}]"
if not greedy
else f"[{name}={param.default}]..."
)
continue continue
else: else:
result.append(f"[{name}]") result.append(f"[{name}]")
@ -1192,21 +1242,29 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
raise DisabledCommand(f"{self.name} command is disabled") raise DisabledCommand(f"{self.name} command is disabled")
if ctx.interaction is None and ( if ctx.interaction is None and (
self.message_command is False or (self.message_command is None and not ctx.bot.message_commands) self.message_command is False
or (self.message_command is None and not ctx.bot.message_commands)
): ):
raise DisabledCommand(f"{self.name} command cannot be run as a message command") raise DisabledCommand(
f"{self.name} command cannot be run as a message command"
)
if ctx.interaction is not None and ( if ctx.interaction is not None and (
self.slash_command is False or (self.slash_command is None and not ctx.bot.slash_commands) self.slash_command is False
or (self.slash_command is None and not ctx.bot.slash_commands)
): ):
raise DisabledCommand(f"{self.name} command cannot be run as a slash command") raise DisabledCommand(
f"{self.name} command cannot be run as a slash command"
)
original = ctx.command original = ctx.command
ctx.command = self ctx.command = self
try: try:
if not await ctx.bot.can_run(ctx): if not await ctx.bot.can_run(ctx):
raise CheckFailure(f"The global check functions for command {self.qualified_name} failed.") raise CheckFailure(
f"The global check functions for command {self.qualified_name} failed."
)
cog = self.cog cog = self.cog
if cog is not None: if cog is not None:
@ -1234,7 +1292,10 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
param param
for name, flag in annotation.get_flags().items() for name, flag in annotation.get_flags().items()
for param in self._param_to_options( for param in self._param_to_options(
name, flag.annotation, required=flag.required, varadic=flag.annotation is tuple name,
flag.annotation,
required=flag.required,
varadic=flag.annotation is tuple,
) )
] ]
@ -1268,7 +1329,10 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
break break
elif origin is Union: elif origin is Union:
if annotation in {Union[discord.Member, discord.Role], Union[MemberConverter, RoleConverter]}: if annotation in {
Union[discord.Member, discord.Role],
Union[MemberConverter, RoleConverter],
}:
option["type"] = 9 option["type"] = 9
elif origin is Literal: elif origin is Literal:
@ -1281,18 +1345,27 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
option["type"] = application_option_type_lookup[python_type] option["type"] = application_option_type_lookup[python_type]
option["choices"] = [ option["choices"] = [
{"name": literal_value, "value": literal_value} for literal_value in annotation.__args__ {"name": literal_value, "value": literal_value}
for literal_value in annotation.__args__
] ]
return [option] # type: ignore return [option] # type: ignore
def to_application_command(self, nested: int = 0) -> Optional[EditApplicationCommand]: def to_application_command(
self, nested: int = 0
) -> Optional[EditApplicationCommand]:
if self.slash_command is False: if self.slash_command is False:
return return
elif nested == 3: elif nested == 3:
raise ApplicationCommandRegistrationError(self, f"{self.qualified_name} is too deeply nested!") raise ApplicationCommandRegistrationError(
self, f"{self.qualified_name} is too deeply nested!"
)
payload = {"name": self.name, "description": self.short_doc or "no description", "options": []} payload = {
"name": self.name,
"description": self.short_doc or "no description",
"options": [],
}
if nested != 0: if nested != 0:
payload["type"] = 1 payload["type"] = 1
@ -1300,15 +1373,23 @@ class Command(_BaseCommand, Generic[CogT, P, T]):
options = self._param_to_options( options = self._param_to_options(
name, name,
param.annotation if param.annotation is not param.empty else str, param.annotation if param.annotation is not param.empty else str,
varadic=param.kind == param.KEYWORD_ONLY or isinstance(param.annotation, Greedy), varadic=param.kind == param.KEYWORD_ONLY
required=(param.default is param.empty and not self._is_typing_optional(param.annotation)) or isinstance(param.annotation, Greedy),
required=(
param.default is param.empty
and not self._is_typing_optional(param.annotation)
)
or param.kind == param.VAR_POSITIONAL, or param.kind == param.VAR_POSITIONAL,
) )
if options is not None: if options is not None:
payload["options"].extend(option for option in options if option is not None) payload["options"].extend(
option for option in options if option is not None
)
# Now we have all options, make sure required is before optional. # Now we have all options, make sure required is before optional.
payload["options"] = sorted(payload["options"], key=itemgetter("required"), reverse=True) payload["options"] = sorted(
payload["options"], key=itemgetter("required"), reverse=True
)
return payload # type: ignore return payload # type: ignore
@ -1327,7 +1408,9 @@ class GroupMixin(Generic[CogT]):
def __init__(self, *args: Any, **kwargs: Any) -> None: def __init__(self, *args: Any, **kwargs: Any) -> None:
case_insensitive = kwargs.get("case_insensitive", True) case_insensitive = kwargs.get("case_insensitive", True)
self.all_commands: Dict[str, Command[CogT, Any, Any]] = _CaseInsensitiveDict() if case_insensitive else {} self.all_commands: Dict[str, Command[CogT, Any, Any]] = (
_CaseInsensitiveDict() if case_insensitive else {}
)
self.case_insensitive: bool = case_insensitive self.case_insensitive: bool = case_insensitive
super().__init__(*args, **kwargs) super().__init__(*args, **kwargs)
@ -1533,7 +1616,12 @@ class GroupMixin(Generic[CogT]):
*args: Any, *args: Any,
**kwargs: Any, **kwargs: Any,
) -> Callable[ ) -> Callable[
[Union[Callable[Concatenate[CogT, ContextT, P], Coro[T]], Callable[Concatenate[ContextT, P], Coro[T]]]], [
Union[
Callable[Concatenate[CogT, ContextT, P], Coro[T]],
Callable[Concatenate[ContextT, P], Coro[T]],
]
],
Group[CogT, P, T], Group[CogT, P, T],
]: ]:
... ...
@ -1684,17 +1772,24 @@ class Group(GroupMixin[CogT], Command[CogT, P, T]):
view.previous = previous view.previous = previous
await super().reinvoke(ctx, call_hooks=call_hooks) await super().reinvoke(ctx, call_hooks=call_hooks)
def to_application_command(self, nested: int = 0) -> Optional[EditApplicationCommand]: def to_application_command(
self, nested: int = 0
) -> Optional[EditApplicationCommand]:
if self.slash_command is False: if self.slash_command is False:
return return
elif nested == 2: elif nested == 2:
raise ApplicationCommandRegistrationError(self, f"{self.qualified_name} is too deeply nested!") raise ApplicationCommandRegistrationError(
self, f"{self.qualified_name} is too deeply nested!"
)
return { # type: ignore return { # type: ignore
"name": self.name, "name": self.name,
"type": int(not (nested - 1)) + 1, "type": int(not (nested - 1)) + 1,
"description": self.short_doc or "no description", "description": self.short_doc or "no description",
"options": [cmd.to_application_command(nested=nested + 1) for cmd in sorted(self.commands, key=lambda x: x.name)], "options": [
cmd.to_application_command(nested=nested + 1)
for cmd in sorted(self.commands, key=lambda x: x.name)
],
} }
@ -2001,7 +2096,9 @@ def check_any(*checks: Check) -> Callable[[T], T]:
try: try:
pred = wrapped.predicate pred = wrapped.predicate
except AttributeError: except AttributeError:
raise TypeError(f"{wrapped!r} must be wrapped by commands.check decorator") from None raise TypeError(
f"{wrapped!r} must be wrapped by commands.check decorator"
) from None
else: else:
unwrapped.append(pred) unwrapped.append(pred)
@ -2103,7 +2200,10 @@ def has_any_role(*items: Union[int, str]) -> Callable[[T], T]:
# ctx.guild is None doesn't narrow ctx.author to Member # ctx.guild is None doesn't narrow ctx.author to Member
getter = functools.partial(discord.utils.get, ctx.author.roles) # type: ignore getter = functools.partial(discord.utils.get, ctx.author.roles) # type: ignore
if any( if any(
getter(id=item) is not None if isinstance(item, int) else getter(name=item) is not None for item in items getter(id=item) is not None
if isinstance(item, int)
else getter(name=item) is not None
for item in items
): ):
return True return True
raise MissingAnyRole(list(items)) raise MissingAnyRole(list(items))
@ -2162,7 +2262,10 @@ def bot_has_any_role(*items: int) -> Callable[[T], T]:
me = ctx.me me = ctx.me
getter = functools.partial(discord.utils.get, me.roles) getter = functools.partial(discord.utils.get, me.roles)
if any( if any(
getter(id=item) is not None if isinstance(item, int) else getter(name=item) is not None for item in items getter(id=item) is not None
if isinstance(item, int)
else getter(name=item) is not None
for item in items
): ):
return True return True
raise BotMissingAnyRole(list(items)) raise BotMissingAnyRole(list(items))
@ -2208,7 +2311,9 @@ def has_permissions(**perms: bool) -> Callable[[T], T]:
ch = ctx.channel ch = ctx.channel
permissions = ch.permissions_for(ctx.author) # type: ignore permissions = ch.permissions_for(ctx.author) # type: ignore
missing = [perm for perm, value in perms.items() if getattr(permissions, perm) != value] missing = [
perm for perm, value in perms.items() if getattr(permissions, perm) != value
]
if not missing: if not missing:
return True return True
@ -2235,7 +2340,9 @@ def bot_has_permissions(**perms: bool) -> Callable[[T], T]:
me = guild.me if guild is not None else ctx.bot.user me = guild.me if guild is not None else ctx.bot.user
permissions = ctx.channel.permissions_for(me) # type: ignore permissions = ctx.channel.permissions_for(me) # type: ignore
missing = [perm for perm, value in perms.items() if getattr(permissions, perm) != value] missing = [
perm for perm, value in perms.items() if getattr(permissions, perm) != value
]
if not missing: if not missing:
return True return True
@ -2264,7 +2371,9 @@ def has_guild_permissions(**perms: bool) -> Callable[[T], T]:
raise NoPrivateMessage raise NoPrivateMessage
permissions = ctx.author.guild_permissions # type: ignore permissions = ctx.author.guild_permissions # type: ignore
missing = [perm for perm, value in perms.items() if getattr(permissions, perm) != value] missing = [
perm for perm, value in perms.items() if getattr(permissions, perm) != value
]
if not missing: if not missing:
return True return True
@ -2290,7 +2399,9 @@ def bot_has_guild_permissions(**perms: bool) -> Callable[[T], T]:
raise NoPrivateMessage raise NoPrivateMessage
permissions = ctx.me.guild_permissions # type: ignore permissions = ctx.me.guild_permissions # type: ignore
missing = [perm for perm, value in perms.items() if getattr(permissions, perm) != value] missing = [
perm for perm, value in perms.items() if getattr(permissions, perm) != value
]
if not missing: if not missing:
return True return True
@ -2368,7 +2479,9 @@ def is_nsfw() -> Callable[[T], T]:
def pred(ctx: Context) -> bool: def pred(ctx: Context) -> bool:
ch = ctx.channel ch = ctx.channel
if ctx.guild is None or (isinstance(ch, (discord.TextChannel, discord.Thread)) and ch.is_nsfw()): if ctx.guild is None or (
isinstance(ch, (discord.TextChannel, discord.Thread)) and ch.is_nsfw()
):
return True return True
raise NSFWChannelRequired(ch) # type: ignore raise NSFWChannelRequired(ch) # type: ignore
@ -2376,7 +2489,9 @@ def is_nsfw() -> Callable[[T], T]:
def cooldown( def cooldown(
rate: int, per: float, type: Union[BucketType, Callable[[Message], Any]] = BucketType.default rate: int,
per: float,
type: Union[BucketType, Callable[[Message], Any]] = BucketType.default,
) -> Callable[[T], T]: ) -> Callable[[T], T]:
"""A decorator that adds a cooldown to a :class:`.Command` """A decorator that adds a cooldown to a :class:`.Command`
@ -2411,14 +2526,17 @@ def cooldown(
if not hasattr(func, "__command_attrs__"): if not hasattr(func, "__command_attrs__"):
func.__command_attrs__ = {} func.__command_attrs__ = {}
func.__command_attrs__["cooldown"] = CooldownMapping(Cooldown(rate, per), type) func.__command_attrs__["cooldown"] = CooldownMapping(
Cooldown(rate, per), type
)
return func return func
return decorator # type: ignore return decorator # type: ignore
def dynamic_cooldown( def dynamic_cooldown(
cooldown: Union[BucketType, Callable[[Message], Any]], type: BucketType = BucketType.default cooldown: Union[BucketType, Callable[[Message], Any]],
type: BucketType = BucketType.default,
) -> Callable[[T], T]: ) -> Callable[[T], T]:
"""A decorator that adds a dynamic cooldown to a :class:`.Command` """A decorator that adds a dynamic cooldown to a :class:`.Command`
@ -2464,7 +2582,9 @@ def dynamic_cooldown(
return decorator # type: ignore return decorator # type: ignore
def max_concurrency(number: int, per: BucketType = BucketType.default, *, wait: bool = False) -> Callable[[T], T]: def max_concurrency(
number: int, per: BucketType = BucketType.default, *, wait: bool = False
) -> Callable[[T], T]:
"""A decorator that adds a maximum concurrency to a :class:`.Command` or its subclasses. """A decorator that adds a maximum concurrency to a :class:`.Command` or its subclasses.
This enables you to only allow a certain number of command invocations at the same time, This enables you to only allow a certain number of command invocations at the same time,