JarCasting
JarCasting JarCasting

Revapi Site Base

Reusable parts of the site that modules can use to create their parts of the resulting site structure.

License

License
GroupId

GroupId

org.revapi
ArtifactId

ArtifactId

revapi-site-base
Last Version

Last Version

1
Release Date

Release Date
Type

Type

jar
Description

Description

Revapi Site Base
Reusable parts of the site that modules can use to create their parts of the resulting site structure.

Download revapi-site-base

Filename Size
revapi-site-base-1.pom
revapi-site-base-1.jar 3 KB
revapi-site-base-1-sources.jar 2 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/org.revapi/revapi-site-base/ -->
<dependency>
    <groupId>org.revapi</groupId>
    <artifactId>revapi-site-base</artifactId>
    <version>1</version>
</dependency>
// https://jarcasting.com/artifacts/org.revapi/revapi-site-base/
implementation 'org.revapi:revapi-site-base:1'
// https://jarcasting.com/artifacts/org.revapi/revapi-site-base/
implementation ("org.revapi:revapi-site-base:1")
'org.revapi:revapi-site-base:jar:1'
<dependency org="org.revapi" name="revapi-site-base" rev="1">
  <artifact name="revapi-site-base" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.revapi', module='revapi-site-base', version='1')
)
libraryDependencies += "org.revapi" % "revapi-site-base" % "1"
[org.revapi/revapi-site-base "1"]

Dependencies

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

Project Modules

There are no modules declared in this project.

Revapi

Table of Contents

Build Status Code Coverage Gitter Chat

Revapi is a tool for API analysis and change tracking.

INFO: Revapi requires Java8 update 40 (1.8.0_40) or later to run. Older versions may produce wrong results.

Summary

While Revapi is designed to be extensible and in theory should support API checks in other languages than Java (not just programming languages but anything that can be decomposed to a tree structure) the only extension in existence today is the Java API checker.

The main distinguishing features of the Java API checker include:

  • large number of API checks

    • categorized by their influence on source, binary and "semantical" compatibility

  • support for computing the API "surface" by tracking usages of types across the checked library and also its dependencies (ability to report type "leakage" from deps)

  • support for Java8 constructs (default methods in particular)

  • powerful filtering stuff to check and reclassification of found problems

  • ability to filter by annotation presence

  • Maven plugin automatically includes depenendcies in the check

Other features:

  • ability to judge the severity of changes based on semver rules (see here)

  • automatic updates of pom.xml or release.properties versions according to semver rules (see here)

  • pluggable reporting (standard output, maven site generation, JUnit report generator (TBD))

Building

This is a maven project, so to build you simply:

mvn install

Usage

Revapi can be invoked in a couple of ways. It can be used as a standalone program, as a maven plugin or it can also be embedded in your application and used as a library.

Standalone

Download the standalone distribution zip and

unzip revapi-XXX-standalone.zip
cd revapi-XXX-standalone
./revapi.sh

Read the usage info and go.

Maven

<build>
    <plugins>
        <plugin>
            <groupId>org.revapi</groupId>
            <artifactId>revapi-maven-plugin</artifactId>
            <version>...</version>
            <dependencies>
                <dependency>
                    <groupId>org.revapi</groupId>
                    <artifactId>revapi-java</artifactId>
                    <version>...</version>
                </dependency>
                <dependency>
                    <groupId>com.acme</groupId>
                    <artifactId>my-extension</artifactId>
                    <version>...</version>
                </dependency>
                ...
            </dependencies>
            <configuration>
                ...
            </configuration>
            <executions>
                <execution>
                    <id>api-check</id>
                    <goals><goal>check</goal></goals>
                    ...
                </execution>
                ...
            </executions>
        </plugin>
        ...
    </plugins>
    ...
</build>

Gradle

There is an external Gradle plugin available for Revapi, https://github.com/palantir/gradle-revapi.

Embedding

Revapi revapi = Revapi.builder().withAllExtensionsFromThreadContextClassLoader().build();

AnalysisContext analysisContext = AnalysisContext.builder()
    .withOldAPI(API.of(...))
    .withNewAPI(API.of(...))
    .withConfigurationFromJSON("json").build();

revapi.analyze(analysisContext);

Extending Revapi

See the site for more info.

org.revapi

Revapi

Revapi - API evolution checker for the masses

Versions

Version
1