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

COLINK / Box-Calc-1.0206 / lib / Box / Calc / Role / Container.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

              
package Box::Calc::Role::Container;
$Box::Calc::Role::Container::VERSION = '1.0206';
use strict;
use warnings;
use Moose::Role;
with 'Box::Calc::Role::Dimensional';
=head1 NAME
Box::Calc::Role::Container - Extends the L<Box::Calc::Role::Dimensional> role to include outer dimensions.
=head1 VERSION
version 1.0206
=head1 METHODS
This role installs these methods:
=head2 outer_x
Returns the outside dimension of largest side of an object.
=cut
has outer_x => (
    is          => 'rw',
    isa         => 'Num',
    required    => 1,
);
=head2 outer_y
Returns the outside dimension of the middle side of an object.
=cut
has outer_y => (
    is          => 'rw',
    isa         => 'Num',
    required    => 1,
);
=head2 outer_z
Returns the outside dimension of the shortest side of an object.
=cut
has outer_z => (
    is          => 'rw',
    isa         => 'Num',
    required    => 1,
);
=head2 outer_volume
Returns the result of multiplying outer_x, outer_y, and outer_z.
=cut
sub outer_volume {
    my ($self) = @_;
    return $self->outer_x * $self->outer_y * $self->outer_z;
}
=head2 outer_dimensions
Returns an array reference containing outer_x, outer_y, and outer_z.
=cut
sub outer_dimensions {
    my ($self) = @_;
    return [ $self->outer_x, $self->outer_y, $self->outer_z, ];
}
=head2 outer_extent
Returns a string of C<outer_x,outer_y,outer_z>. Good for comparing whether two items are dimensionally similar.
=cut
sub outer_extent {
    my ($self) = @_;
    return join ',', $self->outer_x, $self->outer_y, $self->outer_z; 
}
=head2 max_weight
The max weight of the items including the container. Defaults to 1000.
=cut
has max_weight => (
    is          => 'ro',
    isa         => 'Num',
    default     => 1000,
);
around BUILDARGS => sub {
    my $orig      = shift;
    my $className = shift;
    my $args;
    if (ref $_[0] eq 'HASH') {
        $args = shift;
    }
    else {
        $args = { @_ };
    }
    $args->{outer_x} ||= $args->{x};
    $args->{outer_y} ||= $args->{y};
    $args->{outer_z} ||= $args->{z};
    # sort large to small
        my ( $x, $y, $z ) = sort { $b <=> $a } ( $args->{outer_x}, $args->{outer_y}, $args->{outer_z} );
     
    $args->{outer_x} = $x;
    $args->{outer_y} = $y;
    $args->{outer_z} = $z;
    return $className->$orig($args);
};
1;