rusty-cli

resty-cli, reimplemented

Why does this exist?

resty-cli is heavily relied upon in most OpenResty deployments, but its runtime dependency on Perl often makes it less than ideal for package maintainers and operators.

This project is a drop-in replacement for resty-cli with no runtime dependencies (aside from OpenResty itself, of course), shippable as a single binary. This translates to slimmer container images and fewer security worries when packaging OpenResty or other software that bundles it.

Status

All features of resty-cli have been implemented.

rusty-cli passes all of resty-cli's tests in CI, and I've added some additional tests of my own to validate behavioral parity.

I have been using rusty-cli in place of resty-cli for almost a year now and have yet to encounter any problems with it in my day-to-day.

Compatibility Limitations

While rusty-cli strives to be functionally compatible with resty-cli where it counts, there are some things that it does not care to replicate exactly:

• Temporary files
  • Example: nginx.conf and .lua file(s) generated from inline expressions
  • Disclaimer: formatting, whitespace, and [non-significant] ordering differences may occur.
• CLI metadata
  • Example: --help text, invalid cli arg error messages
  • Disclaimer: Anything that is intended for human eyes and not typically machine-parseable will not be byte-for-byte identical to resty-cli.

In many cases I have replicated string outputs exactly as resty-cli, but only because this makes compatibility testing easier for me (I need to maintain patches for any of resty-cli's tests that produce different string output from rusty-cli). Do not rely on this if you are using rusty-cli.

If you are using resty-cli in a way that is sensitive to the exact contents of CLI metadata, error messages, and nginx.conf, I recommend against using rusty-cli.

Non-Goals

• Windows Support: not planned at this time

TODO

• tests
  • test against resty-cli's test suite
  • additional in-repo resty-cli compatibility tests
    • custom runner arg parsing and execution
    • lua arg global generation
    • nginx.conf generation
• automated binary releases
  • x86_64-unknown-linux-gnu
  • x86_64-unknown-linux-musl
  • aarch64-unknown-linux-gnu*
  • aarch64-unknown-linux-musl*
  • x86_64-apple-darwin*
  • aarch64-apple-darwin*

* These are built with new releases but not yet fully tested

Acknowledgements

Thanks to the OpenResty folks for creating an awesome piece of software that is fun to build with ❤️.