| # 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` |
