Skip to content

Commands

Kirill Semyonkin edited this page Oct 12, 2023 · 1 revision

Use following commands to interact with Build++ (flags may start with --, - or /):

buildpp --version       # show version
buildpp --help          # show help

buildpp build           # build the project into `target` directory
    --is library        # optional: will detect from either `main.cpp` or `lib.cpp`.
                        # also profiles may override this detection, like CUDA's `main.cu`.
    --profile default   # optional, profile name (default is `default`)

buildpp run             # build and run the program
    --profile default   # optional, profile name (default is `default`)
    -- args...          # optional, additional arguments to pass to the running program

buildpp new             # create project with `build++.lsd` and `src` hello world program
    --is binary         # required, supported: `binary` (main.cpp) or `library` (lib.cpp)
    --name project-name # required, name of the folder / metadata to be made

⚠️ --help is currently not properly supported due to incomplete command architecture (registries of currently available commands, dependency and profile types have to be added).


Future command features:

  • Git / .gitignore in project creation.
  • Initialization of existing projects (by adding build++.lsd).
  • Clearing cache and, optionally, target.
  • Managing configuration from command line (adding dependencies, profiles).
  • Installing programs.
  • Support --help properly.
  • Allow = (and maybe : ) syntax for flags.
Clone this wiki locally