/** * Generated by API Builder - https://www.apibuilder.io * Service version: 0.0.1-dev * User agent: apibuilder app.apibuilder.io/natalia/foursquare/0.0.1-dev/play_2_5_client */ package natalia.foursquare.v0.models { /** * Photo of venues */ final case class Photo( prefix: String, suffix: String, width: Int, height: Int ) /** * Venue * * @param name Name * @param id Id * @param bestPhoto Best photo of venue */ final case class Venue( name: String, id: String, bestPhoto: _root_.scala.Option[natalia.foursquare.v0.models.Photo] = None ) /** * Venue details response */ final case class VenueDetailsResponse( venue: natalia.foursquare.v0.models.Venue ) /** * Venue details response wrapper */ final case class VenueDetailsResponseWrapper( response: natalia.foursquare.v0.models.VenueDetailsResponse ) /** * Explore venue response * * @param groups List of venue groups i.e. Recommended Places */ final case class VenueExploreResponse( groups: Seq[natalia.foursquare.v0.models.VenueGroup] ) /** * Explore venue response wrapper * * @param response Response content */ final case class VenueExploreResponseWrapper( response: natalia.foursquare.v0.models.VenueExploreResponse ) /** * Venue group * * @param items Venue item */ final case class VenueGroup( items: Seq[natalia.foursquare.v0.models.VenueItem] ) /** * Venue item * * @param venue Venue */ final case class VenueItem( venue: natalia.foursquare.v0.models.Venue ) } package natalia.foursquare.v0.models { package object json { import play.api.libs.json.__ import play.api.libs.json.JsString import play.api.libs.json.Writes import play.api.libs.functional.syntax._ import natalia.foursquare.v0.models.json._ private[v0] implicit val jsonReadsUUID: play.api.libs.json.Reads[_root_.java.util.UUID] = __.read[String].map { str => _root_.java.util.UUID.fromString(str) } private[v0] implicit val jsonWritesUUID: play.api.libs.json.Writes[_root_.java.util.UUID] = (x: _root_.java.util.UUID) => play.api.libs.json.JsString(x.toString) private[v0] implicit val jsonReadsJodaDateTime: play.api.libs.json.Reads[_root_.org.joda.time.DateTime] = __.read[String].map { str => _root_.org.joda.time.format.ISODateTimeFormat.dateTimeParser.parseDateTime(str) } private[v0] implicit val jsonWritesJodaDateTime: play.api.libs.json.Writes[_root_.org.joda.time.DateTime] = (x: _root_.org.joda.time.DateTime) => { play.api.libs.json.JsString(_root_.org.joda.time.format.ISODateTimeFormat.dateTime.print(x)) } private[v0] implicit val jsonReadsJodaLocalDate: play.api.libs.json.Reads[_root_.org.joda.time.LocalDate] = __.read[String].map { str => _root_.org.joda.time.format.ISODateTimeFormat.dateTimeParser.parseLocalDate(str) } private[v0] implicit val jsonWritesJodaLocalDate: play.api.libs.json.Writes[_root_.org.joda.time.LocalDate] = (x: _root_.org.joda.time.LocalDate) => { play.api.libs.json.JsString(_root_.org.joda.time.format.ISODateTimeFormat.date.print(x)) } implicit def jsonReadsFoursquarePhoto: play.api.libs.json.Reads[natalia.foursquare.v0.models.Photo] = { for { prefix <- (__ \ "prefix").read[String] suffix <- (__ \ "suffix").read[String] width <- (__ \ "width").read[Int] height <- (__ \ "height").read[Int] } yield Photo(prefix, suffix, width, height) } def jsObjectPhoto(obj: natalia.foursquare.v0.models.Photo): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "prefix" -> play.api.libs.json.JsString(obj.prefix), "suffix" -> play.api.libs.json.JsString(obj.suffix), "width" -> play.api.libs.json.JsNumber(obj.width), "height" -> play.api.libs.json.JsNumber(obj.height) ) } implicit def jsonWritesFoursquarePhoto: play.api.libs.json.Writes[Photo] = { (obj: natalia.foursquare.v0.models.Photo) => { natalia.foursquare.v0.models.json.jsObjectPhoto(obj) } } implicit def jsonReadsFoursquareVenue: play.api.libs.json.Reads[natalia.foursquare.v0.models.Venue] = { for { name <- (__ \ "name").read[String] id <- (__ \ "id").read[String] bestPhoto <- (__ \ "bestPhoto").readNullable[natalia.foursquare.v0.models.Photo] } yield Venue(name, id, bestPhoto) } def jsObjectVenue(obj: natalia.foursquare.v0.models.Venue): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "name" -> play.api.libs.json.JsString(obj.name), "id" -> play.api.libs.json.JsString(obj.id) ) ++ (obj.bestPhoto match { case None => play.api.libs.json.Json.obj() case Some(x) => play.api.libs.json.Json.obj("bestPhoto" -> natalia.foursquare.v0.models.json.jsObjectPhoto(x)) }) } implicit def jsonWritesFoursquareVenue: play.api.libs.json.Writes[Venue] = { (obj: natalia.foursquare.v0.models.Venue) => { natalia.foursquare.v0.models.json.jsObjectVenue(obj) } } implicit def jsonReadsFoursquareVenueDetailsResponse: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueDetailsResponse] = { (__ \ "venue").read[natalia.foursquare.v0.models.Venue].map { x => VenueDetailsResponse(venue = x) } } def jsObjectVenueDetailsResponse(obj: natalia.foursquare.v0.models.VenueDetailsResponse): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "venue" -> natalia.foursquare.v0.models.json.jsObjectVenue(obj.venue) ) } implicit def jsonWritesFoursquareVenueDetailsResponse: play.api.libs.json.Writes[VenueDetailsResponse] = { (obj: natalia.foursquare.v0.models.VenueDetailsResponse) => { natalia.foursquare.v0.models.json.jsObjectVenueDetailsResponse(obj) } } implicit def jsonReadsFoursquareVenueDetailsResponseWrapper: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueDetailsResponseWrapper] = { (__ \ "response").read[natalia.foursquare.v0.models.VenueDetailsResponse].map { x => VenueDetailsResponseWrapper(response = x) } } def jsObjectVenueDetailsResponseWrapper(obj: natalia.foursquare.v0.models.VenueDetailsResponseWrapper): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "response" -> natalia.foursquare.v0.models.json.jsObjectVenueDetailsResponse(obj.response) ) } implicit def jsonWritesFoursquareVenueDetailsResponseWrapper: play.api.libs.json.Writes[VenueDetailsResponseWrapper] = { (obj: natalia.foursquare.v0.models.VenueDetailsResponseWrapper) => { natalia.foursquare.v0.models.json.jsObjectVenueDetailsResponseWrapper(obj) } } implicit def jsonReadsFoursquareVenueExploreResponse: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueExploreResponse] = { (__ \ "groups").read[Seq[natalia.foursquare.v0.models.VenueGroup]].map { x => VenueExploreResponse(groups = x) } } def jsObjectVenueExploreResponse(obj: natalia.foursquare.v0.models.VenueExploreResponse): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "groups" -> play.api.libs.json.Json.toJson(obj.groups) ) } implicit def jsonWritesFoursquareVenueExploreResponse: play.api.libs.json.Writes[VenueExploreResponse] = { (obj: natalia.foursquare.v0.models.VenueExploreResponse) => { natalia.foursquare.v0.models.json.jsObjectVenueExploreResponse(obj) } } implicit def jsonReadsFoursquareVenueExploreResponseWrapper: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueExploreResponseWrapper] = { (__ \ "response").read[natalia.foursquare.v0.models.VenueExploreResponse].map { x => VenueExploreResponseWrapper(response = x) } } def jsObjectVenueExploreResponseWrapper(obj: natalia.foursquare.v0.models.VenueExploreResponseWrapper): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "response" -> natalia.foursquare.v0.models.json.jsObjectVenueExploreResponse(obj.response) ) } implicit def jsonWritesFoursquareVenueExploreResponseWrapper: play.api.libs.json.Writes[VenueExploreResponseWrapper] = { (obj: natalia.foursquare.v0.models.VenueExploreResponseWrapper) => { natalia.foursquare.v0.models.json.jsObjectVenueExploreResponseWrapper(obj) } } implicit def jsonReadsFoursquareVenueGroup: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueGroup] = { (__ \ "items").read[Seq[natalia.foursquare.v0.models.VenueItem]].map { x => VenueGroup(items = x) } } def jsObjectVenueGroup(obj: natalia.foursquare.v0.models.VenueGroup): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "items" -> play.api.libs.json.Json.toJson(obj.items) ) } implicit def jsonWritesFoursquareVenueGroup: play.api.libs.json.Writes[VenueGroup] = { (obj: natalia.foursquare.v0.models.VenueGroup) => { natalia.foursquare.v0.models.json.jsObjectVenueGroup(obj) } } implicit def jsonReadsFoursquareVenueItem: play.api.libs.json.Reads[natalia.foursquare.v0.models.VenueItem] = { (__ \ "venue").read[natalia.foursquare.v0.models.Venue].map { x => VenueItem(venue = x) } } def jsObjectVenueItem(obj: natalia.foursquare.v0.models.VenueItem): play.api.libs.json.JsObject = { play.api.libs.json.Json.obj( "venue" -> natalia.foursquare.v0.models.json.jsObjectVenue(obj.venue) ) } implicit def jsonWritesFoursquareVenueItem: play.api.libs.json.Writes[VenueItem] = { (obj: natalia.foursquare.v0.models.VenueItem) => { natalia.foursquare.v0.models.json.jsObjectVenueItem(obj) } } } } package natalia.foursquare.v0 { object Bindables { import play.api.mvc.{PathBindable, QueryStringBindable} // import models directly for backwards compatibility with prior versions of the generator import Core._ object Core { implicit def pathBindableDateTimeIso8601(implicit stringBinder: QueryStringBindable[String]): PathBindable[_root_.org.joda.time.DateTime] = ApibuilderPathBindable(ApibuilderTypes.dateTimeIso8601) implicit def queryStringBindableDateTimeIso8601(implicit stringBinder: QueryStringBindable[String]): QueryStringBindable[_root_.org.joda.time.DateTime] = ApibuilderQueryStringBindable(ApibuilderTypes.dateTimeIso8601) implicit def pathBindableDateIso8601(implicit stringBinder: QueryStringBindable[String]): PathBindable[_root_.org.joda.time.LocalDate] = ApibuilderPathBindable(ApibuilderTypes.dateIso8601) implicit def queryStringBindableDateIso8601(implicit stringBinder: QueryStringBindable[String]): QueryStringBindable[_root_.org.joda.time.LocalDate] = ApibuilderQueryStringBindable(ApibuilderTypes.dateIso8601) } trait ApibuilderTypeConverter[T] { def convert(value: String): T def convert(value: T): String def example: T def validValues: Seq[T] = Nil def errorMessage(key: String, value: String, ex: java.lang.Exception): String = { val base = s"Invalid value '$value' for parameter '$key'. " validValues.toList match { case Nil => base + "Ex: " + convert(example) case values => base + ". Valid values are: " + values.mkString("'", "', '", "'") } } } object ApibuilderTypes { val dateTimeIso8601: ApibuilderTypeConverter[_root_.org.joda.time.DateTime] = new ApibuilderTypeConverter[_root_.org.joda.time.DateTime] { override def convert(value: String): _root_.org.joda.time.DateTime = _root_.org.joda.time.format.ISODateTimeFormat.dateTimeParser.parseDateTime(value) override def convert(value: _root_.org.joda.time.DateTime): String = _root_.org.joda.time.format.ISODateTimeFormat.dateTime.print(value) override def example: _root_.org.joda.time.DateTime = _root_.org.joda.time.DateTime.now } val dateIso8601: ApibuilderTypeConverter[_root_.org.joda.time.LocalDate] = new ApibuilderTypeConverter[_root_.org.joda.time.LocalDate] { override def convert(value: String): _root_.org.joda.time.LocalDate = _root_.org.joda.time.format.ISODateTimeFormat.dateTimeParser.parseLocalDate(value) override def convert(value: _root_.org.joda.time.LocalDate): String = _root_.org.joda.time.format.ISODateTimeFormat.date.print(value) override def example: _root_.org.joda.time.LocalDate = _root_.org.joda.time.LocalDate.now } } final case class ApibuilderQueryStringBindable[T]( converters: ApibuilderTypeConverter[T] ) extends QueryStringBindable[T] { override def bind(key: String, params: Map[String, Seq[String]]): _root_.scala.Option[_root_.scala.Either[String, T]] = { params.getOrElse(key, Nil).headOption.map { v => try { Right( converters.convert(v) ) } catch { case ex: java.lang.Exception => Left( converters.errorMessage(key, v, ex) ) } } } override def unbind(key: String, value: T): String = { s"$key=${converters.convert(value)}" } } final case class ApibuilderPathBindable[T]( converters: ApibuilderTypeConverter[T] ) extends PathBindable[T] { override def bind(key: String, value: String): _root_.scala.Either[String, T] = { try { Right( converters.convert(value) ) } catch { case ex: java.lang.Exception => Left( converters.errorMessage(key, value, ex) ) } } override def unbind(key: String, value: T): String = { converters.convert(value) } } } } package natalia.foursquare.v0 { object Constants { val BaseUrl = "https://api.foursquare.com/v2" val Namespace = "natalia.foursquare.v0" val UserAgent = "apibuilder app.apibuilder.io/natalia/foursquare/0.0.1-dev/play_2_5_client" val Version = "0.0.1-dev" val VersionMajor = 0 } class Client( ws: play.api.libs.ws.WSClient, val baseUrl: String = "https://api.foursquare.com/v2", auth: scala.Option[natalia.foursquare.v0.Authorization] = None, defaultHeaders: Seq[(String, String)] = Nil ) extends interfaces.Client { import natalia.foursquare.v0.models.json._ private val logger = play.api.Logger("natalia.foursquare.v0.Client") logger.info(s"Initializing natalia.foursquare.v0.Client for url $baseUrl") def venues: Venues = Venues object Venues extends Venues { override def getExplore( clientId: String, clientSecret: String, v: String, near: String, query: String, requestHeaders: Seq[(String, String)] = Nil )(implicit ec: scala.concurrent.ExecutionContext): scala.concurrent.Future[natalia.foursquare.v0.models.VenueExploreResponseWrapper] = { val queryParameters = Seq( Some("client_id" -> clientId), Some("client_secret" -> clientSecret), Some("v" -> v), Some("near" -> near), Some("query" -> query) ).flatten _executeRequest("GET", s"/venues/explore", queryParameters = queryParameters, requestHeaders = requestHeaders).map { case r if r.status == 200 => _root_.natalia.foursquare.v0.Client.parseJson("natalia.foursquare.v0.models.VenueExploreResponseWrapper", r, _.validate[natalia.foursquare.v0.models.VenueExploreResponseWrapper]) case r => throw natalia.foursquare.v0.errors.FailedRequest(r.status, s"Unsupported response code[${r.status}]. Expected: 200") } } override def getByVenueId( venueId: String, clientId: String, clientSecret: String, v: String, requestHeaders: Seq[(String, String)] = Nil )(implicit ec: scala.concurrent.ExecutionContext): scala.concurrent.Future[natalia.foursquare.v0.models.VenueDetailsResponseWrapper] = { val queryParameters = Seq( Some("client_id" -> clientId), Some("client_secret" -> clientSecret), Some("v" -> v) ).flatten _executeRequest("GET", s"/venues/${play.utils.UriEncoding.encodePathSegment(venueId, "UTF-8")}", queryParameters = queryParameters, requestHeaders = requestHeaders).map { case r if r.status == 200 => _root_.natalia.foursquare.v0.Client.parseJson("natalia.foursquare.v0.models.VenueDetailsResponseWrapper", r, _.validate[natalia.foursquare.v0.models.VenueDetailsResponseWrapper]) case r => throw natalia.foursquare.v0.errors.FailedRequest(r.status, s"Unsupported response code[${r.status}]. Expected: 200") } } } def _requestHolder(path: String): play.api.libs.ws.WSRequest = { val holder = ws.url(baseUrl + path).withHeaders( "User-Agent" -> Constants.UserAgent, "X-Apidoc-Version" -> Constants.Version, "X-Apidoc-Version-Major" -> Constants.VersionMajor.toString ).withHeaders(defaultHeaders: _*) auth.fold(holder) { case Authorization.Basic(username, password) => { holder.withAuth(username, password.getOrElse(""), play.api.libs.ws.WSAuthScheme.BASIC) } } } def _logRequest(method: String, req: play.api.libs.ws.WSRequest): play.api.libs.ws.WSRequest = { val queryComponents = for { (name, values) <- req.queryString value <- values } yield s"$name=$value" val url = s"${req.url}${queryComponents.mkString("?", "&", "")}" auth.fold(logger.info(s"curl -X $method '$url'")) { _ => logger.info(s"curl -X $method -u '[REDACTED]:' '$url'") } req } def _executeRequest( method: String, path: String, queryParameters: Seq[(String, String)] = Nil, requestHeaders: Seq[(String, String)] = Nil, body: Option[play.api.libs.json.JsValue] = None ): scala.concurrent.Future[play.api.libs.ws.WSResponse] = { method.toUpperCase match { case "GET" => { _logRequest("GET", _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)).get() } case "POST" => { _logRequest("POST", _requestHolder(path).withHeaders(_withJsonContentType(requestHeaders): _*).withQueryString(queryParameters: _*)).post(body.getOrElse(play.api.libs.json.Json.obj())) } case "PUT" => { _logRequest("PUT", _requestHolder(path).withHeaders(_withJsonContentType(requestHeaders): _*).withQueryString(queryParameters: _*)).put(body.getOrElse(play.api.libs.json.Json.obj())) } case "PATCH" => { _logRequest("PATCH", _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)).patch(body.getOrElse(play.api.libs.json.Json.obj())) } case "DELETE" => { _logRequest("DELETE", _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)).delete() } case "HEAD" => { _logRequest("HEAD", _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)).head() } case "OPTIONS" => { _logRequest("OPTIONS", _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)).options() } case _ => { _logRequest(method, _requestHolder(path).withHeaders(requestHeaders: _*).withQueryString(queryParameters: _*)) sys.error("Unsupported method[%s]".format(method)) } } } /** * Adds a Content-Type: application/json header unless the specified requestHeaders * already contain a Content-Type header */ def _withJsonContentType(headers: Seq[(String, String)]): Seq[(String, String)] = { headers.find { _._1.toUpperCase == "CONTENT-TYPE" } match { case None => headers ++ Seq("Content-Type" -> "application/json; charset=UTF-8") case Some(_) => headers } } } object Client { def parseJson[T]( className: String, r: play.api.libs.ws.WSResponse, f: (play.api.libs.json.JsValue => play.api.libs.json.JsResult[T]) ): T = { f(play.api.libs.json.Json.parse(r.body)) match { case play.api.libs.json.JsSuccess(x, _) => x case play.api.libs.json.JsError(errors) => { throw natalia.foursquare.v0.errors.FailedRequest(r.status, s"Invalid json for class[" + className + "]: " + errors.mkString(" ")) } } } } sealed trait Authorization extends _root_.scala.Product with _root_.scala.Serializable object Authorization { final case class Basic(username: String, password: Option[String] = None) extends Authorization } package interfaces { trait Client { def baseUrl: String def venues: natalia.foursquare.v0.Venues } } trait Venues { /** * Fetches venues nearby for a given query * * @param v Version parameter * @param near Search near this location * @param query What to search for */ def getExplore( clientId: String, clientSecret: String, v: String, near: String, query: String, requestHeaders: Seq[(String, String)] = Nil )(implicit ec: scala.concurrent.ExecutionContext): scala.concurrent.Future[natalia.foursquare.v0.models.VenueExploreResponseWrapper] /** * Venue details * * @param v Version parameter */ def getByVenueId( venueId: String, clientId: String, clientSecret: String, v: String, requestHeaders: Seq[(String, String)] = Nil )(implicit ec: scala.concurrent.ExecutionContext): scala.concurrent.Future[natalia.foursquare.v0.models.VenueDetailsResponseWrapper] } package errors { final case class FailedRequest(responseCode: Int, message: String, requestUri: Option[_root_.java.net.URI] = None) extends _root_.java.lang.Exception(s"HTTP $responseCode: $message") } }