Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/py2many/py2many
Transpiler of Python to many other languages
https://github.com/py2many/py2many
ast dart dlang golang julia kotlin mojo nim python rust smt transpiler vlang
Last synced: 24 days ago
JSON representation
Transpiler of Python to many other languages
- Host: GitHub
- URL: https://github.com/py2many/py2many
- Owner: py2many
- License: mit
- Created: 2021-01-24T03:19:12.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-06T15:16:26.000Z (30 days ago)
- Last Synced: 2024-10-10T20:03:15.789Z (26 days ago)
- Topics: ast, dart, dlang, golang, julia, kotlin, mojo, nim, python, rust, smt, transpiler, vlang
- Language: Python
- Homepage:
- Size: 1.97 MB
- Stars: 669
- Watchers: 13
- Forks: 47
- Open Issues: 120
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-rust-list - py2many/py2many
- awesome-rust-list - py2many/py2many
README
# py2many: Python to many CLike languages transpiler
## Why
Python is popular, easy to program in, but has poor runtime
performance. We can fix that by transpiling a subset of the language
into a more performant, statically typed language.
A second benefit is security. Writing security sensitive
code in a low level language like C is error prone and could
lead to privilege escalation. Specialized languages such as
[wuffs](https://github.com/google/wuffs) exist to address this use
case. py2many can be a more general purpose solution to the problem
where you can verify the source via unit tests before you transpile.
A third potential use case is to accelerate python code by transpiling
it into an [extension](https://github.com/adsharma/py2many/issues/62)
Swift and Kotlin dominate the mobile app development workflow. However, there is
no one solution that works well for lower level libraries where there is desire
to share code between platforms. Kotlin Mobile Multiplatform (KMM) is a player
in this place, but it hasn't really caught on. py2many provides an alternative.
Lastly, it's a great educational tool to learn a new language by implementing
a backend for your favorite language.
## Status
Rust is the language where the focus of development has been.
C++14 is historically the first language to be supported.
C++17 is now required for some features.
Preliminary support exists for Julia, Kotlin, Nim, Go, Dart, V, and D.
py2many can also emit Python 3 code that includes inferred type annotations,
and revisions to the syntax intended to simplify parsing of the code.
## History
Based on Julian Konchunas' [pyrs](http://github.com/konchunas/pyrs).
Based on Lukas Martinelli [Py14](https://github.com/lukasmartinelli/py14)
and [Py14/python-3](https://github.com/ProgVal/py14/tree/python-3) branch by Valentin
Lorentz.
## Example
Original Python version.
```python
def fib(i: int) -> int:
if i == 0 or i == 1:
return 1
return fib(i - 1) + fib(i - 2)
```
Transpiled Rust code:
```rust
fn fib(i: i32) -> i32 {
if i == 0 || i == 1 {
return 1;
}
return (fib((i - 1)) + fib((i - 2)));
}
```
Transpiled code for other languages:
https://github.com/adsharma/py2many/tree/main/tests/expected (fib*)
## Trying it out
Requirements:
- Python 3.8+
Local installation:
```sh
pip3 install --user # installs to $HOME/.local
```
OR
```sh
sudo pip3 install # installs systemwide
```
Add the py2many script to your $PATH and run:
Transpiling:
```sh
py2many --cpp=1 tests/cases/fib.py
py2many --rust=1 tests/cases/fib.py
py2many --julia=1 tests/cases/fib.py
py2many --kotlin=1 tests/cases/fib.py
py2many --nim=1 tests/cases/fib.py
py2many --dart=1 tests/cases/fib.py
py2many --go=1 tests/cases/fib.py
py2many --dlang=1 tests/cases/fib.py
```
Compiling:
```sh
clang tests/expected/fib.cpp
rustup run nightly cargo build -Zscript --manifest-path tests/expected/fib.rs
...
dmd -run tests/cases/fib.d
```
Many of the transpilers rely on a language specific formatter to parse the output and reformat it.
Typically this is the most prominent formatter for the language, such as `rustfmt` for Rust.
Most of the transpilers also rely on external libraries to provide bridges from
Python constructs to the target language.
The steps to install these external libraries can be found in `.github/workflows/main.yml`.
# Contributing
See [CONTRIBUTING.md](https://github.com/adsharma/py2many/blob/main/CONTRIBUTING.md)
for how to test your changes and contribute to this project.