Metadata-Version: 2.4
Name: turtlelab
Version: 0.2.0
Summary: An interactive graphical interface to make turtle programming easier & better
Keywords: turtle,turtleide,interactiveturtle
Author: Arsalan Arish
Author-email: Arsalan Arish <mail@arsalanarish.com>
License-Expression: MIT
Maintainer: Arsalan Arish
Maintainer-email: Arsalan Arish <mail@arsalanarish.com>
Requires-Python: >=3.11
Project-URL: Repository, https://github.com/arsalan-arish/turtlelab
Description-Content-Type: text/markdown

# ✨Interactive Turtle Lab 🐢🔬

A simple Graphical Interface for executing Python turtle graphics from external files interactively, to make turtle programming easier & better.

## Features
- Browse and load `.py` files with turtle code
- A small built-in integrated code editor inside
- Embedded turtle canvas (no external windows)
- Built-in sandboxed execution environment

## Usage

```cli
pip install turtlelab
turtlelab test.py # Execute from CLI
```

1. Click **Browse...** to select a Python file
2. Review the code from the editor
3. Click **Run** to execute (Ctrl+Enter). It will automatically sync from the file loaded as well before running. So you can edit the file in your personal Editor and just click 'Run' and it will auto-fetch code from the file.
4. Click **Clear** to reset the canvas
5. Click **Save** (Ctrl-s) to save the code in code editor to the loaded file. If the file is not loaded already, it will prompt a filedialog window to ask save name and path

## Important Rules

- Use provided `t` (turtle) and `screen` objects directly
- Do NOT use `import turtle` in your code

## API

Your code has access to:
- `t` - RawTurtle object with full turtle graphics API
- `screen` - TurtleScreen for the canvas

**More features will be coming soon!**