what should i eat?
Project description
welp
welp
is a CLI Yelp! client
Features
- Utilizes the Yelp! fusion API to search Yelp without visiting the web UI. Great for devs who want to look busy but are already thinking about lunch!
- Curses menus for interactive CLI menus
- Vim bindings for navigating menus without the keyboard
- Scroll compatible on Termux and other mobile touch screen shell clients
- Emojis for easily scannable food option results
Installation
Install using pip.
pip install welp
Usage
You will need a Yelp Fusion API key in order to use this application because this is my side project and im not going to fork over an api key for it. they key is free and is more than enough for personal queries or even dev on this project.
Once you have it, export it to your environment. Stick it into your bashrc to persist it.
export YELP_API_KEY=<key>
If you'd like to use Google Geolocation API for automated geolocated results, provide the environment with the Google Geolocation API Key also:
export GOOGLE_API_KEY=<key>
Both of these keys are basically free for to use individually. The Google API will require a form of payment, but has a free credit program.
Hotkeys
welp has general vim shotcuts.
j
scrolls one selection downk
scrolls one selection uph
scrolls one page backl
scrolls one page forwardq
quits or goes back to previous pagereturn
opens detailed business information
Development
To build this project, use venv
and python3.
Install dependencies using pip install -r requirements.txt
and place keys in .env
of the project root.
Start venv using the following is your venv is named "venv"
source env/bin/activate && set -a; source .env; set +a
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.