#!/usr/bin/perl

package Crypt::Random::Source::Base::File;
use Squirrel;

use Carp qw(croak);

extends qw(Crypt::Random::Source::Base::Handle);

use IO::File;

has path => (
	is => "rw",
	required => 1,
);

sub open_handle {
	my ( $self, $mode ) = @_;

	my $file = $self->path;

	my $fh = IO::File->new;

	$fh->open($file, $mode || "r")
		or croak "open($file): $!";

	return $fh;
}

__PACKAGE__

__END__

=pod

=head1 NAME

Crypt::Random::Source::Base::File - File (or device) random data sources.

=head1 SYNOPSIS

	use Squirrel;
	extends qw(Crypt::Random::Source::Base::File);

	has '+path' => (
		default => "/foo/bar",
	);

=head1 DESCRIPTION

This is a base class for file (or file like) random data sources.

=head1 ATTRIBUTES

=over 4

=item path

A required attribute, the path to the file to open.

=back

=head1 METHODS

=over 4

=item open_handle

Uses L<IO::File> to open C<path> for reading.

=back

=cut