/ 
MOSES-MOBY-0.81
River stage zero No dependents
/ MOSES::MOBY::Cache::Registries

NAME

MOSES::MOBY::Cache::Registries - List of known BioMoby registries

SYNOPSIS

use MOSES::MOBY::Cache::Registries;

# print synonyms of all available registries
print "Available registries: ",
      join (", ", MOSES::MOBY::Cache::Registries->list);

# print all features of a selected registry
my $regs = new MOSES::MOBY::Cache::Registries;
my %reg = $regs->get ('IRRI');
foreach $key (sort keys $reg) {
   print "$key: $reg{$key}\n";
}

DESCRIPTION

A list of known BioMoby registries is hard coded here, and their characteristics (such as their endpoints) can be retrieved by a user-friendly synonym.

There is not that many registries, so there is (at the moment) no intention to retrieve details from a database. Hard-coded entries seem to be sufficient (if you can create a new BioMoby registry, you are fully qualified and capable to edit also this file).

SUBROUTINES

All subroutines can be called as object or class methods.

list

my @regs = MOSES::MOBY::Cache::Registries->list;

Return a list of synonyms (abbreviations) of all available registries. At least a synonym default is always present. The synonyms can be used in the get method.

get

my %reg = MOSES::MOBY::Cache::Registries->get ('IRRI');
my %reg = MOSES::MOBY::Cache::Registries->get;

Return a hash with details about a registry whose abbreviation was given as an argument. No argument is the same as 'default'. The known synonyms can be obtained by list method.

Returned hash can contain the following keys:

  • endpoint

    Value is an endpoint (a stringified URL) of this BioMoby registry.

  • namespace

    Value is a namespace (a URI) used by this registry.

  • name

    Value is a full-name of this registry. Often accompanied with the geographical location.

  • contact

    Value is a contact person, perhaps with en email, who is in charge of this registry.

  • public

    Indicate (by value 'yes') that this registry is publicly available.

  • text

    A human-readable description explaining reasons, sometimes policies, of this registry.

all

my $regs = MOSES::MOBY::Cache::Registries->all;

Return a hash reference with details about all registries. It is the same as calling get for all individual entries.

AUTHORS

Martin Senger (martin.senger [at] gmail [dot] com)
Edward Kawas (edward.kawas [at] gmail [dot] com)