Skip to content

Commit 8e11c8f

Browse files
Docs - Added README File
1 parent e6c8cd4 commit 8e11c8f

File tree

2 files changed

+61
-1
lines changed

2 files changed

+61
-1
lines changed

.github/workflows/build-and-release.yml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,10 @@ jobs:
3333
3434
- name: Get short commit hash
3535
id: vars
36-
run: echo "SHORT_SHA=${GITHUB_SHA::7}" >> $GITHUB_ENV
36+
shell: pwsh
37+
run: |
38+
$shortSha = "${{ github.sha }}".Substring(0, 7)
39+
echo "SHORT_SHA=$shortSha" >> $env:GITHUB_ENV
3740
3841
- name: Create GitHub Release
3942
uses: softprops/action-gh-release@v1

README.md

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
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

Comments
 (0)