Z
d
dlZd
dlZyd
dl
ZWn!ek



Do not import this module directly. Thanks to __init__.py you should do
something like:

  import transitfeed
  schedule = transitfeed.Schedule()
  ...

This module is a library to help you create, read and write Google
Transit Feed files. Refer to the feed specification, available at
http://code.google.com/transit/spec/transit_feed_specification.htm, for a
complete description how the transit feed represents a transit schedule. This
library supports all required parts of the specification but does not yet
support all optional parts. Patches welcome!

The specification describes several tables such as stops, routes and trips.
In a feed file these are stored as comma separeted value files. This library
represents each row of these tables with a single Python object. This object has
attributes for each value on the row. For example, schedule.AddStop returns a
Stop object which has attributes such as stop_lat and stop_name.

  Schedule: Central object of the parser
  GenericGTFSObject: A base class for each of the objects below
  Route: Represents a single route
  Trip: Represents a single trip
  Stop: Represents a single stop
  ServicePeriod: Represents a single service, a set of dates
  Agency: Represents the agency in this feed
  Transfer: Represents a single transfer rule
  TimeToSecondsSinceMidnight(): Convert HH:MM:SS into seconds since midnight.
  FormatSecondsSinceMidnight(s): Formats number of seconds past midnight into a string

  Optionally encode text and return it. The result should be safe to print.



  an exception object for each problem. Subclasses must implement


    Args:
      file_name: string
      row_num: int
      row: list of strings
      headers: list of column headers, its order corresponding to row's











c	








__module__t__doc__R
RRRRRRRRRR R!R7R#R&R(R*R0R5R6RR;R@RARDRIRKRMRORURXR[R\R`(((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyRfsF			
	
			

    A word-wrap function that preserves existing line breaks
    and most spaces in the text. Expects that existing line
    breaks are posix newlines (
).

    Taken from:
    http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/148061

s

i
i(tlentrfindtsplit(tlinetwordtwidth((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyt<lambda>L
s


!
t
 (treduceRj(RRm((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyRfB
s

d

    context and context2, if present, must be a tuple of (file_name, row_num,
    row, headers). context2 comes from ProblemReporter.SetFileContext. context
    was passed in with the keyword arguments. context2 is ignored if context
    is present.RN(t	ExceptionR
t__dict__tupdatetContextTupleToDictRt_typeR7(R	RRtkwargs((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyR



    Args:
      d: map returned by GetDictToFormat with  with formatting added
    R's%s




    Subclasses should define this if exceptions should be listed in something
    other than the order they are reported.

    Args:
      y: object to compare to self

    Returns:
      An int which is negative if self is more significant than y, 0 if they
      are similar significance and positive if self is less significant than
      y. Returning a float won't work.

    Raises:
      TypeError by default, meaning objects of the type can not be compared.











startswith(
turl((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyt

s$
Compute the brightness of an sRGB color using the formula from
  http://www.w3.org/TR/2000/WD-AERT-20000426#color-contrast.

  Args:
    color: a string of six hex digits in the format verified by IsValidColor().

  Returns:



  For example "01:02:03" returns 3723. The leading zero of the hours may be




tdtjtj|





s%Object with arbitrary attributes which may be added to a schedule.

  This class should be used as the base class for GTFS objects which may
  be stored in a Schedule. It defines some methods for reading and writing
  attributes. If self._schedule is None than the object is not in a Schedule.

  Subclasses must:
  * define an __init__ method which sets the _schedule member to None or a
    weakref to a Schedule
  * Set the _TABLE_NAME class variable to a name such as 'stops', 'agency', ...
  * define methods to validate objects of that type


    This method is only called when name is not found in __dict__.







  Callers may assign arbitrary values to instance attributes.
  Stop.ParseAttributes validates attributes according to GTFS and converts some
  into native types. ParseAttributes may delete invalid attributes.
  Accessing an attribute that is a column in GTFS will return None if this
  object does not have a value or it is ''.
  A Stop object acts like a dict with string values.

  Attributes:
    stop_lat: a float representing the latitude of the stop
    stop_lon: a float representing the longitude of the stop
    All other attributes are strings.



    Args:
      field_dict: A dictionary mapping attribute name to unicode string
      lat: a float, ignored when field_dict is present
      lng: a float, ignored when field_dict is present
      name: a string, ignored when field_dict is present
      stop_id: a string, ignored when field_dict is present
      stop_code: a string, ignored when field_dict is present




    A trip may be in the list multiple times with different index.
    stop_sequence is an integer.

    Args:
      schedule: Deprecated, do not use.




    trip: a Trip object
    index: an offset in trip.GetStopTimes()



    time: an integer. It might be interpolated.
    trip: a Trip object.
    index: the offset of this stop in trip.GetStopTimes(), which may be
      different from the stop_sequence.
    is_timepoint: a bool









    If value is not valid call problems. Return a new value of the correct type
    or None if value couldn't be converted.

























    This method is only called when name is not found in __dict__.



q









*






route_typet	agency_idt




    Args:
      headsign: headsign of the trip as a string

    Returns:
      a new Trip object


    This method overrides GenericGTFSObject.__getattr__ to provide backwards
    compatible access to trips.

setdefaultt






	








	




	



	


	








	
	




	



	








  Represents a single stop of a trip. StopTime contains most of the columns
  from the stop_times.txt file. It does not contain trip_id, which is implied
  by the Trip used to access it.

  See the Google Transit Feed Specification for the semantic details.

  stop: A Stop object
  arrival_time: str in the form HH:MM:SS; readonly after __init__
  departure_time: str in the form HH:MM:SS; readonly after __init__
  arrival_secs: int number of seconds since midnight
  departure_secs: int number of seconds since midnight
  stop_headsign: str
  pickup_type: int
  drop_off_type: int
  shape_dist_traveled: float
  stop_id: str; readonly
  stop_time: The only time given for this stop.  If present, it is used
             for both arrival and departure time.
  stop_sequence: int


















	



	



    trip must be provided because it is not stored in StopTime.

    If both are None return None.N(RW
RRX
(
R	((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pytGetTimeSecsls




	
	



	

h	
	
	
R=
cBsh
eZ
dd
dgZeddddgZdddd	gZd


service_idREt
trip_headsigntdirection_idtblock_idRGt




    Args:
      stop: A Stop object
      kwargs: remaining keyword args passed to StopTime.__init__

    Returns:
      None



    The trip isn't checked for duplicate sequence numbers so it must be



    Keys the StopTime object to be replaced by trip_id, stop_sequence
    and stop_id as 'stoptime', with the object 'stoptime'.





    Args:
      stoptime: A StopTime object. Should not be reused in multiple trips.
      schedule: Schedule object containing this trip which must be
      passed to Trip.__init__ or here
      problems: ProblemReporter object for validating the StopTime in its new
      home

    Returns:
      None



    Caution: arrival_secs and departure_secs may be 0, a false value meaning a





    secs will always be an int. If the StopTime object does not have explict
    times this method guesses using distance. stoptime is a StopTime object and
    is_timepoint is a bool.

    Raises:
      ValueError if this trip does not have the times needed to interpolate

total_timet
time_estimate((sE/var/www/bus/origin-src/transitfeed-1.2.5/transitfeed/_transitfeed.pyR
s<















%



)


!



    StopTime objects previously returned by GetStopTimes are unchang