blib/lib/Games/Tournament/Contestant/Swiss.pm

filter: Statementstmt 70.0% 75 / 107 Branchbran 63.1% 24 / 38 Conditioncond 71.4% 15 / 21 MC/DCmcdc 35.7% 5 / 14 Subroutinesub 84.2% 16 / 19 Podpod 100% 11 / 11 totaltotal 69.5% 146 / 210 CC 29 SCAR 17.9
CC
29
Cov
69%
opponents
12.0
unbyable
12.0
roles
9.1
CRAP 6.0
« blib/lib/Games/Tournament/Swiss/Config.pm ↑ Summary blib/lib/Games/Tournament/Swiss/Procedure/Dummy.pm »
1 package Games::Tournament::Contestant::Swiss;
2 33 $Games::Tournament::Contestant::Swiss::VERSION = '0.21';
3 # Last Edit: 2011 2月 27, 21時32分54秒
4 # $Id: $
5  
6 33 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
7 33 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
8  
9 33 ▶use List::MoreUtils qw/any/;
Subroutine BEGIN: called CC=1 SCAR=0.0
10  
11 33 ▶use Games::Tournament::Swiss::Config;
Subroutine BEGIN: called CC=1 SCAR=0.0
12 33 ▶use constant ROLES => @Games::Tournament::Swiss::Config::roles?
Subroutine BEGIN: called CC=2 SCAR=6.9
Branch: 1 branch
BranchTrueFalseTotal
@Games::Tournament::Swiss::Config::roles ? : 29 4 33
13 @Games::Tournament::Swiss::Config::roles:
14 33 Games::Tournament::Swiss::Config->roles;
15  
16 33 ▶use base qw/Games::Tournament::Contestant/;
Subroutine BEGIN: called CC=1 SCAR=0.0
17  
18 # use overload qw/0+/ => 'pairingNumber', qw/""/ => 'name', fallback => 1;
19  
20 =head1 NAME
21  
22 Games::Tournament::Contestant::Swiss A competitor in a FIDE-Swiss-Rules event
23  
24 =cut
25  
26 =head1 SYNOPSIS
27  
28 my $foo = Games::Tournament::Contestant::Swiss->new( rating => '15', name => 'Deep Blue', pairingNumber => 2 );
29 ...
30  
31 =head1 DESCRIPTION
32  
33 Subclasses Games::Tournament::Contestant with Games::Tournament::Swiss-specific data and methods, like pairingNumber, floats.
34  
35 Games::Tournament::Swiss will use this class when constructing a 'Bye' contestant.
36  
37 =head1 METHODS
38  
39 =head2 new
40  
41 Games::Tournament::Contestant::Swiss->new( rating => '15',
42 name => 'Red Chessman', pairingNumber => 2,
43 floats => [qw/Not Down Not Not],
44 roles => [qw/Black White Black White/] );
45  
46 Actually, you don't want to assign pairing numbers this way. Let the assignPairingNumbers method in Games::Tournament::Swiss do it. The player gets a default mild preference for neither role.
47  
48 =cut
49  
50 1869 ▶sub new() {
Subroutine new: called CC=1 SCAR=0.0
Pod documented
51 1869 my $self = shift;
52 1869 my %args = @_;
53 # $args{roles} = [] unless $args{roles};
54 1869 my $object = bless \%args, $self;
55 1869 $object->preference(
56 Games::Tournament::Contestant::Swiss::Preference->new );
57 1869 return $object;
58 }
59  
60  
61 =head2 preference
62  
63 $member->preference
64  
65 Gets (sets) $member's preference, or right (duty) to take a role, eg White or Black, in the next round, calculated as a function of the difference between the number of games previously played in the different roles, and accommodated according to its value, Mild, Strong, or Absolute. An Absolute preference of +2 for White is given when the contestant has played 2 (or a larger number) more of the previous rounds as Black than as White, or when the last 2 rounds were played as Black. A Strong preference of +1 for White represents having played one more round as Black than as White. A Mild preference of +0 occurs when the number of games played with both colors is the same, but the last game was played as Black. A Mild preference of -0 is the same, but with the last game being as White, the preference is for Black. Preferences of -1 and -2 represent the same situations as for +1 and +2, but with the roles reversed. Before the first round, the preference of the highest ranked player (+-0) is determined by lot. A7
66  
67 =cut
68  
69 46960 ▶sub preference {
Subroutine preference: called CC=2 SCAR=7.0
Pod documented
70 46960 my $self = shift;
71 46960 ▶ my $preference = shift() || $self->{preference};
Condition66%2/3
shift() || $self->{'preference'}
l!l&&r!l&&!r
5210417500
MC/DC0%0/2
shift() || $self->{'preference'}
shift() $self->{'preference'}
Truth table66%2/3
A || B
A= shift()B= $self->{'preference'}
ABresult
1X1
011
000
72 46960 $self->{preference} = $preference;
73 46960 return $preference;
74 }
75  
76  
77 =head2 pairingNumber
78  
79 $member->pairingNumber(1)
80  
81 Sets/gets the pairing number of the contestant, used to identify participants when pairing them with others. This index is assigned in order of a sorting of the participants by ranking, title and name. You know what you're doing with this number, don't you?
82  
83 =cut
84  
85 39991 ▶sub pairingNumber {
Subroutine pairingNumber: called CC=2 SCAR=6.9
Pod documented
86 39991 my $self = shift;
87 39991 ▶ $self->{pairingNumber} = shift if @_;
Branch: 1 branch
BranchTrueFalseTotal
if @_ 1643 38348 39991
88 39991 $self->{pairingNumber};
89 }
90  
91  
92 =head2 oldId
93  
94 $member->oldId
95  
96 Sets/gets an original, possibly unreliable id of the contestant, supplied by the user.
97  
98 =cut
99  
100 16 ▶sub oldId {
Subroutine oldId: called CC=3 SCAR=13.3
Pod documented
101 16 my $self = shift;
102 16 my $oldId = shift;
103 0 ▶ if ( defined $oldId ) { $self->{oldId} = $oldId; }
Branch: 2 branches
BranchTrueFalseTotal
if (defined $oldId) { } 0 16 16
elsif ($self->{'oldId'}) { } 0 16 16
104 0 elsif ( $self->{oldId} ) { return $self->{oldId}; }
105 }
106  
107 =head2 opponents
108  
109 $member->opponents( 0, 5, 11 )
110 $rolehistory = $member->opponents
111  
112 If ids are passed, adds them to the end of the list representing the latest opponents that $member has had in this tournament. (Normally one and only one parameter, the id of the opponent in the latest round, will be passed.) If no parameter is passed, returns a reference to the list. If the member had no game or played no game, because of a bye, or no result, or was unpaired, pass 'Bye' or 'Forfeit' or 'Unpaired'.
113  
114 =cut
115  
116 0 ▶sub opponents {
Subroutine opponents: not called CC=3 SCAR=24.8
Pod documented
117 0 my $self = shift;
118 0 my @opponents = @_;
119 0 ▶ if ( @opponents ) { push @{ $self->{opponents} }, @opponents; return }
Branch: 2 branches
BranchTrueFalseTotal
if (@opponents) { } 0 0 0
elsif ($self->{'opponents'}) { } 0 0 0
120 0 elsif ( $self->{opponents} ) { return $self->{opponents}; }
121 0 else { return []; }
122 }
123  
124  
125 =head2 roles
126  
127 $member->roles( 1, 'Black' )
128 $member->roles( 1 ) # 'Black'
129 $rolehistory = $member->roles # { 1 => 'Black' }
130  
131 If a round and role are passed, adds them to the roles that $member has had in this tournament. If the member had no game (or had a game but didn't play it), that is, if they had a bye, or no result, or were unpaired, pass 'Bye', or 'Forfeit', or 'Unpaired.' F2,3
132  
133 =cut
134  
135 2456 ▶sub roles {
Subroutine roles: called CC=8 SCAR=22.1
Pod documented
136 2456 my $self = shift;
137 2456 my $round = shift;
138 2456 my $role = shift;
139 2456 ▶ if ( defined $role and defined $round ) {
Branch: 3 branches
BranchTrueFalseTotal
if (defined $role and defined $round) { } 660 1796 2456
elsif ($self->{'roles'} and $round) { } 0 1796 1796
elsif ($self->{'roles'}) { } 1552 244 1796
Condition66%2/3
defined $role and defined $round
!ll&&!rl&&r
17960660
MC/DC50%1/2
defined $role and defined $round
defined $role defined $round
Truth table66%2/3
A and B
A= defined $roleB= defined $round
ABresult
0X0
100
111
140 660 my $oldrole = $self->{roles}->{$round};
141 660 ▶ warn "$oldrole role replaced by $role" if defined $oldrole and
Branch: 1 branch
BranchTrueFalseTotal
if defined $oldrole and $oldrole ne $role 0 660 660
Condition33%1/3
defined $oldrole and $oldrole ne $role
!ll&&!rl&&r
66000
MC/DC0%0/2
defined $oldrole and $oldrole ne $role
defined $oldrole $oldrole ne $role
Truth table33%1/3
A and B
A= defined $oldroleB= $oldrole ne $role
ABresult
0X0
100
111
142 $oldrole ne $role;
143 660 $self->{roles}->{$round} = $role;
144 }
145 0 ▶ elsif ( $self->{roles} and $round ) { return $self->{roles}->{$round}; }
Condition66%2/3
$self->{"roles"} and $round
!ll&&!rl&&r
24415520
MC/DC0%0/2
$self->{"roles"} and $round
$self->{"roles"} $round
Truth table66%2/3
A and B
A= $self->{"roles"}B= $round
ABresult
0X0
100
111
146 1552 elsif ( $self->{roles} ) { return $self->{roles}; }
147 244 else { return {}; }
148 }
149  
150  
151 =head2 rolesPlayedList
152  
153 A list, in round order, of the roles played against other players. Byes and other non-partnership roles are not included.
154  
155 =cut
156  
157 1136 ▶sub rolesPlayedList {
Subroutine rolesPlayedList: called CC=1 SCAR=0.0
Pod documented
158 1136 my $self = shift;
159 1136 my $roles = $self->roles;
160 1136 my @rounds = sort { $a <=> $b } keys %$roles;
161 1136 my $last = $rounds[-1];
162 1136 my @playrounds = grep { my $role = $roles->{$_};
163 3050 ▶ any { $role eq $_ } ROLES } @rounds;
Subroutine __ANON__: called CC=1 SCAR=0.0
164 1136 my @playroles = map { $roles->{$_} } @playrounds;
165 1136 return \@playroles;
166 }
167  
168  
169 =head2 floating
170  
171 $member->floating
172 $member->floating( 'Up'|'Down'|'' )
173  
174 Sets/gets the direction in which the contestant is floating in the next round, "Up", "Down". If nothing is returned, the contestant is not floating. A4
175  
176 =cut
177  
178 2323 ▶sub floating {
Subroutine floating: called CC=4 SCAR=13.9
Pod documented
179 2323 my $self = shift;
180 2323 my $direction = shift;
181 2323 ▶ if ( defined $direction and $direction =~ m/^(?:Up|Down|)$/ ) {
Branch: 2 branches
BranchTrueFalseTotal
if (defined $direction and $direction =~ /^(?:Up|Down|)$/) { } 1235 1088 2323
elsif ($self->{'floater'}) { } 362 726 1088
Condition100%3/3
defined $direction and $direction =~ /^(?:Up|Down|)$/
!ll&&!rl&&r
8122761235
MC/DC100%2/2
defined $direction and $direction =~ /^(?:Up|Down|)$/
defined $direction $direction =~ /^(?:Up|Down|)$/
Truth table100%3/3
A and B
A= defined $directionB= $direction =~ /^(?:Up|Down|)$/
ABresult
0X0
100
111
182 1235 $self->{floater} = $direction;
183 }
184 362 elsif ( $self->{floater} ) { return $self->{floater}; }
185 }
186  
187 =head2 floats
188  
189 $member->floats( $round, 'Down' )
190 $rolehistory = $member->floats
191  
192 If a round number and float is passed, inserts this in an anonymous array representing the old floats that $member has had in this tournament. If only a round is passed, returns the float for that round. If no parameter is passed, returns a anonymous array of all the floats ordered by the round. If the player was not floated, pass 'Not'. For convenience, if -1 or -2 are passed for the last round before, or the round 2 rounds ago, and those rounds do not exist (perhaps the tournament only started one round before), 'Not' is returned.
193  
194 =cut
195  
196  
197 2721 ▶sub floats {
Subroutine floats: called CC=8 SCAR=21.2
Pod documented
198 2721 my $self = shift;
199 2721 my $round = shift;
200 2721 my $float = shift;
201 2721 ▶ if ( defined $round and defined $float ) {
Branch: 3 branches
BranchTrueFalseTotal
if (defined $round and defined $float) { } 660 2061 2721
elsif (defined $round) { } 2035 26 2061
elsif ($self->{'floats'}) { } 26 0 26
Condition100%3/3
defined $round and defined $float
!ll&&!rl&&r
262035660
MC/DC100%2/2
defined $round and defined $float
defined $round defined $float
Truth table100%3/3
A and B
A= defined $roundB= defined $float
ABresult
0X0
100
111
202 660 $self->{floats}->[$round-1] = $float;
203 660 return;
204 }
205 elsif ( defined $round ) {
206 2035 ▶ if ($round == -1 or $round == -2) {
Branch: 1 branch
BranchTrueFalseTotal
if ($round == -1 or $round == -2) { } 2035 0 2035
Condition66%2/3
$round == -1 or $round == -2
l!l&&r!l&&!r
10689670
MC/DC0%0/2
$round == -1 or $round == -2
$round == -1 $round == -2
Truth table66%2/3
A or B
A= $round == -1B= $round == -2
ABresult
1X1
011
000
207 2035 ▶ if (not exists $self->{floats}->[$round-1] ) {return 'Not'}
Branch: 1 branch
BranchTrueFalseTotal
if (not exists $self->{'floats'}[$round - 1]) { } 666 1369 2035
208 1369 else { return $self->{floats}->[$round]; }
209 }
210 0 else { return $self->{floats}->[$round-1]; }
211 }
212 26 elsif ( $self->{floats} ) { return $self->{floats}; }
213 0 else { return; }
214 }
215  
216 =head2 importPairtableRecord
217  
218 $member->importPairtableRecord(
219 { opponents => [ 6,4 ]
220 roles => [ 'Win', 'Loss' ],
221 floats => [ undef, 'Not', 'Down' ],
222 score => 1.5 } )
223  
224 Populate $member with data about opponents met, roles played, and floats received in previous rounds, which together with the total score will allow it to be paired with an appropriate opponent in the next round. Set $member's preference. Delete any pre-existing opponents, roles, floats, scores, score, or preference data.
225  
226 =cut
227  
228  
229 0 ▶sub importPairtableRecord {
Subroutine importPairtableRecord: not called CC=3 SCAR=20.3
Pod documented
230 0 my $self = shift;
231 0 my $record = shift;
232 #die $self->name . ", " . $self->id . " pairtable record field lengths"
233 # unless @{$record->{opponents}} == @{$record->{roles}} and
234 # @{$record->{roles}} == @{$record->{floats}} - 1;
235 0 my ($opponents, $roles, $floats) = @$record{qw/opponents roles floats/};
236 0 delete @$self{qw/opponents roles floats scores score preference/};
237 0 $self->opponents(@$opponents);
238 0 $self->roles(@$roles);
239 0 for my $i ( 0 .. $#$floats ) { $self->floats( $i, $floats->[$i] ); }
240 33 ▶ use Games::Tournament::Contestant::Swiss::Preference;
Subroutine BEGIN: called CC=1 SCAR=0.0
241 0 $self->preference(Games::Tournament::Contestant::Swiss::Preference->new);
242 0 $self->preference->update( [ @$roles[0..$_] ] ) for 0.. $#$roles;
243 0 $self->{score} = $record->{score};
244 0 return;
245 }
246  
247 =head2 unbyable
248  
249 $member->unbyable(1)
250 return BYE unless $member->unbyable
251  
252 A flag of convenience telling you whether to let this player have the bye. Am I doing the right thing here? This will be gettable and settable, but will it be reliable?
253  
254 =cut
255  
256 0 ▶sub unbyable {
Subroutine unbyable: not called CC=3 SCAR=24.8
Pod documented
257 0 my $self = shift;
258 0 my $unbyable = shift;
259 0 ▶ if ( $unbyable ) { $self->{unbyable} = 1; return }
Branch: 2 branches
BranchTrueFalseTotal
if ($unbyable) { } 0 0 0
elsif (defined $self->{'unbyable'}) { } 0 0 0
260 0 elsif ( defined $self->{unbyable} ) { return $self->{unbyable}; }
261 0 else { return; }
262 }
263  
264  
265 =head1 AUTHOR
266  
267 Dr Bean, C<< <drbean, followed by the at mark (@), cpan, then a dot, and finally, org> >>
268  
269 =head1 BUGS
270  
271 Please report any bugs or feature requests to
272 C<bug-games-tournament-contestant at rt.cpan.org>, or through the web interface at
273 L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Games-Tournament-Contestant-Swiss>.
274 I will be notified, and then you'll automatically be notified of progress on
275 your bug as I make changes.
276  
277 =head1 SUPPORT
278  
279 You can find documentation for this module with the perldoc command.
280  
281 perldoc Games::Tournament::Contestant::Swiss
282  
283 You can also look for information at:
284  
285 =over 4
286  
287 =item * AnnoCPAN: Annotated CPAN documentation
288  
289 L<http://annocpan.org/dist/Games-Tournament-Contestant-Swiss>
290  
291 =item * CPAN Ratings
292  
293 L<http://cpanratings.perl.org/d/Games-Tournament-Contestant-Swiss>
294  
295 =item * RT: CPAN's request tracker
296  
297 L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Games-Tournament-Contestant-Swiss>
298  
299 =item * Search CPAN
300  
301 L<http://search.cpan.org/dist/Games-Tournament-Contestant-Swiss>
302  
303 =back
304  
305 =head1 ACKNOWLEDGEMENTS
306  
307 =head1 COPYRIGHT & LICENSE
308  
309 Copyright 2006 Dr Bean, all rights reserved.
310  
311 This program is free software; you can redistribute it and/or modify it
312 under the same terms as Perl itself.
313  
314 =cut
315  
316 33 1; # End of Games::Tournament::Contestant::Swiss
317  
318 # vim: set ts=8 sts=4 sw=4 noet:
« blib/lib/Games/Tournament/Swiss/Config.pm ↑ Summary blib/lib/Games/Tournament/Swiss/Procedure/Dummy.pm »