Part 6: Take things

In this section we’ll add the take command.

Part 6.1: Add command

source code

In this section we’ll define a do_take() function that gets called when the player types t, take, or grab.

Demo

A: Define do_take()

1. [ ] Define a do_take() function.

2. [ ] In it, use the debug() function to print something like "Trying to take: args.".

Code

def do_take(args):
    """Pick up an item and add it to inventory."""
    debug(f"Trying to take: {args}")

B: Modify main(), in the while loop

1. [ ] Add an elif that checks if command is "t", "take" or "grab".

   • [ ] if so, call do_take()

Code

        if command in ["q", "quit", "exit"]:
            do_quit()

        elif command in ("shop"):
            do_shop()

        elif command in ("g", "go"):
            do_go(args)

        elif command in ("x", "exam", "examine"):
            do_examine(args)

        elif command in ("l", "look"):
            do_look()

        elif command in ("t", "take", "grab"):
            do_take(args)

        else:
            error("No such command.")
            continue

Part 6.2: Validate item

source code

In this section we’ll check to make sure that the player entered a valid, takeable item in the current place.

Demo

A: Modify ITEMS

1. [ ] For any item you wish for the player to be able to take, add "can_take": True to the items dictionary.

Code

    "book": {
        "key": "book",
        "can_take": True,
        "name": "a book",
        "description": (
            "A hefty leather-bound tome open to an interesting passage."
        ),
    },

B: Modify do_take(): make sure the item is valid in the current place

1. [ ] Check to see if args is falsy, if so:

   • [ ] Use the error() function to print a message saying: "Which way do you want to go?"

   • [ ] return

2. [ ] get the value from PLAYER associated with the "place" key and assign it to place_name

3. [ ] get the value from PLACES associated with place_name and assign it to place

4. [ ] assign the first item of the args list to the variable name and make it lowercase

5. [ ] Get the list of items in the place dictionary using .get() with a default value of []. Check to see if name is in the list. If not:

   • [ ] Print an error message like:

     "Sorry, I don't see a name here."

   • [ ] return

Code

def do_take(args):
    """Pick up an item and add it to inventory."""
    debug(f"Trying to take: {args}")

    # make sure the player typed an item
    if not args:
        error("What do you want to take?")
        return

    # get the item name from arguments
    # and make it lowercase
    name = args[0].lower()

    # look up where the player is now
    place_name = PLAYER["place"]
    place = PLACES[place_name]

    # make sure the item is in this place
    if name not in place.get("items", []):
        error(f"Sorry, I don't see a {name!r} here.")
        return

C: Modify do_take(): make sure the item is takeable

1. [ ] Using .get(), get the value from ITEMS associated with the name key and assign it to the variable item.

2. [ ] If item is falsy,

   • [ ] Print an error message like:

     "Woops! The information about name!r seems to be missing."

   • [ ] return

3. [ ] Using .get(), get the value from item associated with the "can_take" key. Check to see if it is falsy. If so:

   • [ ] Use wrap() to print a message like:

     "You try to pick up item['name'], but you find you aren't able to lift it."

   • [ ] return

Code

def do_take(args):
    """Pick up an item and add it to inventory."""
    debug(f"Trying to take: {args}")

    # make sure the player typed an item
    if not args:
        error("What do you want to take?")
        return

    # get the item name from arguments
    # and make it lowercase
    name = args[0].lower()

    # look up where the player is now
    place_name = PLAYER["place"]
    place = PLACES[place_name]

    # make sure the item is in this place
    if name not in place.get("items", []):
        error(f"Sorry, I don't see a {name!r} here.")
        return

    # get the item information
    item = ITEMS.get(name)

    # make sure the item is in the ITEMS dictionary
    if not item:
        error(f"Woops! The information about {name!r} seems to be missing.")
        return

    if not item.get("can_take"):
        wrap(f"You try to pick up {item['name']}, but you find you aren't able to lift it.")
        return

Part 6.3: Take it

source code

In this section we’ll actually take the item.

Demo

A: Modify PLAYER

1. [ ] Add "inventory": {} to the PLAYER dictionary.

Code

PLAYER = {
    "place": "home",
    "inventory": {},

B: Modify do_take()

In this section we will add the item to our inventory, remove it from the place, and let the player know that it’s done.

1. [ ] Call .setdefault() on PLAYER["inventory"] with the arguments name and 0.

   This will set the current inventory for name to 0 if it is not already in our inventory.

2. [ ] Add 1 to PLAYER["inventory"][name]

3. [ ] Remove name from the place["items"] list using the .remove() method

4. [ ] Use the wrap() function to print a message like:

   "You pick up name and put it in your pack."

Code

def do_take(args):
    """Pick up an item and add it to inventory."""
    debug(f"Trying to take: {args}")

    # make sure the player typed an item
    if not args:
        error("What do you want to take?")
        return

    # get the item name from arguments
    # and make it lowercase
    name = args[0].lower()

    # look up where the player is now
    place_name = PLAYER["place"]
    place = PLACES[place_name]

    # make sure the item is in this place
    if name not in place.get("items", []):
        error(f"Sorry, I don't see a {name!r} here.")
        return

    # get the item information
    item = ITEMS.get(name)

    # make sure the item is in the ITEMS dictionary
    if not item:
        error(f"Woops! The information about {name!r} seems to be missing.")
        return

    if not item.get("can_take"):
        wrap(f"You try to pick up {item['name']}, but you find you aren't able to lift it.")
        return

    PLAYER["inventory"].setdefault(name, 0)
    PLAYER["inventory"][name] += 1
    place["items"].remove(name)

    wrap(f"You pick up {item['name']} and put it in your pack.")

Part 6.4: Examine inventory

source code

In this section we’ll modify do_examine() so it can be used to look at inventory items.

Demo

A: Modify do_examine()

1. [ ] Find the if statement where you check if name is not in the place items list. Modify it so that it shows the error if name is not in place items and name is not in PLAYER["inventory"].

Code

def do_examine(args):
    """Look at an item in the current place."""

    debug(f"Trying to examine: {args}")

    # make sure the player said what they want to examine
    if not args:
        error("What do you want to examine?")
        return

    # look up where the player is now
    place_name = PLAYER["place"]
    place = PLACES[place_name]

    # get the item entered by the user and make it lowercase
    name = args[0].lower()

    # make sure the item is in this place or in the players inventory
    if not (name in place.get("items", []) or name in PLAYER["inventory"]):
        error(f"Sorry, I don't know what this is: {name!r}.")
        return