Krakatau Java Assembler Tools

Assembler, disassebmler, decompiler and compiler tools for Java. Contains library, command-line interface and maven plugin.

License	GNU Pubic License 3.0
Categories	Java Languages
GroupId	com.alexkasko.krakatau
ArtifactId	krakatau-java
Last Version	1.1
Release Date	Apr 30, 2015
Type	pom
Description	Krakatau Java Assembler Tools Assembler, disassebmler, decompiler and compiler tools for Java. Contains library, command-line interface and maven plugin.
Project URL	https://github.com/alexkasko/krakatau-java
Source Code Management	https://github.com/alexkasko/krakatau-java

Download krakatau-java

Filename	Size
krakatau-java-1.1.pom	7 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.alexkasko.krakatau/krakatau-java/ -->
<dependency>
    <groupId>com.alexkasko.krakatau</groupId>
    <artifactId>krakatau-java</artifactId>
    <version>1.1</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.alexkasko.krakatau/krakatau-java/
implementation 'com.alexkasko.krakatau:krakatau-java:1.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.alexkasko.krakatau/krakatau-java/
implementation ("com.alexkasko.krakatau:krakatau-java:1.1")

Apache Buildr

'com.alexkasko.krakatau:krakatau-java:pom:1.1'

Apache Ivy

<dependency org="com.alexkasko.krakatau" name="krakatau-java" rev="1.1">
  <artifact name="krakatau-java" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.alexkasko.krakatau', module='krakatau-java', version='1.1')
)

Scala SBT

libraryDependencies += "com.alexkasko.krakatau" % "krakatau-java" % "1.1"

Leiningen

[com.alexkasko.krakatau/krakatau-java "1.1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

• krakatau-lib
• krakatau-cli
• krakatau-maven-plugin
• krakatau-maven-plugin-test

Java disassembler, assembler and decompiler

This project contains tools from Krakatau python library embedded into java library using Jython.

Command line tool and maven plugin were built on top of this library.

Krakatau java library

This library contains jython-standalone library merged with Krakatau python source code using maven shade plugin. It allows to use all Krakatau operations (disassembler, assembler and decompiler) as usual Java API without CPython. It also contains standalone java compiler (eclipse ecj) that allows to compile Java sources with the API similar to other operations.

Javadocs are available here.

Library dependency (from maven central):

<dependency>
    <groupId>com.alexkasko.krakatau</groupId>
    <artifactId>krakatau-lib</artifactId>
    <version>1.1</version>
    <classifier>standalone</classifier>
    <exclusions>
        <exclusion>
            <groupId>org.python</groupId>
            <artifactId>jython-standalone</artifactId>
            </exclusion>
        <exclusion>
            <groupId>org.eclipse.jdt.core.compiler</groupId>
            <artifactId>ecj</artifactId>
        </exclusion>
        <exclusion>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Operations:

• disassemble: converts Java class file into human-readable text representation of Java byte-code (.j asm files)
• assemble: converts asm (.j) files into Java class files
• decompile: converts Java class files into Java source files
• compile: usual compilation, added to library for completeness

API usage example:

List<String> classes = Arrays.asList("foo.bar.Baz1", "foo.bar.Baz2")
List<File> classpath = ...
File outputDir = new File("out");
KrakatauLibrary krakatau = new KrakatauLibrary().
krakatau.decompile(classpath, classes, outputDir);

Command line tool

Command line tool was created mainly for testing purposes, Jython slow startup make it impractical comparing to original Krakatau.

Download krakatau.jar-1.1 (sha256sum).

Maven plugin

This maven plugin is a kind of poor-man's IDE plugin for disassemble and decompilation of Java classes. Plugin may be configured in pom file to be run from command line (or IDE interface) as follows (see pom example and maven-generated plugin site):

mvn krakatau:assemble
mvn krakatau:disassemble
mvn krakatau:decompile
mvn krakatau:compile

Also decompile operation in Krakatau requires Java classpath that may be cumbersome to specify from CLI, but very easy in Maven - project dependencies are used as a classpath.

License information

This project is released under the GNU Public License 3.0 (it's required by original Krakatau license).

Changelog

1.1 (2015-04-30)

• Krakatau, Jython and ECJ updated
• language level option added to compile task
• Jython cleanup fix when running from maven

1.0.1 (2013-10-03)

• fix test dependencies resolving in compiler and decompiler maven

1.0 (2013-10-01)

• initial public version

Versions

Version
1.1 Apr 30, 2015
1.0.1 Oct 3, 2013
1.0 Oct 1, 2013