Home | History | Annotate | only in /external/python/cpython2/Tools/world
Up to higher level directory
NameDateSize
README22-Oct-20202.8K
world22-Oct-202014.9K

README

      1 world -- Print mappings between country names and DNS country codes.
      2 
      3 Contact: Barry Warsaw
      4 Email:   bwarsaw (a] python.org
      5 
      6 This script will take a list of Internet addresses and print out where in the
      7 world those addresses originate from, based on the top-level domain country
      8 code found in the address.  Addresses can be in any of the following forms:
      9 
     10     xx                -- just the country code or top-level domain identifier
     11     host.domain.xx    -- any Internet host or network name
     12     somebody (a] where.xx -- an Internet email address
     13 
     14 If no match is found, the address is interpreted as a regular expression [*]
     15 and a reverse lookup is attempted.  This script will search the country names
     16 and print a list of matching entries.  You can force reverse mappings with the
     17 `-r' flag (see below).
     18 
     19 For example:
     20 
     21     %% world tz us
     22     tz originated from Tanzania, United Republic of
     23     us originated from United States
     24 
     25     %% world united
     26     united matches 6 countries:
     27         ae: United Arab Emirates
     28         uk: United Kingdom (common practice)
     29         um: United States Minor Outlying Islands
     30         us: United States
     31         tz: Tanzania, United Republic of
     32         gb: United Kingdom
     33 
     34 
     35  [*] Note that regular expressions must conform to Python 1.5's re.py module
     36  syntax.  The comparison is done with the search() method.
     37 
     38 Country codes are maintained by the RIPE Network Coordination Centre,
     39 in coordination with the ISO 3166 Maintenance Agency at DIN Berlin.  The
     40 authoritative source of counry code mappings is:
     41 
     42     <url:ftp://info.ripe.net/iso3166-countrycodes>
     43 
     44 The latest known change to this information was:
     45 
     46     Thu Aug  7 17:59:51 MET DST 1997
     47 
     48 This script also knows about non-geographic top-level domains.
     49 
     50 Usage: world [-d] [-p file] [-o] [-h] addr [addr ...]
     51 
     52     --dump
     53     -d
     54         Print mapping of all top-level domains.
     55 
     56     --parse file
     57     -p file
     58         Parse an iso3166-countrycodes file extracting the two letter country
     59         code followed by the country name.  Note that the three letter country
     60         codes and numbers, which are also provided in the standard format
     61         file, are ignored.
     62 
     63     --outputdict
     64     -o
     65         When used in conjunction with the `-p' option, output is in the form
     66         of a Python dictionary, and country names are normalized
     67         w.r.t. capitalization.  This makes it appropriate for cutting and
     68         pasting back into this file.
     69 
     70     --reverse
     71     -r
     72         Force reverse lookup.  In this mode the address can be any Python
     73         regular expression; this is matched against all country names and a
     74         list of matching mappings is printed.  In normal mode (e.g. without
     75         this flag), reverse lookup is performed on addresses if no matching
     76         country code is found.
     77 
     78     -h
     79     --help
     80         Print this message.
     81 
     82 
     84 Local Variables:
     85 indent-tabs-mode: nil
     86 End:
     87