# Pomsky CLI

This CLI allows you to compile [pomsky expressions](https://pomsky-lang.org/) to regexes in the
command line.

## Use pre-built binaries

Binaries are available for Windows, Linux and macOS. Download them from the
[releases page](https://github.com/pomsky-lang/pomsky/releases).

## Install from source

This requires that a recent Rust toolchain is installed. Instructions for how to install Rust can be
found [here](https://www.rust-lang.org/tools/install).

Install the CLI with

```sh
cargo install pomsky-bin
```

## Usage

Then you can compile pomsky expressions to a regex flavor of your choice; the default is PCRE.

```sh
$ pomsky --help
pomsky 0.1.0
Ludwig Stecher <ludwig.stecher@gmx.de>
Compile pomsky expressions, a new regular expression language

USAGE:
    pomsky [OPTIONS] [INPUT]

ARGS:
    <INPUT>    Pomsky expression to compile

OPTIONS:
    -d, --debug              Show debug information
    -f, --flavor <FLAVOR>    Regex flavor [possible values: pcre, python,
                             java, javascript, dotnet, ruby, rust]
    -h, --help               Print help information
    -p, --path <FILE>        File containing the pomsky expression to compile
    -V, --version            Print version information
```

It provides nice error messages:

```sh
$ pomsky "'Hello world'* \X+"
Error:
  × Backslash escapes are not supported
   ╭────
 1 │ 'Hello world'* \X+
   ·                ─┬
   ·                 ╰── error occurred here
   ╰────
  help: Replace `\X` with `Grapheme`
```

## License

Dual-licensed under the [MIT license](https://opensource.org/licenses/MIT) or the
[Apache 2.0 license](https://opensource.org/licenses/Apache-2.0).