misk-client

HTTP client for misk

License	License The Apache Software License, Version 2.0
Categories	Categories CLI User Interface Square Business Logic Libraries Financial
GroupId	GroupId com.squareup.misk
ArtifactId	ArtifactId misk-client
Last Version	Last Version 0.17.0
Release Date	Release Date Apr 28, 2021
Type	Type jar
Description	Description misk-client HTTP client for misk
Project URL	Project URL https://github.com/square/misk/
Source Code Management	Source Code Management https://github.com/square/misk/

Download misk-client

Filename	Size
misk-client-0.17.0.pom
misk-client-0.17.0.jar	33 KB
misk-client-0.17.0-sources.jar	7 KB
misk-client-0.17.0-javadoc.jar	1 MB
Browse

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.squareup.misk/misk-client/ -->
<dependency>
    <groupId>com.squareup.misk</groupId>
    <artifactId>misk-client</artifactId>
    <version>0.17.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.squareup.misk/misk-client/
implementation 'com.squareup.misk:misk-client:0.17.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.squareup.misk/misk-client/
implementation ("com.squareup.misk:misk-client:0.17.0")

Apache Buildr

'com.squareup.misk:misk-client:jar:0.17.0'

Apache Ivy

<dependency org="com.squareup.misk" name="misk-client" rev="0.17.0">
  <artifact name="misk-client" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.squareup.misk', module='misk-client', version='0.17.0')
)

Scala SBT

libraryDependencies += "com.squareup.misk" % "misk-client" % "0.17.0"

Leiningen

[com.squareup.misk/misk-client "0.17.0"]

Dependencies

compile (9)

Group / Artifact	Type	Version
io.grpc : grpc-bom	jar	1.36.0
com.google.guava : guava	jar	30.1.1-jre
com.fasterxml.jackson : jackson-bom	jar	2.12.2
org.glassfish.jersey : jersey-bom	jar	2.29.1
org.eclipse.jetty : jetty-bom	jar	9.4.38.v20210224
org.jetbrains.kotlin : kotlin-bom	jar	1.4.0
io.netty : netty-bom	jar	4.1.60.Final
com.squareup.misk : wisp-ssl	jar	0.17.0
com.squareup.misk : wisp-logging	jar	0.17.0

runtime (11)

Group / Artifact	Type	Version
com.github.jnr : jnr-unixsocket	jar	0.22
org.jetbrains.kotlin : kotlin-stdlib-jdk8	jar	1.4.0
com.squareup.moshi : moshi-kotlin	jar	1.11.0
com.squareup.okhttp3 : okhttp	jar	4.8.0
com.squareup.okio : okio	jar	2.7.0
io.opentracing : opentracing-api	jar	0.33.0
io.opentracing.contrib : opentracing-okhttp3	jar	3.0.0
com.squareup.retrofit2 : retrofit	jar	2.8.1
com.squareup.retrofit2 : converter-moshi	jar	2.8.1
com.squareup.retrofit2 : converter-protobuf	jar	2.8.1
com.squareup.retrofit2 : converter-wire	jar	2.8.1

test (1)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-api	jar	5.6.0

Project Modules

There are no modules declared in this project.

See the project website for documentation and APIs.

Misk is a new open source application container from Cash App.

Misk is not ready for use. The API is not stable.

Releases

Our change log has release history. API is subject to change.

implementation("com.squareup.misk:misk:0.17.1")

Snapshot builds are available.

Modules

misk-actions

The core annotations and interfaces necessary to define actions that can be hosted in Misk. This package has no dependency on the enclosing container (Misk!) and so your actions can be used in other environments without any heavy dependencies.

Actions should extend WebAction, be annotated with a HTTP method like @Post, accept a request object and return a response object. Throw an exception like BadRequestException to fail the request without much boilerplate.

misk-aws

Integrate with Amazon Web Services, and includes packages to integrate with S3 and SQS.

misk-aws-dynamodb

Integrate with AWS DynamoDb using AWS SDK for Java 1.x. It should be safe to install side-by-side with misk-aws2-dynamodb if you need to use features in both.

misk-aws-dynamodb-testing

Integrate with this package to write tests for code that interacts with DynamoDb. Exposes APIs via AWS SDK for Java 1.x. Use alongside with misk-aws-dynamodb.

Installing InProcessDynamoDbModule runs a DynamoDb Local instance in memory for your tests to run against. This module is recommended over DockerDynamoDbModule because there is less overhead in test execution performance.

Installing DockerDynamoDbModule runs a DynamoDB Local instance in Docker for your tests to execute against.

misk-aws2-dynamodb

Integrate with AWS DynamoDb using AWS SDK for Java 2.x. It should be safe to install side-by-side with misk-aws-dynamodb if you need to use features in both.

Please read the AWS SDK for Java 2.x Migration Guide for more details.

misk-aws2-dynamodb-testing

Integrate with this package to write tests for code that interacts with DynamoDb. Exposes APIs via AWS SDK for Java 2.x. Use alongside with misk-aws2-dynamodb.

Installing DockerDynamoDbModule runs a DynamoDB Local instance in Docker for your tests to execute against.

misk-service

Bind Guava services with inter-service dependencies.

Any service can depend on any other service. ServiceManager won't start a service until the services it depends on are running.

misk-inject

Integrates Guice with Kotlin.

Extending KAbstractModule instead of Guice's AbstractModule lets you use KClass instead of java.lang.Class and other conveniences.

misk-feature

Runtime feature flags. misk-launchdarkly is the reference implementation.

misk-jobqueue

A job queue with a high quality fake. AwsSqsJobQueueModule from misk-aws is the reference implementation.

misk-events

An event publisher + consumer. There is no open source reference implementation at this time.

Looking for Misk-Web?

Misk-Web powers the Misk Admin Dashboard with modular Typescript + React powered tabs.

Check out Misk-Web!

What are the wisp* modules?

The wisp* modules contain no Dependency Injection based code (i.e. no Guice, etc). These modules should never refer to misk* modules, although misk* modules can (and should) use wisp* modules.

Also, modules that are wisp*-testing will only be used in test scope in other wisp modules, never in the api/implementation scope.

If you are refactoring code from misk into the wisp modules, you must not break any external Misk dependencies or apis. It is ok to deprecate items in misk to encourage eventual migration to wisp directly if desired. If your refactoring does not fit one of the existing wisp modules, create a new module. For now, it is preferred to have many small modules rather than larger conglomerate modules requiring many different dependencies.

It should be considered that wisp will be volatile for sometime with the potential for a lot of changes, additions, etc. Misk apps should use wisp modules directly with caution as breaking changes might be required.

Square

Versions

Version
0.17.0 Apr 28, 2021