derhuerst/gtfs-linked-connections-server

[work in progress] – A Linked Connections server using PostgreSQL to serve GTFS.

gtfs-linked-connections-server

A Linked Connections server using PostgreSQL to serve GTFS.

Note: This projects follows the Linked Connections 2.0 draft as of 2020-03-18.

Installation

npm install derhuerst/gtfs-linked-connections-server # install from GitHub

Usage

Follow gtfs-via-postgres' instructions on importing data. Make sure to use the --stops-location-index flag.

psql -c 'create database gtfs'
export PGDATABASE=gtfs

# import GTFS into PostgreSQL
npm install -D gtfs-via-postgres
npm exec -- gtfs-to-sql --require-dependencies -- gtfs/*.txt | psql -b

Then serve the imported data as Linked Connections via HTTP:

# start HTTP server that serves Linked Connections
npm install gtfs-linked-connections-server
npm exec -- serve-gtfs-as-lc

Contributing

If you have a question or need support using gtfs-linked-connections-server, please double-check your code and setup first. If you think you have found a bug or want to propose a feature, use the issues page.

gtfs-linked-connections-server's Issues

add basic CLI

A basic serve-gtfs-as-lc CLI would prevent users from writing wrapper Node.js scripts.

mri is a good candidate for process.argv parsing.

add Memento support?

Given that TREE allows linking to historical versions of a dataset (or time-series data), this is not strictly necessary, but I think it would be helpful to have support for Memento HTTP headers.

refactor serve-linked-connections into serve-linked-tree

Building this prototype, I realised that the lib/serve-linked-connections abstraction (initiated by linkedconnections/linked-connections-server#53 (comment)) should actually be a "I'll find data, make me a TREE endpoint" abstraction.

I should

1. refactor lib/serve-linked-connections into lib/serve-linked-tree,
2. finish this prototype to make sure this API is ergonomic,
3. pull out lib/serve-linked-tree into it's own repo/package, so that other projects can re-use it.

implement other RDF serialisations

gtfs-linked-connections-server/lib/serve-linked-connections.js

Lines 10 to 13 in 51a5d7b

	const supportedMimeTypes = [
	'application/ld+json',
	// todo: support more: https://github.com/linkedconnections/linked-connections-server/blob/aad9de79d2d2b61fe5ca2c24da31961a4d8e9b42/lib/routes/page-finder.js#L250-L279
	]

https://github.com/linkedconnections/linked-connections-server/blob/aad9de79d2d2b61fe5ca2c24da31961a4d8e9b42/lib/routes/page-finder.js#L250-L279