Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bootique/bootique-tool


https://github.com/bootique/bootique-tool

bootique cli

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

[![verify](https://github.com/bootique/bootique-tool/actions/workflows/verify.yml/badge.svg)](https://github.com/bootique/bootique-tool/actions/workflows/verify.yml)

# `bq` : Bootique CLI tool

`bq` is an interactive tool to create and manage Bootique projects.

## Documentation

https://bootique.io/docs/2.x/bootique-tool-docs/

## How to Build

### MacOS / Linux

Follow documentation link above for instructions on how to get a platform-specific `bq` binary. To build `bq` from
source, do the following:

* [Download](https://github.com/graalvm/graalvm-ce-builds/releases) and unpack GraalVM 8. (As of this writing builds
don't yet work with GraalVM 11)
* If you are on MacOS, make sure GraalVM is allowed to run:
```
xattr -d com.apple.quarantine /path/to/graalvm-ce-java8-X.X.X/
```

* Checkout and build the repo:
```
git clone [email protected]:bootique/bootique-tool.git
cd bootique-tool
export JAVA_HOME=
mvn package -Pnative-image
```
The binary is created at `bootique-tool/target/bq`

### Windows build

Windows build is a little trickier than other platforms.
Mainly this is because `native-image` support is not perfect on Windows so there is a hope that this will improve over time.

There are different actions required for different versions of GraalVM.

#### Java 8
For Java 8 you need to install Windows SDK 7.1, the easiest way to do this is via `Chocolotey`:

```bash
choco install windows-sdk-7.1 kb2519277
```
From the cmd prompt, activate the sdk-7.1 environment:

```bash
call "C:\Program Files\Microsoft SDKs\Windows\v7.1\Bin\SetEnv.cmd"
```

Now you can start build as usual (note, that you should use same cmd prompt as for command above).

```bash
mvn package -Pnative-image -DskipTests
```

#### Java 11

For Java 11 versions of GraalVM you should use newer dev tools:

```bash
choco install visualstudio2017-workload-vctools
```

And then call:
```bash
call "C:\Program Files (x86)\Microsoft Visual Studio\2017\BuildTools\VC\Auxiliary\Build\vcvars64.bat"
```

Build is the same:
```bash
mvn package -Pnative-image -DskipTests
```

Other problems with GraalVM on Windows:

* there could be a problem installing GraalVM not on a "C:" drive;
* staring from version 20.0.0 you should use `gu install native-image` to install `native-image` binary as it no longer bundled by default;
* for GraalVM 20.0.0 and earlier for Java 11 you may need to compile `native-image` into a binary executable (this should be done
from the command prompt with initialized dev tools environment, as with `bq` tool build):
```bash
cd %GRAALVM_HOME%\bin
native-image.cmd -jar ..\lib\graalvm\svm-driver.jar
```