Coverage for nltk.app.wordnet_app : 28%

# Natural Language Toolkit: WordNet Browser Application 

# 

# Copyright (C) 2001-2012 NLTK Project 

# Author: Jussi Salmela <jtsalmela@users.sourceforge.net> 

#         Paul Bone <pbone@students.csse.unimelb.edu.au> 

# URL: <http://www.nltk.org/> 

# For license information, see LICENSE.TXT 

""" 

A WordNet Browser application which launches the default browser 

(if it is not already running) and opens a new tab with a connection 

to http://localhost:port/ .  It also starts an HTTP server on the 

specified port and begins serving browser requests.  The default 

port is 8000.  (For command-line help, run "python wordnet -h") 

This application requires that the user's web browser supports 

Javascript. 

BrowServer is a server for browsing the NLTK Wordnet database It first 

launches a browser client to be used for browsing and then starts 

serving the requests of that and maybe other clients 

Usage:: 

    browserver.py -h 

    browserver.py [-s] [-p <port>] 

Options:: 

    -h or --help 

        Display this help message. 

    -l <file> or --log-file <file> 

        Logs messages to the given file, If this option is not specified 

        messages are silently dropped. 

    -p <port> or --port <port> 

        Run the web server on this TCP port, defaults to 8000. 

    -s or --server-mode 

        Do not start a web browser, and do not allow a user to 

        shotdown the server through the web interface. 

""" 

# TODO: throughout this package variable names and docstrings need 

# modifying to be compliant with NLTK's coding standards.  Tests also 

# need to be develop to ensure this continues to work in the face of 

# changes to other NLTK packages. 

from __future__ import print_function 

# Allow this program to run inside the NLTK source tree. 

from sys import path 

import os 

from sys import argv 

from BaseHTTPServer import HTTPServer, BaseHTTPRequestHandler 

from collections import defaultdict 

import webbrowser 

import datetime 

import re 

import threading 

import time 

import getopt 

import base64 

import cPickle 

import copy 

from nltk import compat 

from nltk.corpus import wordnet as wn 

from nltk.corpus.reader.wordnet import Synset, Lemma 

# now included in local file 

# from util import html_header, html_trailer, \ 

#    get_static_index_page, get_static_page_by_path, \ 

#    page_from_word, page_from_href 

firstClient = True 

# True if we're not also running a web browser.  The value f server_mode 

# gets set by demo(). 

server_mode = None 

# If set this is a file object for writting log messages. 

logfile = None 

class MyServerHandler(BaseHTTPRequestHandler): 

    def do_HEAD(self): 

        self.send_head() 

    def do_GET(self): 

        global firstClient 

        sp = self.path[1:] 

        if compat.unquote_plus(sp) == 'SHUTDOWN THE SERVER': 

            if server_mode: 

                page = "Server must be killed with SIGTERM." 

                type = "text/plain" 

            else: 

                print('Server shutting down!') 

                os._exit(0) 

        elif sp == 'favicon.ico': 

            type = 'image/x-icon' 

            page = favicon_data() 

        elif sp == '': # First request. 

            type = 'text/html' 

            if not server_mode and firstClient: 

                firstClient = False 

                page = get_static_index_page(True) 

            else: 

                page = get_static_index_page(False) 

            word = 'green' 

        elif sp.endswith('.html'): # Trying to fetch a HTML file TODO: 

            type = 'text/html' 

            usp = compat.unquote_plus(sp) 

            if usp == 'NLTK Wordnet Browser Database Info.html': 

                word = '* Database Info *' 

                if os.path.isfile(usp): 

                    page = open(usp).read() 

                else: 

                    page = (html_header % word) + \ 

                        '<p>The database info file:'\ 

                        '<p><b>' + usp + '</b>' + \ 

                        '<p>was not found. Run this:' + \ 

                        '<p><b>python dbinfo_html.py</b>' + \ 

                        '<p>to produce it.' + html_trailer 

            else: 

                # Handle files here. 

                word = sp 

                page = get_static_page_by_path(usp) 

        elif sp.startswith("search"): 

            # This doesn't seem to work with MWEs. 

            type = 'text/html' 

            parts = (sp.split("?")[1]).split("&") 

            word = [p.split("=")[1].replace("+", " ") 

                    for p in parts if p.startswith("nextWord")][0] 

            page, word = page_from_word(word) 

        elif sp.startswith("lookup_"): 

            # TODO add a variation of this that takes a non ecoded word or MWE. 

            type = 'text/html' 

            sp = sp[len("lookup_"):] 

            page, word = page_from_href(sp) 

        elif sp == "start_page": 

            # if this is the first request we should display help 

            # information, and possibly set a default word. 

            type = 'text/html' 

            page, word = page_from_word("wordnet") 

        else: 

            type = 'text/plain' 

            page = "Could not parse request: '%s'" % sp 

        # Send result. 

        self.send_head(type) 

        self.wfile.write(page) 

    def send_head(self, type=None): 

        self.send_response(200) 

        self.send_header('Content-type', type) 

        self.end_headers() 

    def log_message(self, format, *args): 

        global logfile 

        if logfile: 

            logfile.write( 

                "%s - - [%s] %s\n" % 

                (self.address_string(), 

                 self.log_date_time_string(), 

                 format%args)) 

# This data was encoded with the following procedure 

def encode_icon(): 

    f = open("favicon.ico", "rb") 

    s = f.read() 

    f.close() 

    def split(s): 

        if len(s) <= 72: 

            return [s] 

        else: 

            return [s[0:72]] + split(s[72:]) 

    print(split(base64.urlsafe_b64encode(s))) 

FAVICON_BASE64_DATA = \ 

['AAABAAEAEBAAAAAAAABoBQAAFgAAACgAAAAQAAAAIAAAAAEACAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAD___8A9___ANb3_wDO9_8AjPf_ALXv_wCc7_8AjO__AHvv_wBz7_8Aa-__AKXn', 

'_wCc5_8AlOf_AITn_wBz5_8Aa-f_AGPn_wBa5_8Ac97_AGve_wBj3v8AWt7_AFLe_wBK3v8A', 

'Qt7_AFrW_wBS1v8AStb_AELW_wA51v8AMdb_ACnO_wAhzv8AGM7_ABjG_wD___cA__f3APf3', 

'9wB73vcAUtb3AErW9wAhxvcAAMb3AFLO7wAYxu8AEMbvACG95wAYvecA9-fWAHPG1gBKvdYA', 

'Ob3WACG91gDv3s4Axt7OACm1zgCMtb0ASq29ACGlvQBStbUAUq21ADGttQA5pbUA3satAEqc', 

'rQDWvaUAY62lAOfGnADWvZwAtbWcAJStnADGrZQAzq2MAIycjABznIwAa5yMAN61hADWrXsA', 

'zq17AMalewCtpXsAa4x7AMaccwC9nHMAtZRzAISUcwBrjHMAzqVrALWUawCtlGsArYxrAHuE', 

'awBre2sAY3trAHuEYwBzhGMAc3tjAGt7YwDGlFoAvYxaAGNzWgBSa1oAxpRSAK2MUgDGjEoA', 

'vYxKAL2ESgC1hEoArYRKAIRzSgB7a0oAc2tKAGtrSgBaY0oAtYRCAK17QgCle0IApXM5AJxz', 

'OQCcazkAjGMxAIRaMQBzWjEAa1oxAIRaKQB7ShAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA', 

'AAAAAAAAAAAAAAAGFh4YLAYAAAAAAAAAAAAHGB4gIBYWBgAAAAAAAAAAFhgzQR45MixGMQAA', 

'AAAAABQYTF0WbzplWQAAAABFVEgKFExdFG59eywWCwBAdHRJCgpLXRhxe3IvIiIDT2p0VAdh', 

'fn5xbzplciAwFFNqanQ3BwoKChYYGB4gICxYanRqalRPWVRZRhMYHiAYTmlqdnZ2dnh5eX1G', 

'FhgeFEVjaT1SVithKzg7WhMYGAsATmM9UjgwXDt2eFsIFgcAAAAAFDRDLUo-bnhZAAAAAAAA', 

'AAgwRS1cO3Z2WgAAAAAAAAADUTZHbVJ0d0kAAAAAAAAAADFPY2pqZEgAAAAAAAAA__8AAP__', 

'AAD__wAAsaEAAE5eAABOXgAA__4AAPv_AAD__wAA__8AAM3-AADw_wAA__8AAML-AAD__wAA', 

'xf4='] 

def favicon_data(): 

    """ 

    Return the data for the favicon image. 

    """ 

    return base64.urlsafe_b64decode(''.join(FAVICON_BASE64_DATA)) 

def get_unique_counter_from_url(sp): 

    """ 

    Extract the unique counter from the URL if it has one.  Otherwise return 

    null. 

    """ 

    pos = sp.rfind('%23') 

    if pos != -1: 

        return int(sp[(pos + 3):]) 

    else: 

        return None 

def wnb(port=8000, runBrowser=True, logfilename=None): 

    """ 

    Run NLTK Wordnet Browser Server. 

    :param port: The port number for the server to listen on, defaults to 

                 8000 

    :type  port: int 

    :param runBrowser: True to start a web browser and point it at the web 

                       server. 

    :type  runBrowser: bool 

    """ 

    # The webbrowser module is unpredictable, typically it blocks if it uses 

    # a console web browser, and doesn't block if it uses a GUI webbrowser, 

    # so we need to force it to have a clear correct behaviour. 

    # 

    # Normally the server should run for as long as the user wants. they 

    # should idealy be able to control this from the UI by closing the 

    # window or tab.  Second best would be clicking a button to say 

    # 'Shutdown' that first shutsdown the server and closes the window or 

    # tab, or exits the text-mode browser.  Both of these are unfreasable. 

    # 

    # The next best alternative is to start the server, have it close when 

    # it receives SIGTERM (default), and run the browser as well.  The user 

    # may have to shutdown both programs. 

    # 

    # Since webbrowser may block, and the webserver will block, we must run 

    # them in separate threads. 

    # 

    global server_mode, logfile 

    server_mode = not runBrowser 

    # Setup logging. 

    if logfilename: 

        try: 

            logfile = open(logfilename, "a", 1) # 1 means 'line buffering' 

        except IOError as e: 

            sys.stderr.write("Couldn't open %s for writing: %s", 

                             logfilename, e) 

            sys.exit(1) 

    else: 

        logfile = None 

    # Compute URL and start web browser 

    url = 'http://localhost:' + str(port) 

    if runBrowser: 

        server_ready = threading.Event() 

        browser_thread = startBrowser(url, server_ready) 

    # Start the server. 

    server = HTTPServer(('', port), MyServerHandler) 

    if logfile: 

        logfile.write( 

            'NLTK Wordnet browser server running serving: %s\n' % url) 

    if runBrowser: 

        server_ready.set() 

    try: 

        server.serve_forever() 

    except KeyboardInterrupt: 

        pass 

    if runBrowser: 

        browser_thread.join() 

def startBrowser(url, server_ready): 

    def run(): 

        server_ready.wait() 

        time.sleep(1) # Wait a little bit more, there's still the chance of 

                      # a race condition. 

        webbrowser.open(url, new = 2, autoraise = 1) 

    t = threading.Thread(target=run) 

    t.start() 

    return t 

##################################################################### 

# Utilities 

##################################################################### 

""" 

WordNet Browser Utilities. 

This provides a backend to both wxbrowse and browserver.py. 

""" 

################################################################################ 

# 

# Main logic for wordnet browser. 

# 

# This is wrapped inside a function since wn is only available if the 

# WordNet corpus is installed. 

def _pos_tuples(): 

    return [ 

        (wn.NOUN,'N','noun'), 

        (wn.VERB,'V','verb'), 

        (wn.ADJ,'J','adj'), 

        (wn.ADV,'R','adv')] 

def _pos_match(pos_tuple): 

    """ 

    This function returns the complete pos tuple for the partial pos 

    tuple given to it.  It attempts to match it against the first 

    non-null component of the given pos tuple. 

    """ 

    if pos_tuple[0] == 's': 

        pos_tuple = ('a', pos_tuple[1], pos_tuple[2]) 

    for n,x in enumerate(pos_tuple): 

        if x is not None: 

            break 

    for pt in _pos_tuples(): 

        if pt[n] == pos_tuple[n]: return pt 

    return None 

HYPONYM = 0 

HYPERNYM = 1 

CLASS_REGIONAL = 2 

PART_HOLONYM = 3 

PART_MERONYM = 4 

ATTRIBUTE = 5 

SUBSTANCE_HOLONYM = 6 

SUBSTANCE_MERONYM = 7 

MEMBER_HOLONYM = 8 

MEMBER_MERONYM = 9 

VERB_GROUP = 10 

INSTANCE_HYPONYM = 12 

INSTANCE_HYPERNYM = 13 

CAUSE = 14 

ALSO_SEE = 15 

SIMILAR = 16 

ENTAILMENT = 17 

ANTONYM = 18 

FRAMES = 19 

PERTAINYM = 20 

CLASS_CATEGORY = 21 

CLASS_USAGE = 22 

CLASS_REGIONAL = 23 

CLASS_USAGE = 24 

CLASS_CATEGORY = 11 

DERIVATIONALLY_RELATED_FORM = 25 

INDIRECT_HYPERNYMS = 26 

def lemma_property(word, synset, func): 

    def flattern(l): 

        if l == []: 

            return [] 

        else: 

            return l[0] + flattern(l[1:]) 

    return flattern([func(l) for l in synset.lemmas if l.name == word]) 

def rebuild_tree(orig_tree): 

    node = orig_tree[0] 

    children = orig_tree[1:] 

    return (node, [rebuild_tree(t) for t in children]) 

def get_relations_data(word, synset): 

    """ 

    Get synset relations data for a synset.  Note that this doesn't 

    yet support things such as full hyponym vs direct hyponym. 

    """ 

    if synset.pos == wn.NOUN: 

        return ((HYPONYM, 'Hyponyms', 

                   synset.hyponyms()), 

                (INSTANCE_HYPONYM , 'Instance hyponyms', 

                   synset.instance_hyponyms()), 

                (HYPERNYM, 'Direct hypernyms', 

                   synset.hypernyms()), 

                (INDIRECT_HYPERNYMS, 'Indirect hypernyms', 

                   rebuild_tree(synset.tree(lambda x: x.hypernyms()))[1]), 

#  hypernyms', 'Sister terms', 

                (INSTANCE_HYPERNYM , 'Instance hypernyms', 

                   synset.instance_hypernyms()), 

#            (CLASS_REGIONAL, ['domain term region'], ), 

                (PART_HOLONYM, 'Part holonyms', 

                   synset.part_holonyms()), 

                (PART_MERONYM, 'Part meronyms', 

                   synset.part_meronyms()), 

                (SUBSTANCE_HOLONYM, 'Substance holonyms', 

                   synset.substance_holonyms()), 

                (SUBSTANCE_MERONYM, 'Substance meronyms', 

                   synset.substance_meronyms()), 

                (MEMBER_HOLONYM, 'Member holonyms', 

                   synset.member_holonyms()), 

                (MEMBER_MERONYM, 'Member meronyms', 

                   synset.member_meronyms()), 

                (ATTRIBUTE, 'Attributes', 

                   synset.attributes()), 

                (ANTONYM, "Antonyms", 

                   lemma_property(word, synset, lambda l: l.antonyms())), 

                (DERIVATIONALLY_RELATED_FORM, "Derivationally related form", 

                   lemma_property(word, synset, lambda l: l.derivationally_related_forms()))) 

    elif synset.pos == wn.VERB: 

        return ((ANTONYM, 'Antonym', 

                   lemma_property(word, synset, lambda l: l.antonyms())), 

                (HYPONYM, 'Hyponym', 

                   synset.hyponyms()), 

                (HYPERNYM, 'Direct hypernyms', 

                   synset.hypernyms()), 

                (INDIRECT_HYPERNYMS, 'Indirect hypernyms', 

                   rebuild_tree(synset.tree(lambda x: x.hypernyms()))[1]), 

                (ENTAILMENT, 'Entailments', 

                   synset.entailments()), 

                (CAUSE, 'Causes', 

                   synset.causes()), 

                (ALSO_SEE, 'Also see', 

                   synset.also_sees()), 

                (VERB_GROUP, 'Verb Groups', 

                   synset.verb_groups()), 

                (DERIVATIONALLY_RELATED_FORM, "Derivationally related form", 

                   lemma_property(word, synset, lambda l: l.derivationally_related_forms()))) 

    elif synset.pos == wn.ADJ or synset.pos == wn.ADJ_SAT: 

        return ((ANTONYM, 'Antonym', 

                   lemma_property(word, synset, lambda l: l.antonyms())), 

                (SIMILAR, 'Similar to', 

                   synset.similar_tos()), 

                # Participle of verb - not supported by corpus 

                (PERTAINYM, 'Pertainyms', 

                   lemma_property(word, synset, lambda l: l.pertainyms())), 

                (ATTRIBUTE, 'Attributes', 

                   synset.attributes()), 

                (ALSO_SEE, 'Also see', 

                   synset.also_sees())) 

    elif synset.pos == wn.ADV: 

        # This is weird. adverbs such as 'quick' and 'fast' don't seem 

        # to have antonyms returned by the corpus.a 

        return ((ANTONYM, 'Antonym', 

                   lemma_property(word, synset, lambda l: l.antonyms())),) 

                # Derived from adjective - not supported by corpus 

    else: 

        raise TypeError("Unhandles synset POS type: " + str(synset.pos)) 

html_header = ''' 

<!DOCTYPE html PUBLIC '-//W3C//DTD HTML 4.01//EN' 

'http://www.w3.org/TR/html4/strict.dtd'> 

<html> 

<head> 

<meta name='generator' content= 

'HTML Tidy for Windows (vers 14 February 2006), see www.w3.org'> 

<meta http-equiv='Content-Type' content= 

'text/html; charset=us-ascii'> 

<title>NLTK Wordnet Browser display of: %s</title></head> 

<body bgcolor='#F5F5F5' text='#000000'> 

''' 

html_trailer = ''' 

</body> 

</html> 

''' 

explanation  = ''' 

<h3>Search Help</h3> 

<ul><li>The display below the line is an example of the output the browser 

shows you when you enter a search word. The search word was <b>green</b>.</li> 

<li>The search result shows for different parts of speech the <b>synsets</b> 

i.e. different meanings for the word.</li> 

<li>All underlined texts are hypertext links. There are two types of links: 

word links and others. Clicking a word link carries out a search for the word 

in the Wordnet database.</li> 

<li>Clicking a link of the other type opens a display section of data attached 

to that link. Clicking that link a second time closes the section again.</li> 

<li>Clicking <u>S:</u> opens a section showing the relations for that synset. 

</li> 

<li>Clicking on a relation name opens a section that displays the associated 

synsets.</li> 

<li>Type a search word in the <b>Word</b> field and start the search by the 

<b>Enter/Return</b> key or click the <b>Search</b> button.</li> 

</ul> 

<hr width='100%'> 

''' 

# HTML oriented functions 

def _bold(txt): return '<b>%s</b>' % txt 

def _center(txt): return '<center>%s</center>' % txt 

def _hlev(n,txt): return '<h%d>%s</h%d>' % (n,txt,n) 

def _italic(txt): return '<i>%s</i>' % txt 

def _li(txt): return '<li>%s</li>' % txt 

def pg(word, body): 

    ''' 

    Return a HTML page of NLTK Browser format constructed from the 

    word and body 

    :param word: The word that the body corresponds to 

    :type word: str 

    :param body: The HTML body corresponding to the word 

    :type body: str 

    :return: a HTML page for the word-body combination 

    :rtype: str 

    ''' 

    return (html_header % word) + body + html_trailer 

def _ul(txt): return '<ul>' + txt + '</ul>' 

def _abbc(txt): 

    """ 

    abbc = asterisks, breaks, bold, center 

    """ 

    return _center(_bold('<br>'*10 + '*'*10 + ' ' + txt + ' ' + '*'*10)) 

full_hyponym_cont_text = \ 

    _ul(_li(_italic('(has full hyponym continuation)'))) + '\n' 

def _get_synset(synset_key): 

    """ 

    The synset key is the unique name of the synset, this can be 

    retrived via synset.name 

    """ 

    return wn.synset(synset_key) 

def _collect_one_synset(word, synset, synset_relations): 

    ''' 

    Returns the HTML string for one synset or word 

    :param word: the current word 

    :type word: str 

    :param synset: a synset 

    :type synset: synset 

    :param synset_relations: information about which synset relations 

    to display. 

    :type synset_relations: dict(synset_key, set(relation_id)) 

    :return: The HTML string built for this synset 

    :rtype: str 

    ''' 

    if isinstance(synset, tuple): # It's a word 

        raise NotImplementedError("word not supported by _collect_one_synset") 

    typ = 'S' 

    pos_tuple = _pos_match((synset.pos, None, None)) 

    assert pos_tuple is not None, "pos_tuple is null: synset.pos: %s" % synset.pos 

    descr = pos_tuple[2] 

    ref = copy.deepcopy(Reference(word, synset_relations)) 

    ref.toggle_synset(synset) 

    synset_label = typ + ";" 

    if synset.name in synset_relations.keys(): 

        synset_label = _bold(synset_label) 

    s = '<li>%s (%s) ' % (make_lookup_link(ref, synset_label), descr) 

    def format_lemma(w): 

        w = w.replace('_', ' ') 

        if w.lower() == word: 

            return _bold(w) 

        else: 

            ref = Reference(w) 

            return make_lookup_link(ref, w) 

    s += ', '.join([format_lemma(l.name) for l in synset.lemmas]) 

    gl = " (%s) <i>%s</i> " % \ 

        (synset.definition, 

         "; ".join(["\"%s\"" % e for e in synset.examples])) 

    return s + gl + _synset_relations(word, synset, synset_relations) + '</li>\n' 

def _collect_all_synsets(word, pos, synset_relations=dict()): 

    """ 

    Return a HTML unordered list of synsets for the given word and 

    part of speech. 

    """ 

    return '<ul>%s\n</ul>\n' % \ 

        ''.join((_collect_one_synset(word, synset, synset_relations) 

                 for synset 

                 in wn.synsets(word, pos))) 

def _synset_relations(word, synset, synset_relations): 

    ''' 

    Builds the HTML string for the relations of a synset 

    :param word: The current word 

    :type word: str 

    :param synset: The synset for which we're building the relations. 

    :type synset: Synset 

    :param synset_relations: synset keys and relation types for which to display relations. 

    :type synset_relations: dict(synset_key, set(relation_type)) 

    :return: The HTML for a synset's relations 

    :rtype: str 

    ''' 

    if not synset.name in synset_relations.keys(): 

        return "" 

    ref = Reference(word, synset_relations) 

    def relation_html(r): 

        if isinstance(r, Synset): 

            return make_lookup_link(Reference(r.lemma_names[0]), r.lemma_names[0]) 

        elif isinstance(r, Lemma): 

            return relation_html(r.synset) 

        elif isinstance(r, tuple): 

            # It's probably a tuple containing a Synset and a list of 

            # similar tuples.  This forms a tree of synsets. 

            return "%s\n<ul>%s</ul>\n" % \ 

                (relation_html(r[0]), 

                 ''.join('<li>%s</li>\n' % relation_html(sr) for sr in r[1])) 

        else: 

            raise TypeError("r must be a synset, lemma or list, it was: type(r) = %s, r = %s" % (type(r), r)) 

    def make_synset_html(db_name, disp_name, rels): 

        synset_html = '<i>%s</i>\n' % \ 

            make_lookup_link( 

                copy.deepcopy(ref).toggle_synset_relation(synset, db_name).encode(), 

                disp_name) 

        if db_name in ref.synset_relations[synset.name]: 

             synset_html += '<ul>%s</ul>\n' % \ 

                ''.join("<li>%s</li>\n" % relation_html(r) for r in rels) 

        return synset_html 

    html = '<ul>' + \ 

        '\n'.join(("<li>%s</li>" % make_synset_html(*rel_data) for rel_data 

                   in get_relations_data(word, synset) 

                   if rel_data[2] != [])) + \ 

        '</ul>' 

    return html 

class Reference(object): 

    """ 

    A reference to a page that may be generated by page_word 

    """ 

    def __init__(self, word, synset_relations=dict()): 

        """ 

        Build a reference to a new page. 

        word is the word or words (separated by commas) for which to 

        search for synsets of 

        synset_relations is a dictionary of synset keys to sets of 

        synset relation identifaiers to unfold a list of synset 

        relations for. 

        """ 

        self.word = word 

        self.synset_relations = synset_relations 

    def encode(self): 

        """ 

        Encode this reference into a string to be used in a URL. 

        """ 

        # This uses a tuple rather than an object since the python 

        # pickle representation is much smaller and there is no need 

        # to represent the complete object. 

        string = cPickle.dumps((self.word, self.synset_relations), -1) 

        return base64.urlsafe_b64encode(string) 

    def toggle_synset_relation(self, synset, relation): 

        """ 

        Toggle the display of the relations for the given synset and 

        relation type. 

        This function will throw a KeyError if the synset is currently 

        not being displayed. 

        """ 

        if relation in self.synset_relations[synset.name]: 

            self.synset_relations[synset.name].remove(relation) 

        else: 

            self.synset_relations[synset.name].add(relation) 

        return self 

    def toggle_synset(self, synset): 

        """ 

        Toggle displaying of the relation types for the given synset 

        """ 

        if synset.name in self.synset_relations.keys(): 

            del self.synset_relations[synset.name] 

        else: 

            self.synset_relations[synset.name] = set() 

        return self 

def decode_reference(string): 

    """ 

    Decode a reference encoded with Reference.encode 

    """ 

    string = base64.urlsafe_b64decode(string) 

    word, synset_relations = cPickle.loads(string) 

    return Reference(word, synset_relations) 

def make_lookup_link(ref, label): 

    return '<a href="lookup_%s">%s</a>' % (ref.encode(), label) 

def page_from_word(word): 

    """ 

    Return a HTML page for the given word. 

    :param word: The currently active word 

    :type word: str 

    :return: A tuple (page,word), where page is the new current HTML page 

             to be sent to the browser and 

             word is the new current word 

    :rtype: A tuple (str,str) 

    """ 

    return page_from_reference(Reference(word)) 

def page_from_href(href): 

    ''' 

    Returns a tuple of the HTML page built and the new current word 

    :param href: The hypertext reference to be solved 

    :type href: str 

    :return: A tuple (page,word), where page is the new current HTML page 

             to be sent to the browser and 

             word is the new current word 

    :rtype: A tuple (str,str) 

    ''' 

    return page_from_reference(decode_reference(href)) 

def page_from_reference(href): 

    ''' 

    Returns a tuple of the HTML page built and the new current word 

    :param href: The hypertext reference to be solved 

    :type href: str 

    :return: A tuple (page,word), where page is the new current HTML page 

             to be sent to the browser and 

             word is the new current word 

    :rtype: A tuple (str,str) 

    ''' 

    word = href.word 

    pos_forms = defaultdict(list) 

    words = word.split(',') 

    words = [w for w in [w.strip().lower().replace(' ', '_') 

                         for w in words] 

             if w != ""] 

    if len(words) == 0: 

        # No words were found. 

        return "", "Please specify a word to search for." 

    # This looks up multiple words at once.  This is probably not 

    # necessary and may lead to problems. 

    for pos in [wn.NOUN, wn.VERB, wn.ADJ, wn.ADV]: 

        form = wn.morphy(w, pos) 

        if form and form not in pos_forms[pos]: 

            pos_forms[pos].append(form) 

    body = '' 

    for pos,pos_str,name in _pos_tuples(): 

        if pos in pos_forms: 

            body += _hlev(3, name) + '\n' 

            for w in pos_forms[pos]: 

                # Not all words of exc files are in the database, skip 

                # to the next word if a KeyError is raised. 

                try: 

                    body += _collect_all_synsets(w, pos, href.synset_relations) 

                except KeyError: 

                    pass 

    if not body: 

        body = "The word or words '%s' where not found in the dictonary." % word 

    return body, word 

##################################################################### 

# Static pages 

##################################################################### 

def get_static_page_by_path(path): 

    """ 

    Return a static HTML page from the path given. 

    """ 

    if path == "index_2.html": 

        return get_static_index_page(False) 

    elif path == "index.html": 

        return get_static_index_page(True) 

    elif path == "NLTK Wordnet Browser Database Info.html": 

        return "Display of Wordnet Database Statistics is not supported" 

    elif path == "upper_2.html": 

        return get_static_upper_page(False) 

    elif path == "upper.html": 

        return get_static_upper_page(True) 

    elif path == "web_help.html": 

        return get_static_web_help_page() 

    elif path == "wx_help.html": 

        return get_static_wx_help_page() 

    else: 

        return "Internal error: Path for static page '%s' is unknown" % path 

    f = open(path) 

    page = f.read() 

    f.close() 

    return page 

def get_static_web_help_page(): 

    """ 

    Return the static web help page. 

    """ 

    return \ 

""" 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 

<html> 

     <!-- Natural Language Toolkit: Wordnet Interface: Graphical Wordnet Browser 

            Copyright (C) 2001-2012 NLTK Project 

            Author: Jussi Salmela <jtsalmela@users.sourceforge.net> 

            URL: <http://www.nltk.org/> 

            For license information, see LICENSE.TXT --> 

     <head> 

          <meta http-equiv='Content-Type' content='text/html; charset=us-ascii'> 

          <title>NLTK Wordnet Browser display of: * Help *</title> 

     </head> 

<body bgcolor='#F5F5F5' text='#000000'> 

<h2>NLTK Wordnet Browser Help</h2> 

<p>The NLTK Wordnet Browser is a tool to use in browsing the Wordnet database. It tries to behave like the Wordnet project's web browser but the difference is that the NLTK Wordnet Browser uses a local Wordnet database. 

<p><b>You are using the Javascript client part of the NLTK Wordnet BrowseServer.</b> We assume your browser is in tab sheets enabled mode.</p> 

<p>For background information on Wordnet, see the Wordnet project home page: <a href="http://wordnet.princeton.edu/"><b> http://wordnet.princeton.edu/</b></a>. For more information on the NLTK project, see the project home: 

<a href="http://nltk.sourceforge.net/"><b>http://nltk.sourceforge.net/</b></a>. To get an idea of what the Wordnet version used by this browser includes choose <b>Show Database Info</b> from the <b>View</b> submenu.</p> 

<h3>Word search</h3> 

<p>The word to be searched is typed into the <b>New Word</b> field and the search started with Enter or by clicking the <b>Search</b> button. There is no uppercase/lowercase distinction: the search word is transformed to lowercase before the search.</p> 

<p>In addition, the word does not have to be in base form. The browser tries to find the possible base form(s) by making certain morphological substitutions. Typing <b>fLIeS</b> as an obscure example gives one <a href="MfLIeS">this</a>. Click the previous link to see what this kind of search looks like and then come back to this page by using the <b>Alt+LeftArrow</b> key combination.</p> 

<p>The result of a search is a display of one or more 

<b>synsets</b> for every part of speech in which a form of the 

search word was found to occur. A synset is a set of words 

having the same sense or meaning. Each word in a synset that is 

underlined is a hyperlink which can be clicked to trigger an 

automatic search for that word.</p> 

<p>Every synset has a hyperlink <b>S:</b> at the start of its 

display line. Clicking that symbol shows you the name of every 

<b>relation</b> that this synset is part of. Every relation name is a hyperlink that opens up a display for that relation. Clicking it another time closes the display again. Clicking another relation name on a line that has an opened relation closes the open relation and opens the clicked relation.</p> 

<p>It is also possible to give two or more words or collocations to be searched at the same time separating them with a comma like this <a href="Mcheer up,clear up">cheer up,clear up</a>, for example. Click the previous link to see what this kind of search looks like and then come back to this page by using the <b>Alt+LeftArrow</b> key combination. As you could see the search result includes the synsets found in the same order than the forms were given in the search field.</p> 

<p> 

There are also word level (lexical) relations recorded in the Wordnet database. Opening this kind of relation displays lines with a hyperlink <b>W:</b> at their beginning. Clicking this link shows more info on the word in question.</p> 

<h3>The Buttons</h3> 

<p>The <b>Search</b> and <b>Help</b> buttons need no more explanation. </p> 

<p>The <b>Show Database Info</b> button shows a collection of Wordnet database statistics.</p> 

<p>The <b>Shutdown the Server</b> button is shown for the first client of the BrowServer program i.e. for the client that is automatically launched when the BrowServer is started but not for the succeeding clients in order to protect the server from accidental shutdowns. 

</p></body> 

</html> 

""" 

def get_static_welcome_message(): 

    """ 

    Get the static welcome page. 

    """ 

    return \ 

""" 

<h3>Search Help</h3> 

<ul><li>The display below the line is an example of the output the browser 

shows you when you enter a search word. The search word was <b>green</b>.</li> 

<li>The search result shows for different parts of speech the <b>synsets</b> 

i.e. different meanings for the word.</li> 

<li>All underlined texts are hypertext links. There are two types of links: 

word links and others. Clicking a word link carries out a search for the word 

in the Wordnet database.</li> 

<li>Clicking a link of the other type opens a display section of data attached 

to that link. Clicking that link a second time closes the section again.</li> 

<li>Clicking <u>S:</u> opens a section showing the relations for that synset.</li> 

<li>Clicking on a relation name opens a section that displays the associated 

synsets.</li> 

<li>Type a search word in the <b>Next Word</b> field and start the search by the 

<b>Enter/Return</b> key or click the <b>Search</b> button.</li> 

</ul> 

""" 

def get_static_index_page(with_shutdown): 

    """ 

    Get the static index page. 

    """ 

    template = \ 

""" 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN"  "http://www.w3.org/TR/html4/frameset.dtd"> 

<HTML> 

     <!-- Natural Language Toolkit: Wordnet Interface: Graphical Wordnet Browser 

            Copyright (C) 2001-2012 NLTK Project 

            Author: Jussi Salmela <jtsalmela@users.sourceforge.net> 

            URL: <http://www.nltk.org/> 

            For license information, see LICENSE.TXT --> 

     <HEAD> 

         <TITLE>NLTK Wordnet Browser</TITLE> 

     </HEAD> 

<frameset rows="7%%,93%%"> 

    <frame src="%s" name="header"> 

    <frame src="start_page" name="body"> 

</frameset> 

</HTML> 

""" 

    if with_shutdown: 

        upper_link = "upper.html" 

    else: 

        upper_link = "upper_2.html" 

    return template % upper_link 

def get_static_upper_page(with_shutdown): 

    """ 

    Return the upper frame page, 

    If with_shutdown is True then a 'shutdown' button is also provided 

    to shutdown the server. 

    """ 

    template = \ 

""" 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 

<html> 

    <!-- Natural Language Toolkit: Wordnet Interface: Graphical Wordnet Browser 

        Copyright (C) 2001-2012 NLTK Project 

        Author: Jussi Salmela <jtsalmela@users.sourceforge.net> 

        URL: <http://www.nltk.org/> 

        For license information, see LICENSE.TXT --> 

    <head> 

                <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> 

        <title>Untitled Document</title> 

    </head> 

    <body> 

    <form method="GET" action="search" target="body"> 

            Current Word:&nbsp;<input type="text" id="currentWord" size="10" disabled> 

            Next Word:&nbsp;<input type="text" id="nextWord" name="nextWord" size="10"> 

            <input name="searchButton" type="submit" value="Search"> 

    </form> 

        <a target="body" href="web_help.html">Help</a> 

        %s 

</body> 

</html> 

""" 

    if with_shutdown: 

        shutdown_link = "<a href=\"SHUTDOWN THE SERVER\">Shutdown</a>" 

    else: 

        shutdown_link = "" 

    return template % shutdown_link 

def usage(): 

    """ 

    Display the command line help message. 

    """ 

    print(__doc__) 

def app(): 

    # Parse and interpret options. 

    (opts, _) = getopt.getopt(argv[1:], "l:p:sh", 

                              ["logfile=", "port=", "server-mode", "help"]) 

    port = 8000 

    server_mode = False 

    help_mode = False 

    logfilename = None 

    for (opt, value) in opts: 

        if (opt == "-l") or (opt == "--logfile"): 

            logfilename = str(value) 

        elif (opt == "-p") or (opt == "--port"): 

            port = int(value) 

        elif (opt == "-s") or (opt == "--server-mode"): 

            server_mode = True 

        elif (opt == "-h") or (opt == "--help"): 

            help_mode = True 

    if help_mode: 

        usage() 

    else: 

        wnb(port, not server_mode, logfilename) 

if __name__ == '__main__': 

    app() 

__all__ = ['app']