FastForward Java Client

FastForward client for Java.

License	The Apache Software License, Version 2.0
Categories	CLI User Interface
GroupId	com.spotify.ffwd
ArtifactId	ffwd-client
Last Version	0.2.4
Release Date	Nov 18, 2020
Type	jar
Description	FastForward Java Client FastForward client for Java.

Download ffwd-client

Filename	Size
ffwd-client-0.2.4.pom
ffwd-client-0.2.4.jar	106 KB
ffwd-client-0.2.4-sources.jar	36 KB
ffwd-client-0.2.4-javadoc.jar	639 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.spotify.ffwd/ffwd-client/ -->
<dependency>
    <groupId>com.spotify.ffwd</groupId>
    <artifactId>ffwd-client</artifactId>
    <version>0.2.4</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.spotify.ffwd/ffwd-client/
implementation 'com.spotify.ffwd:ffwd-client:0.2.4'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.spotify.ffwd/ffwd-client/
implementation ("com.spotify.ffwd:ffwd-client:0.2.4")

Apache Buildr

'com.spotify.ffwd:ffwd-client:jar:0.2.4'

Apache Ivy

<dependency org="com.spotify.ffwd" name="ffwd-client" rev="0.2.4">
  <artifact name="ffwd-client" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.spotify.ffwd', module='ffwd-client', version='0.2.4')
)

Scala SBT

libraryDependencies += "com.spotify.ffwd" % "ffwd-client" % "0.2.4"

Leiningen

[com.spotify.ffwd/ffwd-client "0.2.4"]

Dependencies

compile (3)

Group / Artifact	Type	Version
com.google.auto.value : auto-value	jar	1.2
javax.annotation : javax.annotation-api	jar	1.3.2
com.google.protobuf : protobuf-java	jar	3.11.1

test (3)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-api	jar	5.5.2
org.junit.jupiter : junit-jupiter-engine	jar	5.5.2
org.mockito : mockito-junit-jupiter	jar	3.4.3

Project Modules

There are no modules declared in this project.

A java client to FastForward

A java client for the native protobuf protocol of ffwd.

Usage

<dependency>
    <groupId>com.spotify.ffwd</groupId>
    <artifactId>ffwd-client</artifactId>
    <version>LATEST-VERSION</version>
</dependency>

public class Foo {
    private static final FastForward ffwd = FastForward.setup();
    private static final Metric metric = FastForward.metric("foo.metric").attribute("class", Foo.class.getCanonicalName());

    public void run() throws IOException {
        ffwd.send(metric.value(42));
    }
}

OpenCensus Exporter

All registered OpenCensus Stats views will be exported to FFWD.

At this time histograms/distributions are not supported in Heroic until #476 is resolved.

<dependency>
    <groupId>com.spotify.ffwd</groupId>
    <artifactId>opencensus-exporter</artifactId>
    <version>LATEST-VERSION</version>
</dependency>

com.spotify.ffwd.FfwdStatsExporter.createAndRegister(
   com.spotify.ffwd.FfwdStatsConfiguration.builder().setExporterIntervalSeconds(30).build()
);

Contributing

1. Fork ffwd-java-client from GitHub and clone your fork.
2. Hack.
3. Push the branch back to GitHub.
4. Send a pull request to our upstream repo.

Releasing

Releasing is done via the maven-release-plugin and nexus-staging-plugin which are configured via the release profile. Deploys are staged in oss.sonatype.org before being deployed to Maven Central. Check out the maven-release-plugin docs and the nexus-staging-plugin docs for more information.

To release, first run:

mvn -P release release:prepare

You will be prompted for the release version and the next development version. On success, follow with:

mvn -P release release:perform

Spotify

Versions

Version
0.2.4 Nov 18, 2020
0.2.3 Oct 13, 2020
0.2.2 Aug 21, 2020
0.2.1 Dec 16, 2019