"""terminalcommand.py -- A minimal interface to Terminal.app.

To run a shell command in a new Terminal.app window:

    import terminalcommand

    terminalcommand.run("ls -l")

No result is returned; it is purely meant as a quick way to run a script

with a decent input/output window.

"""

#

# This module is a fairly straightforward translation of Jack Jansen's

# Mac/OSX/PythonLauncher/doscript.m.

#

from warnings import warnpy3k

warnpy3k("In 3.x, the terminalcommand module is removed.", stacklevel=2)

import time

import os

from Carbon import AE

from Carbon.AppleEvents import *

TERMINAL_SIG = "trmx"

START_TERMINAL = "/usr/bin/open /Applications/Utilities/Terminal.app"

SEND_MODE = kAENoReply  # kAEWaitReply hangs when run from Terminal.app itself

def run(command):

    """Run a shell command in a new Terminal.app window."""

    termAddress = AE.AECreateDesc(typeApplicationBundleID, "com.apple.Terminal")

    theEvent = AE.AECreateAppleEvent(kAECoreSuite, kAEDoScript, termAddress,

                                     kAutoGenerateReturnID, kAnyTransactionID)

    commandDesc = AE.AECreateDesc(typeChar, command)

    theEvent.AEPutParamDesc(kAECommandClass, commandDesc)

    try:

        theEvent.AESend(SEND_MODE, kAENormalPriority, kAEDefaultTimeout)

    except AE.Error, why:

        if why[0] != -600:  # Terminal.app not yet running

            raise

        os.system(START_TERMINAL)

        time.sleep(1)

        theEvent.AESend(SEND_MODE, kAENormalPriority, kAEDefaultTimeout)

if __name__ == "__main__":

    run("ls -l")