blib/lib/POE/Session/Multiplex.pm

filter: Statementstmt 89.6% 173 / 193 Branchbran 71.2% 67 / 94 Conditioncond 61.1% 11 / 18 MC/DCmcdc 33.3% 4 / 12 Subroutinesub 96.3% 26 / 27 Podpod 86.6% 13 / 15 totaltotal 81.8% 294 / 359 CC 58 SCAR 21.6
CC
58
Cov
82%
object_register
20.4
_invoke_state
11.8
_handler_for
9.1
CRAP 8.7
↑ Summary
1 package POE::Session::Multiplex;
2  
3 6 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 6 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 6 ▶use Carp;
Subroutine BEGIN: called CC=1 SCAR=0.0
7 6 ▶use POE;
Subroutine BEGIN: called CC=1 SCAR=0.0
8 6 ▶use POE::Session;
Subroutine BEGIN: called CC=1 SCAR=0.0
9  
10 6 ▶use Scalar::Util qw( blessed );
Subroutine BEGIN: called CC=1 SCAR=0.0
11  
12 6 require Exporter;
13  
14 6 our @ISA = qw(Exporter POE::Session);
15 6 our %EXPORT_TAGS = ( 'all' => [ qw( ev evs rsvp evo evos ) ] );
16  
17 6 our @EXPORT_OK = ( @{ $EXPORT_TAGS{'all'} } );
18  
19 6 our @EXPORT = qw( ev evo evs rsvp );
20  
21 6 our $VERSION = '0.0600';
22 6 our $CURRENTOBJ;
23  
24 6 our $START;
25  
26 #######################################
27 6 our $LAST_OFF;
28 6 ▶BEGIN {
Subroutine BEGIN: called CC=2 SCAR=7.2
29 6 *SE_NAMESPACE = \&POE::Session::SE_NAMESPACE;
30 6 *SE_OPTIONS = \&POE::Session::SE_OPTIONS;
31 6 *SE_STATES = \&POE::Session::SE_STATES;
32  
33 ## +1 and +2 used by PlainCall
34 6 ▶ if( POE::Session->can( 'SE_ID' ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ('POE::Session'->can('SE_ID')) { } 6 0 6
35 # POE 1.300 +
36 6 *SE_ID = \&POE::Session::SE_ID;
37 6 eval '
38 *SE_OBJECTS = sub () { POE::Session::SE_ID+3 };
39 *SE_STATERE = sub () { POE::Session::SE_ID+4 };
40 *SE_ISAPLAIN = sub () { POE::Session::SE_ID+5 };
41 ';
42 }
43 else {
44 # POE 1.299-
45 0 *SE_OBJECTS = sub () { POE::Session::SE_STATES+3 };
46 0 *SE_STATERE = sub () { POE::Session::SE_STATES+4 };
47 0 *SE_ISAPLAIN = sub () { POE::Session::SE_STATES+5 };
48 }
49  
50 6 *EN_SIGNAL = \&POE::Session::EN_SIGNAL;
51 6 *EN_DEFAULT = \&POE::Session::EN_DEFAULT;
52  
53 6 *OPT_TRACE = \&POE::Session::OPT_TRACE;
54 6 *OPT_DEBUG = \&POE::Session::OPT_DEBUG;
55 6 *OPT_DEFAULT = \&POE::Session::OPT_DEFAULT;
56 }
57  
58 sub OH_OBJECT () { 0 }
59 sub OH_NAME () { 1 }
60 sub OH_OURS () { 2 }
61  
62 ############################################################################
63 sub _loggable
64 0 ▶{
Subroutine _loggable: not called CC=1 SCAR=6.9
65 0 my( $self ) = @_;
66 0 $POE::Kernel::poe_kernel->_data_alias_loggable( $_[0] );
67 }
68  
69 sub create
70 4 ▶{
Subroutine create: called CC=2 SCAR=7.6
Pod documented
71 4 my $package = shift;
72  
73 4 ▶ if( $package->isa( 'POE::Session::PlainCall' ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($package->isa('POE::Session::PlainCall')) { } 0 4 4
74 0 return $package->POE::Session::PlainCall::create( @_ );
75 }
76 else {
77 4 return $package->SUPER::create( @_ );
78 }
79 }
80  
81 sub instantiate
82 4 ▶{
Subroutine instantiate: called CC=1 SCAR=0.0
Pod documented
83 4 my $package = shift;
84 4 my $self = $package->SUPER::instantiate( @_ );
85 4 $self->__init;
86 4 return $self;
87 }
88  
89 sub __init
90 4 ▶{
Subroutine __init: called CC=3 SCAR=12.3
91 4 my( $self ) = @_;
92 4 ▶ if( $self->[SE_OBJECTS] ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[6]) 0 4 4
93 0 die "Definition of POE::Session changed! $self needs to be modified.\n";
94 }
95 4 $self->[SE_OBJECTS] = {};
96 4 $self->[SE_ISAPLAIN] = $self->isa( 'POE::Session::PlainCall' );
97 4 ▶ if( $self->[SE_ISAPLAIN] ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[8]) 0 4 4
98 0 $self->POE::Session::PlainCall::__init;
99 }
100 }
101  
102 #######################################
103 sub _invoke_state
104 38 ▶{
Subroutine _invoke_state: called CC=9 SCAR=24.6
105 38 my( $self, $source_session, $state, $etc, $file, $line, $fromstate ) = @_;
106  
107 38 ▶ $self->set_objectre unless $self->[SE_STATERE];
Branch: 1 branch
BranchTrueFalseTotal
unless $self->[7] 10 28 38
108  
109 38 ▶ if ($self->[SE_OPTIONS]->{+OPT_TRACE}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[1]{"trace"}) 0 38 38
110 0 POE::Kernel::_warn( $self->_loggable,
111 " -> $state (from $file at $line)\n"
112 );
113 }
114
115 38 ▶ if( $state =~ /^$self->[SE_STATERE]$/ ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($state =~ /^$self->[7]$/) 24 14 38
116 24 my $obj_name = $1;
117 24 my $obj_state = $2;
118  
119 24 my( $object, $method ) = $self->handler_for( $obj_name, $obj_state, $state );
120 24 ▶ if( $method ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($method) 24 0 24
121 24 ▶ if ($self->[SE_OPTIONS]->{+OPT_TRACE}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[1]{"trace"}) 0 24 24
122 0 POE::Kernel::_warn( $self->_loggable,
123 " OBJECT=$obj_name METHOD=$method\n"
124 );
125 }
126  
127 24 local $CURRENTOBJ = $obj_name;
128 24 ▶ if( $self->[SE_ISAPLAIN] ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[8]) 0 24 24
129 0 local $POE::Session::PlainCall::POE_HOLDER = bless [
130 ( $object, # object
131 $self, # session
132 $POE::Kernel::poe_kernel, # kernel
133 $self->[SE_NAMESPACE], # heap
134 $obj_state, # state
135 $source_session, # sender
136 undef, # unused #6
137 $file, # caller file name
138 $line, # caller file line
139 $fromstate, # caller state
140 $method, # method
141 $etc, # args
142 ) ], 'POE::Session::PlainCall::Holder';
143 0 return $object->$method( @$etc );
144 }
145 24 return $object->$method(
146 $self, # SESSION
147 $POE::Kernel::poe_kernel, # KERNEL
148 $self->[SE_NAMESPACE], # HEAP
149 $obj_state, # STATE
150 $source_session, # SENDER
151 undef, # unused #6
152 $file, # CALLER_FILE
153 $line, # CALLER_LINE
154 $fromstate, # CALLER_STATE
155 @$etc, # ARG0, ARG1, ARG2
156 );
157 }
158 }
159  
160 14 ▶ if ($self->[SE_OPTIONS]->{+OPT_TRACE}) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[1]{"trace"}) 0 14 14
161 0 POE::Kernel::_warn( $self->_loggable,
162 " -> $state (not an multiplex state)\n"
163 );
164 }
165  
166 ## Skip out if it's not our state
167 14 ▶ if( $self->[SE_ISAPLAIN] ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[8]) { } 0 14 14
168 0 return shift->POE::Session::PlainCall::_invoke_state( @_ );
169 }
170 else {
171 14 return shift->SUPER::_invoke_state( @_ );
172 }
173 }
174  
175  
176 #######################################
177 sub evo ($$)
178 25 ▶{
Subroutine evo: called CC=1 SCAR=0.0
Pod documented
179 25 my( $obj_name, $event ) = @_;
180 25 return "$obj_name->$event";
181 }
182  
183 #######################################
184 sub ev ($)
185 14 ▶{
Subroutine ev: called CC=2 SCAR=7.1
Pod documented
186 14 my( $event ) = @_;
187 14 ▶ croak "Can't call ev outside of a multiplexed object" unless $CURRENTOBJ;
Branch: 1 branch
BranchTrueFalseTotal
unless $POE::Session::Multiplex::CURRENTOBJ 0 14 14
188 14 return evo $CURRENTOBJ, $event;
189 }
190  
191 #######################################
192 sub evs ($)
193 3 ▶{
Subroutine evs: called CC=3 SCAR=11.3
Pod documented
194 3 my( $event ) = @_;
195 3 ▶ croak "Can't call evs outside of a multiplexed object" unless $CURRENTOBJ;
Branch: 1 branch
BranchTrueFalseTotal
unless $POE::Session::Multiplex::CURRENTOBJ 0 3 3
196 3 my $self = $poe_kernel->get_active_session;
197 3 ▶ croak "Can't call evs outside of a multiplexed session" unless $self;
Branch: 1 branch
BranchTrueFalseTotal
unless $self 0 3 3
198 3 return $self->ID, ev$event;
199 }
200  
201 #######################################
202 sub rsvp ($)
203 3 ▶{
Subroutine rsvp: called CC=1 SCAR=0.0
Pod documented
204 3 return [ evs $_[0] ];
205 }
206  
207 #######################################
208 sub evos ($$$)
209 3 ▶{
Subroutine evos: called CC=2 SCAR=7.1
Pod documented
210 3 my( $session, $obj_name, $event ) = @_;
211 3 ▶ $session = $session->ID if blessed $session;
Branch: 1 branch
BranchTrueFalseTotal
if builtin::blessed($session) 3 0 3
212 3 return $session, evo $obj_name, $event;
213 }
214  
215  
216 #######################################
217 sub set_objectre
218 10 ▶{
Subroutine set_objectre: called CC=1 SCAR=0.0
Pod undocumented
219 10 my( $self ) = @_;
220 10 my $re = '(' . join( '|', map quotemeta, keys %{$self->[SE_OBJECTS]} ).
221 ')->(.+)';
222 10 $self->[SE_STATERE] = $re;
223 }
224  
225 #######################################
226 # $obj_name => name of object
227 # $obj_state => clean state name
228 # $state => raw state name ($obj_name->$obj_state)
229 sub handler_for
230 24 ▶{
Subroutine handler_for: called CC=2 SCAR=7.0
Pod undocumented
231 24 my( $self, $obj_name, $obj_state, $state ) = @_;
232  
233 24 my @ret = $self->_handler_for( $obj_name, $state );
234 24 ▶ return @ret if @ret;
Branch: 1 branch
BranchTrueFalseTotal
if @ret 0 24 24
235  
236 24 return $self->_handler_for( $obj_name, $obj_state );
237 }
238  
239 sub _handler_for
240 77 ▶{
Subroutine _handler_for: called CC=7 SCAR=22.0
241 77 my( $self, $obj_name, $state ) = @_;
242 77 my $handler = $self->[SE_STATES]->{$state};
243 77 ▶ return unless $handler;
Branch: 1 branch
BranchTrueFalseTotal
unless $handler 48 29 77
244 29 ▶ return if 'CODE' eq ref $handler;
Branch: 1 branch
BranchTrueFalseTotal
if "CODE" eq ref $handler 0 29 29
245  
246 29 my $def = $self->[SE_OBJECTS]->{$obj_name};
247 29 ▶ return unless $def;
Branch: 1 branch
BranchTrueFalseTotal
unless $def 0 29 29
248  
249 # Same object?
250 29 ▶ if( blessed $handler->[0] and $handler->[0] eq $def->[OH_OBJECT] ) {
Branch: 2 branches
BranchTrueFalseTotal
if (builtin::blessed($handler->[0]) and $handler->[0] eq $def->[0]) { } 0 29 29
elsif ($def->[0]->isa($handler->[0])) { } 29 0 29
Condition33%1/3
builtin::blessed($handler->[0]) and $handler->[0] eq $def->[0]
!ll&&!rl&&r
2900
MC/DC0%0/2
builtin::blessed($handler->[0]) and $handler->[0] eq $def->[0]
builtin::blessed($handler->[0]) $handler->[0] eq $def->[0]
Truth table33%1/3
A and B
A= builtin::blessed($handler->[0])B= $handler->[0] eq $def->[0]
ABresult
0X0
100
111
251 0 return $def->[OH_OBJECT], $handler->[1];
252 }
253 # Object of the right package?
254 elsif( $def->[OH_OBJECT]->isa( $handler->[0] ) ) {
255 29 return $def->[OH_OBJECT], $handler->[1];
256 }
257 0 return;
258 }
259  
260 #######################################
261 sub object
262 20 ▶{
Subroutine object: called CC=3 SCAR=11.6
Pod documented
263 20 my( $self, $obj_name, @def ) = @_;
264 20 ▶ if( @def ) {
Branch: 1 branch
BranchTrueFalseTotal
if (@def) { } 17 3 20
265 17 ▶ if( blessed $obj_name ) {
Branch: 1 branch
BranchTrueFalseTotal
if (builtin::blessed($obj_name)) 0 17 17
266 0 @def = ( $obj_name, @def );
267 0 $obj_name = $self->_obj_name( $def[0] );
268 }
269 17 $self->object_register( name => $obj_name,
270 object => $def[0],
271 states => $def[1]
272 );
273 }
274 else {
275 3 $self->object_unregister( $obj_name );
276 }
277 }
278  
279 sub _obj_name
280 4 ▶{
Subroutine _obj_name: called CC=3 SCAR=11.0
281 4 my( $package, $obj ) = @_;
282 4 ▶ return "$obj" unless $obj->can( '__name' );
Branch: 1 branch
BranchTrueFalseTotal
unless $obj->can("__name") 2 2 4
283 2 my $name = $obj->__name;
284 2 ▶ die ref( $obj ), "->__name must return the object's name" unless $name;
Branch: 1 branch
BranchTrueFalseTotal
unless $name 0 2 2
285 2 return $name;
286 }
287  
288  
289 #######################################
290 sub object_get
291 8 ▶{
Subroutine object_get: called CC=2 SCAR=6.9
Pod documented
292 8 my( $self, $obj_name ) = @_;
293 8 ▶ return unless exists $self->[SE_OBJECTS]->{ $obj_name };
Branch: 1 branch
BranchTrueFalseTotal
unless exists $self->[6]{$obj_name} 3 5 8
294 5 return $self->[SE_OBJECTS]->{ $obj_name }[OH_OBJECT];
295 }
296  
297 #######################################
298 sub object_register
299 19 ▶{
Subroutine object_register: called CC=20 SCAR=30.2
Pod documented
300 19 my( $self, @def ) = @_;
301  
302 19 ▶ if( 1==@def ) {
Branch: 1 branch
BranchTrueFalseTotal
if (1 == @def) 1 18 19
303 1 @def = ( object => $def[0] );
304 }
305 19 my %def = ( @def );
306  
307 19 my $object = $def{object};
308 19 ▶ croak "You must supply an object" unless $object;
Branch: 1 branch
BranchTrueFalseTotal
unless $object 0 19 19
309  
310 19 ▶ my $obj_name = $def{name} || $self->_obj_name( $object );
Condition66%2/3
$def{'name'} || $self->_obj_name($object)
l!l&&r!l&&!r
1720
MC/DC0%0/2
$def{'name'} || $self->_obj_name($object)
$def{'name'} $self->_obj_name($object)
Truth table66%2/3
A || B
A= $def{'name'}B= $self->_obj_name($object)
ABresult
1X1
011
000
311 19 ▶ croak "You may not include -> in an object name" if $obj_name =~ /->/;
Branch: 1 branch
BranchTrueFalseTotal
if $obj_name =~ /->/ 0 19 19
312 19 ▶ my $states = $def{states} || $def{events};
Condition66%2/3
$def{'states'} || $def{'events'}
l!l&&r!l&&!r
3016
MC/DC50%1/2
$def{'states'} || $def{'events'}
$def{'states'} $def{'events'}
Truth table66%2/3
A || B
A= $def{'states'}B= $def{'events'}
ABresult
1X1
011
000
313  
314 19 ▶ if( $self->[SE_OBJECTS]->{ $obj_name } ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->[6]{$obj_name}) 3 16 19
315 3 $self->object_unregister( $obj_name );
316 }
317 19 $self->[SE_STATERE] = '';
318  
319 19 my $hold = $self->[SE_OBJECTS]->{ $obj_name } = [];
320 19 ▶ if( $states ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($states) { } 3 16 19
321 # Tediously define states for this object
322 3 my $ours = $hold->[OH_OURS] = [];
323 3 local $CURRENTOBJ = $obj_name;
324 3 ▶ $states = [ $states ] unless ref $states;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $states 0 3 3
325 3 ▶ if( 'HASH' eq ref $states ) {
Branch: 1 branch
BranchTrueFalseTotal
if ('HASH' eq ref $states) { } 2 1 3
326 2 ▶ while( my( $event, $method ) = each %$states ) {
Branch: 1 branch
BranchTrueFalseTotal
if (() = each %$states) 2 2 4
327 2 push @$ours, ev$event;
328 2 $self->_register_state( $ours->[-1], $object, $method );
329 }
330 }
331 else {
332 1 foreach my $event ( @$states ) {
333 1 push @$ours, ev$event;
334 1 $self->_register_state( $ours->[-1], $object, $event );
335 }
336 }
337 }
338 else {
339 # Make sure there are some states defined for this object's class
340 16 my $ok = 0;
341 16 my $package = ref $object;
342 16 foreach my $handler ( values %{ $self->[SE_STATES] } ) {
343 20 ▶ next unless 'ARRAY' eq ref $handler;
Branch: 1 branch
BranchTrueFalseTotal
unless "ARRAY" eq ref $handler 1 19 20
344 19 ▶ next if blessed $handler->[0] and $handler->[0] ne $object;
Branch: 1 branch
BranchTrueFalseTotal
if builtin::blessed($handler->[0]) and $handler->[0] ne $object 0 19 19
Condition33%1/3
builtin::blessed($handler->[0]) and $handler->[0] ne $object
!ll&&!rl&&r
1900
MC/DC0%0/2
builtin::blessed($handler->[0]) and $handler->[0] ne $object
builtin::blessed($handler->[0]) $handler->[0] ne $object
Truth table33%1/3
A and B
A= builtin::blessed($handler->[0])B= $handler->[0] ne $object
ABresult
0X0
100
111
345 19 ▶ next unless $package eq $handler->[0] or
Branch: 1 branch
BranchTrueFalseTotal
unless $package eq $handler->[0] or $object->isa($handler->[0]) 4 15 19
Condition100%3/3
$package eq $handler->[0] or $object->isa($handler->[0])
l!l&&r!l&&!r
1324
MC/DC100%2/2
$package eq $handler->[0] or $object->isa($handler->[0])
$package eq $handler->[0] $object->isa($handler->[0])
Truth table100%3/3
A or B
A= $package eq $handler->[0]B= $object->isa($handler->[0])
ABresult
1X1
011
000
346 $object->isa( $handler->[0] );
347 15 $ok = 1;
348 15 last;
349 }
350 16 ▶ croak "No package_states defined for package $package" unless $ok;
Branch: 1 branch
BranchTrueFalseTotal
unless $ok 1 15 16
351 }
352 18 $hold->[OH_NAME] = $obj_name;
353 18 $hold->[OH_OBJECT] = $object;
354
355 # greet the object
356 18 ▶ if( $self->_handler_for( $obj_name, "_psm_begin" ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_handler_for($obj_name, "_psm_begin")) 4 14 18
357 4 $poe_kernel->call( $self, evo( $obj_name, "_psm_begin" ) );
358 }
359  
360 18 return 1;
361 }
362  
363 #######################################
364 sub object_unregister
365 11 ▶{
Subroutine object_unregister: called CC=7 SCAR=19.7
Pod documented
366 11 my( $self, $obj_name ) = @_;
367  
368 11 ▶ if( blessed $obj_name ) {
Branch: 1 branch
BranchTrueFalseTotal
if (builtin::blessed($obj_name)) 2 9 11
369 2 $obj_name = $self->_obj_name( $obj_name );
370 }
371 # say good bye the object
372 11 ▶ if( $self->_handler_for( $obj_name, "_psm_end" ) ) {
Branch: 1 branch
BranchTrueFalseTotal
if ($self->_handler_for($obj_name, "_psm_end")) 1 10 11
373 1 $poe_kernel->call( $self, evo( $obj_name, "_psm_end" ) );
374 }
375 11 my $def = delete $self->[SE_OBJECTS]->{ $obj_name };
376 11 ▶ unless( $def ) {
Branch: 1 branch
BranchTrueFalseTotal
unless ($def) 0 11 11
377 0 carp "Attempt to unregister unknown object $obj_name";
378 0 return;
379 }
380  
381 11 $self->[SE_STATERE] = '';
382 11 ▶ return unless $def and $def->[OH_OURS];
Branch: 1 branch
BranchTrueFalseTotal
unless $def and $def->[2] 8 3 11
Condition66%2/3
$def and $def->[2]
!ll&&!rl&&r
083
MC/DC50%1/2
$def and $def->[2]
$def $def->[2]
Truth table66%2/3
A and B
A= $defB= $def->[2]
ABresult
0X0
100
111
383  
384 3 foreach my $event ( @{ $def->[OH_OURS] } ) {
385 3 $self->_register_state( $event );
386 }
387 3 return 1;
388 }
389  
390 #######################################
391 sub object_list
392 2 ▶{
Subroutine object_list: called CC=1 SCAR=0.0
Pod documented
393 2 my( $self ) = @_;
394 2 return keys %{ $self->[SE_OBJECTS] };
395 }
396  
397  
398 #######################################
399 sub package_register
400 2 ▶{
Subroutine package_register: called CC=5 SCAR=16.1
Pod documented
401 2 my( $self, $package, $states ) = @_;
402  
403 2 ▶ $states = [ $states ] unless ref $states;
Branch: 1 branch
BranchTrueFalseTotal
unless ref $states 0 2 2
404 2 ▶ if( 'HASH' eq ref $states ) {
Branch: 1 branch
BranchTrueFalseTotal
if ('HASH' eq ref $states) { } 1 1 2
405 1 ▶ while( my( $event, $method ) = each %$states ) {
Branch: 1 branch
BranchTrueFalseTotal
if (() = each %$states) 1 1 2
406 1 $self->_register_state( $event, $package, $method );
407 }
408 }
409 else {
410 1 foreach my $event ( @$states ) {
411 5 $self->_register_state( $event, $package, $event );
412 }
413 }
414 2 return 1;
415 }
416  
417 6 1;
418  
419  
420 __END__
↑ Summary