|
| 1 | +# ChiX |
| 2 | + |
| 3 | +ChiX is a Python-based GUI application designed to serve as a C Code Editor and Runner. It provides users with an intuitive interface to write, compile, and run C programs seamlessly. With features like syntax highlighting, file management, and output display, ChiX is ideal for developers and learners working with C. |
| 4 | + |
| 5 | +## Features |
| 6 | + |
| 7 | +- **C Code Editor**: Write and edit C code with syntax highlighting. |
| 8 | +- **C Code Runner**: Compile and run C programs directly from the application. |
| 9 | +- **File Management**: Create, open, save, and save-as C files within the application. |
| 10 | +- **Themed GUI**: Experience a modern dark-theme user interface. |
| 11 | + |
| 12 | +## Installation |
| 13 | + |
| 14 | +To set up ChiX on your local machine, follow these steps: |
| 15 | + |
| 16 | +1. Clone the repository: |
| 17 | + ```bash |
| 18 | + git clone https://github.com/PrakharDoneria/ChiX.git |
| 19 | + cd ChiX |
| 20 | + ``` |
| 21 | + |
| 22 | +2. Install the required Python libraries: |
| 23 | + ```bash |
| 24 | + pip install -r requirements.txt |
| 25 | + ``` |
| 26 | + |
| 27 | +3. Ensure you have GCC (MinGW) installed and added to your system's PATH. |
| 28 | + |
| 29 | +## Usage |
| 30 | + |
| 31 | +1. Run the application: |
| 32 | + ```bash |
| 33 | + python app.py |
| 34 | + ``` |
| 35 | + |
| 36 | +2. Features available: |
| 37 | + - Write C code in the editor. |
| 38 | + - Use the toolbar to manage files (New, Open, Save, Save As). |
| 39 | + - Compile and run your code using the "Compile & Run" button. |
| 40 | + |
| 41 | +## Code Structure |
| 42 | + |
| 43 | +- **`app.py`**: The main entry point of the application. |
| 44 | +- **`core/runner.py`**: Handles code compilation and execution. |
| 45 | +- **`utils/highlighter.py`**: Adds syntax highlighting for C code. |
| 46 | +- **`compiler/compiler.py`**: Checks GCC installation and compiles C code. |
| 47 | +- **`ui/widgets.py`**: Builds the GUI components. |
| 48 | +- **`ui/theme.py`**: Configures the application's theme. |
| 49 | +- **`core/file_ops.py`**: Manages file operations such as open and save. |
| 50 | + |
| 51 | +## Contributing |
| 52 | + |
| 53 | +Contributions are welcome! Feel free to fork the repository, raise issues, and submit pull requests. |
| 54 | + |
| 55 | +## Acknowledgments |
| 56 | + |
| 57 | +Special thanks to the developers of `customtkinter` and `pygments` for their amazing libraries. |
0 commit comments