1"""terminalcommand.py -- A minimal interface to Terminal.app.
2
3To run a shell command in a new Terminal.app window:
4
5    import terminalcommand
6    terminalcommand.run("ls -l")
7
8No result is returned; it is purely meant as a quick way to run a script
9with a decent input/output window.
10"""
11
12#
13# This module is a fairly straightforward translation of Jack Jansen's
14# Mac/OSX/PythonLauncher/doscript.m.
15#
16
17from warnings import warnpy3k
18warnpy3k("In 3.x, the terminalcommand module is removed.", stacklevel=2)
19
20import time
21import os
22from Carbon import AE
23from Carbon.AppleEvents import *
24
25
26TERMINAL_SIG = "trmx"
27START_TERMINAL = "/usr/bin/open /Applications/Utilities/Terminal.app"
28SEND_MODE = kAENoReply  # kAEWaitReply hangs when run from Terminal.app itself
29
30
31def run(command):
32    """Run a shell command in a new Terminal.app window."""
33    termAddress = AE.AECreateDesc(typeApplicationBundleID, "com.apple.Terminal")
34    theEvent = AE.AECreateAppleEvent(kAECoreSuite, kAEDoScript, termAddress,
35                                     kAutoGenerateReturnID, kAnyTransactionID)
36    commandDesc = AE.AECreateDesc(typeChar, command)
37    theEvent.AEPutParamDesc(kAECommandClass, commandDesc)
38
39    try:
40        theEvent.AESend(SEND_MODE, kAENormalPriority, kAEDefaultTimeout)
41    except AE.Error, why:
42        if why[0] != -600:  # Terminal.app not yet running
43            raise
44        os.system(START_TERMINAL)
45        time.sleep(1)
46        theEvent.AESend(SEND_MODE, kAENormalPriority, kAEDefaultTimeout)
47
48
49if __name__ == "__main__":
50    run("ls -l")
51