jip 0.9.16

许可证

jip本身根据MIT许可证分发。

安装

jip建议在virtualenv中运行，这是Python/Jython开发人员创建独立、便携环境的最佳实践。从jip 0.7开始，您可以使用jip.embed进行全局安装。

virtualenv -p /usr/local/bin/jython jython-env

cd jython-dev
source bin/activate

pip install jip

jython setup.py install

用法

jip install <groupId>:<artifactId>:<version>

jip install org.springframework:spring-core:3.0.5.RELEASE

jip resolve pom.xml

jip deps info.sunng.gefr:gefr:0.2-SNAPSHOT

jip update info.sunng.bason:bason-annotation:0.1-SNAPSHOT

jip remove org.springframework:spring-core:3.0.5.RELEASE

jip freeze > pom.xml

配置

您可以使用点文件配置自定义 Maven 仓库，jip 将按以下顺序搜索配置：

1. $VIRTUAL_ENV/.jip_config，您的虚拟环境主目录

2. $HOME/.jip_config，您的家目录

以下是一个示例

[repos:jboss]
uri=http://repository.jboss.org/maven2/
type=remote

[repos:local]
uri=~/.m2/repository/
type=local

[repos:central]
uri=https://repo1.maven.org/maven2/
type=remote

请注意，.jip_config 文件将覆盖默认设置，因此您必须显式包含默认本地和中央仓库。jip 一旦找到匹配 Maven 协调器的包，就会跳过仓库。

构件将缓存在 $HOME/.jip（如果您使用虚拟环境，则为 $VIRTUAL_ENV/.jip）。

从 0.4 版本开始，如果您使用 resolve 命令，您也可以在 pom.xml 中定义仓库。jip 将以最高优先级添加这些自定义仓库。

分发助手

从 0.4 版本开始，您可以在 setup.py 中使用 jip 来简化 jython 源代码包的分发。在 setup.py 所在目录中创建 pom.xml。以标准方式填写您的 Java 依赖项。在此文件中，您还可以定义自定义仓库。以下是一个示例

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

    ...

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>1.6.1</version>
        </dependency>

        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.6.1</version>
        </dependency>

        ...

    </dependencies>

    <repositories>
        <repository>
            <id>sonatype-oss-sonatype</id>
            <url>http://oss.sonatype.org/content/repositories/snapshots/</url>
        </repository>
    </repositories>
</project>

在您的 setup.py 中，使用 jip setup 包装器代替 setuptools 或 distutils 提供的包装器。您可以使用关键字参数 pom 来指定 pom 文件的自定义名称。

from jip.dist import setup

除了传统的 pom 配置之外，jip 还允许您以 Python 的方式描述依赖项。您可以在 setup.py 中定义一个数据结构，如下所示

requires_java = {
    'dependencies':[
        ## (groupdId, artifactId, version)
        ('org.slf4j', 'slf4j-api', '1.6.1'),
        ('org.slf4j', 'slf4j-log4j12', '1.6.1'),
        ('info.sunng.soldat', 'soldat', '1.0-SNAPSHOT'),
        ('org.apache.mina', 'mina-core', '2.0.2')
    ],
    'repositories':[
        ('sonatype-oss-snapshot', 'http://oss.sonatype.org/content/repositories/snapshots/')
    ]
}

并将其传递给 jip setup 作为关键字参数 requires_java。一旦 jip 发现此参数，它将不会尝试加载 pom 文件。

from jip.dist import setup
setup(
    ...
    requires_java=requires_java,
    ...)

setuptools 中还添加了另一个 resolve 命令，您可以使用此命令将所有依赖项下载到库路径。

jython setup.py resolve

所有依赖项将在运行时安装

jython setup.py install

因此，使用jip的setup()包装器，pip将自动安装您的包所需的依赖项。您可以将您的包发布到Python Cheese Shop，并且只有一个命令就可以完成所有操作。

pip install [your-package-name]

嵌入式依赖项助手

jip.embed可用于虚拟环境和全局安装。您可以在代码中描述Java依赖项，然后它将自动解析。jip.embed灵感来源于Groovy的@Grab。

from jip.embed import require

require('commons-lang:commons-lang:2.6')
from org.apache.commons.lang import StringUtils

StringUtils.reverse('jip rocks')

联系方式

如果您在使用jip时遇到任何问题或对jip有功能请求，请随时在GitHub问题跟踪器上提交问题。您也可以在twitter上关注@Sunng。

变更记录

• 下一版本 - 未发布

• 0.9.16 - 2022-12-20

• 0.9.15 - 2020-06-04

  • 修复从本地仓库下载时的编码错误

• 0.9.14 - 2020-05-25

  • 添加Python 3.7兼容性

  • 如果未知仓库类型，则优雅地失败

  • Maven中心迁移到HTTPS

• 0.9.13 - 2017-07-23

  • 为install命令添加了copy-pom选项

• 0.9.12 - 2017-03-20

  • 修复下载包含元音符号的POM时的错误

  • 删除jip.JIP_VERSION。如果您需要，请使用jip.__version__

• 0.9.11 - 2017-03-11

  • 改进下载错误处理

• 0.9.10 - 2017-03-09

  • 修复虚拟环境中.jip/cache未隔离的问题

• 0.9.9 - 2016-10-31

  • 修复可能崩溃的问题

• 0.9.8 - 2016-07-27

  • 一些小修复

• 0.9 - 2015-04-23

  • Python 3支持

• 0.8 - 2014-03-31

  • Windows支持

• 0.7 - 2011-06-11

  • 所有新的jip.embed和全局安装

  • 增强搜索

  • 为install、deps和resolve添加了dry-run选项

  • 为install命令和jip.dist添加了排除选项

  • 默认禁用本地Maven仓库

  • 改进依赖项解析速度

  • jip现在在$HOME/.jip/cache/中维护jar和pom的本地缓存

  • 使用argparse以获得更好的命令行UI

  • 添加一些测试用例

• 0.5.1 - 2011-05-14

  • 并行下载 artifact jar 包

  • 在http请求中包含User-agent头

  • 添加新命令freeze以转储当前状态

  • 错误修复

• 0.4 - 2011-04-15

  • 新增命令：search、deps、list、remove

  • 新增功能jip.dist以实现setuptools集成

  • 支持依赖项排除，感谢vvangelovski

  • 允许在pom.xml和setup.py中定义项目范围的仓库

  • 代码重构，现在编程友好

  • 将README转换为reStructuredText

  • 迁移到MIT许可证

• 0.2.1 - 2011-04-07

  • 改进控制台输出格式

  • 正确处理依赖项管理继承的范围

  • 快照管理alpha版本，您可以更新快照 artifact

  • 环境无关配置。每个环境一个.jip

  • 错误修复

• 0.1 - 2011-01-04

  • 初始版本

链接

• 不要重复自己：使用jip.dist分发jython包

• 已废弃 jip 0.1 简介

• GitHub上的项目

• Python Cheese Shop上的包