Webservice/OVH/Cloud/Project/Network/Private/Subnet.pm

filter: Statementstmt 16.2% 14 / 86 Branchbran 0.0% 0 / 38 Conditioncond 0.0% 0 / 18 MC/DCmcdc 0.0% 0 / 8 Subroutinesub 26.6% 4 / 15 Podpod 87.5% 7 / 8 totaltotal 14.4% 25 / 173 CC 26 SCAR 45.7
CC
26
Cov
10%
_new
240.0
_new_existing
30.0
delete
12.0
CRAP 96.4
« Webservice/OVH/Hosting/Web/Service.pm ↑ Summary Webservice/OVH/Email/Domain/Domain/MailingList.pm »
1 package Webservice::OVH::Cloud::Project::Network::Private::Subnet;
2  
3 =encoding utf-8
4  
5 =head1 NAME
6  
7 Webservice::OVH::Cloud::Project::Network::Private::Subnet
8  
9 =head1 SYNOPSIS
10  
11 use Webservice::OVH;
12
13 my $ovh = Webservice::OVH->new_from_json("credentials.json");
14
15 my $projects = $ovh->cloud->projects;
16 my $example_project = $projects->[0];
17
18 my $networks = $example_project->network->privates;
19
20 foreach my $network (@$networks) {
21
22 my $subnets = $network->subnets;
23
24 foreach my $subnet (@$subnets) {
25
26 print $subnet->name;
27 }
28 }
29  
30 =head1 DESCRIPTION
31  
32 Gives access to subnet methods.
33  
34 =head1 METHODS
35  
36 =cut
37  
38 36 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
39 36 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
40 36 ▶use Carp qw{ carp croak };
Subroutine BEGIN: called CC=1 SCAR=0.0
41 36 ▶use JSON;
Subroutine BEGIN: called CC=1 SCAR=0.0
42  
43 36 our $VERSION = 0.48;
44  
45 =head2 _new_existing
46  
47 Internal Method to create the Subnet object.
48 This method is not ment to be called directly.
49  
50 =over
51  
52 =item * Parameter: %params - key => value
53  
54 =item * Return: L<Webservice::OVH::Cloud::Project::Network::Private::Subnet>
55  
56 =item * Synopsis: Webservice::OVH::Cloud::Project::Network::Private::Subnet->_new(wrapper => $ovh_api_wrapper, project => $project, module => $module, id => $id );
57  
58 =back
59  
60 =cut
61  
62 0 ▶sub _new_existing {
Subroutine _new_existing: not called CC=5 SCAR=34.0
63  
64 0 my ( $class, %params ) = @_;
65  
66 0 ▶ die "Missing id" unless $params{id};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"id"} 0 0 0
67 0 ▶ die "Missing project" unless $params{project};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"project"} 0 0 0
68 0 ▶ die "Missing wrapper" unless $params{wrapper};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"wrapper"} 0 0 0
69 0 ▶ die "Missing module" unless $params{module};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"module"} 0 0 0
70  
71 # Special Case, because subnet properties can't be called individually
72 0 my $project_id = $params{project}->id;
73 0 my $properties = $params{properties};
74 0 my $api = $params{wrapper};
75 0 my $module = $params{module};
76 0 my $subnet_id = $properties->{id};
77 0 my $private = $params{private};
78  
79 # No api check possible, because single subnets can't be checked
80 0 my $self = bless { _module => $module, _valid => 1, _api_wrapper => $api, _id => $subnet_id, _properties => $properties, _project => $params{project}, _network => $private }, $class;
81  
82 0 return $self;
83 }
84  
85 =head2 _new_existing
86  
87 Internal Method to create the Subnet object.
88 This method is not ment to be called directly.
89  
90 =over
91  
92 =item * Parameter: %params - key => value
93  
94 =item * Return: L<Webservice::OVH::Cloud::Project::Network::Private::Subnet>
95  
96 =item * Synopsis: Webservice::OVH::Cloud::Project::Network::Private::Subnet->_new(wrapper => $ovh_api_wrapper, project => $project, module => $module );
97  
98 =back
99  
100 =cut
101  
102 0 ▶sub _new {
Subroutine _new: not called CC=15 SCAR=54.8
103  
104 0 my ( $class, %params ) = @_;
105  
106 0 ▶ die "Missing id" unless $params{project};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"project"} 0 0 0
107 0 ▶ die "Missing project" unless $params{wrapper};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"wrapper"} 0 0 0
108 0 ▶ die "Missing wrapper" unless $params{module};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"module"} 0 0 0
109 0 ▶ die "Missing module" unless $params{private};
Branch: 1 branch
BranchTrueFalseTotal
unless $params{"private"} 0 0 0
110  
111 0 ▶ my $dhcp = $params{dhcp} && ( $params{dhcp} eq 'true' || $params{dhcp} eq '1' || $params{dhcp} eq 'yes' ) ? JSON::true : JSON::false;
Branch: 1 branch
BranchTrueFalseTotal
$params{'dhcp'} && ($params{'dhcp'} eq 'true' || $params{'dhcp'} eq '1' || $params{'dhcp'} eq 'yes') ? : 0 0 0
Condition0%0/9
$params{"dhcp"} and $params{"dhcp"} eq "true" || $params{"dhcp"} eq 1 || $params{"dhcp"} eq "yes"
!ll&&!rl&&r
000
$params{"dhcp"} eq "true" or $params{"dhcp"} eq 1 or $params{"dhcp"} eq "yes"
l!l&&r!l&&!r
000
$params{"dhcp"} eq "true" or $params{"dhcp"} eq 1
l!l&&r!l&&!r
000
MC/DC0%0/4
$params{"dhcp"} and $params{"dhcp"} eq "true" || $params{"dhcp"} eq 1 || $params{"dhcp"} eq "yes"
$params{"dhcp"} $params{"dhcp"} eq "true" $params{"dhcp"} eq 1 $params{"dhcp"} eq "yes"
Truth table0%0/5
A and B or C or D
A= $params{"dhcp"}B= $params{"dhcp"} eq "true"C= $params{"dhcp"} eq 1D= $params{"dhcp"} eq "yes"
ABCDresult
0XXX0
10000
11XX1
101X1
10011
112 0 ▶ my $no_gateway = $params{noGateway} && ( $params{no_gateway} eq 'true' || $params{no_gateway} eq '1' || $params{no_gateway} eq 'yes' ) ? JSON::true : JSON::false;
Branch: 1 branch
BranchTrueFalseTotal
$params{'noGateway'} && ($params{'no_gateway'} eq 'true' || $params{'no_gateway'} eq '1' || $params{'no_gateway'} eq 'yes') ? : 0 0 0
Condition0%0/9
$params{"noGateway"} and $params{"no_gateway"} eq "true" || $params{"no_gateway"} eq 1 || $params{"no_gateway"} eq "yes"
!ll&&!rl&&r
000
$params{"no_gateway"} eq "true" or $params{"no_gateway"} eq 1 or $params{"no_gateway"} eq "yes"
l!l&&r!l&&!r
000
$params{"no_gateway"} eq "true" or $params{"no_gateway"} eq 1
l!l&&r!l&&!r
000
MC/DC0%0/4
$params{"noGateway"} and $params{"no_gateway"} eq "true" || $params{"no_gateway"} eq 1 || $params{"no_gateway"} eq "yes"
$params{"noGateway"} $params{"no_gateway"} eq "true" $params{"no_gateway"} eq 1 $params{"no_gateway"} eq "yes"
Truth table0%0/5
A and B or C or D
A= $params{"noGateway"}B= $params{"no_gateway"} eq "true"C= $params{"no_gateway"} eq 1D= $params{"no_gateway"} eq "yes"
ABCDresult
0XXX0
10000
11XX1
101X1
10011
113  
114 0 my $project_id = $params{project}->id;
115 0 my $api = $params{wrapper};
116 0 my $module = $params{module};
117 0 my $private = $params{private};
118  
119 0 my @keys_needed = qw{ network end region start };
120 0 ▶ if ( my @missing_parameters = grep { not $params{$_} } @keys_needed ) {
Branch: 1 branch
BranchTrueFalseTotal
if (my(@missing_parameters) = grep({not $params{$_};} @keys_needed)) 0 0 0
121  
122 0 croak "Missing parameter: @missing_parameters";
123 }
124  
125 0 my $network_id = $private->id;
126  
127 0 my $body = {};
128 0 $body->{dhcp} = $dhcp;
129 0 $body->{end} = $params{end};
130 0 $body->{network} = $params{network};
131 0 $body->{noGateway} = $no_gateway;
132 0 $body->{region} = $params{region};
133 0 $body->{start} = $params{start};
134  
135 0 my $response = $api->rawCall( method => 'post', path => "/cloud/project/$project_id/network/private/$network_id/subnet", body => $body, noSignature => 0 );
136 0 ▶ die $response->error if $response->error;
Branch: 1 branch
BranchTrueFalseTotal
if $response->error 0 0 0
137  
138 0 my $subnet_id = $response->content->{id};
139 0 my $properties = $response->content;
140  
141 0 my $self = bless { _network => $private, _module => $module, _valid => 1, _api_wrapper => $api, _id => $subnet_id, _properties => $properties, _project => $params{project} }, $class;
142  
143 0 return $self;
144 }
145  
146 =head2 project
147  
148 Root Project.
149  
150 =over
151  
152 =item * Return: L<Webservice::OVH::Cloud::Project>
153  
154 =item * Synopsis: my $project = $subnet->project;
155  
156 =back
157  
158 =cut
159  
160 0 ▶sub project {
Subroutine project: not called CC=1 SCAR=6.9
Pod documented
161  
162 0 my ($self) = @_;
163  
164 0 return $self->{_project};
165 }
166  
167 =head2 project
168  
169 Root Network.
170  
171 =over
172  
173 =item * Return: L<Webservice::OVH::Cloud::Project::Network::Private>
174  
175 =item * Synopsis: my $project = $subnet->project;
176  
177 =back
178  
179 =cut
180  
181 0 ▶sub network {
Subroutine network: not called CC=1 SCAR=6.9
Pod undocumented
182  
183 0 my ($self) = @_;
184  
185 0 return $self->{_network};
186 }
187  
188 =head2 is_valid
189  
190 When this object is deleted on the api side, this method returns 0.
191  
192 =over
193  
194 =item * Return: VALUE
195  
196 =item * Synopsis: print "Valid" if $subnet->is_valid;
197  
198 =back
199  
200 =cut
201  
202 0 ▶sub is_valid {
Subroutine is_valid: not called CC=1 SCAR=6.9
Pod documented
203  
204 0 my ($self) = @_;
205  
206 0 return $self->{_valid};
207 }
208  
209 =head2 _is_valid
210  
211 Intern method to check validity.
212 Difference is that this method carps an error.
213  
214 =over
215  
216 =item * Return: VALUE
217  
218 =item * Synopsis: $subnet->_is_valid;
219  
220 =back
221  
222 =cut
223  
224 0 ▶sub _is_valid {
Subroutine _is_valid: not called CC=2 SCAR=17.9
225  
226 0 my ($self) = @_;
227  
228 0 ▶ carp "Subnet is not valid anymore" unless $self->is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->is_valid 0 0 0
229 0 return $self->is_valid;
230 }
231  
232 =head2 id
233  
234 Returns the api id
235  
236 =over
237  
238 =item * Return: VALUE
239  
240 =item * Synopsis: my $id = $subnet->id;
241  
242 =back
243  
244 =cut
245  
246 0 ▶sub id {
Subroutine id: not called CC=2 SCAR=17.9
Pod documented
247  
248 0 my ($self) = @_;
249  
250 0 ▶ return unless $self->_is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_is_valid 0 0 0
251  
252 0 return $self->{_id};
253 }
254  
255 =head2 gateway_ip
256  
257 Exposed property value.
258  
259 =over
260  
261 =item * Return: VALUE
262  
263 =item * Synopsis: my $gateway_ip = $subnet->gateway_ip;
264  
265 =back
266  
267 =cut
268  
269 0 ▶sub gateway_ip {
Subroutine gateway_ip: not called CC=2 SCAR=17.9
Pod documented
270  
271 0 my ($self) = @_;
272  
273 0 ▶ return unless $self->_is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_is_valid 0 0 0
274  
275 0 return $self->{_properties}->{gatewayIp};
276 }
277  
278 =head2 cidr
279  
280 Exposed property value.
281  
282 =over
283  
284 =item * Return: VALUE
285  
286 =item * Synopsis: my $cidr = $subnet->cidr;
287  
288 =back
289  
290 =cut
291  
292 0 ▶sub cidr {
Subroutine cidr: not called CC=2 SCAR=17.9
Pod documented
293  
294 0 my ($self) = @_;
295  
296 0 ▶ return unless $self->_is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_is_valid 0 0 0
297  
298 0 return $self->{_properties}->{cidr};
299 }
300  
301 =head2 ip_pools
302  
303 Exposed property value.
304  
305 =over
306  
307 =item * Return: ARRAY
308  
309 =item * Synopsis: my $ip_pools = $subnet->ip_pools;
310  
311 =back
312  
313 =cut
314  
315 0 ▶sub ip_pools {
Subroutine ip_pools: not called CC=2 SCAR=17.9
Pod documented
316  
317 0 my ($self) = @_;
318  
319 0 ▶ return unless $self->_is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_is_valid 0 0 0
320  
321 0 return $self->{_properties}->{ipPools};
322 }
323  
324 =head2 delete
325  
326 Deletes the object api sided and sets it invalid.
327  
328 =over
329  
330 =item * Synopsis: $subnet->delete;
331  
332 =back
333  
334 =cut
335  
336 0 ▶sub delete {
Subroutine delete: not called CC=3 SCAR=24.8
Pod documented
337  
338 0 my ($self) = @_;
339  
340 0 ▶ return unless $self->_is_valid;
Branch: 1 branch
BranchTrueFalseTotal
unless $self->_is_valid 0 0 0
341  
342 0 my $api = $self->{_api_wrapper};
343 0 my $project_id = $self->project->id;
344 0 my $network_id = $self->network->id;
345 0 my $subnet_id = $self->id;
346 0 my $response = $api->rawCall( method => 'delete', path => "/cloud/project/$project_id/network/private/$network_id/subnet/$subnet_id", noSignature => 0 );
347 0 ▶ croak $response->error if $response->error;
Branch: 1 branch
BranchTrueFalseTotal
if $response->error 0 0 0
348  
349 0 $self->{_valid} = 0;
350 }
351  
352 36 1;
« Webservice/OVH/Hosting/Web/Service.pm ↑ Summary Webservice/OVH/Email/Domain/Domain/MailingList.pm »