These instructions describe the process to install Codescape Console on your development machine.

Pre-requisites

Codescape Console requires Python 2.7 (Python 2.6 is ok on Linux, but Python 2.7 is preferred). Please download and install from https://www.python.org/download/releases/2.7/

Windows

1. Extract the given .zip file.

2. In a command prompt in the extracted directory run “python install_all_packages.py”

3. Add c:\Python27 and c:\Python27\Scripts to PATH in Control Panel. See python docs for details.

Linux/OSX

1. Extract the given .zip file.

2. In a shell in the extracted directory, run either :

$ sudo python install_all_packages.py

or

$ python install_all_packages.py --user

3. On most distributions the CodescapeConsole application will now be available on PATH but if you use the --user option, you might find that CodescapeConsole has been installed to a location which is not on your path. Look for the line:

“Installing CodescapeConsole script to /…../bin”

You need to add that path to your PATH.

Final Installation Steps

Jinja2 is a third party package that provides the templating engine for the `regs` command:

$ easy_install jinja2
Note: You may get a PEP440 warning here, this is a bug in setuptools and can be safely ignored.

The following packages are not required but they add extra functionality to Codescape Console through 3rd party libraries.

1. Add tab completion support to Windows – DO NOT install pyreadline on Linux/OSX:

$ easy_install pyreadline

2. Add elf loading support:

$ easy_install pyelftools
Note: For easy_install commands on Linux/OSX you will need to either run the command with sudo, or add the --user command line argument before the package name.

Running Codescape Console

From a command prompt/shell:

$ CodescapeConsole DAnet123