Name

File::DataClass - Structured data file IO with OO paradigm

Version

This document describes version v0.26.$Rev: 1 $ of File::DataClass

Synopsis

use File::DataClass::Schema;

$schema = File::DataClass::Schema->new
   ( path    => [ qw(path to a file) ],
     result_source_attributes => { source_name => {}, },
     tempdir => [ qw(path to a directory) ] );

$schema->source( q(source_name) )->attributes( [ qw(list of attr names) ] );
$rs = $schema->resultset( q(source_name) );
$result = $rs->find( { name => q(id of field element to find) } );
$result->$attr_name( $some_new_value );
$result->update;
@result = $rs->search( { 'attr name' => q(some value) } );

Description

Provides methods for manipulating structured data stored in files of different formats

The documentation for this distribution starts in the class File::DataClass::Schema

File::DataClass::IO is a Moo based implementation of IO::Alls API. It implements the file and directory methods only

Configuration and Environment

Defines no attributes

Subroutines/Methods

F_DC_Cache

$hash_ref_of_CHI_objects = File::DataClass->F_DC_Cache;

A class method which returns a hash ref of CHI objects which are used to cache the results of reading files

Diagnostics

None

Dependencies

Moo

Incompatibilities

On MSWin32 and Cygwin it is assumed that NTFS is being used and that it does not support mtime so caching on those platforms is disabled

Bugs and Limitations

There are no known bugs in this module. Please report problems to http://rt.cpan.org/NoAuth/Bugs.html?Dist=File-DataClass. Patches are welcome

Acknowledgements

Larry Wall - For the Perl programming language

The class structure and API where taken from DBIx::Class

The API for the file IO was taken from IO::All

Author

Peter Flanigan, <pjfl@cpan.org>

License and Copyright

Copyright (c) 2013 Peter Flanigan. All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic

This program is distributed in the hope that it will be useful, but WITHOUT WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE