historical/toontown-classic.git/panda/direct/dist/pfreeze.py

#! /usr/bin/env python

"""

This script can be used to produce a standalone executable from
arbitrary Python code.  You supply the name of the starting Python
file to import, and this script attempts to generate an executable
that will produce the same results as "python startfile.py".

This script is actually a wrapper around Panda's FreezeTool.py, which
is itself a tool to use Python's built-in "freeze" utility to compile
Python code into a standalone executable.  It also uses Python's
built-in modulefinder module, which it uses to find all of the modules
imported directly or indirectly by the original startfile.py.

Usage::

  pfreeze.py [opts] [startfile]

Options::

  -o output
     Specifies the name of the resulting executable file to produce.
     If this ends in ".mf", a multifile is written instead of a frozen
     binary.  If it ends in ".dll", ".pyd", or ".so", a shared library
     is written.

  -x module[,module...]
     Specifies a comma-separated list of Python modules to exclude from
     the resulting file, even if they appear to be referenced.  You
     may also repeat the -x command for each module.

  -i module[,module...]
     Specifies a comma-separated list of Python modules to include in
     the resulting file, even if they do not appear to be referenced.
     You may also repeat the -i command for each module.

  -p module[,module...]
     Specifies a list of Python modules that do run-time manipulation
     of the __path__ variable, and thus must be actually imported to
     determine the true value of __path__.

  -P path
     Specifies an additional directory in which we should search for
     Python modules.  This is equivalent to setting the PYTHONPATH
     environment variable.  May be repeated.

  -s
     Adds the standard set of modules that are necessary for embedding
     the Python interpreter.  Implicitly set if an executable is
     generated.

  -k
     Keeps temporary files generated by pfreeze.  Useful when debugging
     FreezeTool itself.

"""

import getopt
import sys
import os
from . import FreezeTool

def usage(code, msg = ''):
    if __doc__:
        sys.stderr.write(__doc__ + '\n')
    sys.stderr.write(str(msg) + '\n')
    sys.exit(code)


def main(args=None):
    if args is None:
        args = sys.argv[1:]

    freezer = FreezeTool.Freezer()

    basename = None
    addStartupModules = False

    try:
        opts, args = getopt.getopt(args, 'o:i:x:p:P:slkh')
    except getopt.error as msg:
        usage(1, msg)

    for opt, arg in opts:
        if opt == '-o':
            basename = arg
        elif opt == '-i':
            for module in arg.split(','):
                freezer.addModule(module)
        elif opt == '-x':
            for module in arg.split(','):
                freezer.excludeModule(module)
        elif opt == '-p':
            for module in arg.split(','):
                freezer.handleCustomPath(module)
        elif opt == '-P':
            sys.path.append(arg)
        elif opt == '-s':
            addStartupModules = True
        elif opt == '-l':
            freezer.linkExtensionModules = True
        elif opt == '-k':
            freezer.keepTemporaryFiles = True
        elif opt == '-h':
            usage(0)
        else:
            print('illegal option: ' + flag)
            sys.exit(1)

    if not basename:
        usage(1, 'You did not specify an output file.')

    if len(args) > 1:
        usage(1, 'Only one main file may be specified.')

    outputType = 'exe'
    bl = basename.lower()
    if bl.endswith('.mf'):
        outputType = 'mf'
    elif bl.endswith('.c'):
        outputType = 'c'
    elif bl.endswith('.dll') or bl.endswith('.pyd') or bl.endswith('.so'):
        basename = os.path.splitext(basename)[0]
        outputType = 'dll'
    elif bl.endswith('.exe'):
        basename = os.path.splitext(basename)[0]

    compileToExe = False
    if args:
        startfile = args[0]
        startmod = startfile
        if startfile.endswith('.py') or startfile.endswith('.pyw') or \
        startfile.endswith('.pyc') or startfile.endswith('.pyo'):
            startmod = os.path.splitext(startfile)[0]

        if outputType == 'dll' or outputType == 'c':
            freezer.addModule(startmod, filename = startfile)
        else:
            freezer.addModule('__main__', filename = startfile)
            compileToExe = True
            addStartupModules = True

    elif outputType == 'exe':
        # We must have a main module when making an executable.
        usage(1, 'A main file needs to be specified when creating an executable.')

    freezer.done(addStartupModules = addStartupModules)

    if outputType == 'mf':
        freezer.writeMultifile(basename)
    elif outputType == 'c':
        freezer.writeCode(basename)
    else:
        freezer.generateCode(basename, compileToExe = compileToExe)

    return 0


if __name__ == '__main__':
    sys.exit(main())