def replace_reaction(target: dict, action: str, reaction_ind, reaction_new):
""" Replace reaction for specified keyword for the {object}
Args:
target: Target {object} or {player};
action: Trigger action keyword;
reaction_ind: Index of reaction that should be replaced;
reaction_new: A new function that should be executed;
Return:
updated {item} objects
"""
# Check that passed target is an {item} or {player} object:
if not (general.is_object(target) or general.is_player(target)):
print(f"Error: {target['name']} is not an Object or Player")
else:
try:
target['reactions'][action][reaction_ind] = reaction_new
print(
f"Reaction on action: {action} was successfully replaced for" +
f"{target['name']}")
except KeyError:
print(
f'There is no such action: {action} or reaction index: {reaction_ind}'
)
return target
def remove_reaction(target: dict,
action: str,
remove_all=False,
reaction_ind=-1):
""" Remove reaction for specified keyword from the {object}
Args:
target: Target {object} or {player};
action: Trigger action keyword;
remove_all: (optional) If True, removes all reactions for specified action. False by default
reaction_ind: If remove_all is set to False, remove only action from specified position (last by default).
Return:
updated {item} objects
"""
# Check that passed target is an {item} or {player} object:
if not (general.is_object(target) or general.is_player(target)):
print(f"Error: {target['name']} is not an Object or Player")
else:
if remove_all:
try:
del target['reactions'][action]
print(
f"All reactions were successfully deleted for action: {action}"
)
except KeyError:
print(f'There is no reactions for such action: {action}')
else:
try:
target['reactions'][action].pop(reaction_ind)
print(
f"Reaction was successfully deleted for action: {action}")
except KeyError:
print(f'There is no such reaction index{reaction_ind}')
return target
def print_reactions(target: dict, action: str):
""" Show all set reactions for specified action for {object}.
Args:
target: Target {object};
action: Trigger action keyword;
"""
# Check that passed target is an {item} or {player} object:
if not (general.is_object(target) or general.is_player(target)):
print(f"Error: {target['name']} is not an Object or Player")
else:
try:
# Print list of existing functions:
for i, reaction in enumerate(target['reactions'][action]):
print(f'Reaction #{i}: {reaction}')
except KeyError:
print(f'There is no reactions for such action: {action}')
def add_reaction(target: dict,
action: str,
reaction,
ind=None,
commands: set = None):
""" Add reaction for specified keyword to the {object}
Args:
target: Target {object} or {player};
action: Trigger action keyword;
reaction: A function that should be executed;
ind: (optional) Reaction index;
commands: Set of acceptable actions
Return:
updated {item} objects
"""
# If no set of acceptable command keywords was passed, use the default one:
if commands is None:
commands = language.create_vocabulary()
# Check that passed target is an {item} or {player} object:
if not (general.is_object(target) or general.is_player(target)):
print(f"Error: {target['name']} is not an Object or Player")
# Check that keyword is in command list:
elif action not in commands:
print(f'{action} is not an appropriate command')
else:
# Check if there is list object exists for passed action and if not, create an empty one:
target['reactions'][action] = target['reactions'].get(action, [])
if ind is None:
target['reactions'][action].append(reaction)
print(
f"Reaction was successfully added into {target['name']} for action: {action}"
)
else:
try:
target['reactions'][action].insert(ind, reaction)
print(
f"Reaction was successfully added into {target['name']} for action: {action}"
)
except KeyError:
print('Error: Incorrect index number')
return target
def set_global_reactions(obj_group: dict, action: str, reaction, ind=0):
""" Replace reaction for specified keyword for the {object}
Args:
obj_group: A group of target {object};
action: Trigger action keyword;
reaction: A function that should be executed;
ind: Index of reaction that should be replaced.
Return:
updated group of {items}
"""
try:
for obj in obj_group.values():
# Check that {item} object was passed:
if general.is_object(obj):
add_reaction(obj, action, reaction, ind)
except KeyError:
print('Failed to assign reaction to given object group')
return obj_group
