Cache::Repository - a framework for handling repositories of files
         Darin McBride

Copyright 2005 Darin McBride

QUICK START:

   Finish reading this README.  Install by doing:
       perl Build.PL
       ./Build.PL
       ./Build.PL test
       ./Build.PL install

   At this point, the source tree is no longer needed - you can delete
   it if you wish.

DESCRIPTION:

   The purpose of this framework is to provide a way to handle a
   repository of files.  In general, unlike simple data, files can be
   too large to fit in available memory, or, more often, too large to
   fit in a reasonable amount of memory.  For example, a repository of
   CD images would be too large to keep in shared memory, or even a
   repository of images, CAD files, etc.  Even for smaller files, such
   as perl code, if you are dealing with them as files, and not as
   data, there may be no reason to load them into a scalar in memory
   to work with.

   Further, files are often grouped together in some manner that they
   will stay together in.  For example, an image and its thumbnail
   will usually be kept together - they either are both required or
   neither.  Or an ISO image and its .md5 file.

   These are both ways that separate this framework from its nearest
   look-alike: Cache::Cache.  With Cache::Cache, each file would be
   treated as data - loaded into memory.  There is no grouping of this
   "data" since it is geared towards caching actual perlish data, and
   you can just cache arrays or hashes to keep your data together.