scripts: move examples and tests in subdirs

client/luascripts/examples/example_cmdline.lua

@@ -0,0 +1,19 @@
+#!/usr/bin/env -S pm3 -l
+
+--[[
+A sampe script file on how to implement at cmd line inteface.
+It also demonstrates how the script can be used with a shebang.
+--]]
+
+print("This is how a cmd-line interface could be implemented\nPrint 'exit' to exit.\n")
+local answer
+repeat
+    io.write("$>")
+    io.flush()
+    answer = io.read()
+    if answer ~= 'exit' then
+        local func = assert(loadstring("return " .. answer))
+        io.write("\n"..tostring(func() or "").."\n");
+    end--]]
+until answer == "exit"
+print("Bye\n");

client/luascripts/examples/example_parameters.lua

@@ -0,0 +1,76 @@
+-- The getopt-functionality is loaded from pm3/getopt.lua
+-- Have a look there for further details
+local getopt = require('getopt')
+local ansicolors = require('ansicolors')
+
+copyright = ''
+usage = 'script run example_parameters.lua -a 1 -blala -c -de'
+author = 'Martin Holst Swende'
+version = 'v1.0.2'
+desc = [[
+This is an example script to demonstrate handle parameters in scripts.
+For more info, check the comments in the code
+]]
+example = [[
+    1. script run example_parameters -a mytestparam_input -c
+]]
+usage = [[
+script run example_parameters [-h] [-a <txt>] [-b <txt>] [-c] [-d] [-e]
+]]
+arguments = [[
+    -h              This help
+    -a <txt>        text
+    -b <txt>        text
+    -c              test param w/o input
+    -d              test param w/o input
+    -e              test param w/o input
+]]
+
+---
+-- Usage help
+local function help()
+    print(copyright)
+    print(author)
+    print(version)
+    print(desc)
+    print(ansicolors.cyan..'Usage'..ansicolors.reset)
+    print(usage)
+    print(ansicolors.cyan..'Arguments'..ansicolors.reset)
+    print(arguments)
+    print(ansicolors.cyan..'Example usage'..ansicolors.reset)
+    print(example)
+end
+
+local function main(args)
+
+    print('These parameters were passed')
+    --[[
+    When passing parameters,
+    x:      means that a value should follow x
+    y       means that 'y' is a flag, either on or off
+    So, the string a:b:def means that we support up to
+    5 parameters; two with values and three flags. The following
+    should be valid:
+
+    script run example_parameters.lua -a 1 -blala -c -de
+
+    Notice two things:
+    1. 'blala' works just like 'b lala', both set 'b' to 'lala'
+    2. Flags can be put together, '-de' is the same as '-d -e'
+    3. The format -b=lala is *not* supported
+    4. The format b lala (without -) is *not* supported
+    --]]
+
+    for o, a in getopt.getopt(args, 'ha:b:ced') do
+        if o == 'h' then return help() end
+        print(o, a)
+    end
+end
+
+
+--[[
+In the future, we may implement so that scripts are invoked directly
+into a 'main' function, instead of being executed blindly. For future
+compatibility, I have done so, but I invoke my main from here.
+--]]
+main(args)