gtfs-to-pouch

Scripts to convert GTFS files to a PouchDB database,

Transit data is commonly stored in the GTFS format. This script can unzip it and store it in PouchDB databases. These can later be queried with query-pouch-gtfs.

API

function parseGTFS(
	inputFile: string | NodeJS.ReadableStream | Buffer,
	destinations: string | { [P in keyof DatabaseList]: DatabaseList[P] | string },
): Promise<void>

Parses a GTFS zip file and saves the data into multiple PouchDB databases.

• inputFile: Either a path to a GTFS file or folder, or a stream/buffer representing zip contents
• destinations: Either a path to a folder containing the databases, or an object specifying paths for each database explicitly.

function parseGTFSPartial(
	partialFile: string,
	destination: string | PouchDB.Database<any>,
): Promise<void>
function parseGTFSPartial(
	partialFile: NodeJS.ReadableStream,
	partialName: string,
	destination: string | PouchDB.Database<any>,
): Promise<void>

Parses a single GTFS partial, rather than the entire ZIP file.

• partialFile: Either a path to an unzipped partial (ie: './routes.txt'), or a readable stream representing the file contents.
• partialName: If partialFile is a stream, provide the name of the file here (ie: 'routes').
• destination: The database to save results to, or a path to it.

Command Line

Examples:

gtfs-to-pouch -i gtfs.zip -o ./gtfs-dbs
gtfs-to-pouch --output ./gtfs-dbs < gtfs.zip
gtfs-to-pouch --input ./gtfs-files -o ./gtfs-dbs
gtfs-to-pouch --partial -i ./routes.txt -o ./db/routes

Options:

--partial     Switches to partial mode. Allows for parsing a single GTFS text
              file, such as routes.txt, rather than the entire ZIP file.

-i, --input   Input path pointing to GTFS file or directory.
              Can also pipe from stdin.
-n, --name    Name of the GTFS partial. Only needed if both in partial mode
              and stdin is being used instead of input.
-o, --output  Output directory, relative to the current working directory.
              Should contain databases, or point to the database in partial mode.
-h, --help    Show help text