Metadata-Version: 2.1
Name: piston-cli
Version: 1.4.0
Summary: A cli tool with an terminal editor to compile over 35 languages instantly using the piston api.
Home-page: https://github.com/Shivansh-007/piston-cli
License: MIT
Keywords: shell,cli,code-editor,code-execution,compile,piston
Author: Shivansh-007
Author-email: shivansh-007@outlook.com
Requires-Python: >=3.9.4,<4.0.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: more-itertools (>=8.7.0,<9.0.0)
Requires-Dist: prompt-toolkit (>=3.0.18,<4.0.0)
Requires-Dist: pygments (>=2.8.1,<3.0.0)
Requires-Dist: requests (>=2.25.1,<3.0.0)
Requires-Dist: rich (>=10.1.0,<11.0.0)
Project-URL: Repository, https://github.com/Shivansh-007/piston-cli
Description-Content-Type: text/markdown

# Piston CLI

[![](https://img.shields.io/github/license/Shivansh-007/piston-cli?style=for-the-badge)]()
[![](https://img.shields.io/github/issues/Shivansh-007/piston-cli?style=for-the-badge)]()
[![](https://img.shields.io/github/issues-pr/Shivansh-007/piston-cli?style=for-the-badge)]()
[![](https://img.shields.io/github/workflow/status/Shivansh-007/piston-cli/Linting/main?style=for-the-badge)]()
[![](https://img.shields.io/pypi/pyversions/piston-cli?style=for-the-badge)]()
[![](https://img.shields.io/pypi/v/piston-cli?style=for-the-badge)]()

A cli tool which uses the [piston api](https://github.com/engineer-man/piston), developed by Engineerman and his team to compile over 35 languages instantly. Accepts files, paste.pythondiscord.com links and input.

### Installation

#### With pip

```bash
# Installing the package
pip install piston-cli -U
# Help Command
piston -h
```
#### With Nix/NixOS

Add this to your configuration.nix

```nix
  environment.systemPackages = with pkgs; [
     piston-cli
  ];
```

Or if you're using [home-manager](https://github.com/nix-community/home-manager)

```nix
  home.packages = with pkgs; [
     piston-cli
  ];
```

And finally using nix-env or nix profile

```bash
# using nix-env
nix-env -i piston-cli
# using nix profile (in nixUnstable)
nix profile install nixpkgs#piston-cli
```
#### For Arch/ArchBased
##### With yay
```bash
yay piston-cli
```
##### With paru
```bash
paru piston-cli
```

Or any AUR helper you use with doesn't matter. You get the point.

### Example usage

#### Default

![example usage](media/piston-cli.png)

#### Shell

![example shell usage](media/piston-cli-shell.png)

#### File

![example file usage](media/piston-cli-file.png)

#### Link

![example link usage](media/piston-cli-link.png)

### Languages

```bash
piston --list
```

## How to run it? (Contributing)

```shell
# This will install the development and project dependencies.
poetry install

# This will install the pre-commit hooks.
poetry run task precommit

# Optionally: run pre-commit hooks to initialize them.
# You can start working on the feature after this.
poetry run task pre-commit run --all-files

# Run it
poetry run task start --help
```

## Contributing

You can comment on the issues you would like to work on.

