NAME

ORLite::Mirror - Extend ORLite to support remote SQLite databases

SYNOPSIS

# Regular ORLite on a readonly SQLite database
use ORLite 'path/mydb.sqlite';

# The equivalent for a remote (optionally compressed) SQLite database
use ORLite::Mirror 'http://myserver/path/mydb.sqlite.gz';

# All available additional options specified
use ORLite::Mirror {
    url           => 'http://myserver/path/mydb.sqlite.gz',
    maxage        => 3600,
    show_progress => 1,
    env_proxy     => 1,
    prune         => 1,
    index         => [
        'table1.column1',
        'table1.column2',
    ],
};

DESCRIPTION

ORLite provides a readonly ORM API when it loads a readonly SQLite database from your local system.

By combining this capability with LWP, ORLite::Mirror goes one step better and allows you to load a SQLite database from any arbitrary URI in readonly form as well.

As demonstrated in the synopsis above, you using ORLite::Mirror in the same way, but provide a URL instead of a file name.

If the URL explicitly ends with a '.gz' or '.bz2' then ORLite::Mirror will decompress the file before loading it.

SUPPORT

Bugs should be reported via the CPAN bug tracker at

http://rt.cpan.org/NoAuth/ReportBug.html?Queue=ORLite-Mirror

For other issues, contact the author.

AUTHOR

Adam Kennedy <adamk@cpan.org>

COPYRIGHT

Copyright 2008 - 2011 Adam Kennedy.

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

The full text of the license can be found in the LICENSE file included with this module.