GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MOOSE::COOKBOOK::SNACK::KEYWORDS (3)

.ds Aq ’

NAME

Moose::Cookbook::Snack::Keywords - Restricted "keywords" in Moose

CONTENTS

VERSION

version 2.1605

DESCRIPTION

Moose exports a number of sugar functions in order to emulate Perl built-in keywords. These can cause clashes with other user-defined functions. This document provides a list of those keywords for easy reference.

    The ’meta’ keyword

use Moose adds a method called meta to your class. If this conflicts with a method or function you are using, you can rename it, or prevent it from being installed entirely. To do this, pass the -meta_name option when you use Moose. For instance:



  # install it under a different name
  use Moose -meta_name => moose_meta;

  # dont install it at all
  use Moose -meta_name => undef;



    Moose Keywords

If you are using Moose or Moose::Role it is best to avoid these keywords:
extends
with
has
before
after
around
super
override
inner
augment
confess
blessed
meta

    Moose::Util::TypeConstraints Keywords

If you are using Moose::Util::TypeConstraints it is best to avoid these keywords:
type
subtype
class_type
role_type
maybe_type
duck_type
as
where
message
inline_as
coerce
from
via
enum
find_type_constraint
register_type_constraint

    Avoiding collisions

Turning off Moose

To remove the sugar functions Moose exports, just add no Moose at the bottom of your code:



  package Thing;
  use Moose;

  # code here

  no Moose;



This will unexport the sugar functions that Moose originally exported. The same will also work for Moose::Role and Moose::Util::TypeConstraints.

Sub::Exporter features

Moose, Moose::Role and Moose::Util::TypeConstraints all use Sub::Exporter to handle all their exporting needs. This means that all the features that Sub::Exporter provides are also available to them.

For instance, with Sub::Exporter you can rename keywords, like so:



  package LOL::Cat;
  use Moose has => { -as => i_can_haz };

  i_can_haz cheeseburger => (
      is      => rw,
      trigger => sub { print "NOM NOM" }
  );

  LOL::Cat->new->cheeseburger(KTHNXBYE);



See the Sub::Exporter docs for more information.

namespace::autoclean and namespace::clean

You can also use namespace::autoclean to clean up your namespace. This will remove all imported functions from your namespace. Note that if you are importing functions that are intended to be used as methods (this includes overload, due to internal implementation details), it will remove these as well.

Another option is to use namespace::clean directly, but you must be careful not to remove meta when doing so:



  package Foo;
  use Moose;
  use namespace::clean -except => meta;
  # ...



SEE ALSO

Moose
Moose::Role
Moose::Util::TypeConstraints
Sub::Exporter
namespace::autoclean
namespace::clean

AUTHORS

o Stevan Little <stevan.little@iinteractive.com>
o Dave Rolsky <autarch@urth.org>
o Jesse Luehrs <doy@tozt.net>
o Shawn M Moore <code@sartak.org>
o XXXX XXXXX (Yuval Kogman) <nothingmuch@woobling.org>
o Karen Etheridge <ether@cpan.org>
o Florian Ragwitz <rafl@debian.org>
o Hans Dieter Pearcey <hdp@weftsoar.net>
o Chris Prather <chris@prather.org>
o Matt S Trout <mst@shadowcat.co.uk>

COPYRIGHT AND LICENSE

This software is copyright (c) 2006 by Infinity Interactive, Inc.

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

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MOOSE::COOKBOOK::SNACK::KEYWORDS (3) 2016-02-16

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.