JsonSchemaEntities

Type Members

case class DocumentedEndpoint(path: String, item: PathItem) extends Product with Serializable
case class DocumentedHeaders(value: List[HeaderName]) extends Product with Serializable
sealed trait DocumentedJsonSchema extends AnyRef

Definition Classes
JsonSchemas
case class DocumentedParameter(name: String, required: Boolean) extends Product with Serializable
case class DocumentedQueryString(parameters: List[DocumentedParameter]) extends Product with Serializable
case class DocumentedRequest(method: Requests.Method, url: Requests.DocumentedUrl, headers: DocumentedHeaders, entity: Option[DocumentedRequestEntity]) extends Product with Serializable

Definition Classes
Requests
case class DocumentedRequestEntity(documentation: Option[String], content: Map[String, MediaType]) extends Product with Serializable
case class DocumentedResponse(status: Int, documentation: String, content: Map[String, MediaType]) extends Product with Serializable
case class DocumentedUrl(path: String, pathParameters: List[DocumentedParameter], queryParameters: List[DocumentedParameter]) extends Product with Serializable
type Endpoint[A, B] = DocumentedEndpoint

Information carried by an HTTP endpoint
Information carried by an HTTP endpoint

Definition Classes
Endpoints → Endpoints
type HeaderName = String

Definition Classes
Requests
type JsonRequest[A] = JsonSchema[A]

Type class defining how to represent the A information as a JSON request entity
Type class defining how to represent the A information as a JSON request entity

Definition Classes
JsonSchemaEntities → JsonEntities
type JsonResponse[A] = JsonSchema[A]

Type class defining how to represent the A information as a JSON response entity
Type class defining how to represent the A information as a JSON response entity

Definition Classes
JsonSchemaEntities → JsonEntities
type JsonSchema[+A] = DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
implicit final class JsonSchemaOps[A] extends AnyRef

Definition Classes
JsonSchemas
sealed trait Method extends AnyRef

Definition Classes
Methods → Methods
type Path[A] = DocumentedUrl

An URL path carrying an A information
An URL path carrying an A information

Definition Classes
Urls → Urls
implicit class PathOps[A] extends AnyRef

Convenient methods for Paths.
type QueryString[A] = DocumentedQueryString

A query string carrying an A information
A query string carrying an A information

Definition Classes
Urls → Urls
implicit class QueryStringOps[A] extends AnyRef

Provides convenient methods on QueryString.
type QueryStringParam[A] = Unit

A single query string parameter carrying an A information.
A single query string parameter carrying an A information.

Definition Classes
Urls → Urls
type Record[+A] = DocumentedRecord

Definition Classes
JsonSchemas → JsonSchemas
implicit final class RecordOps[A] extends AnyRef

Definition Classes
JsonSchemas
type Request[A] = DocumentedRequest

Information carried by a whole request (headers and entity)
Information carried by a whole request (headers and entity)

Definition Classes
Requests → Requests
type RequestEntity[A] = Option[DocumentedRequestEntity]

Information carried by request entity
Information carried by request entity

Definition Classes
Requests → Requests
type RequestHeaders[A] = DocumentedHeaders

Information carried by requests’ headers
Information carried by requests’ headers

Definition Classes
Requests → Requests
type Response[A] = List[DocumentedResponse]

Information carried by a response
Information carried by a response

Definition Classes
Responses → Responses
type Segment[A] = Unit

An URL path segment carrying an A information.
An URL path segment carrying an A information.

Definition Classes
Urls → Urls
type Tagged[+A] = DocumentedCoProd

Definition Classes
JsonSchemas → JsonSchemas
implicit final class TaggedOps[A] extends AnyRef

Definition Classes
JsonSchemas
type Url[A] = DocumentedUrl

An URL carrying an A information
An URL carrying an A information

Definition Classes
Urls → Urls

Value Members

final def !=(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def !=(arg0: Any): Boolean

Definition Classes
Any
final def ##(): Int

Definition Classes
AnyRef → Any
final def ==(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def ==(arg0: Any): Boolean

Definition Classes
Any
object Delete extends Method with Product with Serializable

Definition Classes
Methods → Methods
object DocumentedJsonSchema

Definition Classes
JsonSchemas
object Get extends Method with Product with Serializable

Definition Classes
Methods → Methods
object Patch extends Method with Product with Serializable

Definition Classes
Methods → Methods
object Post extends Method with Product with Serializable

Definition Classes
Methods → Methods
object Put extends Method with Product with Serializable

Definition Classes
Methods → Methods
def arrayJsonSchema[C[X] <: Seq[X], A](implicit jsonSchema: JsonSchema[A], cbf: CanBuildFrom[_, A, C[A]]): JsonSchema[C[A]]

Definition Classes
JsonSchemas → JsonSchemas
final def asInstanceOf[T0]: T0

Definition Classes
Any
lazy val bigdecimalJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
lazy val booleanJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def chainPaths[A, B](first: Path[A], second: Path[B])(implicit tupler: Tupler[A, B]): Path[Out]

Chains the two paths
Chains the two paths

Definition Classes
Urls → Urls
def choiceTagged[A, B](taggedA: DocumentedCoProd, taggedB: DocumentedCoProd): DocumentedCoProd

Definition Classes
JsonSchemas → JsonSchemas
def clone(): AnyRef

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( ... )
def combineQueryStrings[A, B](first: QueryString[A], second: QueryString[B])(implicit tupler: Tupler[A, B]): QueryString[Out]

Concatenates two QueryStrings
Concatenates two QueryStrings

Definition Classes
Urls → Urls
lazy val doubleJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def emptyHeaders: DocumentedHeaders

No particular information.
No particular information. Does not mean that the headers *have to* be empty. Just that, from a server point of view no information will be extracted from them, and from a client point of view no particular headers will be built in the request.

Definition Classes
Requests → Requests
def emptyRequest: None.type

Empty request.
Empty request.

Definition Classes
Requests → Requests
def emptyResponse(documentation: String): Response[Unit]

Empty response.
Empty response.

Definition Classes
Responses → Responses
def endpoint[A, B](request: Request[A], response: Response[B]): Endpoint[A, B]

HTTP endpoint.
HTTP endpoint.
request
Request
response
Response

Definition Classes
Endpoints → Endpoints
final def eq(arg0: AnyRef): Boolean

Definition Classes
AnyRef
def equals(arg0: Any): Boolean

Definition Classes
AnyRef → Any
def field[A](name: String, documentation: Option[String])(implicit tpe: DocumentedJsonSchema): DocumentedRecord

Definition Classes
JsonSchemas → JsonSchemas
def finalize(): Unit

Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@throws( classOf[java.lang.Throwable] )
final def get[A, B](url: Url[A], headers: RequestHeaders[B] = emptyHeaders)(implicit tuplerAC: Tupler[A, B]): Request[Out]

Helper method to perform GET request
Helper method to perform GET request

Definition Classes
Requests
final def getClass(): Class[_]

Definition Classes
AnyRef → Any
def hashCode(): Int

Definition Classes
AnyRef → Any
lazy val intJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def intQueryString: QueryStringParam[Int]

Ability to define Int query string parameters
Ability to define Int query string parameters

Definition Classes
Urls → Urls
def intSegment: Segment[Int]

Ability to define Int path segments
Ability to define Int path segments

Definition Classes
Urls → Urls
def invmapJsonSchema[A, B](jsonSchema: DocumentedJsonSchema, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def invmapRecord[A, B](record: DocumentedRecord, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedRecord

Definition Classes
JsonSchemas → JsonSchemas
def invmapTagged[A, B](tagged: DocumentedCoProd, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedCoProd

Definition Classes
JsonSchemas → JsonSchemas
final def isInstanceOf[T0]: Boolean

Definition Classes
Any
def jsonRequest[A](documentation: Option[String])(implicit codec: JsonSchema[A]): Option[DocumentedRequestEntity]

Defines a RequestEntity[A] given an implicit JsonRequest[A]
Defines a RequestEntity[A] given an implicit JsonRequest[A]

Definition Classes
JsonSchemaEntities → JsonEntities
def jsonResponse[A](documentation: String)(implicit codec: JsonSchema[A]): List[DocumentedResponse]

Defines a Response[A] given an implicit JsonResponse[A]
Defines a Response[A] given an implicit JsonResponse[A]

Definition Classes
JsonSchemaEntities → JsonEntities
lazy val longJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def longQueryString: QueryStringParam[Long]

Query string parameter containing a Long value
Query string parameter containing a Long value

Definition Classes
Urls → Urls
def longSegment: Segment[Long]

Segment containing a Long value
Segment containing a Long value

Definition Classes
Urls → Urls
final def ne(arg0: AnyRef): Boolean

Definition Classes
AnyRef
final def notify(): Unit

Definition Classes
AnyRef
final def notifyAll(): Unit

Definition Classes
AnyRef
def openApi(info: Info)(endpoints: DocumentedEndpoint*): OpenApi

info
General information about the documentation to generate
endpoints
The endpoints to generate the documentation for
returns
An OpenApi instance for the given endpoint descriptions

Definition Classes
Endpoints
def optField[A](name: String, documentation: Option[String])(implicit tpe: DocumentedJsonSchema): DocumentedRecord

Definition Classes
JsonSchemas → JsonSchemas
def optQs[A](name: String)(implicit value: QueryStringParam[A]): QueryString[Option[A]]

Builds a QueryString with one optional parameter of type A.
Builds a QueryString with one optional parameter of type A.
name
Parameter’s name

Definition Classes
Urls → Urls
val path: Path[Unit]

An empty path.
An empty path.
Useful to begin a path definition:
```
path / "foo" / segment[Int]("some-value")
```
Definition Classes
Urls
final def post[A, B, C, AB](url: Url[A], entity: RequestEntity[B], headers: RequestHeaders[C] = emptyHeaders)(implicit tuplerAB: Tupler.Aux[A, B, AB], tuplerABC: Tupler[AB, C]): Request[Out]

Helper method to perform POST request
Helper method to perform POST request

Definition Classes
Requests
def qs[A](name: String)(implicit value: QueryStringParam[A]): QueryString[A]

Builds a QueryString with one parameter.
Builds a QueryString with one parameter.
A
Type of the value carried by the parameter
name
Parameter’s name

Definition Classes
Urls → Urls
def request[A, B, C, AB](method: Method, url: Url[A], entity: RequestEntity[B] = emptyRequest, headers: RequestHeaders[C] = emptyHeaders)(implicit tuplerAB: Tupler.Aux[A, B, AB], tuplerABC: Tupler[AB, C]): Request[Out]

Request for given parameters
Request for given parameters
method
Request method
url
Request URL

Definition Classes
Requests → Requests
def segment[A](name: String)(implicit A: Segment[A]): Path[A]

Builds a path segment carrying an A information
Builds a path segment carrying an A information
name
Name for the segment (for documentation)

Definition Classes
Urls → Urls
def staticPathSegment(segment: String): Path[Unit]

Builds a static path segment
Builds a static path segment

Definition Classes
Urls → Urls
lazy val stringJsonSchema: DocumentedJsonSchema

Definition Classes
JsonSchemas → JsonSchemas
def stringQueryString: QueryStringParam[String]

Ability to define String query string parameters
Ability to define String query string parameters

Definition Classes
Urls → Urls
def stringSegment: Segment[String]

Ability to define String path segments
Ability to define String path segments

Definition Classes
Urls → Urls
final def synchronized[T0](arg0: ⇒ T0): T0

Definition Classes
AnyRef
def taggedRecord[A](recordA: DocumentedRecord, tag: String): DocumentedCoProd

Definition Classes
JsonSchemas → JsonSchemas
def textResponse(documentation: String): Response[String]

Text response.
Text response.

Definition Classes
Responses → Responses
def toSchema(documentedCodec: DocumentedJsonSchema): Schema
def toString(): String

Definition Classes
AnyRef → Any
def urlWithQueryString[A, B](path: Path[A], qs: QueryString[B])(implicit tupler: Tupler[A, B]): Url[Out]

Builds an URL from the given path and query string
Builds an URL from the given path and query string

Definition Classes
Urls → Urls
final def wait(): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long, arg1: Int): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
final def wait(arg0: Long): Unit

Definition Classes
AnyRef
Annotations
@throws( ... )
def zipRecords[A, B](recordA: DocumentedRecord, recordB: DocumentedRecord): DocumentedRecord

Definition Classes
JsonSchemas → JsonSchemas

trait JsonSchemaEntities extends algebra.JsonSchemaEntities with Endpoints with JsonSchemas

Type Members

case class DocumentedEndpoint(path: String, item: PathItem) extends Product with Serializable

case class DocumentedHeaders(value: List[HeaderName]) extends Product with Serializable

sealed trait DocumentedJsonSchema extends AnyRef

case class DocumentedParameter(name: String, required: Boolean) extends Product with Serializable

case class DocumentedQueryString(parameters: List[DocumentedParameter]) extends Product with Serializable

case class DocumentedRequest(method: Requests.Method, url: Requests.DocumentedUrl, headers: DocumentedHeaders, entity: Option[DocumentedRequestEntity]) extends Product with Serializable

case class DocumentedRequestEntity(documentation: Option[String], content: Map[String, MediaType]) extends Product with Serializable

case class DocumentedResponse(status: Int, documentation: String, content: Map[String, MediaType]) extends Product with Serializable

case class DocumentedUrl(path: String, pathParameters: List[DocumentedParameter], queryParameters: List[DocumentedParameter]) extends Product with Serializable

type Endpoint[A, B] = DocumentedEndpoint

type HeaderName = String

type JsonRequest[A] = JsonSchema[A]

type JsonResponse[A] = JsonSchema[A]

type JsonSchema[+A] = DocumentedJsonSchema

implicit final class JsonSchemaOps[A] extends AnyRef

sealed trait Method extends AnyRef

type Path[A] = DocumentedUrl

implicit class PathOps[A] extends AnyRef

type QueryString[A] = DocumentedQueryString

implicit class QueryStringOps[A] extends AnyRef

type QueryStringParam[A] = Unit

type Record[+A] = DocumentedRecord

implicit final class RecordOps[A] extends AnyRef

type Request[A] = DocumentedRequest

type RequestEntity[A] = Option[DocumentedRequestEntity]

type RequestHeaders[A] = DocumentedHeaders

type Response[A] = List[DocumentedResponse]

type Segment[A] = Unit

type Tagged[+A] = DocumentedCoProd

implicit final class TaggedOps[A] extends AnyRef

type Url[A] = DocumentedUrl

Value Members

final def !=(arg0: AnyRef): Boolean

final def !=(arg0: Any): Boolean

final def ##(): Int

final def ==(arg0: AnyRef): Boolean

final def ==(arg0: Any): Boolean

object Delete extends Method with Product with Serializable

object DocumentedJsonSchema

object Get extends Method with Product with Serializable

object Patch extends Method with Product with Serializable

object Post extends Method with Product with Serializable

object Put extends Method with Product with Serializable

def arrayJsonSchema[C[X] <: Seq[X], A](implicit jsonSchema: JsonSchema[A], cbf: CanBuildFrom[_, A, C[A]]): JsonSchema[C[A]]

final def asInstanceOf[T0]: T0

lazy val bigdecimalJsonSchema: DocumentedJsonSchema

lazy val booleanJsonSchema: DocumentedJsonSchema

def chainPaths[A, B](first: Path[A], second: Path[B])(implicit tupler: Tupler[A, B]): Path[Out]

def choiceTagged[A, B](taggedA: DocumentedCoProd, taggedB: DocumentedCoProd): DocumentedCoProd

def clone(): AnyRef

def combineQueryStrings[A, B](first: QueryString[A], second: QueryString[B])(implicit tupler: Tupler[A, B]): QueryString[Out]

lazy val doubleJsonSchema: DocumentedJsonSchema

def emptyHeaders: DocumentedHeaders

def emptyRequest: None.type

def emptyResponse(documentation: String): Response[Unit]

def endpoint[A, B](request: Request[A], response: Response[B]): Endpoint[A, B]

final def eq(arg0: AnyRef): Boolean

def equals(arg0: Any): Boolean

def field[A](name: String, documentation: Option[String])(implicit tpe: DocumentedJsonSchema): DocumentedRecord

def finalize(): Unit

final def get[A, B](url: Url[A], headers: RequestHeaders[B] = emptyHeaders)(implicit tuplerAC: Tupler[A, B]): Request[Out]

final def getClass(): Class[_]

def hashCode(): Int

lazy val intJsonSchema: DocumentedJsonSchema

def intQueryString: QueryStringParam[Int]

def intSegment: Segment[Int]

def invmapJsonSchema[A, B](jsonSchema: DocumentedJsonSchema, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedJsonSchema

def invmapRecord[A, B](record: DocumentedRecord, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedRecord

def invmapTagged[A, B](tagged: DocumentedCoProd, f: (A) ⇒ B, g: (B) ⇒ A): DocumentedCoProd

final def isInstanceOf[T0]: Boolean

def jsonRequest[A](documentation: Option[String])(implicit codec: JsonSchema[A]): Option[DocumentedRequestEntity]

def jsonResponse[A](documentation: String)(implicit codec: JsonSchema[A]): List[DocumentedResponse]

lazy val longJsonSchema: DocumentedJsonSchema

def longQueryString: QueryStringParam[Long]

def longSegment: Segment[Long]

final def ne(arg0: AnyRef): Boolean

final def notify(): Unit