The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
 / 
Meta-0.06
River stage zero No dependents
/ Meta::Digest::Collection

NAME

Meta::Digest::Collection - a collection of MD5 signatures for files.

COPYRIGHT

Copyright (C) 2001, 2002 Mark Veltzer; All rights reserved.

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.

DETAILS

        MANIFEST: Collection.pm
        PROJECT: meta
        VERSION: 0.04

SYNOPSIS

        package foo;
        use Meta::Digest::Collection qw();
        my($object)=Meta::Digest::Collection->new();
        $object->add_file("/etc/passwd");

DESCRIPTION

This object encapsulates a collection of MD5. This collection maps files to signatures and signatures to maps.

The class is two hashes - one mapping files to sums and the other mapping sums to files.

FUNCTIONS

        new($)
        add($$$)
        add_file($$)
        has_file($$)
        get_file($$)
        has_sum($$)
        TEST($)

FUNCTION DOCUMENTATION

new($)

This is a constructor for the Meta::Digest::Collection object.

add($$$)

This will add a file name and a sum to the map.

add_file($$)

Read a file, calculate it's sum and add it to the map.

has_file($$)

Return whether the file exists in the collection.

get_file($$)

Returns the file name with the specified sum.

has_sum($$)

Return whether the sum exists in the collection.

TEST($)

Test suite for this module.

SUPER CLASSES

None.

BUGS

None.

AUTHOR

        Name: Mark Veltzer
        Email: mailto:veltzer@cpan.org
        WWW: http://www.veltzer.org
        CPAN id: VELTZER

HISTORY

        0.00 MV web site development
        0.01 MV web site automation
        0.02 MV SEE ALSO section fix
        0.03 MV download scripts
        0.04 MV bring movie data

SEE ALSO

Meta::Digest::MD5(3), Meta::Ds::Hash(3), strict(3)

TODO

-this entire class should either derive from some 1-1 mapping object or from a reverse has (many to 1). implement both classes (1-1 mapping and many to 1) and then derive.