| 1 |
lua_altgetopt is a MIT-licenced module for Lua programming language |
| 2 |
for processing application's arguments the same way |
| 3 |
BSD/GNU getopt_long(3) functions do. |
| 4 |
|
| 5 |
Main features and goals: |
| 6 |
1) compatibility to SUS "Utility Syntax Guidelines" |
| 7 |
http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap12.html#tag_12_02 |
| 8 |
guidelines 3-13. |
| 9 |
2) This module is for plain Lua |
| 10 |
2) No extra dependencies |
| 11 |
3) No hooks, no functional tricks ;-) |
| 12 |
4) Support for long options, e.g. compatibility with getopt_long(3) C function |
| 13 |
present in *BSD and GNU libc. |
| 14 |
5) Long options may optionally have one-char synonym or other long synonym |
| 15 |
6) Strict error checking (checks for an incorrect use of options) |
| 16 |
7) alt_getopt.lua is a Lua module. |
| 17 |
|
| 18 |
In particular alt_getopt.lua supports the following |
| 19 |
-kVALUE, -k VALUE, --key=VALUE, --key VALUE, |
| 20 |
-abcd is equivalent to -a -b -c -d if neither of them accept value. |
| 21 |
All options must be declared as accepting value or not. |
| 22 |
|
| 23 |
Two ways of options handling are provided. |
| 24 |
See alt_getopt application which is a part of regression tests. |
| 25 |
|
| 26 |
Makefile: |
| 27 |
It's probably useless for end users, you can copy alt_getopt.lua |
| 28 |
to the destination yourself. Otherwise use BSD make, |
| 29 |
NetBSD make is preferred because NetBSD is my development platform. |
| 30 |
|
| 31 |
If 'make test' fails on your platform/Lua, please let me know. |
| 32 |
If you find a a bug, register it here |
| 33 |
http://luaforge.net/project/lua_altgetopt |
| 34 |
or send me bugreport directly. |
| 35 |
|
| 36 |
Author: Aleksey Cheusov <[email protected]> |