search

ignacio / lua-appveyor-example

For experiments with AppVeyor CI
MIT License
13 stars 8 forks source link

readme

Build status License Coverage Status

lua-appveyor-example

This repository is intended as an example of how to integrate your Lua project with AppVeyor, providing you with continuous integration on a Windows environment.

Just add appveyor.yml and the .appveyor folder to your repository, follow the steps to enable integration with AppVeyor and that's it.

Each time you push some changes to your repository, or someone sends you a pull request, the code will be checked out, built and tested with different versions of Lua (and LuaJIT), for both 32 and 64 bits, using different compilers.

All those combinations form what is known as a "build matrix". The matrix is comprised of "build jobs". Each build job will download and build a given Lua and LuaRocks version, using a given compiler, for the given platform. So, one build job could be "Lua 5.3.1 64 bits using Visual Studio 2015", another one could be "Lua 5.2.4 32 bits using MinGW", etc.

Note: It is best to edit the appveyor.yml file to suite your needs. You probably won't need to run tests using all those different compilers, or you're just interested in a certain Lua version. See the Customizing the environment section below.

So, each job will do the following:

This project is based on Alexey Melnichuk's lua-travis-example.

Customizing the environment

By default, you can set a test matrix with different Lua and LuaJIT versions. Using the LUA_VER variable yo specify the full Lua version to use (i.e. 5.2.4). Using the LJ_VER variable, you specify the LuaJIT version to use (i.e. 2.0.4). LuaJIT 2.1 is special in that it is currently tracking the HEAD of its git repository.

The C compiler to be used is chosen ìn the configuration section of the appveyor.yml file, and the platform (32 or 64 bits) is chosen in the platform section.

The following variables can also be overridden if necessary: