Skip to content

Latest commit

 

History

History
196 lines (143 loc) · 5.71 KB

File metadata and controls

196 lines (143 loc) · 5.71 KB

PyGUIde - Interactive Python IDE

Python License Platform Version

Logo

An educational Python development environment designed to make coding more visual and interactive.

📋 Table of Contents

✨ Features

🏗️ Project Management

  • 📁 Project-based workflow with integrated file explorer
  • 🐍 Virtual environment creation and management
  • 📦 Automatic dependency detection and installation
  • 🔄 Smart package management with missing dependency alerts

💻 Code Editing

  • 🎨 Syntax highlighting for Python code
  • 🔢 Line numbers with synchronized scrolling
  • ↩️ Undo/Redo functionality
  • 🔍 Find and Replace with dialog boxes
  • 📝 Code snippets for rapid development
  • ⚡ Auto-indentation and smart formatting

🔧 Development Tools

  • ▶️ Integrated code execution with real-time output
  • 🛠️ Syntax checking and error detection
  • 📊 Code analysis and complexity metrics
  • 🎯 Function and class detection
  • 💡 Code improvement suggestions
  • 🐞 Problems panel for error tracking

🎛️ User Interface

  • 🌙 Modern dark/light theme support
  • 📱 Responsive layout with resizable panels
  • 🔀 Tabbed interface for organized workflow
  • 📺 Interactive Python console
  • 📈 Real-time dependency status monitoring
  • ⚙️ Customizable workspace

🚀 Advanced Features

  • 🔄 Automatic dependency analysis from code imports
  • 📦 One-click installation of missing packages
  • 🎯 Smart virtual environment detection
  • 📊 Code complexity visualization
  • 💾 Auto-save and session persistence
  • 🔍 Enhanced file explorer with project navigation

🎨 Main Interface

MainInterface

🚀 Installation

Prerequisites

  • Python 3.7+ 🐍
  • pip (Python package installer) 📦

Install Dependencies

# Install required packages
pip install customtkinter

Download and Run

  1. Clone or download the PyGUIde repository
  2. Navigate to the project directory
  3. Run the application:
python PyGUIde.py

🎯 Quick Start

1. 🆕 Create Your First Project

  1. Launch PyGUIde
  2. Go to FileOpen Folder 📁
  3. Select or create a new project directory
  4. Start coding in the main editor! 💻

2. ⚙️ Set Up Virtual Environment

  1. Open your project folder 📂
  2. Go to ProjectCreate Virtual Environment 🐍
  3. Enter a name (e.g., "venv") ✏️
  4. PyGUIde will automatically detect and use it! ✅

3. 📦 Manage Dependencies

  1. Write code with import statements 📝
  2. Check the Dependencies tab 📊
  3. Click "Install All Missing" for automatic setup 🚀
  4. PyGUIde handles the rest! ✨

4. ▶️ Run Your Code

  • Press F5 or click the ► Run button
  • View output in the Output tab 📺
  • Use the Console tab for interactive Python 🐍
  • Check Problems tab for syntax errors 🐞

📖 Usage Guide

🗂️ File Management

Action Shortcut Description
New File Ctrl+N Create a new Python file 📄
Open File Ctrl+O Open an existing file 📂
Open Folder Ctrl+Shift+O Open project folder 📁
Save Ctrl+S Save current file 💾
Save As Ctrl+Shift+S Save with new name 📝

✏️ Editing

Action Shortcut Description
Undo Ctrl+Z Undo last action ↩️
Redo Ctrl+Y Redo last undone action ↪️
Find Ctrl+F Find text 🔍
Replace Ctrl+H Find and replace 🔄

▶️ Execution

Action Shortcut Description
Run Code F5 Execute current file 🚀
Check Syntax - Validate Python syntax ✅
Stop Execution - Terminate running process ⏹️

🎛️ Interface

  • Explorer Tab 📁: Navigate project files and folders
  • Dependencies Tab 📦: Manage packages and virtual environments
  • Insights Tab 📊: View code analysis and suggestions
  • Snippets Tab 📝: Quick access to code templates
  • Output Panel 📺: View execution results and errors
  • Console Panel 🐍: Interactive Python interpreter
  • Problems Panel 🐞: Syntax errors and warnings

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Bug Reports

  • Use the issue tracker to report bugs 🐞
  • Include Python version and OS details 💻
  • Provide steps to reproduce the issue 📝

💡 Feature Requests

  • Suggest new features via issues ✨
  • Explain the use case and benefits 📋
  • Consider backward compatibility 🔄

🛠️ Code Contributions

  1. Fork the repository 🍴
  2. Create a feature branch 🌿
  3. Make your changes ✏️
  4. Test thoroughly 🧪
  5. Submit a pull request 📤

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.


🌟 Star this repository if you find it helpful! 🌟

Made with ❤️ for the Python community

PyGUIde - Making Python development visual, interactive, and fun! 🚀