Windows | OS X / Linux | Nuget |
---|---|---|
Console application which brings appveyor.yml to the center of your build process by making possible to execute its build jobs, locally.
LocalAppVeyor tries to strictly follow same build pipeline as AppVeyor CI itself.
- Grabs appveyor.yml's build configuration from current (or specified) local repository folder.
- Reads supported build steps from it.
- Executes build pipeline for each job (or specified ones) on the build matrix.
Build engine tries to be the less intrusive as possible printing only what it comes from the build output.
Usage: LocalAppVeyor [options] [command]
Options:
-?|-h|--help Show help information
-v|--version Show version information
Commands:
build Executes one or all build jobs on specified repository directory
jobs List all build jobs available to execution.
Use "LocalAppVeyor [command] --help" for more information about a command.
This is the main console command which allows one to execute all or a smaller set of jobs from the
build matrix. --job
command should be followed by a integer
corresponding to job index as listed on jobs
command
Usage: LocalAppVeyor build [options]
Options:
-?|-h|--help Show help information
-d|--dir Local repository directory where appveyor.yml sits. If not specified current directory is used
-j|--job Job to build. You can specify multiple jobs. Use 'jobs' command to list all jobs
Usage: LocalAppVeyor jobs [options]
Options:
-?|-h|--help Show help information
-d|--dir Local repository directory where appveyor.yml sits. If not specified current directory is used
Due to LocalAppVeyor's nature only a subset of AppVeyor build steps are supported. Some of them might get some support later in time, after consideration, but others most likely won't ever be part of the build pipeline.
✅ Fully supported 🔵 Partially supported 🔴 Not yet supported
Step \ Option | Support | Notes |
---|---|---|
version | ✅ | {build} placeholder is replaced by 0 |
environment | ✅ | As for the standard AppVeyor variables these are the ones supported: APPVEYOR , CI , APPVEYOR_BUILD_FOLDER , APPVEYOR_BUILD_NUMBER , APPVEYOR_BUILD_VERSION , PLATFORM and CONFIGURATION |
configuration | ✅ | |
platform | ✅ | |
os | ✅ | Relatively undocumented option but it exists apparently. It's usually a single value so it serves nothing other than to build the matrix job name. |
init | ✅ | |
clone_folder | ✅ | Tries first to clone to specified clone_folder , if any; otherwise it will use C:\Projects\LocalAppVeyorTempClone . From this step on all scripts will be executed as the clone folder being the working directory. |
matrix | ✅ | |
install | ✅ | |
assembly_info | ✅ | |
before_build | ✅ | |
build | ✅ | |
build_script | ✅ | |
after_build | ✅ | |
before_test | 🔴 | |
test | 🔴 | |
test_script | 🔵 | It will always execute if it exists, no matter if other tests options are specified. |
after_test | 🔴 | |
on_success | ✅ | |
on_failure | ✅ | |
on_finish | ✅ |