The Perl Toolchain Summit 2025 Needs You: You can help 🙏 Learn more

KENTNL / Parse-Method-Signatures-1.003019 / lib / Parse / Method / Signatures / Sig.pm 

            

              
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
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

              
package Parse::Method::Signatures::Sig;
use Moose;
use MooseX::Types::Moose qw/HashRef/;
use Parse::Method::Signatures::Types qw/Param ParamCollection NamedParam/;
use List::MoreUtils qw/part/;
use namespace::clean -except => 'meta';
has invocant => (
    is        => 'ro',
    does      => Param,
    predicate => 'has_invocant',
);
has _positional_params => (
    is        => 'ro',
    isa       => ParamCollection,
    init_arg  => 'positional_params',
    predicate => 'has_positional_params',
    coerce    => 1,
    handles   => {
        positional_params => 'params',
    },
);
has _named_params => (
    is        => 'ro',
    isa       => ParamCollection,
    init_arg  => 'named_params',
    predicate => 'has_named_params',
    coerce    => 1,
    handles   => {
        named_params => 'params',
    },
);
has _named_map => (
    is         => 'ro',
    isa        => HashRef[Param],
    lazy_build => 1,
);
override BUILDARGS => sub {
    my $args = super();
    if (my $params = delete $args->{params}) {
        my ($positional, $named) = part { NamedParam->check($_) ? 1 : 0 } @{ $params };
        $args->{positional_params} = $positional if $positional;
        $args->{named_params} = $named if $named;
    }
    return $args;
};
sub _build__named_map {
    my ($self) = @_;
    return {} unless $self->has_named_params;
    return { map { $_->label => $_ } @{ $self->named_params } };
}
sub named_param {
    my ($self, $name) = @_;
    return $self->_named_map->{$name};
}
around has_positional_params => sub {
    my $orig = shift;
    my $ret = $orig->(@_);
    return unless $ret;
    my ($self) = @_;
    return scalar @{ $self->positional_params };
};
around has_named_params => sub {
    my $orig = shift;
    my $ret = $orig->(@_);
    return unless $ret;
    my ($self) = @_;
    return scalar @{ $self->named_params };
};
sub to_string {
    my ($self) = @_;
    my $ret = q{(};
    if ($self->has_invocant) {
        $ret .= $self->invocant->to_string;
        $ret .= q{:};
        if ($self->has_positional_params || $self->has_named_params) {
            $ret .= q{ };
        }
    }
    $ret .= $self->_positional_params->to_string if $self->has_positional_params;
    $ret .= q{, } if $self->has_positional_params && $self->has_named_params;
    $ret .= $self->_named_params->to_string if $self->has_named_params;
    $ret .= q{)};
    return $ret;
}
__PACKAGE__->meta->make_immutable;
1;
__END__
=head1 NAME
Parse::Method::Signatures::Sig - Method Signature
=head1 DESCRIPTION
Represents the parsed method signature.
=head1 ATTRIBUTES
=head2 invocant
=head2 named_params
A ParamCollection representing the name parameters of this signature.
=head2 positional_params
A ParamCollection representing the positional parameters of this signature.
=head1 METHODS
=head2 has_named_params
Predicate returning true if this signature has named parameters.
=head2 has_positional_params
Predicate returning true if this signature has positional parameters.
=head2 named_param
Returns the Param with the specified name.
=head2 to_string
Returns a string representation of this signature.
=head1 LICENSE
Licensed under the same terms as Perl itself.
=cut