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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
package Travel::Routing::DE::VRR::Route::Part;
use strict;
use warnings;
use 5.010;
use parent 'Class::Accessor';
our $VERSION = '2.00';
Travel::Routing::DE::VRR::Route::Part->mk_ro_accessors(
qw(arrival_platform arrival_stop
arrival_date arrival_time arrival_sdate arrival_stime
delay departure_platform departure_stop
departure_date departure_time departure_sdate departure_stime
train_line train_destination
)
);
sub new {
my ( $obj, %conf ) = @_;
my $ref = \%conf;
return bless( $ref, $obj );
}
sub arrival_stop_and_platform {
my ($self) = @_;
if ( length( $self->arrival_platform ) ) {
return
sprintf( '%s: %s', $self->get(qw(arrival_stop arrival_platform)) );
}
return $self->arrival_stop;
}
sub departure_stop_and_platform {
my ($self) = @_;
if ( length( $self->departure_platform ) ) {
return
sprintf( '%s: %s',
$self->get(qw(departure_stop departure_platform)) );
}
return $self->arrival_stop;
}
sub extra {
my ($self) = @_;
return @{ $self->{extra} // [] };
}
sub via {
my ($self) = @_;
return @{ $self->{via} // [] };
}
1;
__END__
=head1 NAME
Travel::Routing::DE::VRR::Route::Part - Describes one connection between two
points, without interchanges
=head1 SYNOPSIS
for my $part ( $route->parts ) {
if ( $part->extra ) {
say join( "\n", $part->extra );
}
printf(
"%s at %s -> %s at %s, via %s to %s",
$part->departure_time, $part->departure_stop,
$part->arrival_time, $part->arrival_stop,
$part->train_line, $part->train_destination,
);
}
=head1 VERSION
version 2.00
=head1 DESCRIPTION
B<Travel::Routing::DE::VRR::Route::Part> holds one specific connection (without
interchanges) between two points. It specifies the start/stop point and time,
the train line and its destination, and optional additional data.
It is usually obtained by a call to Travel::Routing::DE::VRR::Route(3pm)'s
B<parts> method.
=head1 METHODS
=head2 ACCESSORS
"Actual" in the description means that the delay (if available) is already
included in the calculation, "Scheduled" means it isn't.
=over
=item $part->arrival_stop
arrival stop (city name plus station name)
=item $part->arrival_platform
arrival platform (either "Gleis x" or "Bstg. x")
=item $part->arrival_stop_and_platform
"stop: platform" concatenation
=item $part->arrival_date
Actual arrival date in DD.MM.YYYY format
=item $part->arrival_time
Actual arrival time in HH:MM format
=item $part->arrival_sdate
Scheduled arrival date in DD.MM.YYYY format
=item $part->arrival_stime
Scheduled arrival time in HH:MM format
=item $part->delay
delay in minutes, 0 if unknown
=item $part->departure_stop
departure stop (city name plus station name)
=item $part->departure_platform
departure platform (either "Gleis x" or "Bstg. x")
=item $part->departure_stop_and_platform
"stop: platform" concatenation
=item $part->departure_date
Actual departure date in DD.MM.YYYY format
=item $part->departure_time
Actual departure time in HH:MM format
=item $part->departure_sdate
Scheduled departure date in DD.MM.YYYY format
=item $part->departure_stime
Scheduled departure time in HH:MM format
=item $part->extra
Additional information about the connection. Returns a list of
newline-terminated strings
=item $part->train_destination
destination of the line providing the connection
=item $part->train_line
name / number of the line
=item $part->via
List of stops passed between departure_stop and arrival_stop, as
C<< [ "DD.MM.YYYY", "HH:MM", stop, platform ] >> hashrefs.
May be empty, these are not always reported by efa.vrr.de.
=back
=head1 DIAGNOSTICS
None.
=head1 DEPENDENCIES
=over
=item * Class::Accessor(3pm)
=back
=head1 BUGS AND LIMITATIONS
$part->via does not work reliably.
=head1 SEE ALSO
Travel::Routing::DE::VRR(3pm), Class::Accessor(3pm).
=head1 AUTHOR
Copyright (C) 2011 by Daniel Friesel E<lt>derf@finalrewind.orgE<gt>
=head1 LICENSE
0. You just DO WHAT THE FUCK YOU WANT TO.
|
