https://github.com/buckley-w-david/polyglot
A script runner that allows usage of multiple languages within the same script.
https://github.com/buckley-w-david/polyglot
Last synced: about 1 month ago
JSON representation
A script runner that allows usage of multiple languages within the same script.
- Host: GitHub
- URL: https://github.com/buckley-w-david/polyglot
- Owner: buckley-w-david
- License: mit
- Created: 2022-12-06T19:14:11.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-03-06T07:08:03.000Z (over 2 years ago)
- Last Synced: 2025-06-11T19:41:45.300Z (4 months ago)
- Language: Python
- Homepage:
- Size: 33.2 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# polyglot
A script runner that allows usage of multiple languages within the same script.
```shell
$ cat << EOF > script.poly
#!/usr/bin/env polyglot
#!/usr/bin/env python
print("Hello, Python!")
#!/usr/bin/env bash
echo "Hello, Bash!"
EOF
$ chmod +x ./script.poly
$ ./script.poly
Hello, Python!
Hello, Bash!
```
## installation
Python tooling is a bit of a mess, but personally I like [pipx](https://pypa.github.io/pipx/).
```shell
$ pipx install git+https://github.com/buckley-w-david/polyglot.git
```
## Usage
```
$ polyglot --help
Usage: polyglot [OPTIONS] TARGET
Run a polyglot script
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * target PATH The polyglot script to run. [default: None] │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --errexit --no-errexit If errexit the script will │
│ exit if any script exits with │
│ an error status code. │
│ [default: errexit] │
│ --communicate --no-communicate If communicate stdout from │
│ each script will be fed into │
│ stdin of the next. │
│ [default: no-communicate] │
│ --install-completion Install completion for the │
│ current shell. │
│ --show-completion Show completion for the │
│ current shell, to copy it or │
│ customize the installation. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
```
## Why?
The idea behind polyglot is that often times you'll run into situations within a single script that are awkward to implement in a single language.
For example something may be simple in Python, but painful in Bash, while a later in the same script the situation is reversed.
Instead of putting up with it (and doing it all in one language) or splitting something into multiple scripts (and having to coordinate calling them in series from some parent script), `polyglot` lets you write the parts in whatever language is easiest.
We're trying to get the benefits of the first option without the negatives.
## Disclaimer
Probably don't depend on this for anything important. It's a relativly simplistic utility, and I have put almost no thought into edge cases.
Each script section is executed as its own subprocess. This means that no state is preserved between sections.
The `--communicate` flag can be used to pipe stdout from each section into stdin of the next. This is currently as far as shared state goes.
## Examples
Check out [tests/test_polyglot/](tests/test_polyglot/) for some (very small) example scripts.