{ "info": { "author": "Kevin Lloyd Bernal", "author_email": "kevinlloydbernal@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Software Development", "Topic :: System :: Monitoring" ], "description": "Uberfare\n========\n\n.. image:: https://img.shields.io/pypi/v/uberfare.svg\n :target: https://pypi.python.org/pypi/uberfare\n\n.. image:: https://img.shields.io/pypi/l/uberfare.svg\n :target: https://pypi.python.org/pypi/uberfare\n\n.. image:: https://img.shields.io/pypi/pyversions/uberfare.svg\n :target: https://pypi.python.org/pypi/uberfare\n\n.. image:: https://travis-ci.org/BurnzZ/uberfare.svg?branch=master\n :target: https://travis-ci.org/BurnzZ/uberfare\n\n.. image:: https://codecov.io/gh/BurnzZ/uberfare/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/BurnzZ/uberfare\n\nThis is a simple wrapper to the official Uber Python SDK intended to\ncollect data from a given **origin** and **destination** at a specified\ntime interval.\n\nThe current implementation only handles the price estimate feature since\nit doesn\u2019t need OAuth 2.0 access.\n\nMotivation\n~~~~~~~~~~\n\nI\u2019m using this tool in order to gather data and then evaluate when\u2019s the\nbest time to leave the house and book an Uber ride to work, and\nvice-versa.\n\nRequirements\n~~~~~~~~~~~~\n\n* Python 3.4+\n\nInstallation\n~~~~~~~~~~~~\n\nI'd recommend installing it via `pipenv `_:\n\n.. code-block:: bash\n\n $ pipenv install uberfare\n $ # or via the usual pip\n $ pip3 install uberfare\n\nAPI Key\n~~~~~~~\n\nGet your ``Server Token`` API Key by creating an app at:\n`developer.uber.com/dashboard `__,\nand then:\n\n* Create or Select an app\n* Copy the **Server Token** value in the **Auth** page\n\nBefore using this package, export your ``Server Token`` as:\n``export UBER_SERVER_TOKEN=``. You can however, override\nthis when using the CLI (see below).\n\nUsage\n~~~~~\n\nYou have to determine the ``(latitude,longitude)`` of your location,\nsince the types of rides available will depend on it.\n\nThe best way to get the coordinates is going to\n`maps.google.com `__ and then clicking\nany point in the map. A small box will then appear at the bottom-center\nof your screen containing the Longitude and Latitude. Take note of the\ncoordinates for both your origin and destination:\n\n.. figure:: docs/img/google-maps-coordinate-lookup.gif\n :alt: Google Maps Coordinates Lookup\n\nCLI\n^^^\n\n.. code:: bash\n\n >>> # To get the fare estimate, provide the arguments: , \n >>> # (Where origin and destination are in the format)\n >>> uberfare estimate 14.55,121.05 14.52,121.01\n\n >>> # To save all the RAW data in a CSV file, you can do:\n >>> uberfare estimate 14.55,121.05 14.52,121.01 --output-file output.csv\n\n.. figure:: docs/img/demo-1.gif\n :alt: CLI demo\n\n.. code:: bash\n\n >>> # You can also periodically fetch the Uber fares by using the\n >>> # --check-interval