| # aspect-cli |
| |
| This is the frontend for the Aspect build tool. |
| It is currently just a wrapper around bazelisk or bazel, meant to install in tools/bazel. |
| |
| In the future, we might totally replace the bazel C++ client, and this tool would be a gRPC client of the bazel server. |
| |
| ## TODOs |
| |
| - [ ] figure out how to cut and host a release |
| GH Action to cut/publish release whenever a tag is pushed upstream |
| - [ ] document lots of ways to install, including a bash one-liner |
| - [ ] help user ensure bash/zsh completion working |
| - [ ] warn user if Bazel version is floating |
| (no bazelisk, or using latest in .bazelversion, or no .bazelversion) |
| |
| # Use Cases |
| |
| ## When I am confused by bazel |
| |
| I can find that Aspect is an easier-to-use wrapper and feel motivated and comfortable to try it immediately. |
| |
| From aspect.build/install I quickly pick an Installation option, and am guided through to successful install. |
| |
| The first time I run `aspect` in interactive mode, |
| - I choose whether I want to install for all users of my workspace, in which case a bootstrap bit is added to tools/bazel ensuring that the tool is downloaded and spawned for anyone cloning my repo. |
| |
| ## When I run bare `bazel` |
| |
| ## When I run bare `bazel build` |
| |
| ## When I run bare `bazel test` |
