https://github.com/vshymanskyy/pypp
Python PreProcessor
https://github.com/vshymanskyy/pypp
Last synced: 7 months ago
JSON representation
Python PreProcessor
- Host: GitHub
- URL: https://github.com/vshymanskyy/pypp
- Owner: vshymanskyy
- License: mit
- Created: 2021-01-04T08:31:30.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-01-09T17:15:07.000Z (about 5 years ago)
- Last Synced: 2025-04-10T17:20:39.699Z (9 months ago)
- Language: Python
- Size: 48.8 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PYPP - Python turned into PreProcessor
**PYPP** formats the whole file using `f-string` syntax, with some additional helper directives and functions.
It should be able to process any text templates: source code, config files, docs, etc.
## Install
```sh
pip3 install https://github.com/vshymanskyy/pypp/archive/main.zip
```
## Usage example
Python 3 can be directly used to generate other files:
```py
from random import randrange
TITLE = "Hello"
print(f"""
{TITLE}
- {randrange(1,100)} ", end="")
""")
for i in range(5):
print(f"
print(f"""
""")
```
It turns out to be very flexible, but there are several problems with this approach:
Unreadable, too much boilerplate. Characters like `{}\` need to be manually escaped in `f-strings`, so it's unusable for processing `C/C++`, `Java`, `JS/JSON`, `Python` files. Python code draws a lot of attention, but it should be secondary here. If you want to include other files it becomes even more unreadable, etc.
PYPP is based on the same idea, but it tries to solve the above issues.
This is an equivalent PYPP template:
```py
#TITLE = "Hello PYPP"
{TITLE}
- {randrange(1,100)} ", end='')
#begin
from random import randrange
for i in range(5):
print(f"
print()
#end
```
After running `pypp template.html > result.html`, you get:
```html
Hello PYPP
- 8
- 15
- 33
- 85
- 38
```
**WebAssembly**
Template:
```wasm
#from pypp.lang.wasm import * # use WebAssembly helpers
#replace(';;.*?\n','\n') # remove comments
#ANSWER = 40
(module
(memory (export "mem") 1)
(data (i32.const 0x0000)
"\DE\AD\BE\EF"
;; Generate binary data for a float number
;; Similar to wat-numeric-values WebAssembly proposal
{f32(3.14159265359)}
)
(func (export "question") (result i32)
;; Use math expression to adjust the answer
(i32.const {ANSWER+2})
)
)
```
Result:
```wasm
(module
(memory (export "mem") 1)
(data (i32.const 0x0000)
"\DE\AD\BE\EF"
"\db\0f\49\40"
)
(func (export "question") (result i32)
(i32.const 42)
)
)
```
## Directives
### `#include()`
Include (and expand) another template file.
Any Python expression can be used as an argument, like: `'utils.wat'`, `f'{HEADER}.html'`, etc.
### `#begin`..`#end`
Run arbitrary Python code.
### `#replace(, )`
Replace arbitrary text.
### `#delim('py:', '%{', '}%')`
Set custom delimiters.
## Ideas (not implemented!)
### `#if()`..`#elif()`..`#else`..`#end`
Conditional block output.
### `#run_with(f'command {file} {args}'`)
Store output to a temporary file, and execute command automatically.
In conjunction with `#!/usr/bin/env pypp`, this should allow preprocessing and executing any templates as ordinary scripts.
__________
## License
This project is released under The MIT License (MIT)