From 819ca3ea5848b605bf87221721297fb24131e408 Mon Sep 17 00:00:00 2001 From: Markus Holtermann Date: Wed, 8 Oct 2014 00:37:41 +0200 Subject: Fixed #6 -- Added some installation and usage instructions --- README.rst | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/README.rst b/README.rst index 53a7ea2..3adef5c 100644 --- a/README.rst +++ b/README.rst @@ -30,3 +30,64 @@ Pictures: .. image:: https://markusholtermann.eu/images/BVG-Grabber-LightningTalk-installation2tb.jpg :alt: Installation 2 + + +Installation +============ + +To use *bvg-grabber* go and install it as you do with every Python package:: + + $ pip install bvg-grabber + +or:: + + $ pip install --user bvg-grabber + + +Usage +===== + +*bvg-grabber* comes with a simple command line tool ``bvg-grabber.py``:: + + $ bvg-grabber.py --help + usage: bvg-grabber.py [-h] + [--vehicle [{S,U,TRAM,BUS,FERRY,RB,IC} [{S,U,TRAM,BUS,FERRY,RB,IC} ...]]] + [--limit LIMIT] + station file + + Query the BVG-website for departures + + positional arguments: + station The station to query + file Path to file. Use - for stdout + + optional arguments: + -h, --help show this help message and exit + --vehicle [{S,U,TRAM,BUS,FERRY,RB,IC} [{S,U,TRAM,BUS,FERRY,RB,IC} ...]] + Vehicles which shall be queried, if non given + actualdepartue (bus) will be used + --limit LIMIT Max departures to query + + +Example:: + + $ bvg-grabber.py "U Ernst-Reuter-Platz (Berlin)" - --vehicle U --limit 2 | json_pp + [ + [ + "U Ernst-Reuter-Platz (Berlin)", + [ + { + "line" : "U2", + "end" : "U Ruhleben (Berlin)", + "remaining" : 12180, + "start" : "U Ernst-Reuter-Platz (Berlin)" + }, + { + "line" : "U2", + "start" : "U Ernst-Reuter-Platz (Berlin)", + "remaining" : 12600, + "end" : "S+U Pankow (Berlin)" + } + ] + ] + ] -- cgit v1.2.3