NAME

lex.pl - Run Graph::Easy::Marpa::Lexer.

SYNOPSIS

lex.pl [options]

        Options:
        -cooked_file aCookedFileName
        -description graphDescription
        -help
        -input_file aRawFileName
        -maxlevel logOption1
        -minlevel logOption2
        -report_items 0 or 1
        -report_stt 0 or 1
        -stt_file sttFileName
        -timeout seconds
        -type '' or csv or ods

Exit value: 0 for success, 1 for failure. Die upon error.

Typical usage:

        perl -Ilib scripts/lex.pl -stt data/default.stt.csv -t csv -d '[node]{color:blue}'

        perl -Ilib scripts/lex.pl -stt data/default.stt.csv -t csv -max debug -d '[node]{color:blue}'

        perl -Ilib scripts/lex.pl -stt data/default.stt.csv -t csv -min error -max debug -d '[node]{color:blue}'

Complex graphs work too: -g '[node.1]{a:b;c:d}<->{e:f;}<=>{g:h}[node.2]{i:j}===[node.3]{k:l}'

        perl -Ilib scripts/lex.pl -stt data/default.stt.csv -t csv -i data/edge.01.raw

        perl -Ilib scripts/lex.pl -stt data/default.stt.csv -t csv -i data/node.04.raw -c node.04.cooked
        diff node.04.cooked data/node.04.cooked

You can use scripts/lex.sh to simplify this process:

        scripts/lex.sh data/node.04.raw data/node.04.cooked

OPTIONS

-cooked_file aCookedFileName

The name of a CSV file of cooked tokens to write. This file can be input to the parser.

The default value is '', meaning no output file will be written.

-description graphDescription

Specify a graph description string for the DFA to process.

You are strongly encouraged to surround this string with '...' to protect it from your shell.

See also the -input_file option to read the description from a file.

The -description option takes precedence over the -input_file option.

There is no default value.

-help

Print help and exit.

-input_file aRawFileName

Read the graph description string from a file.

See also the -description option to read the graph description from the command line.

The whole file is slurped in as 1 graph.

The first lines of the file can start with /\s*#/, and will be discarded as comments.

The -description option takes precedence over the -input_file option.

There is no default value.

-maxlevel logOption1

This option affects Log::Handler.

See the Log::handler docs.

The default maxlevel is 'info'. Another typical value is 'debug'.

-minlevel logOption2

This option affects Log::Handler.

See the Log::handler docs.

The default minlevel is 'error'.

No lower levels are used.

-report_items 0 or 1

Report the items recognised by the state machine.

The default value is 0.

-report_stt 0 or 1

Call Set::FA::Element.report(). Set min and max log levels to 'info' for this.

The default value is 0.

-stt_file sttFileName

Specify which file contains the state transition table.

Default: ''.

The default value means the STT is read from the source code of Graph::Easy::Marpa::Lexer.

Candidate files are '', 'data/default.stt.csv' and 'data/default.stt.ods'.

The type of this file must be specified by the -type option.

Note: If you use stt_file => your.stt.ods and type => 'ods', Module::Load's load() will be used to load OpenOffice::OODoc. This module is no longer listed in Build.PL and Makefile.PL as a pre-req, so you will need to install it manually.

-timeout seconds

Run the DFA for at most this many seconds.

Default: 3.

-type '' or cvs or ods

Specify the type of the stt_file: '' for internal STT, csv for CSV or ods for Open Office Calc spreadsheet.

Default: ''.

The default value means the STT is read from the source code of Graph::Easy::Marpa::Lexer.

This option must be used with the -stt_file option.