NAME¶
Debian::LicenseReconcile::CopyrightDatum - copyright data as an object
VERSION¶
Version 0.5
DESCRIPTION¶
This module conceives of copyright data as a mapping from strings (the
individual copyright holders) to sets of years.
Copyright data can be compared. Datum "A" is contained in Datum
"B" if for every key "k" in "A",
"A{k}" is contained in "B{l}", where "l" is the
key in "B" that most closely matches "k". When matching
strings they are paired off in a 1-1 manner.
SYNOPSIS¶
use Debian::LicenseReconcile::CopyrightDatum;
my $copyright = Debian::LicenseReconcile::CopyrightDatum->new($text);
my $explanation = "";
if (not $copyright->contains($copyright2, \$explanation)) {
warn $explanation;
}
SUBROUTINES/METHODS¶
new¶
This constructor parses a copyright string.
contains¶
This method returns a boolean indicating whether the object contains the
argument. The method will respect the argument if it is a
Debian::LicenseReconcile::CopyrightDatum and otherwise stringify and parse it.
It may also take an optional reference. If this is set on failing to veryify
containment the reason found will be placed in that reference.
copyright_holders¶
This method returns the list of copyright holders parsed from the original
string.
years¶
Given an exactly matching copyright holder this returns the set of years as an
Set::IntSpan object.
as_hash¶
Returns a hash reference of the objects data.
AUTHOR¶
Nicholas Bamber, "<nicholas at periapt.co.uk>"
LICENSE AND COPYRIGHT¶
Copyright 2012 Nicholas Bamber "<nicholas at periapt.co.uk>".
This program is free software; you can redistribute it and/or modify it under
the terms of either: the GNU General Public License as published by the Free
Software Foundation; or the Artistic License.
See
http://dev.perl.org/licenses/ for more information.