Installing Space Diner 🍔

Prerequisites

• python3 is required. You can check your python version with: python --version. If you don't have python3, see python.org.
• Download the package file space-diner-VERSION.tar.gz (without unpacking it).

Installation

1. Open a terminal/command prompt and go to the directory with the downloaded package.
2. Run one of the following commands, replacing VERSION with the actual version number from the file name:
   • pip3 install space-diner-VERSION.tar.gz
   • or: pip install space-diner-VERSION.tar.gz
   • (Whether the command pip or pip3 is available depends on your system. When in doubt, try out which one works.)
3. Check if any of the conditions below apply - otherwise, you are done!
• Only if your python version < 3.7, additionally run: pip3 install importlib_resources.
• Only under Windows, additionally run: pip3 install pyreadline.
• Only under Linux, try to run the command space-diner. If it is not available, you need to adjust your shell's PATH (see packaging.python.org for detailed instructions):
  • Run: python -m site --user-base. This will typically return a path like ~/.local/bin.
  • Add the line export PATH="$PATH:~/.local/bin", adjusted with the path from above, to your ~/.bashrc file, e.g., at the end of the file (if you are using the standard bash terminal).
  • Run: source ~/.bashrc or start a new terminal.

(Instead of installing the package globally, you can alternatively use a virtual environment. See the instructions on packaging.python.org for details.)

Starting the game

You can now start the game from the terminal with the following command: space-diner

You can optionally start the game in a text-only mode (without ASCII art and decorative special characters): space-diner --text-only

Troubleshooting

• If, under Linux, starting the game with space-diner returns the error 'command not found', check the following:
  • Run python -m site --user-base, which will return a path. Check if this path is included in the list that is returned by echo $PATH. If not, check if the line you added to ~/.bashrc is correct.
  • In case it still doesn't work, try to alternatively start the game with ~/.local/bin/space-diner (potentially adjusted based on the output of python -m site --user-base, as described above).
• If you encounter any other problems during installation or during the game, please feel free to contact us: marta@2e2a.de