feat(rail): add a Rail layer with keyless live trains

Live trains from 30 keyless operator feeds: GPS positions from 29 and
Irish Rail's station reports, shown as the operators publish them. 28
work out of the box; Renfe long and medium distance and KTMB appear once
their pack is built, because their vehicles name no route.

Packs are opt-in (scripts/build-rail-paths.mjs): the operator's own
route lines, stop names, next stops and trip-update delays for live
trains. Nothing downloads when the app starts, no train is placed from a
timetable, and no request carries a deployer's key.
This commit is contained in:
Denis Groshev committed 2026-11-11 16:06:22 +01:00
1 parent 14db73f201
commit 830c080803
114 files changed
+26639 -26

No files matched your search

+86
View File
@@ -0,0 +1,86 @@
// France (2026-11-10): the Bordeaux and Montpellier tram networks, from
// transport.data.gouv.fr. Registered, switched on with the dataset's licence
// field quoted, polled for live positions, and sorted into categories; no
// registry URL is on a download path its host's robots.txt disallows.
import test from 'node:test';
import assert from 'node:assert/strict';
import {
RAIL_FEED_REGISTRY,
classifyTrain,
getRailFeed,
getRegisteredRailFeed,
railFeedHasTripUpdates,
railFeedPositions,
} from './railFeeds.js';
const kind = (id, routeId) => {
const train = classifyTrain(getRegisteredRailFeed(id), routeId);
return train ? `${train.category}/${train.mode}` : null;
};
const FR_FEEDS = ['tbm-bordeaux', 'tam-montpellier'];
// ------------------------------------------------------------ registry
test('the French feeds are on and quote the dataset licence field', () => {
for (const id of FR_FEEDS) {
const feed = getRegisteredRailFeed(id);
assert.ok(feed, `${id} is registered`);
assert.ok(getRailFeed(id), `${id} is pollable`);
assert.equal(feed.defaultEnabled, true, id);
assert.match(feed.staticGtfsUrl, /^https:\/\//, id);
assert.ok(['lov2', 'odc-odbl', 'fr-lo'].includes(feed.terms.quote), id);
assert.match(feed.terms.note, /transport\.data\.gouv\.fr dataset "/, id);
assert.match(feed.terms.note, /2026-11-10/, id);
}
});
test('the ODbL dataset carries the share-alike note and the access point conditions', () => {
const feed = getRegisteredRailFeed('tam-montpellier');
assert.equal(feed.license, 'ODbL 1.0');
assert.match(feed.terms.note, /share-alike/);
assert.match(feed.terms.note, /dans le format d'origine/);
assert.equal(
getRegisteredRailFeed('tbm-bordeaux').license,
'Licence Ouverte / Open Licence 1.0',
);
});
test('positions: Bordeaux and Montpellier trams are GPS, with trip updates', () => {
for (const id of FR_FEEDS) {
assert.equal(railFeedPositions(getRegisteredRailFeed(id)), 'gps', id);
assert.ok(railFeedHasTripUpdates(getRegisteredRailFeed(id)), id);
}
});
// ------------------------------------------------------------ categories
test('tram lines are transit; buses are dropped', () => {
const cases = [
['tbm-bordeaux', '164', 'transit/tram'],
['tbm-bordeaux', '901', null],
['tam-montpellier', '5', 'transit/tram'],
['tam-montpellier', 'A', null],
];
for (const [id, route, expected] of cases)
assert.equal(kind(id, route), expected, `${id} ${route}`);
});
// ------------------------------------------------------------ download
// Hosts whose robots.txt disallows the download paths French publishers use.
const DISALLOWED = [
/^https:\/\/eu\.ftp\.opendatasoft\.com\//,
/^https:\/\/thello\.axelor\.com\//,
/^https:\/\/static\.data\.gouv\.fr\/resources\//,
/^https:\/\/www\.data\.gouv\.fr\/(fr\/)?(api\/1\/)?datasets\/r\//,
/\/explore\/dataset\/.*\/download/,
];
test('no registry URL is on a download path its robots.txt disallows', () => {
for (const feed of RAIL_FEED_REGISTRY)
for (const url of [feed.url, feed.tripUpdatesUrl, feed.staticGtfsUrl])
if (url)
for (const pattern of DISALLOWED)
assert.ok(!pattern.test(url), `${feed.id} ${url}`);
});