summary refs log tree commit diff
path: root/lib/MooseX/Privacy.pm
blob: ad4f9074ad838d1806e004002ac3a225de771c21 (plain) (blame)
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
package MooseX::Privacy;

our $VERSION = '0.01';

use Moose::Exporter;

Moose::Exporter->setup_import_methods(
    with_meta => [qw( private_method protected_method )], );

sub private_method {
    my ( $meta, $name, $body ) = @_;
    $meta->add_private_method( $name, $body );
}

sub protected_method {
    my ( $meta, $name, $body ) = @_;
    $meta->add_protected_method( $name, $body );
}

sub init_meta {
    my ( $me, %options ) = @_;

    my $for = $options{for_class};
    Moose->init_meta(%options);

    Moose::Util::MetaRole::apply_metaroles(
        for_class       => $for,
        metaclass_roles => [ 'MooseX::Privacy::Meta::Class', ],
    );
}

1;
__END__

=head1 NAME

MooseX::Privacy - Provides the syntax to restrict/control visibility of your methods

=head1 SYNOPSIS

  use MooseX::Privacy;

  private _foo => sub {
    return 23;
  };

  protected _bar => sub {
    return 42;
  };

=head1 DESCRIPTION

MooseX::Privacy brings the concept of private and protected methods to your class.

=head2 Private

When you declare a method as B<private>, this method can be called only within the class.

    package Foo;
    use Moose;
    use MooseX::Privacy;
    private _foo => sub { return 23 };
    sub foo { my $self = shift; $self->_foo }
    1;

    my $foo = Foo->new;
    $foo->_foo; # die
    $foo->foo;  # ok

=head2 Protected

When you declare a method as B<protected>, this method can be called only
within the class AND any of it's subclasses.

    package Foo;
    use Moose;
    use MooseX::Privacy;
    protected _foo => sub { return 23 };

    package Bar;
    use Moose;
    extends Foo;
    sub foo { my $self = shift; $self->_foo }
    1;

    my $foo = Foo->new;
    $foo->_foo; # die
    my $bar = Bar->new;
    $bar->foo;  # ok

=head1 AUTHOR

franck cuny E<lt>franck@lumberjaph.netE<gt>

=head1 SEE ALSO

=head1 LICENSE

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

=cut