Gecko [ v99win.today ]

Name	Size	Permission
Icons	[ DIR ]	drwxr-xr-x
idle_test	[ DIR ]	drwxr-xr-x
CREDITS.txt	2.1 KB	-rw-r--r--
ChangeLog	55.04 KB	-rw-r--r--
HISTORY.txt	10.07 KB	-rw-r--r--
NEWS2x.txt	26.54 KB	-rw-r--r--
News3.txt	54.67 KB	-rw-r--r--
README.txt	11.38 KB	-rw-r--r--
TODO.txt	8.28 KB	-rw-r--r--
__init__.py	396 B	-rw-r--r--
__main__.py	159 B	-rw-r--r--
autocomplete.py	9.13 KB	-rw-r--r--
autocomplete_w.py	20.37 KB	-rw-r--r--
autoexpand.py	3.14 KB	-rw-r--r--
browser.py	8.39 KB	-rw-r--r--
calltip.py	7.1 KB	-rw-r--r--
calltip_w.py	6.92 KB	-rw-r--r--
codecontext.py	11.15 KB	-rw-r--r--
colorizer.py	14.44 KB	-rw-r--r--
config-extensions.def	2.21 KB	-rw-r--r--
config-highlight.def	2.8 KB	-rw-r--r--
config-keys.def	10.65 KB	-rw-r--r--
config-main.def	3.09 KB	-rw-r--r--
config.py	37.5 KB	-rw-r--r--
config_key.py	14.87 KB	-rw-r--r--
configdialog.py	102.84 KB	-rw-r--r--
debugger.py	20.5 KB	-rw-r--r--
debugger_r.py	11.83 KB	-rw-r--r--
debugobj.py	4.08 KB	-rw-r--r--
debugobj_r.py	1.06 KB	-rw-r--r--
delegator.py	1.02 KB	-rw-r--r--
dynoption.py	1.95 KB	-rw-r--r--
editor.py	67.93 KB	-rw-r--r--
extend.txt	3.55 KB	-rw-r--r--
filelist.py	3.78 KB	-rw-r--r--
format.py	15.41 KB	-rw-r--r--
grep.py	7.34 KB	-rw-r--r--
help.html	76.68 KB	-rw-r--r--
help.py	11.69 KB	-rw-r--r--
help_about.py	8.76 KB	-rw-r--r--
history.py	3.97 KB	-rw-r--r--
hyperparser.py	12.59 KB	-rw-r--r--
idle.bat	177 B	-rw-r--r--
idle.py	454 B	-rw-r--r--
idle.pyw	570 B	-rw-r--r--
iomenu.py	15.78 KB	-rw-r--r--
macosx.py	9.07 KB	-rw-r--r--
mainmenu.py	3.85 KB	-rw-r--r--
multicall.py	18.21 KB	-rw-r--r--
outwin.py	5.57 KB	-rw-r--r--
parenmatch.py	7.04 KB	-rw-r--r--
pathbrowser.py	3.02 KB	-rw-r--r--
percolator.py	3.48 KB	-rw-r--r--
pyparse.py	19.4 KB	-rw-r--r--
pyshell.py	60.76 KB	-rwxr-xr-x
query.py	14.71 KB	-rw-r--r--
redirector.py	6.67 KB	-rw-r--r--
replace.py	9.57 KB	-rw-r--r--
rpc.py	20.58 KB	-rw-r--r--
run.py	21.36 KB	-rw-r--r--
runscript.py	8.08 KB	-rw-r--r--
scrolledlist.py	4.37 KB	-rw-r--r--
search.py	5.44 KB	-rw-r--r--
searchbase.py	7.67 KB	-rw-r--r--
searchengine.py	7.2 KB	-rw-r--r--
sidebar.py	19.85 KB	-rw-r--r--
squeezer.py	12.53 KB	-rw-r--r--
stackviewer.py	3.92 KB	-rw-r--r--
statusbar.py	1.44 KB	-rw-r--r--
textview.py	6.65 KB	-rw-r--r--
tooltip.py	6.51 KB	-rw-r--r--
tree.py	16.1 KB	-rw-r--r--
undo.py	10.76 KB	-rw-r--r--
util.py	1.28 KB	-rw-r--r--
window.py	2.55 KB	-rw-r--r--
zoomheight.py	4.1 KB	-rw-r--r--
zzdummy.py	1.96 KB	-rw-r--r--

Code Editor : macosx.py

"""
A number of functions that enhance IDLE on macOS.
"""
from os.path import expanduser
import plistlib
from sys import platform  # Used in _init_tk_type, changed by test.

import tkinter

## Define functions that query the Mac graphics type.
## _tk_type and its initializer are private to this section.

_tk_type = None

def _init_tk_type():
    """ Initialize _tk_type for isXyzTk functions.

This function is only called once, when _tk_type is still None.
    """
    global _tk_type
    if platform == 'darwin':

# When running IDLE, GUI is present, test/* may not be.
        # When running tests, test/* is present, GUI may not be.
        # If not, guess most common.  Does not matter for testing.
        from idlelib.__init__ import testing
        if testing:
            from test.support import requires, ResourceDenied
            try:
                requires('gui')
            except ResourceDenied:
                _tk_type = "cocoa"
                return

root = tkinter.Tk()
        ws = root.tk.call('tk', 'windowingsystem')
        if 'x11' in ws:
            _tk_type = "xquartz"
        elif 'aqua' not in ws:
            _tk_type = "other"
        elif 'AppKit' in root.tk.call('winfo', 'server', '.'):
            _tk_type = "cocoa"
        else:
            _tk_type = "carbon"
        root.destroy()
    else:
        _tk_type = "other"
    return

def isAquaTk():
    """
    Returns True if IDLE is using a native OS X Tk (Cocoa or Carbon).
    """
    if not _tk_type:
        _init_tk_type()
    return _tk_type == "cocoa" or _tk_type == "carbon"

def isCarbonTk():
    """
    Returns True if IDLE is using a Carbon Aqua Tk (instead of the
    newer Cocoa Aqua Tk).
    """
    if not _tk_type:
        _init_tk_type()
    return _tk_type == "carbon"

def isCocoaTk():
    """
    Returns True if IDLE is using a Cocoa Aqua Tk.
    """
    if not _tk_type:
        _init_tk_type()
    return _tk_type == "cocoa"

def isXQuartz():
    """
    Returns True if IDLE is using an OS X X11 Tk.
    """
    if not _tk_type:
        _init_tk_type()
    return _tk_type == "xquartz"

def readSystemPreferences():
    """
    Fetch the macOS system preferences.
    """
    if platform != 'darwin':
        return None

plist_path = expanduser('~/Library/Preferences/.GlobalPreferences.plist')
    try:
        with open(plist_path, 'rb') as plist_file:
            return plistlib.load(plist_file)
    except OSError:
        return None

def preferTabsPreferenceWarning():
    """
    Warn if "Prefer tabs when opening documents" is set to "Always".
    """
    if platform != 'darwin':
        return None

prefs = readSystemPreferences()
    if prefs and prefs.get('AppleWindowTabbingMode') == 'always':
        return (
            'WARNING: The system preference "Prefer tabs when opening'
            ' documents" is set to "Always". This will cause various problems'
            ' with IDLE. For the best experience, change this setting when'
            ' running IDLE (via System Preferences -> Dock).'
        )
    return None

## Fix the menu and related functions.

def addOpenEventSupport(root, flist):
    """
    This ensures that the application will respond to open AppleEvents, which
    makes is feasible to use IDLE as the default application for python files.
    """
    def doOpenFile(*args):
        for fn in args:
            flist.open(fn)

# The command below is a hook in aquatk that is called whenever the app
    # receives a file open event. The callback can have multiple arguments,
    # one for every file that should be opened.
    root.createcommand("::tk::mac::OpenDocument", doOpenFile)

def hideTkConsole(root):
    try:
        root.tk.call('console', 'hide')
    except tkinter.TclError:
        # Some versions of the Tk framework don't have a console object
        pass

def overrideRootMenu(root, flist):
    """
    Replace the Tk root menu by something that is more appropriate for
    IDLE with an Aqua Tk.
    """
    # The menu that is attached to the Tk root (".") is also used by AquaTk for
    # all windows that don't specify a menu of their own. The default menubar
    # contains a number of menus, none of which are appropriate for IDLE. The
    # Most annoying of those is an 'About Tck/Tk...' menu in the application
    # menu.
    #
    # This function replaces the default menubar by a mostly empty one, it
    # should only contain the correct application menu and the window menu.
    #
    # Due to a (mis-)feature of TkAqua the user will also see an empty Help
    # menu.
    from tkinter import Menu
    from idlelib import mainmenu
    from idlelib import window

closeItem = mainmenu.menudefs[0][1][-2]

# Remove the last 3 items of the file menu: a separator, close window and
    # quit. Close window will be reinserted just above the save item, where
    # it should be according to the HIG. Quit is in the application menu.
    del mainmenu.menudefs[0][1][-3:]
    mainmenu.menudefs[0][1].insert(6, closeItem)

# Remove the 'About' entry from the help menu, it is in the application
    # menu
    del mainmenu.menudefs[-1][1][0:2]
    # Remove the 'Configure Idle' entry from the options menu, it is in the
    # application menu as 'Preferences'
    del mainmenu.menudefs[-3][1][0:2]
    menubar = Menu(root)
    root.configure(menu=menubar)

menu = Menu(menubar, name='window', tearoff=0)
    menubar.add_cascade(label='Window', menu=menu, underline=0)

def postwindowsmenu(menu=menu):
        end = menu.index('end')
        if end is None:
            end = -1

if end > 0:
            menu.delete(0, end)
        window.add_windows_to_menu(menu)
    window.register_callback(postwindowsmenu)

def about_dialog(event=None):
        "Handle Help 'About IDLE' event."
        # Synchronize with editor.EditorWindow.about_dialog.
        from idlelib import help_about
        help_about.AboutDialog(root)

def config_dialog(event=None):
        "Handle Options 'Configure IDLE' event."
        # Synchronize with editor.EditorWindow.config_dialog.
        from idlelib import configdialog

# Ensure that the root object has an instance_dict attribute,
        # mirrors code in EditorWindow (although that sets the attribute
        # on an EditorWindow instance that is then passed as the first
        # argument to ConfigDialog)
        root.instance_dict = flist.inversedict
        configdialog.ConfigDialog(root, 'Settings')

def help_dialog(event=None):
        "Handle Help 'IDLE Help' event."
        # Synchronize with editor.EditorWindow.help_dialog.
        from idlelib import help
        help.show_idlehelp(root)

root.bind('<<about-idle>>', about_dialog)
    root.bind('<<open-config-dialog>>', config_dialog)
    root.createcommand('::tk::mac::ShowPreferences', config_dialog)
    if flist:
        root.bind('<<close-all-windows>>', flist.close_all_callback)

# The binding above doesn't reliably work on all versions of Tk
        # on macOS. Adding command definition below does seem to do the
        # right thing for now.
        root.createcommand('::tk::mac::Quit', flist.close_all_callback)

if isCarbonTk():
        # for Carbon AquaTk, replace the default Tk apple menu
        menu = Menu(menubar, name='apple', tearoff=0)
        menubar.add_cascade(label='IDLE', menu=menu)
        mainmenu.menudefs.insert(0,
            ('application', [
                ('About IDLE', '<<about-idle>>'),
                    None,
                ]))
    if isCocoaTk():
        # replace default About dialog with About IDLE one
        root.createcommand('tkAboutDialog', about_dialog)
        # replace default "Help" item in Help menu
        root.createcommand('::tk::mac::ShowHelp', help_dialog)
        # remove redundant "IDLE Help" from menu
        del mainmenu.menudefs[-1][1][0]

def fixb2context(root):
    '''Removed bad AquaTk Button-2 (right) and Paste bindings.

They prevent context menu access and seem to be gone in AquaTk8.6.
    See issue #24801.
    '''
    root.unbind_class('Text', '<B2>')
    root.unbind_class('Text', '<B2-Motion>')
    root.unbind_class('Text', '<<PasteSelection>>')

def setupApp(root, flist):
    """
    Perform initial OS X customizations if needed.
    Called from pyshell.main() after initial calls to Tk()

There are currently three major versions of Tk in use on OS X:
        1. Aqua Cocoa Tk (native default since OS X 10.6)
        2. Aqua Carbon Tk (original native, 32-bit only, deprecated)
        3. X11 (supported by some third-party distributors, deprecated)
    There are various differences among the three that affect IDLE
    behavior, primarily with menus, mouse key events, and accelerators.
    Some one-time customizations are performed here.
    Others are dynamically tested throughout idlelib by calls to the
    isAquaTk(), isCarbonTk(), isCocoaTk(), isXQuartz() functions which
    are initialized here as well.
    """
    if isAquaTk():
        hideTkConsole(root)
        overrideRootMenu(root, flist)
        addOpenEventSupport(root, flist)
        fixb2context(root)

if __name__ == '__main__':
    from unittest import main
    main('idlelib.idle_test.test_macosx', verbosity=2)

${this.title}

Code Editor : macosx.py