# Copyright 2004-2008 Nanorex, Inc. See LICENSE file for details. """ main_startup.py -- provides the startup_script function called by main.py @version: $Id$ @copyright: 2004-2008 Nanorex, Inc. See LICENSE file for details. History: mostly unrecorded, except in cvs; originally by Josh (under the name atom.py); lots of changes by various developers at various times. renamed from atom.py to main.py before release of A9, mid-2007, and split out of main.py into this file (main_startup.py) by bruce 070704. """ import sys import time import os import NE1_Build_Constants # Note -- Logic in startup_before_most_imports depends on its load location. # If you move it, fix the endUser code in before_most_imports(). from ne1_startup import startup_before_most_imports # NOTE: all other imports MUST be added inside the following function, # since they must not be done before startup_before_most_imports.before_most_imports is executed. 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('') # 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 # end