Lua 5.1 script that makes LÖVE game release easier (previously Bash script).
Automates LÖVE Game Distribution.
LÖVE forum_topic.
Available as a LuaRocks package.
Features
love-release makes your LÖVE game release easier. It can create from your sources Windows executables, MacOS X applications, Debian packages and simple LÖVE files.
love-release creates only one LÖVE file per release directory and keeps it synced with your sources.
love-release can extract its information from the environment: it guesses your game's title from the directory where it's stored, selects by default the latest LÖVE version from the web or uses its latest bundled LÖVE version, then parses the conf.lua file to extract even more information such as the real LÖVE version your project uses.
Usage
Code: Select all
Usage: love-release [-D] [-M] [-a <author>] [-b] [-d <desc>]
[-e <email>] [-l <love>] [-p <package>] [-t <title>] [-u <url>]
[--uti <uti>] [-v <v>] [--version] [-h] [<release>] [<source>]
[-W [32|64]]
Makes LÖVE games releases easier!
Arguments:
release Project release directory.
source Project source directory.
Options:
-D Debian package.
-M MacOS X application.
-W [32|64] Windows executable.
-a <author>, --author <author>
Author full name.
-b Compile new or updated files to LuaJIT bytecode.
-d <desc>, --desc <desc>
Project description.
-e <email>, --email <email>
Author email.
-l <love>, --love <love>
LÖVE version to use.
-p <package>, --package <package>
Package and command name.
-t <title>, --title <title>
Project title.
-u <url>, --url <url> Project homepage url.
--uti <uti> Project Uniform Type Identifier.
-v <v> Project version.
--version Show love-release version and exit.
-h, --help Show this help message and exit.
For more info, see https://github.com/MisterDA/love-releaselove-release prints to the command-line a Lua table containing the information it uses to generate your project. These information can be stored in your conf.lua file to be used later.
Code: Select all
function love.conf(t)
t.releases = {
title = nil, -- The project title (string)
package = nil, -- The project command and package name (string)
loveVersion = nil, -- The project LÖVE version
version = nil, -- The project version
author = nil, -- Your name (string)
email = nil, -- Your email (string)
description = nil, -- The project description (string)
homepage = nil, -- The project homepage (string)
identifier = nil, -- The project Uniform Type Identifier (string)
releaseDirectory = nil, -- Where to store the project releases (string)
}
endDependencies
love-release is only installable through LuaRocks and highly depends on LuaRocks internal API. love-release is currently build on LuaRocks 2.3.0. LuaRocks API is not meant to be stable, and a future update could break love-release. As love-release is made for LÖVE, it is written for Lua 5.1.
Required
- libzip headers for lua-zip.
- lua-zip has no official stable version, thus while available on LuaRocks it must be installed manually.
- Other libraries are automatically installed, but let's give them some credit: luafilesystem, loadconf, middleclass, semver.
Optional
- love can be used to determine your system LÖVE version.
- fakeroot and dpkg-deb are required to create Debian packages.
- LuaJIT can be used to compile your sources, either with luarocks-luajit or if luajit is installed.
Install
Code: Select all
# sudo
luarocks install --server=http://luarocks.org/dev lua-zip
# latest stable version
luarocks install love-release
# development version
luarocks install --server=http://luarocks.org/dev love-releaseYou may have previously installed the Bash version of love-release. You can remove it with the following piece of code. Take the time to assure yourself that the paths are correct and match your installation of love-release.
Code: Select all
rm -rf '/usr/bin/love-release'
rm -rf '/usr/share/love-release'
rm -rf '/usr/share/man/man1/love-release.1.gz'
rm -rf '/usr/share/bash-completion/completions/love-release' '/etc/bash_completion.d/love-release'The documentation of love-release internals is written with LDoc. Generate it by running ldoc ..
I do not plan to keep developing the Bash script, not even fixing it. If there appears to be any need for it, let me know and I might consider doing so.
Every bug report or feature request is gladly welcome!
Thanks to the LÖVE developers!
Thanks to Josefnpat, Positive07, socketubs, nundonato, kikito, Alloyed and the others for their support on love-release development on Github!
Also, thanks for the little reviews made here ericjmritz.name, and here ambiance.sk and for all the people who have commented, requested features or found bugs, and who have starred the project on Github!
