Blame view

lapp.nim 10.8 KB
85eedc50   Göran Krampe   Added lapp.nim to...
1
  import strutils
5e811526   Göran Krampe   Added updated lap...
2
  import os
85eedc50   Göran Krampe   Added lapp.nim to...
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
  import tables
  export tables.`[]`
  
  #### Simple string lexer ###
  type
    PLexer = ref TLexer
    TLexer = object
      str: string
      idx: int
    TLexType = enum
      tend
      tword
      tint
      tfloat
      trange
      telipsis
      tchar
  
  proc thisChar(L: PLexer):char = L.str[L.idx]
  proc next(L: PLexer) = L.idx += 1
  
  proc skipws(L: PLexer) =
    while thisChar(L) in Whitespace: next(L)
      
  proc get(L: PLexer; t: var TLexType): string =
    skipws(L)
    let c = thisChar(L)
    t = tend
    if c == '\0': return nil
    result = ""
    result.add(c)
    next(L) 
    t = tchar
    case c
    of '-':  # '-", "--"
      if thisChar(L) == '-':
        result.add('-')
        next(L)
    of Letters: # word
      t = tword
      while thisChar(L) in Letters:
        result.add(thisChar(L))
        next(L)
    of Digits: # number
      t = tint
      while thisChar(L) in Digits:
        result.add(thisChar(L))
        next(L)
      if thisChar(L) == '.':
        t = tfloat
5e811526   Göran Krampe   Added updated lap...
53
        result.add(thisChar(L))
85eedc50   Göran Krampe   Added lapp.nim to...
54
55
        next(L)
        while thisChar(L) in Digits:
5e811526   Göran Krampe   Added updated lap...
56
          result.add(thisChar(L))
85eedc50   Göran Krampe   Added lapp.nim to...
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
          next(L)
    of '.': # ".", "..", "..."
      if thisChar(L) == '.':
        t = trange
        result.add('.')
        next(L)
        if thisChar(L) == '.':
          t = telipsis
          result.add('.')
          next(L)
    else: discard
      
  proc get(L: PLexer): string = 
    var t: TLexType
    get(L,t)
      
  proc reset(L: PLexer, s: string) =
    L.str  = s
    L.idx = 0
  
  proc newLexer(s: string): PLexer =
    new(result)
    result.reset(s)
      
  ### a container for values ###
      
  type
    TValueKind = enum
      vInt,
      vFloat,
      vString,
      vBool,
      vFile,
      vSeq
  
5e811526   Göran Krampe   Added updated lap...
92
93
94
95
96
97
98
    PValue* = ref TValue
    TValue* = object
      case kind*: TValueKind
        of vInt: asInt*: int
        of vFloat: asFloat*: float
        of vString: asString*: string
        of vBool: asBool*: bool
85eedc50   Göran Krampe   Added lapp.nim to...
99
        of vFile:
5e811526   Göran Krampe   Added updated lap...
100
101
102
          asFile*: File
          fileName*: string
        of vSeq: asSeq*: seq[PValue]
85eedc50   Göran Krampe   Added lapp.nim to...
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
  
  proc boolValue(c: bool): PValue =  PValue(kind: vBool, asBool: c)
      
  proc fileValue(f: File, name: string): PValue =  PValue(kind: vFile, asFile: f, fileName: name)
      
  proc strValue(s: string): PValue =  PValue(kind: vString, asString: s) 
      
  proc intValue(v: int): PValue =   PValue(kind: vInt, asInt: v)
      
  proc floatValue(v: float): PValue = PValue(kind: vFloat, asFloat: v)
      
  proc seqValue(v: seq[PValue]): PValue = PValue(kind: vSeq, asSeq: v)
  
  const MAX_FILES = 30
      
  type
    PSpec = ref TSpec
    TSpec = object
      defVal: string
      ptype: string
      needsValue, multiple, used: bool
  var
    progname, usage: string
    aliases: array[char,string]
    parm_spec =  initTable[string,PSpec]()
5e811526   Göran Krampe   Added updated lap...
128
  
85eedc50   Göran Krampe   Added lapp.nim to...
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
  proc fail(msg: string)  =
    stderr.writeln(progname & ": " & msg)
    quit(usage)
  
  proc parseSpec(u: string) =    
    var
      L: PLexer
      tok: string
      k = 1
        
    let lines = u.splitLines
    L = newLexer(lines[0])
    progname = L.get
    usage = u
    for line in lines[1..(-1)]:
      var
        isarg = false
        multiple = false
        getnext = true
        name: string
        alias: char
      L.reset(line)
      tok = L.get
      if tok == "-" or tok == "--":  # flag
        if tok == "-": #short flag
          let flag = L.get
          if len(flag) != 1: fail("short option has one character!")
          tok = L.get
          if tok == ",": # which is alias for long flag
            tok = L.get
            if tok != "--": fail("expecting long --flag")
            name = L.get
            alias = flag[0]
          else: # only short flag
            name = flag
            alias = flag[0]
            getnext = false
        else: # only long flag
          name = L.get
          alias = '\0'
      elif tok == "<":  # argument
        isarg = true
        name = L.get
        alias = chr(k)
        k += 1
        tok = L.get
        if tok != ">": fail("argument must be enclosed in <...>")
          
      if getnext:  tok = L.get
      if tok == ":": # allowed to have colon after flags
        tok = L.get
      if tok == nil: continue
      # default types for flags and arguments
      var 
        ftype = if isarg: "string" else: "bool"
        defValue = ""
      if tok == "(": # typed flag/argument
        var t = tchar
        tok = L.get(t)
        if tok == "default":  # type from default value
          defValue = L.get(t)
          if t == tint: ftype = "int"
          elif t == tfloat: ftype = "float"
          elif t == tword:
            if defValue == "stdin": ftype = "infile"
            elif defValue == "stdout": ftype = "outfile"
            else: ftype = "string"
          else: fail("unknown default value " & tok)
        else: # explicit type
          if t == tword:
            ftype = tok
            if tok == "bool": defValue = "false"
          else: fail("unknown type " & tok)
        discard L.get(t)
        multiple = t == telipsis
      elif ftype == "bool": # no type or default
        defValue = "false"
              
      if name != nil:
5e811526   Göran Krampe   Added updated lap...
208
        # echo("Param: " & name & " type: " & $ftype & " needsvalue: " & $(ftype != "bool") & " default: " & $defValue & " multiple: " & $multiple)
85eedc50   Göran Krampe   Added lapp.nim to...
209
210
211
212
213
214
215
        let spec = PSpec(defVal:defValue, ptype: ftype, needsValue: ftype != "bool",multiple:multiple)
        aliases[alias] = name        
        parm_spec[name] = spec
  
  proc tail(s: string): string = s[1..(-1)]
  
  var 
5e811526   Göran Krampe   Added updated lap...
216
    files = newSeq[File]()
85eedc50   Göran Krampe   Added lapp.nim to...
217
218
  
  proc closeFiles() {.noconv.} =
5e811526   Göran Krampe   Added updated lap...
219
220
    for f in files:
      f.close()
85eedc50   Göran Krampe   Added lapp.nim to...
221
  
5e811526   Göran Krampe   Added updated lap...
222
  proc parseArguments*(usage: string, args: seq[string]): Table[string,PValue] =
85eedc50   Göran Krampe   Added lapp.nim to...
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
    var
      vars = initTable[string,PValue]()
      n = len(args) - 1
      i = 1
      k = 1
      flag,value, arg: string        
      info: PSpec
      short: bool
      flagvalues: seq[seq[string]]
        
    proc next(): string =
      if i > n: fail("an option required a value!")
      result = args[i]
      i += 1
        
    proc get_alias(c: char): string =
      result = aliases[c]
      if result == nil:
        n = ord(c)
        if n < 20:
          fail("no such argument: " & $n)
        else:
          fail("no such option: " & c)
        
    proc get_spec(name: string): PSpec =
      result = parm_spec[name]
      if result == nil:
        fail("no such option: " & name)
  
    newSeq(flagvalues, 0)
    parseSpec(usage)
    addQuitProc(closeFiles)
  
5e811526   Göran Krampe   Added updated lap...
256
257
258
    # Collect failures
    var failures = newSeq[string]()
    
85eedc50   Göran Krampe   Added lapp.nim to...
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
    # parse the flags and arguments
    while i <= n:
      arg = next()
      if arg[0] == '-':  #flag
        short = arg[1] != '-'
        arg = arg.tail
        if short: # all short args are aliases, even if only to themselves
          flag = get_alias(arg[0])
        else:
          flag = arg[1..high(arg)]
        info = get_spec(flag)
        if info.needsValue:
          if short and len(arg) > 1: # value can follow short flag
            value = arg.tail
          else:  # grab next argument
            value = next()
        else:
          value = "true"
          if short and len(arg) > 0: # short flags can be combined
            for c in arg.tail:
              let f = get_alias(c)
              let i = get_spec(f)
5e811526   Göran Krampe   Added updated lap...
281
282
              if i.needsValue:
                failures.add("option " & f & " needs a value")
85eedc50   Göran Krampe   Added lapp.nim to...
283
284
285
286
287
288
289
290
291
292
              flagvalues.add(@[f,"true"])
              i.used = true
      else: # argument (stored as \001, \002, etc
        flag = get_alias(chr(k))
        value = arg
        info = get_spec(flag)
        # don't move on if this is a varags last param
        if not info.multiple:  k += 1
      flagvalues.add(@[flag,value])
      info.used = true
5e811526   Göran Krampe   Added updated lap...
293
294
295
296
297
298
299
300
301
    
    # Some options disables checking
    var enableChecks = true
    for flag,info in parm_spec:
      if info.used:
        if flag == "help" or flag == "version":
          enableChecks = false
    
  
85eedc50   Göran Krampe   Added lapp.nim to...
302
303
304
305
    # any flags not mentioned?
    for flag,info in parm_spec:
      if not info.used:
        if info.defVal == "": # no default!
5e811526   Göran Krampe   Added updated lap...
306
307
308
309
310
311
312
313
314
          failures.add("required option or argument missing: " & flag)
        else:
          flagvalues.add(@[flag,info.defVal])
  
    if enableChecks:
      # any failures up until now - then we fail
      if failures.len > 0:
        fail(failures.join("\n") & "\n")
  
85eedc50   Göran Krampe   Added lapp.nim to...
315
316
317
318
319
320
321
322
323
324
325
326
327
    # cool, we have the info, can convert known flags
    for item in flagvalues:
      var pval: PValue;
      let
        flag = item[0]
        value = item[1]
        info = get_spec(flag)
      case info.ptype
      of "int":
        var v: int
        try:
          v = value.parseInt
        except:
5e811526   Göran Krampe   Added updated lap...
328
          fail("bad integer for " & flag)
85eedc50   Göran Krampe   Added lapp.nim to...
329
330
331
332
333
334
        pval = intValue(v)
      of "float":
        var v: float
        try:
          v = value.parseFloat
        except:
5e811526   Göran Krampe   Added updated lap...
335
          fail("bad float for " & flag)
85eedc50   Göran Krampe   Added lapp.nim to...
336
337
338
339
340
341
342
343
344
        pval = floatValue(v)
      of "bool":
        pval = boolValue(value.parseBool)
      of "string":
        pval = strValue(value)
      of "infile","outfile": # we open files for the app...
        var f: File
        try:
          if info.ptype == "infile":
5e811526   Göran Krampe   Added updated lap...
345
346
347
348
            if value == "stdin":
              f = stdin
            else:
              f = open(value, fmRead)
85eedc50   Göran Krampe   Added lapp.nim to...
349
          else:
5e811526   Göran Krampe   Added updated lap...
350
351
352
353
            if value == "stdout":
              f = stdout
            else:
              f = open(value, fmWrite)
85eedc50   Göran Krampe   Added lapp.nim to...
354
          # they will be closed automatically on program exit
5e811526   Göran Krampe   Added updated lap...
355
          files.add(f)
85eedc50   Göran Krampe   Added lapp.nim to...
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
        except:
          fail("cannot open " & value)
        pval = fileValue(f,value)
      else: discard
      
      var oval = vars[flag]
      if info.multiple: # multiple flags are sequence values
        if oval == nil: # first value!
          pval = seqValue(@[pval])
        else: # just add to existing sequence
          oval.asSeq.add(pval)
          pval = oval
      elif oval != nil: # cannot repeat a single flag!
        fail("cannot use '" & flag & "' more than once")
      vars[flag] = pval
  
    return vars
  
  proc parse*(usage: string): Table[string,PValue] =
    var 
      args: seq[string]
      n = paramCount()
    newSeq(args,n+1)
    for i in 0..n:
      args[i] = paramStr(i)
    return parseArguments(usage,args)    
  
5e811526   Göran Krampe   Added updated lap...
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
  # Helper proc for verbosity level.
  proc verbosityLevel*(args: Table[string,PValue]): int =
    if args.hasKey("verbose"):
      let verbosity = args["verbose"].asSeq
      result = verbosity.len
      if not verbosity[0].asBool:
        result = 0
    else:
      result = 0
  
  # Helper to check if we should show version
  proc showVersion*(args: Table[string,PValue]): bool =
    args["version"].asBool
  
  # Helper to check if we should show help
  proc showHelp*(args: Table[string,PValue]): bool =
    args["help"].asBool
  
  
  # Typical usage
85eedc50   Göran Krampe   Added lapp.nim to...
403
  when isMainModule:
5e811526   Göran Krampe   Added updated lap...
404
405
406
407
408
409
410
411
    let help = """
    head [flags] files... [out]
      -h,--help                     Show this help
      --version                     Show version
      -n: (default 10)              Number of lines to show
      -v,--verbose: (bool...)       Verbosity level, ignored
      -o,--out: (default stdout)    Optional outfile, defaults to stdout
      <files>: (default stdin...)   Files to take head of
85eedc50   Göran Krampe   Added lapp.nim to...
412
    """
5e811526   Göran Krampe   Added updated lap...
413
414
    # On parsing failure this will show usage automatically
    var args = parse(help)
85eedc50   Göran Krampe   Added lapp.nim to...
415
  
5e811526   Göran Krampe   Added updated lap...
416
417
418
419
420
421
422
423
424
    # These two are special, they short out
    if args.showHelp: quit(help)
    if args.showVersion: quit("Version: 1.99")
    
    # Ok, so what did we get...
    let n = args["n"].asInt
    
    # This one is a helper
    let v = verbosityLevel(args)
85eedc50   Göran Krampe   Added lapp.nim to...
425
    
5e811526   Göran Krampe   Added updated lap...
426
427
    echo "Lines to show: " & $n
    echo "Verbosity level: " & $verbosityLevel(args)
85eedc50   Göran Krampe   Added lapp.nim to...
428
429
    
    let myfiles = args["files"].asSeq
5e811526   Göran Krampe   Added updated lap...
430
431
    var outFile = args["out"].asFile
    
85eedc50   Göran Krampe   Added lapp.nim to...
432
    for f in myfiles:
5e811526   Göran Krampe   Added updated lap...
433
434
      for i in 1..n:
        writeln(outFile, string(f.asFile.readLine()))