The PyMailGUI Module - SharedNames: Program-Wide Globals

(Page 2 of 4 )

The module in Example 15-2 implements a shared, system-wide namespace that collects resources used in most modules in the system, and defines global objects that span files. This allows other files to avoid redundantly repeating common imports, and encapsulates the locations of package imports; it is the only file that must be updated if paths change in the future. Using globals can make programs harder to understand in general (the source of some names is not as clear), but it is reasonable if all such names are collected in a single expected module such as this one (because there is only one place to search for unknown names).

Example 15-2. PP3E\Internet\Email\PyMailGui\SharedNames.py

################################################################ # objects shared by all window classes and main file: program-wide globals ###############################################################

# used in all window, icon titles
appname = 'PyMailGUI 2.1'

# used for list save, open, delete; also for sent messages file
saveMailSeparator = 'PyMailGUI' + ('-'*60) + 'PyMailGUI\n'

# currently viewed mail save files; also for sent-mail file
openSaveFiles     = {}           # 1 window per file,{name:win}

# standard library services
import sys, os, email, webbrowser
from Tkinter       import *
from tkFileDialog  import SaveAs, Open, Directory
from tkMessageBox  import showinfo, showerror, askyesno

# reuse book examples
from PP3E.Gui.Tools  import windows     # window border, exit protocols
from PP3E.Gui.Tools  import threadtools # thread callback queue checker

from PP3E.Internet.Email import mailtools	# load,send,parse,build utilities
from PP3E.Gui.TextEditor import textEditor	# component and pop up
# modules defined here
import mailconfig	# user params: servers, fonts, etc.
import popuputil	# help, busy, passwd pop-up windows
import wraplines	# wrap long message lines
import messagecache	# remember already loaded mail
import PyMailGuiHelp	# user documentation

def printStack(exc_info):
    # debugging: show exception and stack traceback on stdout
    print exc_info[0]
    print exc_info[1]
    import traceback
    traceback.print_tb(exc_info[2], file=sys.stdout)

# thread busy counters for threads run by this GUI
# sendingBusy shared by all send windows, used by main window quit

loadingHdrsBusy = threadtools.ThreadCounter()   # only 1
deletingBusy    = threadtools.ThreadCounter()   # only 1
loadingMsgsBusy = threadtools.ThreadCounter()   # poss many
sendingBusy     = threadtools.ThreadCounter()   # poss many

Next: ListWindows: Message List Windows >>
 

More Python Articles
More By O'Reilly Media

Comments On: The PyMailGUI Module

· This article is an excerpt from the book "Programming Python, Third Edition,"...   >>> Post your comment now!

Buy this book...

This article is excerpted from chapter 15 of the book Programming Python, Third Edition, written by Mark Lutz (O'Reilly, 2006; ISBN: 0596009259). Check it out today at your favorite bookstore. Buy this book now.