File: README

package info (click to toggle)
libmoosex-util-perl 0.006-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 264 kB
  • sloc: perl: 101; makefile: 2
file content (105 lines) | stat: -rw-r--r-- 3,291 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
NAME

    MooseX::Util - Moose::Util extensions

VERSION

    This document describes version 0.006 of MooseX::Util - released June
    26, 2015 as part of MooseX-Util.

SYNOPSIS

        use MooseX::Util qw{ ensure_all_roles with_traits };
    
        # profit!

DESCRIPTION

    This is a utility module that handles all of the same functions that
    Moose::Util handles. In fact, most of the functions exported by this
    package are simply re-exports from Moose::Util, so you're recommended
    to read the documentation of that module for a comprehensive view.

    However.

    We've re-implemented a number of the functions our parent provides, for
    a variety of reasons. Those functions are documented here.

FUNCTIONS

 with_traits(<classname> => (<trait1>, ... ))

    Given a class and one or more traits, we construct an anonymous class
    that is a subclass of the given class and consumes the traits given.
    This is exactly the same as "with_traits" in Moose::Util, except that
    we use "create_anon_class" in MooseX::Util::Meta::Class to construct
    the anonymous class, rather than "create_anon_class" in
    Moose::Meta::Class directly.

    Essentially, this means that when we do:

        my $anon_class_name = with_traits('Zombie::Catcher', 'SomeTrait');

    For $anon_class_name we get:

        Zombie::Catcher::__ANON__::SERIAL::1

    Rather than:

        Moose::Meta::Class::__ANON__::SERIAL::1

    This is nice because we have an idea of where the first anonymous class
    came from, whereas the second one could could be from anywhere.

 is_private

        # true if "private"
        ... if is_private('_some_name');

    Ofttimes we need to determine if a name is considered "private" or not.
    By convention, method, attribute, and other names are considered
    private if their first character is an underscore.

    While trivial to test for, this allows us to centralize the tests in
    one place.

SEE ALSO

    Please see those modules/websites for more information related to this
    module.

      * Moose::Util

BUGS

    Please report any bugs or feature requests on the bugtracker website
    https://github.com/RsrchBoy/moosex-util/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.

AUTHOR

    Chris Weyl <cweyl@alumni.drew.edu>

 I'm a material boy in a material world

    Please note I do not expect to be gittip'ed or flattr'ed for this work,
    rather it is simply a very pleasant surprise. I largely create and
    release works like this because I need them or I find it enjoyable;
    however, don't let that stop you if you feel like it ;)

    Flattr
    <https://flattr.com/submit/auto?user_id=RsrchBoy&url=https%3A%2F%2Fgithub.com%2FRsrchBoy%2Fmoosex-util&title=RsrchBoy's%20CPAN%20MooseX-Util&tags=%22RsrchBoy's%20MooseX-Util%20in%20the%20CPAN%22>,
    Gratipay <https://gratipay.com/RsrchBoy/>, or indulge my Amazon
    Wishlist <http://bit.ly/rsrchboys-wishlist>... If and *only* if you so
    desire.

COPYRIGHT AND LICENSE

    This software is Copyright (c) 2012 by Chris Weyl.

    This is free software, licensed under:

      The GNU Lesser General Public License, Version 2.1, February 1999