https://github.com/capsadmin/one-click-lua-launch
a way to launch lua in one click on Linux, macOS and Windows via os scripts
https://github.com/capsadmin/one-click-lua-launch
Last synced: over 1 year ago
JSON representation
a way to launch lua in one click on Linux, macOS and Windows via os scripts
- Host: GitHub
- URL: https://github.com/capsadmin/one-click-lua-launch
- Owner: CapsAdmin
- Created: 2018-10-01T15:17:28.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-10-03T11:40:09.000Z (over 7 years ago)
- Last Synced: 2025-01-22T15:11:37.006Z (over 1 year ago)
- Language: Batchfile
- Size: 22.5 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### About
This is a way of running Lua with a mouse click on Linux, macOS and Windows.
It supports a way to detect if ran from a file browser or command line, arguments,
shortcuts on Windows (with arguments) and a nice way of showing errors.
It works by simply downloading the Lua executable with Shell or Batch from the internet.
By default, the scripts download files to `./data/*` but you can also set it to
write to `$HOME/.appexample` on Unix or`%appdata%\appexample` on Windows
if you want.
### DownloadFile helper function
```bash
# bash
# Uses wget or curl
DownloadFile "https://foobar.com/baz" "baz"
```
```batch
:: batch
:: Uses curl or powershell
call:DownloadFile "https://foobar.com/baz.exe" "baz.exe"
```
The DownloadFile function on Windows will use curl, powershell or Windows Script Host
depending on what's available. It should work on windows 2000 and up, but beware of the
lack of https support on old versions of windows.
When downloading an executable it's good practice to run validation afterwards
to make sure it works. For example, if `lua_downloaded_and_validated`
doesn't exist download luajit.exe, check if the exit code is correct by running
`os.exit` and if successful write `lua_downloaded_and_validated` to the same
directory indicating that it's been downloaded and validated. This is what
the example scripts do.
### How is it possible to allow Lua in Shell and Batch?
Both of the scripts use some syntax to allow writing Lua code at beginning of each script.
Batch uses the following:
```lua
::_::BATCH_PROGRAM=[[
...
goto:eof
rem ]]
```
Which requires goto labels in Lua to be valid. This can be replaced with the following
if Lua 5.1 is desired.
```lua
rem = nil BATCH_PROGRAM=[[
...
goto:eof
rem ]]
```
The Shell version uses the following:
```lua
#!/bin/sh
SHELL_PROGRAM=[=[
...
exit 0
]=]
```
Which looks a bit more natural.
These hacks are not strictly nesseceary as you change the script
to download an external Lua script and just execute that instead.
### Why not powershell or WSH on Windows?
I use Batch because it has a significant faster startup time than Powershell.
Windows script host (.js or .vb) is fast but has some limitations when it comes
to being executed from command line vs explorer.