NAME

Graph::Easy::Parser - Parse graph from textual description

SYNOPSIS

# creating a graph from a textual description
use Graph::Easy::Parser;
my $parser = Graph::Easy::Parser->new();

my $graph = $parser->from_text(
        '[ Bonn ] => [ Berlin ]'.
        '[ Berlin ] => [ Rostock ]'.
);
print $graph->as_ascii( );

DESCRIPTION

Graph::Easy::Parser lets you parse simple textual descriptions of graphs, and constructs a Graph::Easy object from them.

The resulting object can than be used to layout and output the graph.

Input

The input consists of text describing the graph.

[ Bonn ]      --> [ Berlin ]
[ Frankfurt ] <=> [ Dresden ]
[ Bonn ]      --> [ Frankfurt ]
[ Bonn ]      ==> [ Frankfurt ]

See Output for how this will be rendered in ASCII art.

The edges between the nodes can have the following styles:

-->		line
==>		double line
..>		dotted
- >		dashed

In additon the following three directions are possible:

 -->		connect the node on the left to the node on the right
<-->		the direction between the nodes
		goes into both directions at once
<--		connect the node on the right to the node on the left

Of course you can combine all three directions with all styles.

Output

The output will be a Graph::Easy object, see there for what you can do with it.

EXAMPLES

See Graph::Easy for an extensive list of examples.

METHODS

Graph::Easy::Parser supports the following methods:

new()

use Graph::Easy::Parser;
my $parser = Graph::Easy::Parser->new();

Creates a new parser object.

reset()

$parser->reset();

Reset the status of the parser, clear errors etc.

from_text()

my $graph = $parser->from_text( $text );

Create a Graph::Easy object from the textual description in $text.

Returns undef for error, you can find out what the error was with error().

This method will reset any previous error, and thus the $parser object can be re-used to parse different texts by just calling from_text() multiple times.

from_file()

my $graph = $parser->from_file( $filename );

Creates a Graph::Easy object from the textual description in the file $filename.

Returns undef for error, you can find out what the error was with error().

error()

my $error = $parser->error();

Returns the last error, or the empty string if no error occured.

_parse_attributes()

	my $attributes = $parser->_parse_attributes( $txt );
  

Internal usage only. Takes a text like this:

attribute: value;  attribute2 : value2;

and returns a hash with the attributes.

EXPORT

Exports nothing.

SEE ALSO

Graph::Easy.

AUTHOR

Copyright (C) 2004 - 2005 by Tels http://bloodgate.com

See the LICENSE file for information.

cpanm Graph::Easy

perl -MCPAN -e shell
install Graph::Easy