Skip to content

jarondl/pygtfs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3c36d16 · Mar 29, 2024
Jul 14, 2023
Nov 12, 2018
Nov 6, 2023
Apr 26, 2017
Oct 9, 2021
Apr 20, 2016
Apr 13, 2016
Jan 20, 2014
Nov 12, 2018
Apr 13, 2016
Jul 14, 2023

Repository files navigation

pygtfs

Travis PyPI

Overview

pygtfs is a library that models information stored in Google's General Transit Feed Specification (GTFS) format. GTFS is a format designed to specify information about a transit system, such as a city's subways or a private company's bus services. pygtfs stores information in an SQLite database using SQLAlchemy to facilitate the storage of Python objects in a relational database.

pygtfs is a fork of @eoghanmurray's fork of a @andrewblim's gtfs-sql which is a fork of @bmander's gtfs. See the git logs for more fun history.

License: MIT, included in license.txt.

Dependencies

  • SQLAlchemy 0.7.8. Used for all mapping of GTFS objects to the relational DB. You'll need to be familiar with it to read the code; the documentation is pretty solid.
  • pytz 2012d. A few GTFS fields are expected to be in a tz time zone format.
  • six. Used in order to support python2 and python3 in a single code base.
  • docopt. Pythonic command line arguments parser, that will make you smile

Installation

Get setuptools if you don't have it, clone the repo, and use python setup.py install.

Documentation

Hosted on https://pygtfs.readthedocs.org/

TODO

  • Improve testing; add some unit testing framework and test with a variety of GTFS data feeds.
  • Add more docs

Why fork?

  • natively support several gtfs feeds per database
  • less SLOC, more DRY
  • add python3 support
  • renamed to a more generic name
  • will continue to maintain