docs: improve the examples in the readme [skip ci]

This commit is contained in:
Amin Yahyaabadi 2021-09-17 21:42:56 -05:00
parent 882d0f7013
commit 405234b70c
1 changed files with 33 additions and 6 deletions

View File

@ -32,7 +32,7 @@ The package can be used locally or from CI services like GitHub Actions. Stay tu
# Usage # Usage
## From Command Prompt ## From Terminal
You should download the exe file or the js file (if have Nodejs installed), and run it with the available options. You should download the exe file or the js file (if have Nodejs installed), and run it with the available options.
@ -40,22 +40,49 @@ Tip: You can automate downloading using `wget`, `curl` or other similar tools.
### Executable ### Executable
Download the executable for your platform from [here](https://github.com/aminya/setup-cpp/releases/tag/v0.1), and run it with the available options. Download the executable for your platform from [here](https://github.com/aminya/setup-cpp/releases/tag/v0.1.1), and run it with the available options.
A Windows example that installs llvm, cmake, ninja, ccache, and conan. An example that installs llvm, cmake, ninja, ccache, and conan.
```ps1
# windows example (open shell as admin)
curl -O "https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_cpp_windows.exe"
./setup_cpp_windows --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
``` ```
./setup_cpp_windows.exe --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
```ps1
# linux example
wget "https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_cpp_linux"
chmod +x setup_cpp_linux
sudo ./setup_cpp_linux --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
```
```ps1
# mac example
wget "https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_mac_linux"
chmod +x setup_cpp_mac
sudo ./setup_cpp_mac --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
``` ```
### With Nodejs ### With Nodejs
Download the `setup_cpp.js` file form [here](https://github.com/aminya/setup-cpp/releases/download/v0.1/setup_cpp.js), and run it with the available options. Download the `setup_cpp.js` file form [here](https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_cpp.js), and run it with the available options.
``` On Windows
```ps1
# open shell as admin
wget "https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_cpp_windows.exe"
node ./setup_cpp.js --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1" node ./setup_cpp.js --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
``` ```
On Linux or Mac:
```ps1
wget "https://github.com/aminya/setup-cpp/releases/download/v0.1.1/setup_cpp.js"
sudo node ./setup_cpp.js --compiler llvm --cmake true --ninja true --ccache true --conan "1.40.1"
```
## Inside GitHub Actions ## Inside GitHub Actions
Here is a complete cross-platform example that tests llvm and gcc. It also uses cmake, ninja, conan, cppcheck, and ccache. Here is a complete cross-platform example that tests llvm and gcc. It also uses cmake, ninja, conan, cppcheck, and ccache.