2014-04-24 14:01:53 +02:00
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > LookupLib — pyhamtools 0.1 documentation< / title >
< link rel = "stylesheet" href = "_static/default.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/pygments.css" type = "text/css" / >
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '0.1',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
< / script >
< script type = "text/javascript" src = "_static/jquery.js" > < / script >
< script type = "text/javascript" src = "_static/underscore.js" > < / script >
< script type = "text/javascript" src = "_static/doctools.js" > < / script >
< link rel = "top" title = "pyhamtools 0.1 documentation" href = "index.html" / >
2014-04-26 00:22:57 +02:00
< link rel = "prev" title = "Callinfo" href = "Callinfo.html" / >
2014-04-24 14:01:53 +02:00
< / head >
< body >
< div class = "related" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "right" >
< a href = "py-modindex.html" title = "Python Module Index"
>modules< / a > |< / li >
< li class = "right" >
2014-04-26 00:22:57 +02:00
< a href = "Callinfo.html" title = "Callinfo"
2014-04-24 14:01:53 +02:00
accesskey="P">previous< / a > |< / li >
< li > < a href = "index.html" > pyhamtools 0.1 documentation< / a > » < / li >
< / ul >
< / div >
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" >
< div class = "section" id = "lookuplib" >
< h1 > LookupLib< a class = "headerlink" href = "#lookuplib" title = "Permalink to this headline" > ¶< / a > < / h1 >
< div class = "toctree-wrapper compound" >
< ul class = "simple" >
< / ul >
< / div >
< span class = "target" id = "module-pyhamtools.lookuplib" > < / span > < dl class = "class" >
< dt id = "pyhamtools.lookuplib.LookupLib" >
2014-04-25 23:46:44 +02:00
< em class = "property" > class < / em > < tt class = "descclassname" > pyhamtools.lookuplib.< / tt > < tt class = "descname" > LookupLib< / tt > < big > (< / big > < em > lookuptype='countryfile'< / em > , < em > apikey=None< / em > , < em > filename=None< / em > , < em > logger=None< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib" title = "Permalink to this definition" > ¶< / a > < / dt >
< dd > < p > This class is a wrapper for the following three Amateur Radio databases:< / p >
2014-04-24 14:01:53 +02:00
< ol class = "arabic simple" >
< li > Clublog.org (daily updated XML File)< / li >
< li > Clublog.org (HTTPS lookup)< / li >
< li > Country-files.com (infrequently updated PLIST File)< / li >
< / ol >
2014-04-26 00:22:57 +02:00
< p > It’ s aim is to provide a homogeneous interface to different databases.< / p >
< p > Typically an instance of this class is injected as a dependency in the < tt class = "xref py py-class docutils literal" > < span class = "pre" > Callinfo< / span > < / tt > class, but it can also be used directly.< / p >
2014-04-25 23:46:44 +02:00
< p > 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.< / p >
2014-04-24 14:01:53 +02:00
< p > By default, LookupLib requires an Internet connection to download the libraries or perform the
lookup against the Clublog API.< / p >
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Parameters:< / th > < td class = "field-body" > < ul class = "first last simple" >
< li > < strong > lookuptype< / strong > (< em > str< / em > ) – “ clublogxml” or “ clublogapi” or “ countryfile” < / li >
< li > < strong > apikey< / strong > (< em > str< / em > ) – Clublog API Key< / li >
2014-04-26 00:22:57 +02:00
< li > < strong > filename< / strong > (< em > str, optional< / em > ) – Filename for Clublog XML or Country-files.com cty.plist file. When a local file is used, no Internet connection not API Key is necessary.< / li >
2014-04-24 17:05:24 +02:00
< li > < strong > logger< / strong > (< em > logging.getLogger(__name__), optional< / em > ) – Python logger< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
< / tbody >
< / table >
< dl class = "method" >
< dt id = "pyhamtools.lookuplib.LookupLib.is_invalid_operation" >
2014-04-26 00:22:57 +02:00
< tt class = "descname" > is_invalid_operation< / tt > < big > (< / big > < em > callsign< / em > , < em > timestamp=datetime.datetime(2014< / em > , < em > 4< / em > , < em > 25< / em > , < em > 22< / em > , < em > 19< / em > , < em > 33< / em > , < em > 219680< / em > , < em > tzinfo=< UTC> )< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib.is_invalid_operation" title = "Permalink to this definition" > ¶< / a > < / dt >
2014-04-24 14:01:53 +02:00
< dd > < p > Returns True if an operations is known as invalid< / p >
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Parameters:< / th > < td class = "field-body" > < ul class = "first simple" >
< li > < strong > callsign< / strong > (< em > string< / em > ) – Amateur Radio callsign< / li >
< li > < strong > timestamp< / strong > (< em > datetime, optional< / em > ) – datetime in UTC (tzinfo=pytz.UTC)< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-even field" > < th class = "field-name" > Returns:< / th > < td class = "field-body" > < p class = "first" > True if a record exists for this callsign (at the given time)< / p >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Return type:< / th > < td class = "field-body" > < p class = "first" > bool< / p >
< / td >
< / tr >
< tr class = "field-even field" > < th class = "field-name" > Raises:< / th > < td class = "field-body" > < ul class = "first last simple" >
2014-04-25 23:46:44 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > KeyError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
No matching callsign found< / li >
2014-04-24 17:46:46 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > APIKeyMissingError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
API Key for Clublog missing or incorrect< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
< / tbody >
< / table >
2014-04-25 23:46:44 +02:00
< p class = "rubric" > Example< / p >
< p > The following code checks the Clublog XML database if the operation is valid for two dates.< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > pyhamtools< / span > < span class = "kn" > import< / span > < span class = "n" > LookupLib< / span >
< span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > datetime< / span > < span class = "kn" > import< / span > < span class = "n" > datetime< / span >
< span class = "gp" > > > > < / span > < span class = "kn" > import< / span > < span class = "nn" > pytz< / span >
< span class = "gp" > > > > < / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > =< / span > < span class = "n" > LookupLib< / span > < span class = "p" > (< / span > < span class = "n" > lookuptype< / span > < span class = "o" > =< / span > < span class = "s" > " clublogxml" < / span > < span class = "p" > ,< / span > < span class = "n" > apikey< / span > < span class = "o" > =< / span > < span class = "s" > " myapikey" < / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > .< / span > < span class = "n" > is_invalid_operation< / span > < span class = "p" > (< / span > < span class = "s" > " 5W1CFN" < / span > < span class = "p" > )< / span >
< span class = "go" > True< / span >
< span class = "gp" > > > > < / span > < span class = "k" > try< / span > < span class = "p" > :< / span >
< span class = "gp" > > > > < / span > < span class = "n" > timestamp< / span > < span class = "o" > =< / span > < span class = "n" > datetime< / span > < span class = "p" > (< / span > < span class = "n" > year< / span > < span class = "o" > =< / span > < span class = "mi" > 2012< / span > < span class = "p" > ,< / span > < span class = "n" > month< / span > < span class = "o" > =< / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span > < span class = "n" > day< / span > < span class = "o" > =< / span > < span class = "mi" > 31< / span > < span class = "p" > )< / span > < span class = "o" > .< / span > < span class = "n" > replace< / span > < span class = "p" > (< / span > < span class = "n" > tzinfo< / span > < span class = "o" > =< / span > < span class = "n" > pytz< / span > < span class = "o" > .< / span > < span class = "n" > UTC< / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > .< / span > < span class = "n" > is_invalid_operation< / span > < span class = "p" > (< / span > < span class = "s" > " 5W1CFN" < / span > < span class = "p" > ,< / span > < span class = "n" > timestamp< / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "k" > except< / span > < span class = "ne" > KeyError< / span > < span class = "p" > :< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "s" > " Seems to be invalid operation before 31.1.2012" < / span >
< span class = "go" > Seems to be an invalid operation before 31.1.2012< / span >
< / pre > < / div >
< / div >
2014-04-24 17:46:46 +02:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
< p > This method is available for< / p >
< ul class = "last simple" >
2014-04-24 14:01:53 +02:00
< li > clublogxml< / li >
< / ul >
2014-04-24 17:46:46 +02:00
< / div >
2014-04-24 14:01:53 +02:00
< / dd > < / dl >
< dl class = "method" >
< dt id = "pyhamtools.lookuplib.LookupLib.lookup_callsign" >
2014-04-26 00:22:57 +02:00
< tt class = "descname" > lookup_callsign< / tt > < big > (< / big > < em > callsign=None< / em > , < em > timestamp=datetime.datetime(2014< / em > , < em > 4< / em > , < em > 25< / em > , < em > 22< / em > , < em > 19< / em > , < em > 33< / em > , < em > 219601< / em > , < em > tzinfo=< UTC> )< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib.lookup_callsign" title = "Permalink to this definition" > ¶< / a > < / dt >
2014-04-24 14:01:53 +02:00
< dd > < p > Returns lookup data if an exception exists for a callsign< / p >
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Parameters:< / th > < td class = "field-body" > < ul class = "first simple" >
< li > < strong > callsign< / strong > (< em > string< / em > ) – Amateur radio callsign< / li >
< li > < strong > timestamp< / strong > (< em > datetime, optional< / em > ) – datetime in UTC (tzinfo=pytz.UTC)< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-even field" > < th class = "field-name" > Returns:< / th > < td class = "field-body" > < p class = "first" > Dictionary containing the country specific data of the callsign< / p >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Return type:< / th > < td class = "field-body" > < p class = "first" > dict< / p >
< / td >
< / tr >
< tr class = "field-even field" > < th class = "field-name" > Raises:< / th > < td class = "field-body" > < ul class = "first last simple" >
2014-04-25 23:46:44 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > KeyError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
No matching callsign found< / li >
2014-04-24 17:46:46 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > APIKeyMissingError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
API Key for Clublog missing or incorrect< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
< / tbody >
< / table >
2014-04-25 23:46:44 +02:00
< p class = "rubric" > Example< / p >
< p > The following code queries the the online Clublog API for the callsign “ VK9XO” on a specific date.< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > pyhamtools< / span > < span class = "kn" > import< / span > < span class = "n" > LookupLib< / span >
< span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > datetime< / span > < span class = "kn" > import< / span > < span class = "n" > datetime< / span >
< span class = "gp" > > > > < / span > < span class = "kn" > import< / span > < span class = "nn" > pytz< / span >
< span class = "gp" > > > > < / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > =< / span > < span class = "n" > LookupLib< / span > < span class = "p" > (< / span > < span class = "n" > lookuptype< / span > < span class = "o" > =< / span > < span class = "s" > " clublogapi" < / span > < span class = "p" > ,< / span > < span class = "n" > apikey< / span > < span class = "o" > =< / span > < span class = "s" > " myapikey" < / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "n" > timestamp< / span > < span class = "o" > =< / span > < span class = "n" > datetime< / span > < span class = "p" > (< / span > < span class = "n" > year< / span > < span class = "o" > =< / span > < span class = "mi" > 1962< / span > < span class = "p" > ,< / span > < span class = "n" > month< / span > < span class = "o" > =< / span > < span class = "mi" > 7< / span > < span class = "p" > ,< / span > < span class = "n" > day< / span > < span class = "o" > =< / span > < span class = "mi" > 7< / span > < span class = "p" > ,< / span > < span class = "n" > tzinfo< / span > < span class = "o" > =< / span > < span class = "n" > pytz< / span > < span class = "o" > .< / span > < span class = "n" > UTC< / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > .< / span > < span class = "n" > lookup_callsign< / span > < span class = "p" > (< / span > < span class = "s" > " VK9XO" < / span > < span class = "p" > ,< / span > < span class = "n" > timestamp< / span > < span class = "p" > )< / span >
< span class = "go" > {< / span >
< span class = "go" > ' country' : ' CHRISTMAS ISLAND' ,< / span >
< span class = "go" > ' longitude' : -105.7,< / span >
< span class = "go" > ' cqz' : 29,< / span >
< span class = "go" > ' adif' : 35,< / span >
< span class = "go" > ' latitude' : -10.5,< / span >
< span class = "go" > ' continent' : ' OC' < / span >
< span class = "go" > }< / span >
< / pre > < / div >
< / div >
2014-04-24 17:46:46 +02:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
< p > This method is available for< / p >
< ul class = "last simple" >
2014-04-24 14:01:53 +02:00
< li > clublogxml< / li >
< li > clublogapi< / li >
< li > countryfile< / li >
< / ul >
2014-04-24 17:46:46 +02:00
< / div >
2014-04-24 14:01:53 +02:00
< / dd > < / dl >
< dl class = "method" >
< dt id = "pyhamtools.lookuplib.LookupLib.lookup_entity" >
< tt class = "descname" > lookup_entity< / tt > < big > (< / big > < em > entity=None< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib.lookup_entity" title = "Permalink to this definition" > ¶< / a > < / dt >
2014-04-26 00:22:57 +02:00
< dd > < p > Returns lookup data of an ADIF Entity< / p >
2014-04-24 14:01:53 +02:00
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Parameters:< / th > < td class = "field-body" > < strong > entity< / strong > (< em > int< / em > ) – ADIF identifier of country< / td >
2014-04-24 14:01:53 +02:00
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-even field" > < th class = "field-name" > Returns:< / th > < td class = "field-body" > Dictionary containing the country specific data< / td >
2014-04-24 14:01:53 +02:00
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Return type:< / th > < td class = "field-body" > dict< / td >
< / tr >
2014-04-25 23:46:44 +02:00
< tr class = "field-even field" > < th class = "field-name" > Raises:< / th > < td class = "field-body" > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > KeyError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
No matching entity found< / td >
2014-04-24 14:01:53 +02:00
< / tr >
< / tbody >
< / table >
2014-04-25 23:46:44 +02:00
< p class = "rubric" > Example< / p >
< p > The following code queries the the Clublog XML database for the ADIF entity Turkmenistan, which has
the id 273.< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > pyhamtools< / span > < span class = "kn" > import< / span > < span class = "n" > LookupLib< / span >
< span class = "gp" > > > > < / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > =< / span > < span class = "n" > LookupLib< / span > < span class = "p" > (< / span > < span class = "n" > lookuptype< / span > < span class = "o" > =< / span > < span class = "s" > " clublogapi" < / span > < span class = "p" > ,< / span > < span class = "n" > apikey< / span > < span class = "o" > =< / span > < span class = "s" > " myapikey" < / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > .< / span > < span class = "n" > lookup_entity< / span > < span class = "p" > (< / span > < span class = "mi" > 273< / span > < span class = "p" > )< / span >
< span class = "go" > {< / span >
< span class = "go" > ' deleted' : False,< / span >
< span class = "go" > ' country' : ' TURKMENISTAN' ,< / span >
< span class = "go" > ' longitude' : -58.4,< / span >
< span class = "go" > ' cqz' : 17,< / span >
< span class = "go" > ' prefix' : ' EZ' ,< / span >
< span class = "go" > ' latitude' : 38.0,< / span >
< span class = "go" > ' continent' : ' AS' < / span >
< span class = "go" > }< / span >
< / pre > < / div >
< / div >
2014-04-24 17:05:24 +02:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
2014-04-24 17:46:46 +02:00
< p > This method is available for the following lookup type< / p >
< ul class = "last simple" >
2014-04-24 14:01:53 +02:00
< li > clublogxml< / li >
< / ul >
2014-04-24 17:05:24 +02:00
< / div >
2014-04-24 14:01:53 +02:00
< / dd > < / dl >
< dl class = "method" >
< dt id = "pyhamtools.lookuplib.LookupLib.lookup_prefix" >
2014-04-26 00:22:57 +02:00
< tt class = "descname" > lookup_prefix< / tt > < big > (< / big > < em > prefix< / em > , < em > timestamp=datetime.datetime(2014< / em > , < em > 4< / em > , < em > 25< / em > , < em > 22< / em > , < em > 19< / em > , < em > 33< / em > , < em > 219601< / em > , < em > tzinfo=< UTC> )< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib.lookup_prefix" title = "Permalink to this definition" > ¶< / a > < / dt >
2014-04-24 14:01:53 +02:00
< dd > < p > Returns lookup data of a Prefix< / p >
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Parameters:< / th > < td class = "field-body" > < ul class = "first simple" >
< li > < strong > prefix< / strong > (< em > string< / em > ) – Prefix of a Amateur Radio callsign< / li >
< li > < strong > timestamp< / strong > (< em > datetime, optional< / em > ) – datetime in UTC (tzinfo=pytz.UTC)< / li >
< / ul >
< / td >
< / tr >
< tr class = "field-even field" > < th class = "field-name" > Returns:< / th > < td class = "field-body" > < p class = "first" > Dictionary containing the country specific data of the Prefix< / p >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Return type:< / th > < td class = "field-body" > < p class = "first" > dict< / p >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:05:24 +02:00
< tr class = "field-even field" > < th class = "field-name" > Raises:< / th > < td class = "field-body" > < ul class = "first last simple" >
2014-04-25 23:46:44 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > KeyError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
No matching Prefix found< / li >
2014-04-24 17:46:46 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > APIKeyMissingError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
API Key for Clublog missing or incorrect< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
< / tbody >
< / table >
2014-04-25 23:46:44 +02:00
< p class = "rubric" > Example< / p >
< p > The following code shows how to obtain the information for the prefix “ DH” from the countryfile.com
database (default database).< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > pyhamtools< / span > < span class = "kn" > import< / span > < span class = "n" > LookupLib< / span >
< span class = "gp" > > > > < / span > < span class = "n" > myLookupLib< / span > < span class = "o" > =< / span > < span class = "n" > LookupLib< / span > < span class = "p" > ()< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "n" > myLookupLib< / span > < span class = "o" > .< / span > < span class = "n" > lookup_prefix< / span > < span class = "p" > (< / span > < span class = "s" > " DH" < / span > < span class = "p" > )< / span >
< span class = "go" > {< / span >
< span class = "go" > ' adif' : 230,< / span >
< span class = "go" > ' country' : ' Fed. Rep. of Germany' ,< / span >
< span class = "go" > ' longitude' : -10.0,< / span >
< span class = "go" > ' cqz' : 14,< / span >
< span class = "go" > ' ituz' : 28,< / span >
< span class = "go" > ' latitude' : 51.0,< / span >
< span class = "go" > ' continent' : ' EU' < / span >
< span class = "go" > }< / span >
< / pre > < / div >
< / div >
2014-04-24 17:46:46 +02:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
< p > This method is available for< / p >
< ul class = "last simple" >
2014-04-24 14:01:53 +02:00
< li > clublogxml< / li >
< li > countryfile< / li >
< / ul >
2014-04-24 17:46:46 +02:00
< / div >
2014-04-24 14:01:53 +02:00
< / dd > < / dl >
< dl class = "method" >
< dt id = "pyhamtools.lookuplib.LookupLib.lookup_zone_exception" >
2014-04-26 00:22:57 +02:00
< tt class = "descname" > lookup_zone_exception< / tt > < big > (< / big > < em > callsign< / em > , < em > timestamp=datetime.datetime(2014< / em > , < em > 4< / em > , < em > 25< / em > , < em > 22< / em > , < em > 19< / em > , < em > 33< / em > , < em > 219687< / em > , < em > tzinfo=< UTC> )< / em > < big > )< / big > < a class = "headerlink" href = "#pyhamtools.lookuplib.LookupLib.lookup_zone_exception" title = "Permalink to this definition" > ¶< / a > < / dt >
2014-04-24 14:01:53 +02:00
< dd > < p > Returns a CQ Zone if an exception exists for the given callsign< / p >
2014-04-24 17:46:46 +02:00
< p > Args:
callsign (string): Amateur radio callsign
timestamp (datetime, optional): datetime in UTC (tzinfo=pytz.UTC)< / p >
2014-04-24 14:01:53 +02:00
< table class = "docutils field-list" frame = "void" rules = "none" >
< col class = "field-name" / >
< col class = "field-body" / >
< tbody valign = "top" >
2014-04-24 17:46:46 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Returns:< / th > < td class = "field-body" > < p class = "first" > Value of the the CQ Zone exception which exists for this callsign (at the given time)< / p >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
2014-04-24 17:46:46 +02:00
< tr class = "field-even field" > < th class = "field-name" > Return type:< / th > < td class = "field-body" > < p class = "first" > int< / p >
2014-04-24 17:05:24 +02:00
< / td >
< / tr >
2014-04-24 17:46:46 +02:00
< tr class = "field-odd field" > < th class = "field-name" > Raises:< / th > < td class = "field-body" > < ul class = "first last simple" >
2014-04-25 23:46:44 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > KeyError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
No matching callsign found< / li >
2014-04-24 17:46:46 +02:00
< li > < tt class = "xref py py-exc docutils literal" > < span class = "pre" > APIKeyMissingError< / span > < / tt > –
2014-04-24 17:05:24 +02:00
API Key for Clublog missing or incorrect< / li >
< / ul >
2014-04-24 14:01:53 +02:00
< / td >
< / tr >
< / tbody >
< / table >
2014-04-25 23:46:44 +02:00
< p class = "rubric" > Example< / p >
< p > The following code checks the Clublog XML database if a CQ Zone exception exists for the callsign DP0GVN.< / p >
< div class = "highlight-python" > < div class = "highlight" > < pre > < span class = "gp" > > > > < / span > < span class = "kn" > from< / span > < span class = "nn" > pyhamtools< / span > < span class = "kn" > import< / span > < span class = "n" > LookupLib< / span >
< span class = "gp" > > > > < / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > =< / span > < span class = "n" > LookupLib< / span > < span class = "p" > (< / span > < span class = "n" > lookuptype< / span > < span class = "o" > =< / span > < span class = "s" > " clublogxml" < / span > < span class = "p" > ,< / span > < span class = "n" > apikey< / span > < span class = "o" > =< / span > < span class = "s" > " myapikey" < / span > < span class = "p" > )< / span >
< span class = "gp" > > > > < / span > < span class = "k" > print< / span > < span class = "n" > my_lookuplib< / span > < span class = "o" > .< / span > < span class = "n" > lookup_zone_exception< / span > < span class = "p" > (< / span > < span class = "s" > " DP0GVN" < / span > < span class = "p" > )< / span >
< span class = "go" > 38< / span >
< / pre > < / div >
< / div >
< p > The prefix “ DP” It is assigned to Germany, but the station is located in Antarctica, and therefore
in CQ Zone 38< / p >
2014-04-24 17:46:46 +02:00
< div class = "admonition note" >
< p class = "first admonition-title" > Note< / p >
< p > This method is available for< / p >
< ul class = "last simple" >
2014-04-24 14:01:53 +02:00
< li > clublogxml< / li >
< / ul >
2014-04-24 17:46:46 +02:00
< / div >
2014-04-24 14:01:53 +02:00
< / dd > < / dl >
< / dd > < / dl >
< / div >
< / div >
< / div >
< / div >
< div class = "sphinxsidebar" >
< div class = "sphinxsidebarwrapper" >
< h4 > Previous topic< / h4 >
2014-04-26 00:22:57 +02:00
< p class = "topless" > < a href = "Callinfo.html"
title="previous chapter">Callinfo< / a > < / p >
2014-04-24 14:01:53 +02:00
< h3 > This Page< / h3 >
< ul class = "this-page-menu" >
< li > < a href = "_sources/LookupLib.txt"
rel="nofollow">Show Source< / a > < / li >
< / ul >
< div id = "searchbox" style = "display: none" >
< h3 > Quick search< / h3 >
< form class = "search" action = "search.html" method = "get" >
< input type = "text" name = "q" / >
< input type = "submit" value = "Go" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< p class = "searchtip" style = "font-size: 90%" >
Enter search terms or a module, class or function name.
< / p >
< / div >
< script type = "text/javascript" > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "right" >
< a href = "py-modindex.html" title = "Python Module Index"
>modules< / a > |< / li >
< li class = "right" >
2014-04-26 00:22:57 +02:00
< a href = "Callinfo.html" title = "Callinfo"
2014-04-24 14:01:53 +02:00
>previous< / a > |< / li >
< li > < a href = "index.html" > pyhamtools 0.1 documentation< / a > » < / li >
< / ul >
< / div >
< div class = "footer" >
© Copyright 2014, Tobias Wellnitz, DH1TW.
Created using < a href = "http://sphinx-doc.org/" > Sphinx< / a > 1.2.2.
< / div >
< / body >
< / html >
