使用 Jython 将我的 Python 脚本作为 JAR 文件分发？

Question

我成为一名 Python 程序员已经快两年了，我习惯于编写小脚本来自动执行一些我必须在办公室执行的重复性任务。 现在，显然我的同事注意到了这一点，他们也想要这些脚本。

他们中有些人有 Mac，有些人有 Windows； 我在窗户上做了这些。 我研究了使用 py2exe 甚至 py2app 来制作我的脚本的本机的可能性，但他们从来没有让我满意......

我开始知道他们所有人的系统上都有 JVM，所以我可以给他们一个单一的可执行 JAR 文件吗我的脚本可能使用 Jython 之类的东西？

这有多可行...我的意思是，我不知道如何为 Jython 编写脚本，我编写脚本时也没有关心它...它会带来什么样的问题？

Answer 1

我遇到了类似的问题，因为我希望能够为我的 jython 应用程序创建简单的命令行调用，不要求用户完成 jython 安装过程，并且能够让 jython 脚本在运行时将库依赖项附加到 sys .path以便包含核心java代码。

# append Java library elements to path
sys.path.append(os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "..", "lib", "poi-3.8-20120326.jar"))

当在 Unix 系统上的命令行上显式运行“jython”启动器时，它只运行一个大的 shell 脚本来正确形成 java 命令行调用。 这个 jython 启动器似乎依赖于返回 jython 的核心安装，并且通过某种方式神奇地允许在运行时从我的 .py 脚本中正确处理添加到 sys.path 的 .jar 文件。 您可以通过以下方式查看调用内容并阻止执行：

jython --print run_form.py
java -Xmx512m -Xss1024k -Dfile.encoding=UTF-8 -classpath /Applications/jython2.5.2/jython.jar: -Dpython.home=/Applications/jython2.5.2 -Dpython.executable=/Applications/jython2.5.2/bin/jython org.python.util.jython run_form.py

但它仍然只是启动 JVM 并运行类文件。 所以我的目标是能够对我的发行版 lib 目录中存在的独立 jython.jar 进行 java 调用，这样用户就不需要执行任何额外的安装步骤来开始使用我的 .py 脚本实用程序。

java -Xmx512m -Xss1024k -classpath ../../lib/jython.jar org.python.util.jython run_form.py

问题是行为非常不同，我会得到这样的响应：

  File "run_form.py", line 14, in <module>
    import xls_mgr
  File "/Users/test/Eclipse/workspace/test_code/py/test/xls_mgr.py", line 17, in <module>
    import org.apache.poi.hssf.extractor as xls_extractor
ImportError: No module named apache

现在您可能会说我应该将 jar 文件添加到 -classpath，事实上我尝试过，但我会得到相同的结果。

将所有 .class 文件捆绑在 jython.jar 中的建议听起来对我来说根本没有吸引力。 这将是一团糟，并且会将 Java/Python 混合应用程序与 jython 发行版绑定得太紧密。 所以这个想法是行不通的。 最后，经过大量搜索，我在 jython.org 上遇到了错误#1776，该错误已被列为关键错误一年半了，但我没有看到 jython 的最新更新包含修复程序。 不过，如果您在让 jython 包含单独的 jar 文件时遇到问题，您应该阅读本文。

http://bugs.jython.org/issue1776

在那里，您将找到此问题的临时解决方法。 就我而言，我获取了 Apache POI jar 文件并将其解压缩到自己单独的 lib 目录中，然后修改 sys.path 条目以指向该目录而不是 jar：

sys.path.append('/Users/test/Eclipse/workspace/test_code/lib/poi_lib')

现在，当我通过 java 运行 jython 时，引用我本地的 jython.jar，该实用程序运行得非常顺利。 现在，我可以创建简单的脚本或批处理文件，为我的 .py 实用程序提供无缝的命令行体验，用户无需任何额外的安装步骤即可运行。

Answer 2

“jythonc”命令应该能够将 .py 源代码编译为 JVM 字节码，这应该使其可移植到任何 Java 安装。 或者我读到： http: //hell.org.ua/Docs/oreilly/other2/python/0596001886_pythonian-chp-25-sect-3.html

Answer 3

要以不需要本机 Python 安装的方式分发 Python 脚本，您还可以尝试 Nuitka，它基本上将您的 Python 代码转换为 C++ 代码，然后将其编译为真正的本机二进制文件。

Answer 4

Jython wiki 上的这篇文章详细介绍了当前在 jar 中分发 Python 文件的最佳技术：http: //wiki.python.org/jython/JythonFaq/DistributingJythonScripts

对于您的情况，我认为您需要获取安装 Jython 时获得的 jython.jar 文件并将 Jython Lib 目录压缩到其中，然后压缩您的 .py 文件，然后添加一个包含启动逻辑的 __run__.py 文件（该文件由 Jython 特殊处理，并且将是您使用“java -jar”调用 jar 时执行的文件”）。

这个过程肯定比应该的更复杂，因此我们（Jython 开发人员）需要想出一个很好的工具来自动执行这些任务，但目前这些是最好的方法。 下面我复制了上述文章底部的配方（稍作修改以适合您的问题描述），让您了解解决方案。

创建基本 jar：

$ cd $JYTHON_HOME
$ cp jython.jar jythonlib.jar
$ zip -r jythonlib.jar Lib

将其他模块添加到 jar：

$ cd $MY_APP_DIRECTORY
$ cp $JYTHON_HOME/jythonlib.jar myapp.jar
$ zip myapp.jar Lib/showobjs.py
# Add path to additional jar file.
$ jar ufm myapp.jar othermanifest.mf

添加 __run__.py 模块：

# Copy or rename your start-up script, removing the "__name__  == '__main__'" check.
$ cp mymainscript.py __run__.py
# Add your start-up script (__run__.py) to the jar.
$ zip myapp.jar __run__.py
# Add path to main jar to the CLASSPATH environment variable.
$ export CLASSPATH=/path/to/my/app/myapp.jar:$CLASSPATH

在 MS Windows 上，设置 CLASSPATH 环境变量的最后一行看起来像这样：

set CLASSPATH=C:\path\to\my\app\myapp.jar;%CLASSPATH%

或者，再次MS Windows，使用控制面板和系统属性来设置 CLASSPATH 环境变量。

运行应用程序：

$ java -jar myapp.jar mymainscript.py arg1 arg2

或者，如果您已将启动脚本添加到 jar 中，请使用以下选项之一：

$ java org.python.util.jython -jar myapp.jar arg1 arg2
$ java -cp myapp.jar org.python.util.jython -jar myapp.jar arg1 arg2
$ java -jar myapp.jar -jar myapp.jar arg1 arg2

双 jar 有点烦人，因此如果您想避免这种情况并获得更令人愉悦的效果：

$ java -jar myapp.jar arg1

您将必须做更多的工作，直到我们将类似的东西纳入未来的 Jython [更新：JarRunner 是 Jython 2.5.1 的一部分]。 下面是一些自动查找 __run__.py 并运行它的 Java 代码。 请注意，这是我第一次尝试这门课。 如果需要改进请告诉我！

package org.python.util;

import org.python.core.imp;
import org.python.core.PySystemState;

public class JarRunner {

    public static void run(String[] args) {
        final String runner = "__run__";
        String[] argv = new String[args.length + 1];
        argv[0] = runner;
        System.arraycopy(args, 0, argv, 1, args.length);
        PySystemState.initialize(PySystemState.getBaseProperties(), null, argv);
        imp.load(runner);
    }

    public static void main(String[] args) {
        run(args);
    }
}

我将此代码放入 org.python.util 包中，因为如果我们决定将其包含在未来的 Jython 中，那么它将位于该包中。 要编译它，您需要将 jython.jar （或您的 myapp.jar）放入类路径中，如下所示：

$ javac -classpath myapp.jar org/python/util/JarRunner.java

然后您需要将 JarRunner.class 添加到您的 jar （类文件需要位于 org/python 中） /util/JarRunner.class) 在“org”目录中调用 jar 将获取 jar 的整个路径。

$ jar uf org

将此添加到您将用于更新清单的文件中，一个好的名称是manifest.txt：

Main-Class: org.python.util.JarRunner

然后更新jar的清单：

$ jar ufm myapp.jar manifest.txt

现在您应该能够像这样运行您的应用程序：

$ java -jar myapp.jar