Pistonpy
Pistonpy is an API wrapper for the Piston code execution engine by Engineer Man.
Key Features
- Simple modern and efficient Pythonic API using the
requestslib. - Supports application integration and CLI usage.
Requirements
Python 3.8+
Installing
To install the library, run the following commands:
# Linux/MacOS
python3 -m pip install -U pistonpy
# Windows
py -3 -m pip install -U pistonpy
Usage
from pistonpy import PistonApp
# Initialize the client.
piston = PistonApp()
my_code = "print('This code ran from app.py itself!')"
output = piston.run(language="python", version="3.10.0", code=my_code)
print(output)
This gives the output:
{'language': 'python', 'version': '3.10.0', 'run': {'stdout': 'This code ran from app.py itself!\n', 'stderr': '', 'code': 0, 'signal': None, 'output': 'This code ran from app.py itself!\n'}}
run_file = piston.run(language="python", files=['test.py']) # version is optional. files even if it maybe only one must be given as lists.
print(run_file)
This gives the same output,
{'language': 'python', 'version': '3.10.0', 'run': {'stdout': 'The code ran from test.py\n', 'stderr': '', 'code': 0, 'signal': None, 'output': 'The code ran from test.py\n'}}
# You cannot provide both code and files in a single PistonAPP().run() instance.
# For running multiple files (For now it ONLY supports multiple python files)
multiple_files = piston.run(language="python", version="3.10.0", files=['test.py', 'test_two.py'])
print(multiple_files)
Sadly, the output for multiple files are provided all-together. This will be fixed in the upcoming updates. The above statement will output to:
{'language': 'python', 'version': '3.10.0', 'run': {'stdout': 'The code ran from test.py\nthis is test 2\n', 'stderr': '', 'code': 0, 'signal': None, 'output': 'The code ran from test.py\nthis is test 2\n'}}
print(piston.languages) # Prints the available languages along with their version.
print(piston.aliases) # Prints the available languages along with their alias/aliases.
print(piston.raw) # Prints the raw data without any formatting done.
License
This project is distributed under the MIT license.
Piston
For visiting Piston's github repository, click here.
71 Jul 19, 2022
3k Dec 29, 2022
904 Jan 2, 2023
7 Dec 11, 2022
16 Mar 29, 2022
16 Dec 10, 2022
4 Dec 22, 2021
1 Nov 19, 2022
1 Jan 08, 2022
5 Oct 19, 2022
2 Oct 29, 2022
1 Dec 27, 2021
1 Dec 06, 2021
4 May 11, 2022
1 Feb 14, 2022
12 Nov 25, 2022
81 Dec 03, 2022
133 Dec 28, 2022
2 Nov 13, 2021
2 Oct 21, 2022
6.8k Jan 04, 2023
3 Dec 29, 2021
12 Oct 24, 2017
23 Nov 21, 2022
2 Oct 21, 2022
6 Sep 05, 2022
1 Oct 22, 2021
1 Jan 22, 2022