NAME

Types::Const - Types that coerce references to read-only

VERSION

version v0.2.2

SYNOPSIS

  use Moo;
  use Types::Const -types;
  use Types::Standard -types;

  ...

  has bar => (
    is      => 'ro',
    isa     => ConstArrayRef[Str],
    coerce  => 1,
  );

DESCRIPTION

This is an experimental type library that provides types that force read-only hash and array reference attributes to be deeply read-only.

See the known issues below for a discussion of side-effects.

TYPES

ConstArrayRef[`a]

A read-only array reference.

ConstHashRef[`a]

A read-only hash reference.

SEE ALSO

Const::Fast

Type::Tiny

Types::Standard

KNOWN ISSUES

Side-effects of read-only data structures

A side-effect of read-only data structures is that an exception will be thrown if you attempt to fetch the value of a non-existent key:

    Attempt to access disallowed key 'foo' in a restricted hash

The work around for this is to check that a key exists beforehand.

Bug reports and feature requests

Please report any bugs or feature requests on the bugtracker website https://github.com/robrwo/Types-Const/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SOURCE

The development version is on github at https://github.com/robrwo/Types-Const and may be cloned from git://github.com/robrwo/Types-Const.git

AUTHOR

Robert Rothenberg <rrwo@cpan.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2018 by Robert Rothenberg.

This is free software, licensed under:

  The Artistic License 2.0 (GPL Compatible)

cpanm Types::Const

perl -MCPAN -e shell
install Types::Const