Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/0x1nf3cted/parcer
Parcer: A Python-based C parser that produces the Abstract Syntax Tree (AST) of the provided code in both JSON and string formats. 🌲🔍
https://github.com/0x1nf3cted/parcer
ast c compiler json lexer parser python string
Last synced: 22 days ago
JSON representation
Parcer: A Python-based C parser that produces the Abstract Syntax Tree (AST) of the provided code in both JSON and string formats. 🌲🔍
- Host: GitHub
- URL: https://github.com/0x1nf3cted/parcer
- Owner: 0x1nf3cted
- License: mit
- Created: 2023-09-24T17:13:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-09-26T23:22:42.000Z (over 1 year ago)
- Last Synced: 2024-11-02T13:42:15.169Z (2 months ago)
- Topics: ast, c, compiler, json, lexer, parser, python, string
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# Parcer: C parser written in Python
Parcer is a simple C parser implemented in Python. This parser is designed to tokenize C code and construct an Abstract Syntax Tree (AST).
## Features
- Tokenizes C code files.
- Recognizes delimiters, keywords, operators, and more.
- Constructs an Abstract Syntax Tree (AST) from the parsed tokens.
- Handles multi-line comments.
- Provides detailed information about each token and AST node.
## Installation
1. Clone the repository to your local machine:
```bash
git clone https://github.com/duckduckcodes/parcer
```
2.
```bash
cd parcer
```
3.
```bash
python3 src/c_ast.py [file]
```
## Example:
1. **String** format
### Input:
```c
for (int i = 0; i < 10; i += 1) {
printf("%d", i);
}
```
### Output:
```
Entry:: Program
For Loop: body: ['{', 'printf', '(', '"', '%', 'd', '"', ',', 'i', ')', ';', '}']
Assignement:
left:
Variable:
type: int, identifier: i
operator: =
right: ['0']
Loop Condition:
left: ['i'], comparator: <, right: ['10']
Assignement:
left: i
operator: =
right:
Binary Expression:
left: i, operator: +, right: 1
```
2. **JSON** format:
```json
{
"node_type": "Entry",
"value": "Program",
"parent": null,
"children": {
"node_type": "For Loop",
"body": ["{", "printf", "(", "\"", "%", "d", "\"", ",", "i", ")", ";", "}"],
"Initialization": {
"node_type": "Assignement",
"operator": "=",
"left": { "node_type": "Variable", "value": "i", "parent": null },
"right": ["0"]
},
"Condition": {
"node_type": "Loop Condition",
"comparator": "<",
"left": ["i"],
"right": ["10"]
},
"Update": {
"node_type": "Assignement",
"operator": "=",
"left": "i",
"right": {
"node_type": "Binary Expression",
"operator": "+",
"left": "i",
"right": "1"
}
}
}
}
```
## ⚠️ Warnings
### Important Information
Please be aware that this project is still in development and may not be stable for production use. Use it at your own risk.
### Contribution
This project is actively under development. You're encouraged to explore, test, and provide feedback. Contributions in the form of bug reports, feature requests, or code contributions are welcome. Please see our [contribution guidelines](https://github.com/duckduckcodes/parcer/blob/main/CONTRIBUTING.md) for more details on how to get involved.