This is a web frontend for a console weather application wego, using it as a backend. You can check it at wttr.in.
Usage
You can access the service from a shell or from a Web browser:
$ curl wttr.in
Weather for City: Paris, France
\ / Clear
.-. 10 – 11 °C
― ( ) ― ↑ 11 km/h
`-’ 10 km
/ \ 0.0 mm
You can specify the location, for that you want to get the weather information. If you omit the location name, you will get the information for you current location, based on your IP address.
$ curl wttr.in/London
$ curl wttr.in/Moscow
You can use 3-letters airport codes if you want to get the weather information about some airports:
$ curl wttr.in/muc # Weather for IATA: muc, Munich International Airport, Germany
$ curl wttr.in/ham # Weather for IATA: ham, Hamburg Airport, Germany
You can also use IP-addresses (direct) or domain names (prefixed with @) as a location specificator:
$ curl wttr.in/@github.com
$ curl wttr.in/@msu.ru
To get this information online, you can access the :help
page:
$ curl wttr.in/:help
Installation
To install the program you need:
- Install external dependencies
- Install python dependencies used by the service
- Get WorldWeatherOnline API Key
- Configure wego
- Configure wttr.in
- Configure HTTP-frontend service
Install external dependencies
External requirements:
- wego [https://github.com/schachmat/wego], weather client for terminal
To install wego
you must have golang installed. After that:
go get https://github.com/schachmat/wego
go install https://github.com/schachmat/wego
Install python dependencies
Python requirements:
- Flask
- geoip2
- geopy
- requests
- gevent
You can install them using pip
.
If virtualenv
is used:
virtualenv ve
ve/bin/pip install -r requirements.txt
ve/bin/pip bin/srv.py
Also, you need to install the geoip2 database. You can use a free database GeoLite2, that can be downloaded from http://dev.maxmind.com/geoip/geoip2/geolite2/
Get WorldWeatherOnline key
To get the WorldWeatherOnline API key, you must register here:
https://developer.worldweatheronline.com/auth/register
Configure wego
After you have the key, configure wego
:
$ cat ~/.wegorc
{
"APIKey": "00XXXXXXXXXXXXXXXXXXXXXXXXXXX",
"City": "London",
"Numdays": 3,
"Imperial": false,
"Lang": "en"
}
The City
parameter in ~/.wegorc
is ignored.
Configure wttr.in
Configure the following environment variables specifing the path to the local wttr.in
installation, to the GeoLite database and to the wego
installation. For example:
WTTR_MYDIR = "/home/igor/wttr.in"
WTTR_GEOLITE = "/home/igor/wttr.in/GeoLite2-City.mmdb"
WTTR_WEGO = "/home/igor/go/bin/wego"
Configure HTTP-frontend service
Configure the web server, that will be used to access the service (if you want to use a web frontend; it's recommended):
server {
listen [::]:80;
server_name wttr.in *.wttr.in;
access_log /var/log/nginx/wttr.in-access.log main;
error_log /var/log/nginx/wttr.in-error.log;
location /clouds_files { root /var/www/igor/; }
location /clouds_images { root /var/www/igor/; }
location / {
proxy_pass http://127.0.0.1:8002;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
client_max_body_size 10m;
client_body_buffer_size 128k;
proxy_connect_timeout 90;
proxy_send_timeout 90;
proxy_read_timeout 90;
proxy_buffer_size 4k;
proxy_buffers 4 32k;
proxy_busy_buffers_size 64k;
proxy_temp_file_write_size 64k;
expires off;
}
}