"""User command functions for the mudpy engine."""
-# Copyright (c) 2004-2018 mudpy authors. Permission to use, copy,
+# Copyright (c) 2004-2019 mudpy authors. Permission to use, copy,
# modify, and distribute this software is granted under terms
# provided in the LICENSE file distributed with this software.
import random
import re
+import traceback
import unicodedata
import mudpy
-def chat(actor):
+def chat(actor, parameters):
"""Toggle chat mode."""
mode = actor.get("mode")
if not mode:
else:
message = "Arglebargle, glop-glyf!?!"
- # send the error message
- actor.send(message)
+ # try to send the error message, and log if we can't
+ try:
+ actor.send(message)
+ except Exception:
+ mudpy.misc.log(
+ 'Sending a command error to user %s raised exception...\n%s' % (
+ actor.owner.account.get("name"), traceback.format_exc()))
def halt(actor, parameters):
if parameters and actor.owner:
# is the command word one for which we have data?
- if parameters in actor.universe.groups["command"]:
- command = actor.universe.groups["command"][parameters]
- else:
- command = None
+ command = mudpy.misc.find_command(parameters)
# only for allowed commands
if actor.can_run(command):
output = "$(red)"
else:
output = "$(grn)"
- output += parameters + "$(nrm) - " + description + "$(eol)$(eol)"
+ output = "%s%s$(nrm) - %s$(eol)$(eol)" % (
+ output, command.subkey, description)
# add the help text if provided
help_text = command.get("help")
# no specific command word was indicated
else:
- # give a sorted list of commands with descriptions if provided
- output = "These are the commands available to you:$(eol)$(eol)"
- sorted_commands = list(actor.universe.groups["command"].keys())
- sorted_commands.sort()
- for item in sorted_commands:
- command = actor.universe.groups["command"][item]
+ # preamble text
+ output = ("These are the commands available to you [brackets indicate "
+ "optional portion]:$(eol)$(eol)")
+
+ # list command names in alphabetical order
+ for command_name, command in sorted(
+ actor.universe.groups["command"].items()):
+
+ # skip over disallowed commands
if actor.can_run(command):
- description = command.get("description")
- if not description:
- description = "(no short description provided)"
+
+ # start incrementing substrings
+ for position in range(1, len(command_name) + 1):
+
+ # we've found our shortest possible abbreviation
+ candidate = mudpy.misc.find_command(
+ command_name[:position])
+ try:
+ if candidate.subkey == command_name:
+ break
+ except AttributeError:
+ pass
+
+ # use square brackets to indicate optional part of command name
+ if position < len(command_name):
+ abbrev = "%s[%s]" % (
+ command_name[:position], command_name[position:])
+ else:
+ abbrev = command_name
+
+ # supply a useful default if the short description is missing
+ description = command.get(
+ "description", "(no short description provided)")
+
+ # administrative command names are in red, others in green
if command.get("administrative"):
- output += " $(red)"
+ color = "red"
else:
- output += " $(grn)"
- output += item + "$(nrm) - " + description + "$(eol)"
- output += ('$(eol)Enter "help COMMAND" for help on a command '
- 'named "COMMAND".')
+ color = "grn"
+
+ # format the entry for this command
+ output = "%s $(%s)%s$(nrm) - %s$(eol)" % (
+ output, color, abbrev, description)
+
+ # add a footer with instructions on getting additional information
+ output = ('%s $(eol)Enter "help COMMAND" for help on a command named '
+ '"COMMAND".' % output)
# send the accumulated output to the user
actor.send(output)
def move(actor, parameters):
"""Move the avatar in a given direction."""
- if parameters in actor.universe.contents[actor.get("location")].portals():
- actor.move_direction(parameters)
+ for portal in sorted(
+ actor.universe.contents[actor.get("location")].portals()):
+ if portal.startswith(parameters):
+ actor.move_direction(portal)
+ return(portal)
+ actor.send("You cannot go that way.")
+
+
+def preferences(actor, parameters):
+ """List, view and change actor preferences."""
+
+ # Escape replacement macros in preferences
+ parameters = mudpy.misc.escape_macros(parameters)
+
+ message = ""
+ arguments = parameters.split()
+ allowed_prefs = set()
+ base_prefs = []
+ user_config = actor.universe.contents.get("mudpy.user")
+ if user_config:
+ base_prefs = user_config.get("pref_allow", [])
+ allowed_prefs.update(base_prefs)
+ if actor.owner.account.get("administrator"):
+ allowed_prefs.update(user_config.get("pref_admin", []))
+ if not arguments:
+ message += "These are your current preferences:"
+
+ # color-code base and admin prefs
+ for pref in sorted(allowed_prefs):
+ if pref in base_prefs:
+ color = "grn"
+ else:
+ color = "red"
+ message += ("$(eol) $(%s)%s$(nrm) - %s" % (
+ color, pref, actor.owner.account.get(pref, "<not set>")))
+
+ elif arguments[0] not in allowed_prefs:
+ message += (
+ 'Preference "%s" does not exist. Try the `preferences` command by '
+ "itself for a list of valid preferences." % arguments[0])
+ elif len(arguments) == 1:
+ message += "%s" % actor.owner.account.get(arguments[0], "<not set>")
else:
- actor.send("You cannot go that way.")
+ pref = arguments[0]
+ value = " ".join(arguments[1:])
+ try:
+ actor.owner.account.set(pref, value)
+ message += 'Preference "%s" set to "%s".' % (pref, value)
+ except ValueError:
+ message = (
+ 'Preference "%s" cannot be set to type "%s".' % (
+ pref, type(value)))
+ actor.send(message)
-def quit(actor):
+def quit(actor, parameters):
"""Leave the world and go back to the main menu."""
if actor.owner:
actor.owner.state = "main_utility"
actor.owner.deactivate_avatar()
-def reload(actor):
+def reload(actor, parameters):
"""Reload all code modules, configs and data."""
if actor.owner:
actor.send("What do you want to say?")
-def set(actor, parameters):
+def c_set(actor, parameters):
"""Set a facet of an element."""
if not parameters:
message = "You must specify an element, a facet and a value."
elif arguments[0] == "version":
message = repr(actor.universe.versions)
elif arguments[0] == "time":
- message = actor.universe.groups["internal"]["counters"].get(
- "elapsed"
- ) + " increments elapsed since the world was created."
+ message = "%s increments elapsed since the world was created." % (
+ str(actor.universe.groups["internal"]["counters"].get("elapsed")))
elif arguments[0] == "groups":
message = "These are the element groups:$(eol)"
groups = list(actor.universe.groups.keys())
message = "You need to specify an expression."
else:
try:
- message = repr(eval(" ".join(arguments[1:])))
+ # there is no other option than to use eval() for this, since
+ # its purpose is to evaluate arbitrary expressions, so do what
+ # we can to secure it and whitelist it for bandit analysis
+ message = repr(eval( # nosec
+ " ".join(arguments[1:]),
+ {"mudpy": mudpy, "universe": actor.universe}))
except Exception as e:
message = ("$(red)Your expression raised an exception...$(eol)"
"$(eol)$(bld)%s$(nrm)" % e)