Rewatch cli refactor

[Bushuo]

Upstream the changes of rescript-lang/rewatch#162 and adjusted the PR description.

This PR refactors the CLI structure of rewatch to enhance clarity and improve the usability of subcommands and their associated arguments.

Key Changes:

Introduction of New Subcommands:

• legacy: Acts as a passthrough to the legacy CLI rescript. In the future, this will be named rescript-legacy.
• dump: Serves as an alias for legacy dump.
• format: Serves as an alias for legacy format.

Breaking Change:

• The --compiler-args argument has been replaced with a new subcommand compiler-args. I assume this change will have minimal impact. I guess this is mainly used as a debug command.
• Arguments must be used after the sub-command. A call like this is invalid now rewatch --bsc-path=something build. This change was made because the number of arguments on the top level was getting out of hand and hard to track.

Benefits:
The refactored structure ensures a more intuitive CLI experience by clearly delineating which arguments apply to specific subcommands.
The introduction of aliases (dump and format) simplifies common operations and aims to make the transition to rewatch as the default build system easier.
The new compiler-args subcommand makes the CLI behavior more consistent and predictable.

[pkg-pr-new]

Open in StackBlitz

rescript

npm i https://pkg.pr.new/rescript-lang/rescript@7551

@rescript/darwin-arm64

npm i https://pkg.pr.new/rescript-lang/rescript/@rescript/darwin-arm64@7551

@rescript/darwin-x64

npm i https://pkg.pr.new/rescript-lang/rescript/@rescript/darwin-x64@7551

@rescript/linux-arm64

npm i https://pkg.pr.new/rescript-lang/rescript/@rescript/linux-arm64@7551

@rescript/linux-x64

npm i https://pkg.pr.new/rescript-lang/rescript/@rescript/linux-x64@7551

@rescript/win32-x64

npm i https://pkg.pr.new/rescript-lang/rescript/@rescript/win32-x64@7551

commit: 693a391

[Bushuo]

@nojaf to answer you on your comment here rescript-lang/rewatch#162 (comment).
I think this is a great idea. I also think the plan was to eventually replace the legacy commands with commands implemented in rewatch.

[nojaf]

Not sure if relevant here, but I still see 1.2.0 for bunx rewatch --version.
At some point, this should be the rescript version?

rewatch legacy --help doesn't show any help:

(base) nojaf@nojaf-mbp tower-defense % bunx rewatch legacy --help

thread 'main' panicked at src/helpers.rs:252:14:
Could not find rescript-legacy
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

I got this with bunx rewatch dump as well.

[Bushuo]

Not sure if relevant here, but I still see 1.2.0 for bunx rewatch --version. At some point, this should be the rescript version?

I think the right time for this would be when rewatch is the default cli.

rewatch legacy --help doesn't show any help:

(base) nojaf@nojaf-mbp tower-defense % bunx rewatch legacy --help

thread 'main' panicked at src/helpers.rs:252:14:
Could not find rescript-legacy
note: run with `RUST_BACKTRACE=1` environment variable to display a backtrace

I got this with bunx rewatch dump as well.

I prematurely already look for a binary named rescript-legacy. I guess in this PR we can still look for rescript. I will also add tests for the legacy subcommands.