IO::Moose - Reimplementation of IO::* with improvements

- NAME
- SYNOPSIS
- DESCRIPTION
- IMPORTS
- SEE ALSO
- BUGS
- AUTHOR
- LICENSE

# NAME

IO::Moose - Reimplementation of IO::* with improvements

Back to Top

# SYNOPSIS

      use IO::Moose 'Handle', 'File';  # loads IO::Moose::* modules

      $passwd = IO::Moose::File->new( file => '/etc/passwd' )->slurp;

Back to Top

# DESCRIPTION

`IO::Moose` provides a simple mechanism to load several modules in one go.

`IO::Moose::*` classes provide an interface mostly compatible with IO. The differences:

- It is based on the Moose manpage object framework.

- It uses the Exception::Base manpage for signaling errors. Most of methods are throwing exception on failure.

- The modifiers like `input_record_separator` are supported on per file handler basis.

- It also implements additional methods like `say`, `slurp`.

Back to Top

# IMPORTS

use IO::Moose [modules]

  Loads a modules from `IO::Moose::*` hierarchy. I.e. `Handle` parameter loads `IO::Moose::Handle` module.

        use IO::Moose 'Handle', 'File';  # loads IO::Moose::Handle and ::File.

  If modules list is empty, it loads following modules at default:

  - the IO::Moose::Handle manpage
  - the IO::Moose::File manpage

Back to Top

# SEE ALSO

IO, the Moose manpage.

Back to Top

# BUGS

The API is not stable yet and can be changed in future.

Back to Top

# AUTHOR

Piotr Roszatycki <dexter@cpan.org>

Back to Top

# LICENSE

Copyright 2008, 2009 by Piotr Roszatycki <dexter@cpan.org>.

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

See http://www.perl.com/perl/misc/Artistic.html

Back to Top

IO::Moose - Reimplementation of IO::* with improvements