A sample app for debugging Python using Rookout.

• Prerequisites
• Setup
• Usage
• License
• Sign up to Rookout
• Online Documentation

1. Python 3.5 - 3.8
2. pip
3. Optional - Docker - https://www.docker.com/get-docker

3. Clone the sample app from this repository:

git clone https://github.com/Rookout/tutorial-python.git
cd tutorial-python

4. Set your Rookout token as an environment variable (for Windows, use set instead of export)

export ROOKOUT_TOKEN=[Your Rookout Token]

5. Run the app:

pip install -r requirements.txt
python app.py

• Optional - Run the app using Docker:

docker run -p 5000:5000 -e ROOKOUT_TOKEN=$ROOKOUT_TOKEN rookout/tutorial-python

• Log in to the Rookout IDE
• Set up your debug session by selecting the Python app you started. See Debug session setup for more information
• Add the source code according to the following instructions. In this case, use the local filesystem option to associate the code in your local 'tutorial-python' folder.
• Open the file 'app.py'
• Add a Breakpoint next to line number 84 by clicking next the the line number in the file viewer
• Go the the app webpage http://localhost:5000/ and add a todo in order to trigger the Breakpoint
• Check the bottom pane Messages and you'll see the snapshot you just added, as it was triggered by the handler of the web api when you added a todo

Go through the bug list and follow instructions to see some basic use cases.

• Breakpoint status is pending (hollow with purple outline) -- Connection to the app was not able to be established. Make sure that you inserted the Rookout Token in the right place and that the SDK was properly installed.
• Breakpoing status is disabled (solid grey) -- The breakpoint was disabled from collecting more data due to the limits being hit.
• Brekapoint error -- something went wrong. Check the breakpoint status to get more information on the error type, and for more information go to our [breakpoint status guide][https://docs.rookout.com/docs/breakpoints-status/].

• Our website for more information
• Our documentation for more information
• our deployment examples for platform-specific integration examples

APACHE 2