This is a short demonstration script which outputs C-class messages from Network Rail's TD feed, or basic information from the train movements feed.
This example includes a rudimentary backoff manager, and the connection will automatically be restarted by OTP when it drops.
You must register an account for the Network Rail data feeds. Verify your email address, then continue.
Note that if you have an account for datafeeds.networkrail.co.uk, you may
need to register an account on the new publicdatafeeds.networkrail.co.uk.
See here
for more information about the data feeds migration.
Create a file named secrets.exs in the config directory. This
file will contain your registered email and password.
For example, if your email address was "[email protected]" and your password
was "hunter2", the contents of the file would be:
import Config
config :networkrailexample,
username: "[email protected]",
password: "hunter2"Make sure you install the dependencies in mix.exs prior to running. You can do this
by opening a terminal in your local copy of this repository, and running mix deps.get
Open a terminal in your local copy of this repository
mix run --no-halt
You can change whether this example outputs TD or TRUST messages depending on
the value of mode in config.exs - :td for TD, :trust for TRUST.
You should now see the printed messages in your terminal.
Durable subscriptions have certain advantages - with a durable subscription, the message queue server will hold messages for a short duration while you reconnect, which reduces the risk you'll miss messages. Unfortunately, while this property is quite desirable, it carries certain availability risks while interacting with the Network Rail feeds via STOMP, due to the interaction between a bug where ActiveMQ may not detect that the STOMP client has disconnected, and an overzealous firewall rule which will block you for several hours if it believes you've attempted to connect while already connected.
For this reason, this example does not use durable subscriptions currently. In order to use them, you would need to pass additional headers when connecting using Barytherium, and when creating the subscription.
See here for more information.
This is licensed under the "MIT No Attribution" licence, a variant of the MIT licence which removes the attribution clause. See LICENCE.txt for more information.