Scroll to navigation

Debian::LicenseReconcile::CopyrightDatum(3pm) User Contributed Perl Documentation Debian::LicenseReconcile::CopyrightDatum(3pm)

NAME

Debian::LicenseReconcile::CopyrightDatum - copyright data as an object

VERSION

Version 0.17

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 verify containment the reason found will be placed in that reference.

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, 2015, 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.

2019-07-15 perl v5.28.1