bbfreeze 1.1.3

概述

bbfreeze 从Python脚本创建独立可执行文件。它在目的上类似于众所周知的Windows的 py2exe、OS X的 py2app、PyInstaller 和 cx_Freeze（实际上，早期版本基于cx_Freeze。它还使用modulegraph 包，该包也由py2app使用）。

它具有以下功能

易于安装

bbfreeze 可以使用setuptools的easy_install命令安装。

zip/egg 文件导入跟踪

bbfreeze 跟踪从zip文件中的导入，如果某些模块来自egg文件，则包括整个egg文件。现在使用setuputils的pkg_resources模块的包将正常工作（新功能，0.95.0版）

二进制依赖跟踪

bbfreeze 将跟踪二进制依赖项，并将包括冻结程序所需的DLL和共享库。

多脚本冻结

bbfreeze 可以一次冻结多个脚本。

包含Python解释器

bbfreeze 将创建一个名为“py”的额外可执行文件，这可以像python可执行文件一样使用。

自动路径名重写

跟踪信息中的路径名被替换为相对路径名（即，如果你从 /home/jdoe/pylib/ 导入包 foo.bar，则从 foo.bar 中的函数生成的跟踪信息不会显示你的本地路径 /home/jdoe/pylib/foo/bar.py。相反，它们将显示为 foo/bar.py）

distutils 命令 'bdist_bbfreeze'

一个新的 distutils/setuptools 命令 bdist_bbfreeze 将 bbfreeze 集成到你的 setup.py 中。

bbfreeze 在 Windows 和类 UNIX 操作系统上运行。bbfreeze 已与 python 2.4、2.5、2.6 和 2.7 进行了测试。bbfreeze 不会与 python 3 或更高版本一起工作。bbfreeze 不在 OS X 上运行。

git clone https://github.com/schmir/bbfreeze.git

git pull

easy_install bbfreeze

bbfreeze - 命令行工具

bbfreeze 提供了一个名为 bbfreeze 的命令行工具，该工具将命令行中给出的所有 Python 脚本冻结到 dist 目录中，该目录包含每个脚本的可执行文件以及这些可执行文件所需的依赖项。

示例用法

$ cat hello-world.py
#! /usr/bin/env python

import sys
import email

print unicode("hello", "utf8"), unicode("world!", "ascii")

print "sys.path:", sys.path
print "__file__:", __file__
print "__name__:", __name__

print "locals():", locals()

print "sys.argv", sys.argv
print "sys.executable:", sys.executable
$ bbfreeze hello-world.py
WARNING: found encodings in multiple directories. Assuming it's a namespace package. (found in /home/ralf/py27/lib/python2.7/encodings, /usr/lib/python2.7/encodings)
*** applied <function recipe_doctest at 0x1f01aa0>
*** applied <function recipe_time at 0x1f01de8>
*** applied <function recipe_urllib at 0x1f01c08>
RPATH ${ORIGIN}:${ORIGIN}/../lib is fine
$ dist/hello-world
hello world!
sys.path: ['/home/ralf/bbfreeze/tests/dist/library.zip', '/home/ralf/bbfreeze/tests/dist']
__file__: hello-world.py
__name__: __main__
locals(): {'__builtins__': <module '__builtin__' (built-in)>, '__file__': 'hello-world.py', '__package__': None, 'sys': <module 'sys' (built-in)>, 'email': <module 'email' from '/home/ralf/bbfreeze/tests/dist/library.zip/email/__init__.pyc'>, '__name__': '__main__', '__doc__': None}
sys.argv ['/home/ralf/bbfreeze/tests/dist/hello-world']
sys.executable: /home/ralf/bbfreeze/tests/dist/hello-world
$ dist/py
Python 2.7.2 (default, Nov 21 2011, 17:25:27)
[GCC 4.6.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
(MyConsole)
>>> import email
>>>

bdist_bbfreeze - distutils 命令

bbfreeze 提供了一个类似于命令行工具的 distutils 命令，但与 distutils 和 setuptools 集成得很好。它收集所有的 'console_scripts' 'gui_scripts' 条目点，生成包装脚本（如 easy_install 会做的那样），并冻结这些脚本。

安装 bbfreeze 后，每个使用 setuptools 的 setup.py 都有一个新的命令 'bdist_bbfreeze'。要显示帮助信息，只需运行

python setup.py bdist_bbfreeze --help

使用示例

# freeze all scripts into ./dist/<egg_name>-<egg_version>/
python setup.py bdist_bbfreeze

# same, but use tagging for "daily build" or "snapshot" releases
python setup.py egg_info --tag-build=dev bdist_bbfreeze

bbfreeze - API

使用 bbfreeze 的首选方式是通过编写使用 bbfreeze API 的简短 Python 脚本。让我们从一个简短的例子开始

from bbfreeze import Freezer
f = Freezer("hello-world-1.0", includes=("_strptime",))
f.addScript("hello-world.py")
f.addScript("hello-version.py")
f()    # starts the freezing process

bbfreeze.Freezer(distdir=”dist”, includes=(), excludes=()) 实例化一个 Freezer 对象。它将在 distdir 目录中创建冻结的可执行文件和依赖项。includes 是要包含的模块的列表或元组，excludes 是要排除的模块的列表或元组。请注意，freezer 在冻结之前会删除 distdir 目录！

bbfreeze.Freezer 对象有以下成员

• use_compression：标志是否在创建的 zipfile 中使用压缩（默认为 True）。

• include_py：标志是否创建包含的 Python 解释器 py（默认为 True）

• addScript(path, gui_only=False)：注册一个用于冻结的 Python 脚本。path 必须是 Python 脚本的路径。freezer 将扫描文件以查找依赖项，并在 distdir 中创建具有相同名称的可执行文件。在 Windows 上，gui_only 标志才有意义：如果设置，为该脚本创建的可执行文件将不会打开控制台窗口。

Linux笔记

用于冻结的系统上的glibc版本通常将是运行二进制文件所需的最低glibc版本。

gtk、gdk、pango、glib共享库不会在冻结过程中被复制。这些库需要一个相当复杂的运行时系统，复制它们可能会引发问题。

Windows笔记

使用python 2.6或2.7创建的二进制文件需要在目标机器上安装Microsoft Visual C++ 2008 Redistributable Package（32位或64位版本）。

变更日志

授权协议

bbfreeze包含modulegraph的修改版，该模块在MIT授权协议下分发，并由Bob Ippolito版权所有。

bbfreeze包含来自Python分发的getpath.c的修改版，该文件在Python软件基金会授权协议第2版下分发，并由Python软件基金会版权所有。

bbfreeze包括一个名为‘bdist_bbfreeze.py’的模块

版权所有 2008-2012 by Hartmut Goebel <h.goebel@goebel-consult.de>

‘bdist_bbfreeze’模块可以与bbfreeze本身相同的授权协议分发。

其余部分在zlib/libpng授权协议下分发

版权所有 (c) 2007-2012 brainbot technologies AG

本软件按“原样”提供，不提供任何明示或暗示的保证。在任何情况下，作者都不会因使用本软件而承担任何损害赔偿责任。

任何人都可以出于任何目的使用本软件，包括商业应用，并且可以自由修改和重新分发，前提是遵守以下限制

1. 本软件的来源不得被误导；你不可以声称你编写了原始软件。如果你将本软件用于产品中，产品文档中的致谢将会受到欢迎，但不是必需的。

2. 修改过的源代码版本必须明确标记为修改版，并且不得将其误认为原始软件。

3. 本声明不得从任何源代码分发中被删除或修改。