jip 0.9.13

License

jip itself is distributed according to MIT License .

Install

jip is recommended to run within virtualenv, which is a best practice for python/jython developers to created a standalone, portable environment. From jip 0.7, you can use jip.embed in the global installation.

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

cd jython-dev
source bin/activate

pip install jip

jython setup.py install

Usage

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

Configuration

You can configure custom maven repository with a dot file, jip will search configurations in the following order:

1. $VIRTUAL_ENV/.jip_config, your virtual environment home

2. $HOME/.jip_config, your home

Here is an example:

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

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

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

Be careful that the .jip_config file will overwrite default settings, so you must include default local and central repository explicitly. jip will skip repositories once it finds package matches the maven coordinator.

Artifacts will be cached at $HOME/.jip ($VIRTUAL_ENV/.jip if you are using a virtual environment).

>From 0.4, you can also define repositories in pom.xml if you use the resolve command. jip will add these custom repositories with highest priority.

Distribution helpers

>From 0.4, you can use jip in your setup.py to simplify jython source package distribution. Create pom.xml in the same directory with setup.py. Fill it with your Java dependencies in standard way. In this file, you can also define custom repositories. Here is an example:

<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>

And in your setup.py, use the jip setup wrapper instead of the one provided by setuptools or distutils. You can add keyword argument pom to specify a custom name of the pom file.

from jip.dist import setup

Other than the traditional pom configuration, jip also allows you to describe dependencies in python. You can define a data structure in your setup.py like:

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/')
    ]
}

And pass it to jip setup as keyword argument requires_java. Once jip found this argument, it won’t try to load a pom file.

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

Another resolve command was added to setuptools, you can use this command to download all dependencies to library path

jython setup.py resolve

All dependencies will be installed when running

jython setup.py install

So with jip’s setup() wrapper, pip will automatically install what your package needs. You can publish your package to python cheese shop, and there is just one command for everything

pip install [your-package-name]

Embedded dependency helper

jip.embed is available for both virtualenv and global installation. You can descirbe Java dependency in you code, then it will be resolved on the fly. jip.embed is inspired by Groovy’s @Grab.

from jip.embed import require

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

StringUtils.reverse('jip rocks')

Contact

If you have any problem using jip, or feature request for jip, please feel free to fire an issue on github issue tracker. You can also follow @Sunng on twitter.

Change Notes

• Next version - unreleased

• 0.9.13 - 2017-07-23

• 0.9.12 - 2017-03-20

  • Fix errors when downloading POMs containing umlauts

  • Remove jip.JIP_VERSION. Use jip.__version__ if you need it

• 0.9.11 - 2017-03-11

  • Improve handling of download errors

• 0.9.10 - 2017-03-09

  • Fix .jip/cache not being isolated in virtualenv

• 0.9.9 - 2016-10-31

  • Fix possible crash

• 0.9.8 - 2016-07-27

  • Minor fixes

• 0.9 - 2015-04-23

  • Python 3 support

• 0.8 - 2014-03-31

  • Windows support

• 0.7 - 2011-06-11

  • All new jip.embed and global installation

  • enhanced search

  • dry-run option for install, deps and resolve

  • exclusion for install command and jip.dist

  • local maven repository is disabled by default

  • improved dependency resolving speed

  • jip now maintains a local cache of jars and poms in $HOME/.jip/cache/

  • use argparse for better command-line ui

  • add some test cases

• 0.5.1 - 2011-05-14

  • Artifact jar package download in paralell

  • User-agent header included in http request

  • new command freeze to dump current state

  • bugfix

• 0.4 - 2011-04-15

  • New commands available: search, deps, list, remove

  • New feature jip.dist for setuptools integration

  • Dependency exclusion support, thanks vvangelovski

  • Allow project-scoped repository defined in pom.xml and setup.py

  • Code refactoring, now programming friendly

  • README converted to reStructuredText

  • Migrate to MIT License

• 0.2.1 - 2011-04-07

  • Improved console output format

  • Correct scope dependency management inheritance

  • Alpha release of snapshot management, you can update a snapshot artifact

  • Environment independent configuration. .jip for each environment

  • Bug fixes

• 0.1 - 2011-01-04

  • Initial release

Links

• Don’t repeat yourself: Distribute jython packages with jip.dist

• Obsolete Introduction to jip 0.1

• Project on Github

• Package on Python Cheese Shop