1
2
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
53
54
55
56
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
======================================================================
runawk: small wrapper for AWK interpreter that impements modules
system and helps one to write the standalone AWK programs.
author: Aleksey Cheusov <vle@gmx.net>
project's home page: http://sourceforge.net/projects/runawk
licence: MIT license
======================================================================
MOTIVATION
See section MOTIVATION of runawk.1 or runawk.pod.
======================================================================
INSTALLATION
See INSTALL file.
======================================================================
MODULES
RunAWK provides lots of AWK modules ready for use. All of them are
under modules/ subdirectory. They are installed by default.
abort.awk, alt_assert.awk
- power abort() and assert()
alt_join.awk - join :-)
braceexpand.awk - awk equivalent to shell's braceexpand functionality
basename.awk, dirname.awk
- equivalents to basename(1) and dirname(1)
embed_str.awk - reads strings from AWK code
exitnow.awk -
has_prefix.awk, has_suffix.awk
- trivial string functions
match_br.awk - find pair closed brackets in a string
max.awk, min.awk, isnum.awk, abs.awk
- trivial math functions
modinfo.awk - routines to get an information about modules that
are in use
multisub.awk - another replacement functions
pow.awk - synonym for ^
init_getopt.awk, alt_getopt.awk, power_getopt.awk
- POSIX/SUS compatible routines
for handling options EASILY ;-)
readfile.awk - read an entire file into variable
runcmd.awk - safe wrapper over system()
shquote.awk - escapes shell's special characters
heapsort.awk, quicksort.awk, sort.awk
- sorting functions
str2regexp.awk - string to regexp routines
tokenre.awk - alternative mechanism for separating input into tokens
xclose.awk, xgetline.awk, xsystem.awk
- functions to write robust programs
tmpfile.awk - generates names of automatically deleted tempfiles
fieldwidths.awk - portable equivalent of GNU awk's FIELDWIDTHS ;-)
CR_in.awk - removes CR symbols from input lines.
trim.awk - functions for trimming spaces from the string.
trim_in.awk - trims spaces from input lines.
backslash_in.awk - treats backslash symbol at the end of line as
"this line will continue on the next one".
ini.awk - functions for reading Win .ini files.
ftrans_in.awk - handle data file transitions
ord.awk - character to id and id to character convertors
======================================================================
SCRIPTS
RunAWK also provides a few scripts:
alt_getopt - program arguments parser aware of long options,
alternative to POSIX getopts and getopt(1).
In addition to alt_getopt(1) utility alt_getopt.sh
shell library is also provided that provides
an alternative way for handling options.
alt_getopt.sh - shell library functionally equivalent
to alt_getopt(1)
======================================================================
EXAMPLES
Lots of examples are available in examples/ subdirectory.
======================================================================
PACKAGES
1) NetBSD, DragonFlyBSD, Linux, Solaris... (pkgsrc)
RunAWK is packaged in pkgsrc as wip/runawk.
2) FreeBSD
RunAWK is packaged in FreeBSD ports as lang/runawk
3) Debian/lenny/x86
Add the following lines
deb http://mova.org/~cheusov/pub/debian lenny main
deb-src http://mova.org/~cheusov/pub/debian lenny main
to /etc/apt/sources.list and then using apt or aptitude commands.
Binary packages are available only for Debian/Lenny/i386.
Ubuntu users need to recompile the package for their system.
|
