def __testWikiHelpBrowser():
import sys
app = QApplication(sys.argv)
w = WikiHelpBrowser("Here is a wiki page about " + __wikiPageHtmlLink("QWhatsThis and web links") + " to click.")
w.show()
app.connect(app, SIGNAL("lastWindowClosed()"), app, SLOT("quit()"))
app.exec_()
def __testWikiHelpBrowser():
import sys
app = QApplication(sys.argv)
w = WikiHelpBrowser("Here is a wiki page about " +
__wikiPageHtmlLink("QWhatsThis and web links") +
" to click.")
w.show()
app.connect(app, SIGNAL("lastWindowClosed()"), app, SLOT("quit()"))
app.exec_()
def startup_script(main_globals):
"""
This is the main startup script for NE1.
It is intended to be run only once, and only by the code in main.py.
When this function returns, the caller is intended to immediately exit
normally.
Parameter main_globals should be the value of globals() in __main__,
which is needed in case .atom-debug-rc is executed, since it must be
executed in that global namespace.
"""
# Note: importing all of NE1's functionality can take a long time.
# To the extent possible, we want that time to be spent after
# something is visible to the user, but (mostly) before the main
# window is shown to the user (since showing the main window implies
# that NE1 is almost ready to go). So we display a splashscreen
# before doing most imports and initializations, then set up most
# of our data structures and UI commands (thus importing the code
# needed to implement them), and then show the main window.
# (Some experimental commands are initialized after that, so that
# errors that occur then can't prevent the main window from becoming
# visible.)
# TODO: turn the sections of code below into named functions or methods,
# and perhaps split before_most_imports and before_creating_app into
# more named functions or methods. The biggest split should be between
# functions that need to be careful to do very few or no imports,
# and functions that are free to do any imports.
# Windows machines spawn and remove the shell, so no info is normally
# captured. This is a first attempt to try to capture some of the console
# prints that would normally be lost. The default for this code is that
# it's turned off, and should remain that way until it's improved.
if NE1_Build_Constants.NE1_CONSOLE_REDIRECT and os.name == "nt":
capture_console = False
capture_file = ""
# if it's not reporting as python is the executable
if not sys.executable.upper().endswith("PYTHON.EXE") and \
not sys.executable.upper().endswith("PYTHON"):
try:
capture_file = u"".join((sys.executable[:-4], "_console.log"))
sys.stdout = open(capture_file, 'w')
capture_console = True # already trapped, don't try more.
except:
pass
if not capture_console:
# Haven't captured the console log yet. Find the default user
# path and try to capture there this happens if we can't write to
# the normal log location, or if python.exe is the executable.
tmpFilePath = os.path.normpath(os.path.expanduser("~/Nanorex/"))
if not os.path.exists(tmpFilePath): #If it doesn't exist
try:
os.mkdir(tmpFilePath) #Try making one
capture_console = True
except:
pass
# we tried, but there's no easy way to capture the console
if capture_console or os.path.isdir(tmpFilePath):
try: # We made the directory or it already existed, try
# creating the log file.
capture_file = os.path.normpath(u"".join((tmpFilePath, \
"/NE1_console.log")))
sys.stdout = open(capture_file, 'w')
capture_console = True
except:
print >> sys.__stderr__, \
"Failed to create any console log file."
capture_console = False
if capture_console:
# Next two lines are specifically printed to the original console
print >> sys.__stdout__, "The console has been redirected into:"
print >> sys.__stdout__, capture_file.encode("utf_8")
print
print "starting NanoEngineer-1 in [%s]," % os.getcwd(
), time.asctime()
print "using Python: " + sys.version
try:
print "on path: " + sys.executable
except:
pass
# print the version information including official release candidate if it
# is not 0 (false)
if NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE:
print "Version: NanoEngineer-1 v%s_RC%s" % \
(NE1_Build_Constants.NE1_RELEASE_VERSION, \
NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE)
else:
print "Version: NanoEngineer-1 v%s" % \
NE1_Build_Constants.NE1_RELEASE_VERSION
# "Do things that should be done before most imports occur."
startup_before_most_imports.before_most_imports(main_globals)
from PyQt4.Qt import QApplication, QSplashScreen
# "Do things that should be done before creating the application object."
startup_before_most_imports.before_creating_app()
### TODO: this imports undo, env, debug, and it got moved earlier
# in the startup process at some point. Those imports are probably not
# too likely to pull in a lot of others, but if possible we should put up
# the splash screen before doing most of them. Sometime try to figure out
# how to do that. The point of this function is mostly to wrap every signal->slot
# connection -- maybe it's sufficient to do that before creating the main
# window rather than before creating the app? [bruce 071008 comment]
# do some imports used for putting up splashscreen
# (this must be done before any code that loads images from cad/src/ui)
import utilities.icon_utilities as icon_utilities
icon_utilities.initialize_icon_utilities()
# Create the application object (an instance of QApplication).
QApplication.setColorSpec(QApplication.CustomColor)
#russ 080505: Make it global so it can be run under debugging below.
global app
app = QApplication(sys.argv)
# Put up the splashscreen (if its image file can be found in cad/images).
#
# Note for developers:
# If you don't want the splashscreen, just rename the splash image file.
splash_pixmap = icon_utilities.imagename_to_pixmap("images/splash.png")
# splash_pixmap will be null if the image file was not found
if not splash_pixmap.isNull():
splash = QSplashScreen(splash_pixmap) # create the splashscreen
splash.show()
MINIMUM_SPLASH_TIME = 3.0
# I intend to add a user pref for MINIMUM_SPLASH_TIME for A7. mark 060131.
splash_start = time.time()
else:
print "note: splash.png was not found"
# connect the lastWindowClosed signal
from PyQt4.Qt import SIGNAL
app.connect(app, SIGNAL("lastWindowClosed ()"), app.quit)
# NOTE: At this point, it is ok to do arbitrary imports as needed,
# except of experimental code.
# import MWsemantics.
# An old comment (I don't know if it's still true -- bruce 071008):
# this might have side effects other than defining things.
from ne1_ui.MWsemantics import MWsemantics
# initialize modules and data structures
from ne1_startup import startup_misc
# do this here, not earlier, so it's free to do whatever toplevel imports it wants
# [bruce 071008 change]
startup_misc.call_module_init_functions()
startup_misc.register_MMP_RecordParsers()
# do this before reading any mmp files
# create the single main window object
foo = MWsemantics(
) # This does a lot of initialization (in MainWindow.__init__)
import __main__
__main__.foo = foo
# developers often access the main window object using __main__.foo when debugging,
# so this is explicitly supported
# initialize CoNTubGenerator
# TODO: move this into one of the other initialization functions
#Disabling the following code that initializes the ConTub plugin
#(in UI it is called Heterojunction.) The Heterojunction generator or
#ConTubGenerator was never ported to Qt4 platform. The plugin generator
#needs a code cleanup -- ninad 2007-11-16
##import CoNTubGenerator
##CoNTubGenerator.initialize()
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *before* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_pre_main_show
except NameError:
pass
else:
func()
# Do other things that should be done just before showing the main window
startup_misc.pre_main_show(
foo) # this sets foo's geometry, among other things
foo._init_after_geometry_is_set()
if not splash_pixmap.isNull():
# If the MINIMUM_SPLASH_TIME duration has not expired, sleep for a moment.
while time.time() - splash_start < MINIMUM_SPLASH_TIME:
time.sleep(0.1)
splash.finish(foo) # Take away the splashscreen
# show the main window
foo.show()
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *after* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_post_main_show
except NameError:
pass
else:
func()
# do other things after showing the main window
startup_misc.post_main_show(foo)
# start psyco runtime optimizer (EXPERIMENTAL) --
# for doc see http://psyco.sourceforge.net/
#
# Example: it speeds up code like this by 17 times:
# (in my test, Intel Mac OS 10.4, Python 2.4.4)
# x = 17
# for i in range(10**7):
# x += i % 3 - 1
#
# [bruce 080524]
from utilities.debug_prefs import debug_pref, Choice_boolean_False
if debug_pref("Use psyco runtime optimizer (next session)?",
Choice_boolean_False,
prefs_key=True):
# Import Psyco if available
try:
import psyco
## psyco.full() -- insert dna takes a lot of time, then segfaults
# after printing "inside this what's this";
# plan: be more conservative about what it should optimize...
# preferably bind specific functions using psyco.bind().
# For now, just tell it to only optimize the most important ones.
psyco.log() # manual says: log file name looks like xxx.log-psyco
# by default, where xxx is the name of the script you ran
# (when I ran "python main.py" in cad/src, it wrote to main.log-psyco there)
# (maybe we can pass our own pathname as an argument?)
## psyco.profile(0.2) # use profiling, optimize funcs that use
# more than 20% of the time (not sure what that means exactly)
# (seems safe, but from log file, i guess it doesn't do much)
psyco.profile(0.05) # "aggressive"
print "using psyco"
pass
except ImportError:
print "not using psyco"
pass
pass
# Decide whether to do profiling, and if so, with which
# profiling command and into what file. Set local variables
# to record the decision, which are used later when running
# the Qt event loop.
# If the user's .atom-debug-rc specifies PROFILE_WITH_HOTSHOT = True,
# use hotshot, otherwise fall back to vanilla Python profiler.
# (Note: to work, it probably has to import this module
# and set this variable in this module's namespace.)
try:
PROFILE_WITH_HOTSHOT
except NameError:
PROFILE_WITH_HOTSHOT = False
try:
# user can set atom_debug_profile_filename to a filename in .atom-debug-rc,
# to enable profiling into that file. For example:
# % cd
# % cat > .atom-debug-rc
# atom_debug_profile_filename = '/tmp/profile-output'
# ^D
# ... then run NE1, and quit it
# ... then in a python shell:
# import pstats
# p = pstats.Stats('<filename>')
# p.strip_dirs().sort_stats('time').print_stats(100) # order by internal time (top 100 functions)
# p.strip_dirs().sort_stats('cumulative').print_stats(100) # order by cumulative time
atom_debug_profile_filename = main_globals.get(
'atom_debug_profile_filename')
if atom_debug_profile_filename:
print("\nUser's .atom-debug-rc requests profiling into file %r" %
(atom_debug_profile_filename, ))
if not type(atom_debug_profile_filename) in [
type("x"), type(u"x")
]:
print "error: atom_debug_profile_filename must be a string"
assert 0 # caught and ignored, turns off profiling
if PROFILE_WITH_HOTSHOT:
try:
import hotshot
except:
print "error during 'import hotshot'"
raise # caught and ignored, turns off profiling
else:
try:
import cProfile as py_Profile
except ImportError:
print "Unable to import cProfile. Using profile module instead."
py_Profile = None
if py_Profile is None:
try:
import profile as py_Profile
except:
print "error during 'import profile'"
raise # caught and ignored, turns off profiling
except:
print "exception setting up profiling (hopefully reported above); running without profiling"
atom_debug_profile_filename = None
# Create a fake "current exception", to help with debugging
# (in case it's shown inappropriately in a later traceback).
# One time this is seen is if a developer inserts a call to print_compact_traceback
# when no exception is being handled (instead of the intended print_compact_stack).
try:
assert 0, "if you see this exception in a traceback, it is from the" \
" startup script called by main.py, not the code that printed the traceback"
except:
pass
# Handle a mmp file passed to it via the command line. The mmp file
# must be the first argument (after the program name) found on the
# command line. All other arguments are currently ignored and only
# one mmp file can be loaded from the command line.
# old revision with --initial-file is at: svn rev 12759
# Derrick 20080520
if ((len(sys.argv) >= 2) and sys.argv[1].endswith(".mmp")):
foo.fileOpen(sys.argv[1])
# Do other post-startup, pre-event-loop, non-profiled things, if any
# (such as run optional startup commands for debugging).
startup_misc.just_before_event_loop()
if os.environ.has_key('WINGDB_ACTIVE'):
# Hack to burn some Python bytecode periodically so Wing's
# debugger can remain responsive while free-running
# [from http://wingware.com/doc/howtos/pyqt; added by bruce 081227]
# Addendum [bruce 090107]: this timer doesn't noticeably slow down NE1,
# but with or without it, NE1 is about 4x slower in Wing than running
# alone, at least when running test_selection_redraw.py.
print "running under Wing IDE debugger; setting up timer"
from PyQt4 import QtCore
timer = QtCore.QTimer()
def donothing(*args):
x = 0
for i in range(0, 100):
x += i
timer.connect(timer, QtCore.SIGNAL("timeout()"), donothing)
timer.start(200)
# Finally, run the main Qt event loop --
# perhaps with profiling, depending on local variables set above.
# This does not normally return until the user asks NE1 to exit.
# Note that there are three copies of the statement which runs that loop,
# two inside string literals, all of which presumably should be the same.
if atom_debug_profile_filename:
if PROFILE_WITH_HOTSHOT:
profile = hotshot.Profile(atom_debug_profile_filename)
profile.run('app.exec_()')
else:
py_Profile.run(
'from ne1_startup.main_startup import app; app.exec_()',
atom_debug_profile_filename)
print("\nProfile data was presumably saved into %r" %
(atom_debug_profile_filename, ))
else:
# if you change this code, also change both string literals just above
app.exec_()
# Now return to the caller in order to do a normal immediate exit of NE1.
return # from startup_script
getters.sort()
for paramname, getter in getters:
try:
print "param %s = %r" % (paramname, getter())
except:
print_compact_traceback(
"exception trying to get param %s: " % (paramname, ))
print
pass
import sys
a = QApplication(sys.argv)
## filename = "testui.txt"
filename = "../plugins/CoNTub/HJ-params.desc"
desc = get_description(filename)
parent = None # should be win or app?
w = NTdialog(parent, desc) ### also, env to supply prefs, state to control
w.show()
a.connect(a, SIGNAL('lastWindowClosed()'), a, SLOT('quit()'))
print "about to exec_"
a.exec_()
print "exiting, test done"
# end
print "do_ok_btn: printing param values"
getters = self.param_getters.items()
getters.sort()
for paramname, getter in getters:
try:
print "param %s = %r" % (paramname, getter())
except:
print_compact_traceback("exception trying to get param %s: " % (paramname,))
print
pass
import sys
a = QApplication(sys.argv)
## filename = "testui.txt"
filename = "../plugins/CoNTub/HJ-params.desc"
desc = get_description(filename)
parent = None # should be win or app?
w = NTdialog(parent, desc) ### also, env to supply prefs, state to control
w.show()
a.connect(a, SIGNAL('lastWindowClosed()'), a, SLOT('quit()'))
print "about to exec_"
a.exec_()
print "exiting, test done"
# end
def startup_script( main_globals):
"""
This is the main startup script for NE1.
It is intended to be run only once, and only by the code in main.py.
When this function returns, the caller is intended to immediately exit
normally.
Parameter main_globals should be the value of globals() in __main__,
which is needed in case .atom-debug-rc is executed, since it must be
executed in that global namespace.
"""
# Note: importing all of NE1's functionality can take a long time.
# To the extent possible, we want that time to be spent after
# something is visible to the user, but (mostly) before the main
# window is shown to the user (since showing the main window implies
# that NE1 is almost ready to go). So we display a splashscreen
# before doing most imports and initializations, then set up most
# of our data structures and UI commands (thus importing the code
# needed to implement them), and then show the main window.
# (Some experimental commands are initialized after that, so that
# errors that occur then can't prevent the main window from becoming
# visible.)
# TODO: turn the sections of code below into named functions or methods,
# and perhaps split before_most_imports and before_creating_app into
# more named functions or methods. The biggest split should be between
# functions that need to be careful to do very few or no imports,
# and functions that are free to do any imports.
# Windows machines spawn and remove the shell, so no info is normally
# captured. This is a first attempt to try to capture some of the console
# prints that would normally be lost. The default for this code is that
# it's turned off, and should remain that way until it's improved.
if NE1_Build_Constants.NE1_CONSOLE_REDIRECT and os.name == "nt":
capture_console = False
capture_file = ""
# if it's not reporting as python is the executable
if not sys.executable.upper().endswith("PYTHON.EXE") and \
not sys.executable.upper().endswith("PYTHON"):
try:
capture_file = u"".join((sys.executable[:-4], "_console.log"))
sys.stdout = open(capture_file, 'w')
capture_console = True # already trapped, don't try more.
except:
pass
if not capture_console:
# Haven't captured the console log yet. Find the default user
# path and try to capture there this happens if we can't write to
# the normal log location, or if python.exe is the executable.
tmpFilePath = os.path.normpath(os.path.expanduser("~/Nanorex/"))
if not os.path.exists(tmpFilePath): #If it doesn't exist
try:
os.mkdir(tmpFilePath) #Try making one
capture_console = True
except:
pass
# we tried, but there's no easy way to capture the console
if capture_console or os.path.isdir(tmpFilePath):
try: # We made the directory or it already existed, try
# creating the log file.
capture_file = os.path.normpath(u"".join((tmpFilePath, \
"/NE1_console.log")))
sys.stdout = open(capture_file, 'w')
capture_console = True
except:
print >> sys.__stderr__, \
"Failed to create any console log file."
capture_console = False
if capture_console:
# Next two lines are specifically printed to the original console
print >> sys.__stdout__, "The console has been redirected into:"
print >> sys.__stdout__, capture_file.encode("utf_8")
print
print "starting NanoEngineer-1 in [%s]," % os.getcwd(), time.asctime()
print "using Python: " + sys.version
try:
print "on path: " + sys.executable
except:
pass
# print the version information including official release candidate if it
# is not 0 (false)
if NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE:
print "Version: NanoEngineer-1 v%s_RC%s" % \
(NE1_Build_Constants.NE1_RELEASE_VERSION, \
NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE)
else:
print "Version: NanoEngineer-1 v%s" % \
NE1_Build_Constants.NE1_RELEASE_VERSION
# "Do things that should be done before most imports occur."
startup_before_most_imports.before_most_imports( main_globals )
from PyQt4.Qt import QApplication, QSplashScreen
# "Do things that should be done before creating the application object."
startup_before_most_imports.before_creating_app()
### TODO: this imports undo, env, debug, and it got moved earlier
# in the startup process at some point. Those imports are probably not
# too likely to pull in a lot of others, but if possible we should put up
# the splash screen before doing most of them. Sometime try to figure out
# how to do that. The point of this function is mostly to wrap every signal->slot
# connection -- maybe it's sufficient to do that before creating the main
# window rather than before creating the app? [bruce 071008 comment]
# do some imports used for putting up splashscreen
# (this must be done before any code that loads images from cad/src/ui)
import utilities.icon_utilities as icon_utilities
icon_utilities.initialize_icon_utilities()
# Create the application object (an instance of QApplication).
QApplication.setColorSpec(QApplication.CustomColor)
#russ 080505: Make it global so it can be run under debugging below.
global app
app = QApplication(sys.argv)
# Put up the splashscreen (if its image file can be found in cad/images).
#
# Note for developers:
# If you don't want the splashscreen, just rename the splash image file.
splash_pixmap = icon_utilities.imagename_to_pixmap( "images/splash.png" )
# splash_pixmap will be null if the image file was not found
if not splash_pixmap.isNull():
splash = QSplashScreen(splash_pixmap) # create the splashscreen
splash.show()
MINIMUM_SPLASH_TIME = 3.0
# I intend to add a user pref for MINIMUM_SPLASH_TIME for A7. mark 060131.
splash_start = time.time()
else:
print "note: splash.png was not found"
# connect the lastWindowClosed signal
from PyQt4.Qt import SIGNAL
app.connect(app, SIGNAL("lastWindowClosed ()"), app.quit)
# NOTE: At this point, it is ok to do arbitrary imports as needed,
# except of experimental code.
# import MWsemantics.
# An old comment (I don't know if it's still true -- bruce 071008):
# this might have side effects other than defining things.
from ne1_ui.MWsemantics import MWsemantics
# initialize modules and data structures
from ne1_startup import startup_misc
# do this here, not earlier, so it's free to do whatever toplevel imports it wants
# [bruce 071008 change]
startup_misc.call_module_init_functions()
startup_misc.register_MMP_RecordParsers()
# do this before reading any mmp files
# create the single main window object
foo = MWsemantics() # This does a lot of initialization (in MainWindow.__init__)
import __main__
__main__.foo = foo
# developers often access the main window object using __main__.foo when debugging,
# so this is explicitly supported
# initialize CoNTubGenerator
# TODO: move this into one of the other initialization functions
#Disabling the following code that initializes the ConTub plugin
#(in UI it is called Heterojunction.) The Heterojunction generator or
#ConTubGenerator was never ported to Qt4 platform. The plugin generator
#needs a code cleanup -- ninad 2007-11-16
##import CoNTubGenerator
##CoNTubGenerator.initialize()
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *before* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_pre_main_show
except NameError:
pass
else:
func()
# Do other things that should be done just before showing the main window
startup_misc.pre_main_show(foo) # this sets foo's geometry, among other things
foo._init_after_geometry_is_set()
if not splash_pixmap.isNull():
# If the MINIMUM_SPLASH_TIME duration has not expired, sleep for a moment.
while time.time() - splash_start < MINIMUM_SPLASH_TIME:
time.sleep(0.1)
splash.finish( foo ) # Take away the splashscreen
# show the main window
foo.show()
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *after* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_post_main_show
except NameError:
pass
else:
func()
# do other things after showing the main window
startup_misc.post_main_show(foo)
# start psyco runtime optimizer (EXPERIMENTAL) --
# for doc see http://psyco.sourceforge.net/
#
# Example: it speeds up code like this by 17 times:
# (in my test, Intel Mac OS 10.4, Python 2.4.4)
# x = 17
# for i in range(10**7):
# x += i % 3 - 1
#
# [bruce 080524]
from utilities.debug_prefs import debug_pref, Choice_boolean_False
if debug_pref("Use psyco runtime optimizer (next session)?",
Choice_boolean_False,
prefs_key = True ):
# Import Psyco if available
try:
import psyco
## psyco.full() -- insert dna takes a lot of time, then segfaults
# after printing "inside this what's this";
# plan: be more conservative about what it should optimize...
# preferably bind specific functions using psyco.bind().
# For now, just tell it to only optimize the most important ones.
psyco.log() # manual says: log file name looks like xxx.log-psyco
# by default, where xxx is the name of the script you ran
# (when I ran "python main.py" in cad/src, it wrote to main.log-psyco there)
# (maybe we can pass our own pathname as an argument?)
## psyco.profile(0.2) # use profiling, optimize funcs that use
# more than 20% of the time (not sure what that means exactly)
# (seems safe, but from log file, i guess it doesn't do much)
psyco.profile(0.05) # "aggressive"
print "using psyco"
pass
except ImportError:
print "not using psyco"
pass
pass
# Decide whether to do profiling, and if so, with which
# profiling command and into what file. Set local variables
# to record the decision, which are used later when running
# the Qt event loop.
# If the user's .atom-debug-rc specifies PROFILE_WITH_HOTSHOT = True,
# use hotshot, otherwise fall back to vanilla Python profiler.
# (Note: to work, it probably has to import this module
# and set this variable in this module's namespace.)
try:
PROFILE_WITH_HOTSHOT
except NameError:
PROFILE_WITH_HOTSHOT = False
try:
# user can set atom_debug_profile_filename to a filename in .atom-debug-rc,
# to enable profiling into that file. For example:
# % cd
# % cat > .atom-debug-rc
# atom_debug_profile_filename = '/tmp/profile-output'
# ^D
# ... then run NE1, and quit it
# ... then in a python shell:
# import pstats
# p = pstats.Stats('<filename>')
# p.strip_dirs().sort_stats('time').print_stats(100) # order by internal time (top 100 functions)
# p.strip_dirs().sort_stats('cumulative').print_stats(100) # order by cumulative time
atom_debug_profile_filename = main_globals.get('atom_debug_profile_filename')
if atom_debug_profile_filename:
print ("\nUser's .atom-debug-rc requests profiling into file %r" %
(atom_debug_profile_filename,))
if not type(atom_debug_profile_filename) in [type("x"), type(u"x")]:
print "error: atom_debug_profile_filename must be a string"
assert 0 # caught and ignored, turns off profiling
if PROFILE_WITH_HOTSHOT:
try:
import hotshot
except:
print "error during 'import hotshot'"
raise # caught and ignored, turns off profiling
else:
try:
import cProfile as py_Profile
except ImportError:
print "Unable to import cProfile. Using profile module instead."
py_Profile = None
if py_Profile is None:
try:
import profile as py_Profile
except:
print "error during 'import profile'"
raise # caught and ignored, turns off profiling
except:
print "exception setting up profiling (hopefully reported above); running without profiling"
atom_debug_profile_filename = None
# Create a fake "current exception", to help with debugging
# (in case it's shown inappropriately in a later traceback).
# One time this is seen is if a developer inserts a call to print_compact_traceback
# when no exception is being handled (instead of the intended print_compact_stack).
try:
assert 0, "if you see this exception in a traceback, it is from the" \
" startup script called by main.py, not the code that printed the traceback"
except:
pass
# Handle a mmp file passed to it via the command line. The mmp file
# must be the first argument (after the program name) found on the
# command line. All other arguments are currently ignored and only
# one mmp file can be loaded from the command line.
# old revision with --initial-file is at: svn rev 12759
# Derrick 20080520
if ((len(sys.argv) >= 2) and sys.argv[1].endswith(".mmp")):
foo.fileOpen(sys.argv[1])
# Do other post-startup, pre-event-loop, non-profiled things, if any
# (such as run optional startup commands for debugging).
startup_misc.just_before_event_loop()
if os.environ.has_key('WINGDB_ACTIVE'):
# Hack to burn some Python bytecode periodically so Wing's
# debugger can remain responsive while free-running
# [from http://wingware.com/doc/howtos/pyqt; added by bruce 081227]
# Addendum [bruce 090107]: this timer doesn't noticeably slow down NE1,
# but with or without it, NE1 is about 4x slower in Wing than running
# alone, at least when running test_selection_redraw.py.
print "running under Wing IDE debugger; setting up timer"
from PyQt4 import QtCore
timer = QtCore.QTimer()
def donothing(*args):
x = 0
for i in range(0, 100):
x += i
timer.connect(timer, QtCore.SIGNAL("timeout()"), donothing)
timer.start(200)
# Finally, run the main Qt event loop --
# perhaps with profiling, depending on local variables set above.
# This does not normally return until the user asks NE1 to exit.
# Note that there are three copies of the statement which runs that loop,
# two inside string literals, all of which presumably should be the same.
if atom_debug_profile_filename:
if PROFILE_WITH_HOTSHOT:
profile = hotshot.Profile(atom_debug_profile_filename)
profile.run('app.exec_()')
else:
py_Profile.run('from ne1_startup.main_startup import app; app.exec_()',
atom_debug_profile_filename)
print ("\nProfile data was presumably saved into %r" %
(atom_debug_profile_filename,))
else:
# if you change this code, also change both string literals just above
app.exec_()
# Now return to the caller in order to do a normal immediate exit of NE1.
return # from startup_script
def startup_script( main_globals):
"""
This is the main startup script for NE1.
It is intended to be run only once, and only by the code in main.py.
When this function returns, the caller is intended to immediately exit
normally.
Parameter main_globals should be the value of globals() in __main__,
which is needed in case .atom-debug-rc is executed, since it must be
executed in that global namespace.
"""
# Note: importing all of NE1's functionality can take a long time.
# To the extent possible, we want that time to be spent after
# something is visible to the user, but (mostly) before the main
# window is shown to the user (since showing the main window implies
# that NE1 is almost ready to go). So we display a splashscreen
# before doing most imports and initializations, then set up most
# of our data structures and UI commands (thus importing the code
# needed to implement them), and then show the main window.
# (Some experimental commands are initialized after that, so that
# errors that occur then can't prevent the main window from becoming
# visible.)
# TODO: turn the sections of code below into named functions or methods,
# and perhaps split before_most_imports and before_creating_app into
# more named functions or methods. The biggest split should be between
# functions that need to be careful to do very few or no imports,
# and functions that are free to do any imports.
# print the version information including official release candidate if it
# is not 0 (false)
if NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE:
print "Version: NanoEngineer-1 v%s_RC%s" % \
(NE1_Build_Constants.NE1_RELEASE_VERSION, \
NE1_Build_Constants.NE1_OFFICIAL_RELEASE_CANDIDATE)
else:
print "Version: NanoEngineer-1 v%s" % \
NE1_Build_Constants.NE1_RELEASE_VERSION
# "Do things that should be done before most imports occur."
startup_before_most_imports.before_most_imports( main_globals )
from PyQt4.Qt import QApplication, QSplashScreen
# "Do things that should be done before creating the application object."
startup_before_most_imports.before_creating_app()
### TODO: this imports undo, env, debug, and it got moved earlier
# in the startup process at some point. Those imports are probably not
# too likely to pull in a lot of others, but if possible we should put up
# the splash screen before doing most of them. Sometime try to figure out
# how to do that. The point of this function is mostly to wrap every signal->slot
# connection -- maybe it's sufficient to do that before creating the main
# window rather than before creating the app? [bruce 071008 comment]
# Create the application object (an instance of QApplication).
QApplication.setColorSpec(QApplication.CustomColor)
#russ 080505: Make it global so it can be run under debugging below.
global app
app = QApplication(sys.argv)
# do some imports used for putting up splashscreen
import utilities.icon_utilities as icon_utilities
icon_utilities.initialize()
# Put up the splashscreen (if its image file can be found in cad/images).
#
# Note for developers:
# If you don't want the splashscreen, just rename the splash image file.
splash_pixmap = icon_utilities.imagename_to_pixmap( "images/splash.png" )
# splash_pixmap will be null if the image file was not found
if not splash_pixmap.isNull():
splash = QSplashScreen(splash_pixmap) # create the splashscreen
splash.show()
MINIMUM_SPLASH_TIME = 3.0
# I intend to add a user pref for MINIMUM_SPLASH_TIME for A7. mark 060131.
splash_start = time.time()
else:
print "note: splash.png was not found"
# connect the lastWindowClosed signal
from PyQt4.Qt import SIGNAL
app.connect(app, SIGNAL("lastWindowClosed ()"), app.quit)
# NOTE: At this point, it is ok to do arbitrary imports as needed,
# except of experimental code.
# import MWsemantics.
# An old comment (I don't know if it's still true -- bruce 071008):
# this might have side effects other than defining things.
from ne1_ui.MWsemantics import MWsemantics
# initialize modules and data structures
from ne1_startup import startup_misc
# do this here, not earlier, so it's free to do whatever toplevel imports it wants
# [bruce 071008 change]
startup_misc.call_module_init_functions()
startup_misc.register_MMP_RecordParsers()
# do this before reading any mmp files
# create the single main window object
foo = MWsemantics() # This does a lot of initialization (in MainWindow.__init__)
import __main__
__main__.foo = foo
# developers often access the main window object using __main__.foo when debugging,
# so this is explicitly supported
# initialize CoNTubGenerator
# TODO: move this into one of the other initialization functions
#Disabling the following code that initializes the ConTub plugin
#(in UI it is called Heterojunction.) The Heterojunction generator or
#ConTubGenerator was never ported to Qt4 platform. The plugin generator
#needs a code cleanup -- ninad 2007-11-16
##import CoNTubGenerator
##CoNTubGenerator.initialize()
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *before* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_pre_main_show
except NameError:
pass
else:
func()
# Do other things that should be done just before showing the main window
startup_misc.pre_main_show(foo) # this sets foo's geometry, among other things
foo._init_after_geometry_is_set()
if not splash_pixmap.isNull():
# If the MINIMUM_SPLASH_TIME duration has not expired, sleep for a moment.
while time.time() - splash_start < MINIMUM_SPLASH_TIME:
time.sleep(0.1)
splash.finish( foo ) # Take away the splashscreen
# show the main window
foo.show()
# set up the sponsors system and perhaps show the permission dialog
if sys.platform != 'darwin':
#bruce 070515 added condition to disable this on Mac, until Brian fixes the hang on Mac.
# Note: this is enabled in the Mac released version, due to a patch during the release
# building process, at least in A9.1.
from sponsors.Sponsors import PermissionDialog
## print "start sponsors startup code"
# Show the dialog that asks permission to download the sponsor logos, then
# launch it as a thread to download and process the logos.
#
permdialog = PermissionDialog(foo)
if permdialog.needToAsk:
permdialog.exec_()
permdialog.start()
## print "end sponsors startup code"
# for developers: run a hook function that .atom-debug-rc might have defined
# in this module's global namespace, for doing things *after* showing the
# main window.
try:
# do this, if user asked us to by defining it in .atom-debug-rc
func = atom_debug_post_main_show
except NameError:
pass
else:
func()
# do other things after showing the main window
startup_misc.post_main_show(foo)
# start psyco runtime optimizer (EXPERIMENTAL) --
# for doc see http://psyco.sourceforge.net/
#
# Example: it speeds up code like this by 17 times:
# (in my test, Intel Mac OS 10.4, Python 2.4.4)
# x = 17
# for i in range(10**7):
# x += i % 3 - 1
#
# [bruce 080524]
from utilities.debug_prefs import debug_pref, Choice_boolean_False
if debug_pref("Use psyco runtime optimizer (next session)?",
Choice_boolean_False,
prefs_key = True ):
# Import Psyco if available
try:
import psyco
## psyco.full() -- insert dna takes a lot of time, then segfaults
# after printing "inside this what's this";
# plan: be more conservative about what it should optimize...
# preferably bind specific functions using psyco.bind().
# For now, just tell it to only optimize the most important ones.
psyco.log() # manual says: log file name looks like xxx.log-psyco
# by default, where xxx is the name of the script you ran
# (when I ran "python main.py" in cad/src, it wrote to main.log-psyco there)
# (maybe we can pass our own pathname as an argument?)
## psyco.profile(0.2) # use profiling, optimize funcs that use
# more than 20% of the time (not sure what that means exactly)
# (seems safe, but from log file, i guess it doesn't do much)
psyco.profile(0.05) # "aggressive"
print "using psyco"
pass
except ImportError:
print "not using psyco"
pass
pass
# Decide whether to do profiling, and if so, with which
# profiling command and into what file. Set local variables
# to record the decision, which are used later when running
# the Qt event loop.
# If the user's .atom-debug-rc specifies PROFILE_WITH_HOTSHOT = True, use hotshot, otherwise
# fall back to vanilla Python profiler.
try:
PROFILE_WITH_HOTSHOT
except NameError:
PROFILE_WITH_HOTSHOT = False
try:
# user can set this to a filename in .atom-debug-rc,
# to enable profiling into that file
atom_debug_profile_filename = main_globals['atom_debug_profile_filename']
if atom_debug_profile_filename:
print ("\nUser's .atom-debug-rc requests profiling into file %r" %
(atom_debug_profile_filename,))
if not type(atom_debug_profile_filename) in [type("x"), type(u"x")]:
print ("error: atom_debug_profile_filename must be a string;" +
"running without profiling")
assert 0 # caught and ignored, turns off profiling
if PROFILE_WITH_HOTSHOT:
try:
import hotshot
except:
print "error during 'import hotshot'; running without profiling"
raise # caught and ignored, turns off profiling
else:
try:
import cProfile
except:
print "error during 'import profile'; running without profiling"
raise # caught and ignored, turns off profiling
except:
atom_debug_profile_filename = None
# Create a fake "current exception", to help with debugging
# (in case it's shown inappropriately in a later traceback).
# One time this is seen is if a developer inserts a call to print_compact_traceback
# when no exception is being handled (instead of the intended print_compact_stack).
try:
assert 0, "if you see this exception in a traceback, it is from the" \
" startup script called by main.py, not the code that printed the traceback"
except:
pass
# Handle a mmp file passed to it via the command line. The mmp file
# must be the first argument (after the program name) found on the
# command line. All other arguments are currently ignored and only
# one mmp file can be loaded from the command line.
# old revision with --initial-file is at: svn rev 12759
# Derrick 20080520
if ((len(sys.argv) >= 2) and sys.argv[1].endswith(".mmp")):
foo.fileOpen(sys.argv[1])
# Finally, run the main Qt event loop --
# perhaps with profiling, depending on local variables set above.
# This does not normally return until the user asks NE1 to exit.
# Note that there are three copies of the statement which runs that loop,
# two inside string literals, all of which presumably should be the same.
if atom_debug_profile_filename:
if PROFILE_WITH_HOTSHOT:
profile = hotshot.Profile(atom_debug_profile_filename)
profile.run('app.exec_()')
else:
cProfile.run('from ne1_startup.main_startup import app; app.exec_()',
atom_debug_profile_filename)
print ("\nProfile data was presumably saved into %r" %
(atom_debug_profile_filename,))
else:
# if you change this code, also change the string literals just above
app.exec_()
# Now return to the caller in order to do a normal immediate exit of NE1.
return # from startup_script