Metadata-Version: 2.1
Name: PyTransportNSW
Version: 0.1.1
Summary: Get transport information from TransportNSW
Home-page: https://github.com/Dav0815/TransportNSW
Author: Dav0815
License: UNKNOWN
Description: # TransportNSW
        Python lib to access Transport NSW information.
        
        ## How to Use
        
        ### Get an API Key
        An OpenData account and API key is required to request the data. More information on how to create the free account can be found here:
        https://opendata.transport.nsw.gov.au/user-guide .
        
        ### Get the stop and line
        The libary will expect at least stop id to request the next leave events. The easieste way to get the ID is using Google Maps and clicking on one of the bus, train or ferry stops. The information pane one the left will show the relevant stop ID.
        
        Another source for the stop ID and line is  https://transportnsw.info/stops#/. It provides the option to search for a stop and the corresponding lines leaving from there. 
        
        ### Sample Code
        The following example will request the next leave event for the bus route/line *199* from stop ID *209516*.
        
        **Code:**
        ```python
        from TransportNSW import TransportNSW
        ptnsw1 = TransportNSW.TransportNSW()
        journey = tnsw.get_departures('209516', '199', '', 'YOUR_API_KEY')
        print(journey)
        ```
        **Result:**
        ```
        {'stop_id': '209516', 'route': '199', 'due': 4, 'delay': 0, 'real_time': 'n', 'destination': 'Palm Beach'}
        ```
        * route: bus, train, ferry number
        * due: minutes till next leave
        * real_time: flag if the leave event has real_time information
        * delay: delay in minutes from the scheduled leave time
        * destination: end point of the route
        
        Leaving the line field empty will return any bus/train/ferry leaving next from a given stop.
        **Code:**
        ```python
        journey = tnsw.get_departures('209516', '', '', 'YOUR_API_KEY')
        ```
        
        Setting a destination will return all lines going there from the stop_id. Example for ferries leaving Balmain Warf towards Circular Quay 
        **Code:**
        ```python
        journey = tnsw.get_departures('10102008','','Circular Quay' 'YOUR_API_KEY')
        ```
        
        ### Errors
        No leave event with wrong stop ID or not matching route.
        ```
        {'stop_id': 'n/a', 'route': 'n/a', 'due': 'n/a', 'delay': 'n/a', 'real_time': 'n/a', destination: 'n/a'}
        ```
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Description-Content-Type: text/markdown
