mappings.py

import os

from pymod.index import modules

py3b = 'https://docs.python.org/3'
py2b = 'https://docs.python.org/2'
from os.path import join

make = lambda v, *segs: v == 3 and join(py3b, *segs) or join(py2b, *segs)

lib3 = lambda page: make(3, 'library', page)
lib2 = lambda page: make(2, 'library', page)
expanded = {
    '2': {
        'abc': lib2('abc.html'),
        'itertools': lib2('itertools.html'),
        'ifilterfalse': lib2('itertools.html#itertools.ifilterfalse'),
        'izip_longest': lib2('itertools.html#itertools.izip_longest'),

    },
    '3': {
        'abc': lib3('abc.html'),
        'ABC': lib3('abc.html#abc.ABC'),
        'abc.ABC': lib3('abc.html#abc.ABC'),
        'itertools': lib3('itertools.html'),
        'accumulate': lib3('itertools.html#itertools.accumulate'),
        'zip_longest': lib3('itertools.html#itertools.zip_longest'),
    }
}
def abc_same(name):
    expanded['2'][name] = lib2('abc.html#abc.'+name)
    expanded['3'][name] = lib3('abc.html#abc.'+name)

for name in ('ABCMeta', 'ABCMeta.register', 'ABCMeta.__subclasshook__',
             'abstractmethod', 'abstractstaticmethod', 'abstractclassmethod',
             'abstractproperty', 'get_cache_token'):
    abc_same(name)

def itertools_same(name):
    expanded['2'][name] = lib2('itertools.html#itertools.'+name)
    expanded['3'][name] = lib3('itertools.html#itertools.'+name)

for name in ('chain', 'chain.from_iterable', 'combinations',
             'combinations_with_replacement', 'groupby', 'islice',
             'compress', 'count', 'cycle', 'dropwhile', 'filterfalse',
             'permutations', 'product', 'repeat', 'starmap', 'takewhile',
             'tee'):
    itertools_same(name)

prio = ['itertools', 'functools', 'string', 'math', 'os', 'sys', 'pdb', 'operator',
        'random', 're', 'shutil', 'struct', 'ssl', 'abc', 'argparse', 'errno',
        'tempfile', 'textwrap', 'time', 'types', 'uuid', 'warnings', 'xml.dom']

const = lambda n: {
    '3': 'https://docs.python.org/3/library/constants.html#{}'.format(n),
    '2': 'https://docs.python.org/2/library/constants.html#{}'.format(n) }

constants = {
    'False': const('False'),
    'True': const('True'),
    'None': const('None'),
    'NotImplemented': const('NotImplemented'),
    'Ellipsis': const('Ellipsis'),
    '__debug__': const('__debug__'),
    'quit': const('quit'),
    'exit': const('exit'),
    'copyright': const('copyright'),
    'license': const('license'),
    'credits': const('credits') }

mods = modules()

funcs = {'abs', 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes',
         'callable', 'chr', 'classmethod', 'compile', 'complex', 'delattr',
         'dir', 'divmod', 'enumerate', 'eval', 'exec', 'filter', 'float',
         'format', 'getattr', 'globals', 'hasattr', 'hash', 'help', 'hex',
         'id', 'input', 'int', 'isinstance', 'issubclass', 'iter', 'len',
         'locals', 'map', 'max', 'min', 'next', 'object', 'oct', 'open',
         'ord', 'pow', 'print', 'property', 'repr', 'reversed', 'round',
         'setattr', 'slice', 'sorted', 'staticmethod', 'sum', 'super',
         'type', 'vars', 'zip', '__import__'}

structs = {
    'dict': 'dictionaries',
    'set': 'sets',
    'tuple': 'tuples-and-sequences',
    'list': 'more-on-lists'
}

excs = { 'BaseException', 'BaseException.args', 'Exception', 'StandardError',
         'ArithmeticError', 'BufferError', 'LookupError', 'EnvironmentError',
         'AssertionError', 'AttributeError', 'EOFError', 'FloatingPointError',
         'GeneratorExit', 'IOError', 'ImportError', 'IndexError', 'KeyError',
         'KeyboardInterrupt', 'MemoryError', 'NameError', 'NotImplementedError',
         'OSError', 'OverflowError', 'ReferenceError', 'RuntimeError',
         'StopIteration', 'SyntaxError', 'IndentationError', 'TabError',
         'SystemError', 'SystemExit', 'TypeError', 'UnboundLocalError',
         'UnicodeError', 'UnicodeError.encoding', 'UnicodeError.reason',
         'UnicodeError.object', 'UnicodeError.start', 'UnicodeError.end',
         'UnicodeEncodeError', 'UnicodeDecodeError', 'UnicodeTranslateError',
         'ValueError', 'VMSError', 'WindowsError', 'ZeroDivisionError',
         'Warning', 'UserWarning', 'DeprecationWarning',
         'PendingDeprecationWarning', 'SyntaxWarning', 'RuntimeWarning',
         'FutureWarning', 'ImportWarning', 'UnicodeWarning', }

fn3base = 'https://docs.python.org/3/library/functions.html#{}'
structbase = 'https://docs.python.org/{}/tutorial/datastructures.html#{}'
ex3base = 'https://docs.python.org/3/library/exceptions.html#{}'
fn2base = 'https://docs.python.org/2/library/functions.html#{}'
ex2base = 'https://docs.python.org/2/library/exceptions.html#exceptions.{}'

specials = {
    'zen': 'https://www.python.org/dev/peps/pep-0020/',
    'antigravity': 'http://xkcd.com/353/'
}

def url(v, term):
    if term in constants:
        return constants[term][v]
    if term in funcs and v == '3':
        return fn3base.format(term)
    elif term in funcs and v == '2':
        return fn2base.format(term)
    if term in structs:
        return structbase.format(v, structs[term])
        return structbase.format(term)
    if term in excs and v == '3':
        return ex3base.format(term)
    elif term in excs and v == '2':
        return ex2base.format(term)
    elif term in specials:
        return specials[term]
    if v == '2' and term == 'configparser':
        term = 'ConfigParser'
    try:
        return mods[term][v]['M'].replace('ConfigParser.html',
                                          'configparser.html')
    except KeyError:
        pass
    modn = term.split('.')[0]
    if modn:
        mod = mods.get(modn)
        if mod is None:
            for pname in prio:
                if pname in mods:
                    cand = url(v, '{}.{}'.format(pname, term))
                    if cand:
                        return cand
            return None
        return v in mod and mod[v].get(term) or None
    return None