AUGPARSE(1) Augeas AUGPARSE(1) NAME augparse - execute an Augeas module SYNOPSIS augparse [OPTIONS] MODULE DESCRIPTION Execute an Augeas module, most commonly to evaluate the tests it contains. OPTIONS -I, --include=DIR Add DIR to the module loadpath. Can be given multiple times. The direc- tories set here are searched before any directories specified in the AUGEAS_LENS_LIB environment variable, and before the default directory /usr/share/augeas/lenses. -t, --trace Print a trace of the modules that are being loaded. --nostdinc Do not search any of the default directories for modules. When this op- tion is set, only directories specified explicitly with -I or specified in AUGEAS_LENS_LIB will be searched for modules. --notypecheck Do not perform lens type checks. Only use this option during lens de- velopment and make sure you typecheck lenses when you are done develop- ing - you should never use a lens that hasn't been typechecked. This option is sometimes useful when you are working on unit tests for a lens to speed up the time it takes to repeatedly run and fix tests. --version Print version information and exit. -h Display this help and exit EXAMPLES To run the tests in lenses/tests/test_foo.aug and use modules from the di- rectory lenses, run augparse -I lenses lenses/tests/test_foo.aug TESTS Tests can appear as top-level forms anywhere in a module. Generally, the tests for a module lenses/foo.aug are kept in a separate file, usually in lenses/tests/test_foo.aug. There are two different kinds of tests that Augeas can run: get and put tests. The syntax for get tests is test LENS get STRING = RESULT which applies the get direction of the lens LENS to STRING and compares it with the given RESULT. RESULT can either be a tree literal, the symbol ? to print the result of applying LENS to STRING, or the symbol * to indicate that the test should produce an exception. The syntax for put tests is test LENS put STRING after COMMANDS = RESULT which first applies the get direction of the lens LENS to STRING, then ap- plies the given COMMANDS to the resulting tree, and finally transforms the modified tree back to a string using the put direction of LENS. The result- ing string is then compared to RESULT, which can be a string, the symbol ? to print the result of applying LENS to STRING, or the symbol * to indicate that the test should produce an exception. AUTHOR David Lutterkort <lutter@watzmann.net> COPYRIGHT AND LICENSE Copyright 2007-2016 David Lutterkort Augeas (and augparse) are distributed under the GNU Lesser General Public License (LGPL) SEE ALSO Augeas project homepage <http://www.augeas.net/> augtool Augeas 1.12.0 2020-09-09 AUGPARSE(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | TESTS | AUTHOR | COPYRIGHT AND LICENSE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=augparse&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>