#! /usr/bin/env python """ This command will pack a Panda application, consisting of a directory tree of .py files and models, into a p3d file for convenient distribution. The resulting p3d file can be run by the Panda3D runtime executable, or by the Panda3D web browser plugin. Also see ppackage, a more powerful (but more complex) tool that can also be used to build p3d applications, using a pdef description file. Usage: %s [opts] app.p3d Options: -d application_root Specify the root directory of the application source; this is a directory tree that contains all of your .py files and models. If this is omitted, the default is the current directory. -m main.py Names the Python file that begins the application. This should be a file within the root directory. If this is omitted, the default is a file named "main.py", or if there is only one Python file present, it is used. If this file contains a function called main(), that function will be called after importing it (this is preferable to having the module start itself immediately upon importing). -S file.crt[,chain.crt[,file.key[,\"password\"]]] Signs the resulting p3d with the indicated certificate. You may specify the signing certificate, the optional authorization chain, and the private key in three different files, or they may all be combined in the first file. If the private key is encrypted, the password will be required to decrypt it. -A Sets the auto-start flag in the application, so that the user will not need to click the green play button before it starts, when embedded in a web page. This can also be set on the HTML page. -r package Names an additional package that this application requires at startup time. The default package is 'panda3d'; you may repeat this option to indicate dependencies on additional packages. -s search_dir Additional directories to search for previously-built packages. This option may be repeated as necessary. These directories may also be specified with the pdef-path Config.prc variable. -D Sets the allow_python_dev flag in the application. This enables additional runtime debug operations, particularly the -i option to the panda3d command, which enables a live Python prompt within the application's environment. Setting this flag may be useful to develop an application initially, but should not be set on an application intended for deployment. """ import sys import os import getopt import glob import direct from direct.p3d import Packager from pandac.PandaModules import * # Temp hack for debugging. #from direct.p3d.AppRunner import dummyAppRunner; dummyAppRunner() class ArgumentError(StandardError): pass def makePackedApp(args): opts, args = getopt.getopt(args, 'd:m:S:Ar:s:Dh') packager = Packager.Packager() root = Filename('.') main = None signParams = [] autoStart = False requires = [] allowPythonDev = False for option, value in opts: if option == '-d': root = Filename.fromOsSpecific(value) elif option == '-m': main = value elif option == '-S': signParams.append(value) elif option == '-A': autoStart = True elif option == '-r': requires.append(value) elif option == '-s': packager.installSearch.appendDirectory(Filename.fromOsSpecific(value)) elif option == '-D': allowPythonDev = True elif option == '-h': print __doc__ % (os.path.split(sys.argv[0])[1]) sys.exit(1) if not args: raise ArgumentError, "No target app specified. Use:\n%s app.p3d" % (os.path.split(sys.argv[0])[1]) if len(args) > 1: raise ArgumentError, "Too many arguments." appFilename = Filename.fromOsSpecific(args[0]) if appFilename.getExtension() != 'p3d': raise ArgumentError, 'Application filename must end in ".p3d".' appDir = Filename(appFilename.getDirname()) if not appDir: appDir = Filename('.') appBase = appFilename.getBasenameWoExtension() if not main: main = Filename(root, 'main.py') if main.exists(): main = 'main.py' else: main = glob.glob(os.path.join(root.toOsSpecific(), '*.py')) if len(main) == 0: raise ArgumentError, 'No Python files in root directory.' elif len(main) > 1: raise ArgumentError, 'Multiple Python files in root directory; specify the main application with -m "main".' main = os.path.split(main[0])[1] main = Filename.fromOsSpecific(main) mainModule = Filename(main) mainModule.setExtension('') mainModule = mainModule.cStr().replace('/', '.') packager.installDir = appDir getModelPath().appendDirectory(root) try: packager.setup() packager.beginPackage(appBase, p3dApplication = True) for requireName in requires: tokens = requireName.split(',') while len(tokens) < 3: tokens.append(None) name, version, host = tokens packager.do_require(name, version = version, host = host) if autoStart: packager.do_config(auto_start = True) if allowPythonDev: packager.do_config(allow_python_dev = True) packager.do_dir(root) packager.do_mainModule(mainModule) for param in signParams: tokens = param.split(',') while len(tokens) < 4: tokens.append('') certificate, chain, pkey, password = tokens[:4] packager.do_sign(certificate, chain = chain, pkey = pkey, password = password) packager.endPackage() packager.close() except Packager.PackagerError: # Just print the error message and exit gracefully. inst = sys.exc_info()[1] print inst.args[0] sys.exit(1) def main(appRunner): """ This function is called when this module is invoked as packp3d.p3d. """ try: makePackedApp(appRunner.argv[1:]) except ArgumentError, e: print e.args[0] sys.exit(1) sys.exit(0) if __name__ == '__main__': try: makePackedApp(sys.argv[1:]) except ArgumentError, e: print e.args[0] sys.exit(1)