new

  my $resource = Metabase::Resource->new(
    'cpan:///distfile/RJBS/Metabase-Fact-0.001.tar.gz',
  );

Takes a single resource string argument and constructs a new Resource object from a resource subtype determined by the URI scheme. Throws an error if the required resource subclass is not available.

resource

scheme

_cache (private)

validate

  $resource->validate

This method is called by the constructor. It SHOULD return true if the resource string is valid according to scheme-specific rules. It MUST die if the resource string is invalid.

metadata

  $meta = $resource->metadata;

This method MUST return a hash reference with resource-specific indexing metadata for the Resource. The key MUST be the name of the field for indexing. The "scheme" key MUST be present and the "scheme" value MUST be identical to the string from the "scheme" accessor. Other keys SHOULD provide dimensions to differentiate one resource from another in the context of "scheme". If a scheme has subcategories, the key "type" SHOULD be used for the subcategory. Values MUST be simple scalars, not references.

Here is a hypothetical example of a "metadata" function for a metabase user resource like 'metabase:user:ec2726a4-070c-11df-a2e0-0018f34ec37c':

  sub metadata {
    my $self = shift;
    my ($uuid) = $self =~ m{\Ametabase:user:(.+)\z};
    return {
      scheme  => 'metabase',
      type    => 'user',
      user    => $uuid,
    }
  }

Field names should be valid perl identifiers, consisting of alphanumeric characters or underscores. Hyphens and periods are allowed, but are not recommended.

metadata_types

  my $typemap = $resource->metadata_types;

This method is used to identify the datatypes of keys in the data structure provided by "metadata". It MUST return a hash reference. It SHOULD contain a key for every key that could appear in the data structure generated by "metadata" and provide a value corresponding to a datatype for each key. It MAY contain keys that do not always appear in the result of "metadata".

Data types are loosely based on Data::RX. Type SHOULD be one of the following:

  '//str' -- indicates a value that should be compared stringwise
  '//num' -- indicates a value that should be compared numerically

Here is a hypothetical example of a "metadata_types" function for a metabase user resource like 'metabase:user:ec2726a4-070c-11df-a2e0-0018f34ec37c':

  sub metadata_types {
    return {
      scheme  => '//str',
      type    => '//str',
      user    => '//str',
    }
  }

Consumers of "metadata_types" SHOULD assume that any "metadata" key not found in the result of "metadata_types" is a '//str' resource.