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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
package MooseX::Privacy;
# ABSTRACT: Provides the syntax to restrict/control visibility of your methods
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 SYNOPSIS
use MooseX::Privacy;
has config => (
is => 'rw',
isa => 'Some::Config',
traits => [qw/Private/],
);
has username => (
is => 'rw',
isa => 'Str',
traits => [qw/Protected/],
);
private_method foo => sub {
return 23;
};
protected_method bar => sub {
return 42;
};
=head1 DESCRIPTION
MooseX::Privacy brings the concept of private and protected methods to your class.
=head1 METHODS
=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_method foo => sub { return 23 };
sub mul_by_foo { my $self = shift; $self->foo * $_[0] }
1;
my $foo = Foo->new;
$foo->foo; # die
$foo->mul_by_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_method foo => sub { return 23 };
package Bar;
use Moose;
extends Foo;
sub bar { my $self = shift; $self->foo }
1;
my $foo = Foo->new;
$foo->foo; # die
my $bar = Bar->new;
$bar->bar; # ok
=head2 Attributes
=head3 Private
When the B<Private> traits is applied to an attribute, this attribute can only be read or set within the class.
=head3 Protected
When the B<Protected> traits is applied to an attribute, this attribute can only be read or set within the class AND any of his subclasses.
|
