Mirrors/wttr.in
2
0
Fork 0
mirror of https://github.com/chubin/wttr.in synced 2025-01-26 10:45:01 +00:00
Code Issues Projects Releases Packages Wiki Activity

Extend location.py docstring

Browse source
This commit is contained in:
Igor Chubin 2020-11-16 19:51:51 +01:00
parent 26372148b5
commit 41d4d3d789
1 changed files with 28 additions and 4 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
lib/location.py
View file

@ -1,11 +1,35 @@
""" """
All location related functions and converters. All location related functions and converters.
The main entry point is `location_processing` The main entry point is `location_processing` which gets `location` and
which gets `location` and `source_ip_address` `source_ip_address` and basing on this information generates precise location
and basing on this information generates description.
precise location description.
[query] --> [location] --> [(lat,long)] -->
^
|
[ip-address] --> _get_location()
To resolve IP address into location, the module uses function `_get_location()`,
which subsequenlty utilizes one of the three methods:
* `_geoip2()` (local sqlite database);
* `_ip2location()` (an external paid service);
* `_ipinfo()` (an external free service).
IP-address resolution data is saved in cache (_ipcachewrite, _ipcache).
Cache entry format:
COUNTRY_CODE;COUNTRY;REGION;CITY[;REST]
To resolve location name into a (lat,long) pair,
an external service is used, which is wrapped
with a function `_geolocator()`.
Exports:
location_processing
is_location_blocked
""" """
from __future__ import print_function from __future__ import print_function