Metadata-Version: 2.4
Name: thonny-tunisiaschools-macos
Version: 0.0.16
Summary: A Thonny IDE plug-in that offers PyQt / QT / Python support for Tunisian computer science secondary teachers / students. macOS support added by JOSEPH218.
Author-email: Selmen Arous <selmen.arous@gmail.com>
Maintainer: JOSEPH218
License-Expression: GPL-3.0-only
Keywords: PyQt,QT,Tunisia,School,Teaching,Education,macOS
Classifier: Environment :: MacOS X
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Education
Classifier: Topic :: Software Development
Requires-Python: >=3.0
Description-Content-Type: text/markdown
Requires-Dist: thonny>=3.2.1

# thonny-tunisiaschools

A Thonny plug-in which offers Tunisian computer science secondary teachers / students some help creating Python & PyQt Applications:

- Loads a QT UI file and:
  - Adds needed code to load that file to the current document
  - Creates empty functions bound to button clicks
  
  ![image](https://github.com/selmen2004/thonny-tunisiaschools/assets/3520243/4e4037a8-3157-4f09-99db-1b4543bb6233)

  - Adds a view that displays the UI inside Thonny (currently supporting Labels, Text inputs and buttons only)

  ![image](https://github.com/selmen2004/thonny-tunisiaschools/assets/3520243/a3bdb491-6f31-4b92-a5eb-d2842eec95f1)

- Adds a new menu (PyQt5) with commands to insert calls to common functions (text, setText, clear, show) for Labels and LineEdits

  ![image](https://github.com/selmen2004/thonny-tunisiaschools/assets/3520243/3bbd2794-c3f1-4425-92d2-6b5b1933f897)

- Changes the default save location for final exams (baccalauréat)
- Disables reopening last open files (to reduce risks of students overwriting each other's work)

---

## Installation

### Windows
Use **Tools → Manage plugins** inside Thonny, search for `thonny-tunisiaschools` and click Install.

### macOS

1. Download and extract this repository
2. Open **Terminal** (Spotlight → type "Terminal")
3. Run this command (you will be asked for your Mac password):

```bash
sudo /Applications/Thonny.app/Contents/Frameworks/Python.framework/Versions/3.10/bin/python3 -m pip install ~/Downloads/thonny_tunisiaschools-0.0.14
```

4. Restart Thonny — you should see a **PyQt5** menu in the menu bar

> **Note:** The `sudo` and Mac password are required because Thonny on macOS installs into a protected system folder. This is a one-time step.

### Prerequisite — Qt Designer (macOS)
To use the "Open in Designer" button, install Qt Designer:
```bash
pip3 install pyqt5-tools
```

---

## Supported platforms
- ✅ Windows
- ✅ macOS
- ✅ Linux
