partridge 0.5.0

Usage

import datetime
import partridge as ptg

path = 'path/to/sfmta-2017-08-22.zip'

service_ids_by_date = ptg.read_service_ids_by_date(path)

service_ids = service_ids_by_date[datetime.date(2017, 9, 25)]

feed = ptg.feed(path, view={
    'trips.txt': {
        'service_id': service_ids,
        'route_id': '12300', # 18-46TH AVENUE
    },
})

assert set(feed.trips.service_id) == service_ids
assert list(feed.routes.route_id) == ['12300']

# Buses running the 18 - 46th Ave line use 88 stops (on September 25, 2017, at least).
assert len(feed.stops) == 88

Features

• Surprisingly fast :)

• Load only what you need into memory

• Built-in support for resolving service dates

• Easily extended to support fields and files outside the official spec (TODO: document this)

• Handle nested folders and bad data in zips

• Predictable type conversions

Installation

pip install partridge

Thank You

I hope you find this library useful. If you have suggestions for improving Partridge, please open an issue on GitHub.

0.5.0 (2017-12-22)

• Easily build a representative view of a zip with ptg.get_representative_feed. Inspired by peartree.

• Extract out GTFS zips by agency_id/route_id with ptg.extract_{agencies,routes}.

• Read arbitrary files from a zip with feed.get('myfile.txt').

• Remove service_ids_by_date, dates_by_service_ids, and trip_counts_by_date from the feed class. Instead use ptg.{read_service_ids_by_date,read_dates_by_service_ids,read_trip_counts_by_date}.

0.4.0 (2017-12-10)

• Add support for Python 2.7. Thanks @danielsclint!

0.3.0 (2017-10-12)

• Fix service date resolution for raw_feed. Previously raw_feed considered all days of the week from calendar.txt to be active regardless of 0/1 value.

0.2.0 (2017-09-30)

• Add missing edge from fare_rules.txt to routes.txt in default dependency graph.

0.1.0 (2017-09-23)

• First release on PyPI.