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
218
|
# db-iris - Commandline Client for DB IRIS Departure Monitor
**db-iris** is a commandline client and Perl module for the DB IRIS departure
monitor located at iris.noncd.db.de. See the [Travel::Status::DE::IRIS
homepage](https://finalrewind.org/projects/Travel-Status-DE-IRIS/) for details.
It provides both human- and machine-readable access to departure data at german
train stations via text and JSON output.
## Installation
You have five installation options:
* `.deb` releases for Debian-based distributions
* finalrewind.org APT repository for Debian-based distributions
* Installing the latest release from CPAN
* Installation from source
* Using a Docker image
Except for Docker, **db-iris** is available in your PATH after installation.
You can run `db-iris --version` to verify this. Documentation is available via
`man db-iris`.
### Release Builds for Debian
[lib.finalrewind.org/deb](https://lib.finalrewind.org/deb) provides Debian
packages of all release versions. Note that these are not part of the official
Debian repository and are not covered by its quality assurance process.
To install the latest release, run:
```
wget https://lib.finalrewind.org/deb/libtravel-status-de-iris-perl_latest_all.deb
sudo apt install ./libtravel-status-de-iris-perl_latest_all.deb
rm libtravel-status-de-iris-perl_latest_all.deb
```
Uninstallation works as usual:
```
sudo apt remove libtravel-status-de-iris-perl
```
### finalrewind.org APT repository
[lib.finalrewind.org/apt](https://lib.finalrewind.org/apt) provides an APT
repository with Debian packages of the latest release versions. Note that this
is not a Debian repository; it is operated under a best-effort SLA and if you
use it you will have to trust me not to screw up your system with bogus
packages. Also, note that the packages are not part of the official Debian
repository and are not covered by its quality assurance process.
To set up the repository and install the latest Travel::Status::DE::IRIS
release, run:
```
curl -s https://finalrewind.org/apt.asc | sudo tee /etc/apt/trusted.gpg.d/finalrewind.asc
echo 'deb https://lib.finalrewind.org/apt stable main' | sudo tee /etc/apt/sources.list.d/finalrewind.list
sudo apt update
sudo apt install libtravel-status-de-iris-perl
```
Afterwards, `apt update` and `apt upgrade` will automatically install new
Travel::Status::DE::IRIS releases.
Uninstallation of Travel::Status::DE::IRIS works as usual:
```
sudo apt remove libtravel-status-de-iris-perl
```
To remove the APT repository from your system, run:
```
sudo rm /etc/apt/trusted.gpg.d/finalrewind.asc \
/etc/apt/sources.list.d/finalrewind.list
```
### Installation from CPAN
Travel::Status::DE::IRIS releases are published on the Comprehensive Perl
Archive Network (CPAN) and can be installed using standard Perl module tools
such as `cpanminus`.
Before proceeding, ensure that you have standard build tools (i.e. make,
pkg-config and a C compiler) installed. You will also need the following
libraries with development headers:
* libdb
* libssl
* libxml2
* zlib
Now, use a tool of your choice to install the module. Minimum working example:
```
cpanm Travel::Status::DE::IRIS
```
If you run this as root, it will install script and module to `/usr/local` by
default.
### Installation from Source
In this variant, you must ensure availability of dependencies by yourself.
You may use carton or cpanminus with the provided `Build.PL`, Module::Build's
installdeps command, or rely on the Perl modules packaged by your distribution.
On Debian 10+, all dependencies are available from the package repository.
To check whether dependencies are satisfied, run:
```
perl Build.PL
```
If it complains about "... is not installed" or "ERRORS/WARNINGS FOUND IN
PREREQUISITES", it is missing dependencies.
Once all dependencies are satisfied, use Module::Build to build, test and
install the module. Testing is optional -- you may skip the "Build test"
step if you like.
If you downloaded a release tarball, proceed as follows:
```
./Build
./Build test
sudo ./Build install
```
If you are using the Git repository, use the following commands:
```
./Build
./Build manifest
./Build test
sudo ./Build install
```
If you do not have superuser rights or do not want to perform a system-wide
installation, you may leave out `Build install` and use **db-iris** from the
current working directory instead.
With carton:
```
carton exec db-iris --version
```
Otherwise (also works with carton):
```
perl -Ilocal/lib/perl5 -Ilib bin/db-iris --version
```
### Running db-iris via Docker
A db-iris image is available on Docker Hub. It is intended for testing
purposes: due to the latencies involved in spawning a container for each
db-iris invocation, and the lack of persistent caching, it is less convenient
for day-to-day usage.
Installation:
```
docker pull derfnull/db-iris:latest
```
Use it by prefixing db-iris commands with `docker run --rm
derfnull/db-iris:latest`, like so:
```
docker run --rm derfnull/db-iris:latest --version
```
Documentation is not available in this image. Please refer to the
[online db-iris manual](https://man.finalrewind.org/1/db-iris/) instead.
## Managing stations
Travel::Status::DE::IRIS needs a list of train stations to operate, which is
located in `share/stations.json`. There are two recommended editing methods.
Automatic method, e.g. to incorporate changes from Open Data sources:
* modify stations.json with a script in any JSON-aware language you like
* run `./json2json` in the share diretcory. This performs consistency checks and
transforms stations.json into its canonical format, which simplifies tracking
of changes and reduces diff size
Manual method:
* run `./json2csv` in the share directory
* modify stations.csv automatically or manually (e.g. with LibreOffice Calc)
* run `./csv2json` in the share directory
If the changes you made are suitable for inclusion in Travel::Status::DE::IRIS,
please [open a pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request-from-a-fork) afterwards.
Please only include stations which are usable with DB IRIS, that is, which have
both DS100 and EVA numbers. If
```
curl -s https://iris.noncd.db.de/iris-tts/timetable/station/EVANUMBER
```
and
```
curl -s https://iris.noncd.db.de/iris-tts/timetable/station/DS100
```
return a `<station>` element with "name", "eva" and "ds100" attributes, you're
good to go.
Note that although EVA numbers are often identical with UIC station IDs, this
is not always the case. Please do not rely on UIC IDs when managing stations.
|
