Returns ADIF id of a callsign’s country
Strips off country prefixes (HC2/**DH1TW) and activity suffixes (DH1TW/P**).
This class is a wrapper for the following three Amateur Radio databases:
It’s aim is to provide a homogeneous interface to different databases.
-Typically an instance of this class is injected as a dependency in the Callinfo class, but it can also be used directly.
+Typically an instance of this class is injected as a dependency in the Callinfo class, but it can also +be used directly.
Even the interface is the same for all lookup sources, the returning data can be different. The documentation of the various methods provide more detail.
By default, LookupLib requires an Internet connection to download the libraries or perform the lookup against the Clublog API.
+The entire lookup data can also be copied into Redis, which an extremely fast in-memory Key/Value store. +A LookupLib object can be instanciated to perform then all lookups in Redis, instead processing and loading +the data from Internet / File. This saves some time and allows several instances of LookupLib +to query the same data concurrently.
| Parameters: |
|
|---|
Copy the complete lookup data into redis. Old data will be overwritten.
+| Parameters: |
|
+
|---|---|
| Returns: | returns True when the data has been copied successfully into Redis + |
+
| Return type: | bool + |
+
Example
+Copy the entire lookup data from the Country-files.com PLIST File into Redis. This example requires a running +instance of Redis, as well the python Redis connector (pip install redis-py).
+>>> from pyhamtools import LookupLib
+>>> import redis
+>>> r = redis.Redis()
+>>> my_lookuplib = LookupLib(lookuptype="countryfile")
+>>> print my_lookuplib.copy_data_in_redis(redis_prefix="CF", redis_instance=r)
+True
+Now let’s create an instance of LookupLib, using Redis to query the data +>>> from pyhamtools import LookupLib +>>> import redis +>>> r = redis.Redis() +>>> my_lookuplib = LookupLib(lookuptype=”countryfile”, redis_instance=r, redis_prefix=”CF”) +>>> my_lookuplib.lookup_callsign(“3D2RI”) +{
+++u’adif’: 460, +u’continent’: ‘OC’, +u’country’: ‘Rotuma Island’, +u’cqz’: 32, +u’ituz’: 56, +u’latitude’: -12.48, +u’longitude’: -177.08
}
+Note
+This method is available for the following lookup type
+Returns True if an operations is known as invalid