bionic (3) Debian::LicenseReconcile::CopyrightDatum.3pm.gz

NAME

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

VERSION

       Version 0.14

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.

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