NAME

Net::GraphSpace - API bindings for GraphSpace

VERSION

version 0.0008

SYNOPSIS

    use Net::GraphSpace;
    use JSON qw(decode_json);
    use Try::Tiny;

    my $client = Net::GraphSpace->new(
        user     => 'bob',
        password => 'secret',
        url      => 'http://graphspace.org'
    );
    my $graph = Net::GraphSpace::Graph->new(description => 'yeast ppi');
    my $node1 = Net::GraphSpace::Node->new(id => 'node-a', label => 'A');
    my $node2 = Net::GraphSpace::Node->new(id => 'node-b', label => 'B');
    my $edge = Net::GraphSpace::Edge->new(
        id => 'a-b', source => 'node-a', target => 'node-b');
    $graph->add_nodes([$node1, $node2]);
    $graph->add_edge($edge);
    $graph->add_node(Net::GraphSpace::Node->new(id => 3, label => 'C'));

    # Upload graph to server and set the graph id
    my $graph_id = 'graph-id-1';
    my $data = $client->add_graph($graph, $graph_id);
    my $url = $data->{url};

    # Upload graph to server and have server autogenerate the graph id
    $data = $client->add_graph($graph);
    $graph_id = $data->{id};
    $url = $data->{url};
    print "Your graph (id: $graph_id) can be viewed at $url\n";

    # Get and update a graph
    $graph = $client->get_graph($graph_id)
        or die "Could not find graph $graph_id";
    $graph->tags(['foo', 'bar']);
    $client->update_graph($graph, $graph_id);

    # Delete a graph
    try {
        $client->delete_graph($graph_id);
        print "Deleted graph $graph_id: $_\n";
    } catch {
        print "Could not delete graph $graph_id: $_\n";
    };

DESCRIPTION

Net::GraphSpace provides bindings for the GraphSpace API. GraphSpace is a web based graph/network visualization tool and data store. See http://graphspace.org for more information.

ATTRIBUTES

Required:

user

password

Optional:

url

Defaults to 'http://graphspace.org'.

METHODS

new

    $client = Net::GraphSpace->new(user => 'bob', password => 'secret');

Takes key/value arguments corresponding to the attributes above.

get_graph

    $graph = $client->get_graph($graph_id)

Returns a Net::GraphSpace::Graph object for the given $graph_id. Returns undef if the graph could not be found.

get_graphs

    $graph = $client->get_graphs()
    $graph = $client->get_graphs(tag => 'foo')

Given no arguments, returns all graphs for the logged in user. Given a tag param, returns the corresponding graphs. Returns an arrayref of the form:

    [ { id => 1, url => 'http://...' }, { id => 2, url => 'http://...' } ]

add_graph

    $data = $client->add_graph($graph);
    $data = $client->add_graph($graph, $graph_id);
    $data = $client->add_graph($graph, $graph_id, check => 0);

Takes a Net::GraphSpace::Graph object and uploads it. If $graph_id is not provided, an id is autogenerated for you by the server. An optional named paramter $check defaults to 1. This means that an extra check is made to see if the graph with the given $graph_id already exists on the server. An exception is thrown if it is found. Set $check => 0 if you don't want this check. This will result in greater efficiency, since one less http request is made to the server. Also, if the graph already exists, it will get overwritten as if update_graph() was called. Returns a hashref of the form:

    { id => 1, url => 'http://...' }

The url is the location where the graph can be viewed. Dies on server error.

update_graph

    $data = $client->update_graph($graph, $graph_id);

Updates the graph on the server with id $graph_id. Returns a hashref just like add_graph(). Dies on server error.

delete_graph($graph_id)

    $success = $client->delete_graph($graph, $graph_id);

Deletes the graph with id $graph_id. Returns a true value on success. Dies on failure or if the graph didn't exist.

SEE ALSO

http://graphspace.org

AUTHOR

Naveed Massjouni <naveedm9@gmail.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Naveed Massjouni.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Net::GraphSpace

perl -MCPAN -e shell
install Net::GraphSpace