add new ::Stop class for stop data

1 files changed, 122 insertions, 0 deletions

diff --git a/lib/Travel/Status/DE/EFA/Stop.pm b/lib/Travel/Status/DE/EFA/Stop.pm
new file mode 100644
index 0000000..a4b3b61
--- /dev/null
+++ b/lib/Travel/Status/DE/EFA/Stop.pm
@@ -0,0 +1,122 @@
+package Travel::Status::DE::EFA::Stop;
+
+use strict;
+use warnings;
+use 5.010;
+
+no if $] >= 5.018, warnings => 'experimental::smartmatch';
+
+use parent 'Class::Accessor';
+
+our $VERSION = '1.09';
+
+Travel::Status::DE::EFA::Stop->mk_ro_accessors(
+	qw(arr_date arr_time dep_date dep_time name name_suf platform));
+
+sub new {
+	my ( $obj, %conf ) = @_;
+
+	my $ref = \%conf;
+
+	return bless( $ref, $obj );
+}
+
+sub TO_JSON {
+	my ($self) = @_;
+
+	return { %{$self} };
+}
+
+1;
+
+__END__
+
+=head1 NAME
+
+Travel::Status::DE::EFA::Stop - Information about a stop (station) contained
+in a Travel::Status::DE::EFA::Result's route
+
+=head1 SYNOPSIS
+
+    for my $stop ($departure->route_post) {
+        printf(
+            "%s -> %s : %40s %s\n",
+            $stop->arr_time // q{     }, $stop->dep_time // q{     },
+            $stop->name, $stop->platform
+        );
+    }
+
+=head1 VERSION
+
+version 1.09
+
+=head1 DESCRIPTION
+
+Travel::Status::DE::EFA::stop describes a TODO.
+
+=head1 METHODS
+
+=head2 ACCESSORS
+
+TODO
+
+=over
+
+=item $stop->arr_date
+
+=item $stop->arr_time
+
+=item $stop->dep_date
+
+=item $stop->dep_time
+
+=item $stop->name
+
+=item $stop->name_suf
+
+=item $stop->platform
+
+=back
+
+=head2 INTERNAL
+
+=over
+
+=item $stop = Travel::Status::DE::EFA::Stop->new(I<%data>)
+
+Returns a new Travel::Status::DE::EFA::Stop object.  You should not need to
+call this.
+
+=item $stop->TO_JSON
+
+Allows the object data to be serialized to JSON.
+
+=back
+
+=head1 DIAGNOSTICS
+
+None.
+
+=head1 DEPENDENCIES
+
+=over
+
+=item Class::Accessor(3pm)
+
+=back
+
+=head1 BUGS AND LIMITATIONS
+
+None known.
+
+=head1 SEE ALSO
+
+Travel::Status::DE::EFA(3pm).
+
+=head1 AUTHOR
+
+Copyright (C) 2015 by Daniel Friesel E<lt>derf@finalrewind.orgE<gt>
+
+=head1 LICENSE
+
+This module is licensed under the same terms as Perl itself.