neandertech / jsonrpclib

A cross-platform (JVM, JS, Native) pure-Scala JsonRPC library, made with Cats Effect, fs2, and jsoniter

jsonrpclib

This is a cross-platform, cross-scala-version library that provides construct for bidirectional communication using the jsonrpc protocol. It is built on top of fs2 and jsoniter-scala

This library does not enforce any transport, and can work on top of stdin/stdout or other channels.

Installation

The dependencies below are following cross-platform semantics. Adapt according to your needs

SBT

libraryDependencies += "tech.neander" %%% "jsonrpclib-fs2" % version

Mill

override def ivyDeps = super.ivyDeps() ++ Agg(ivy"tech.neander::jsonrpclib-fs2::$version")

Scala-cli

//> using lib "tech.neander::jsonrpclib-fs2:<VERSION>"

Usage

/!\ Please be aware that this library is in its early days and offers strictly no guarantee with regards to backward compatibility

See the examples folder

jsonrpclib's Issues

Make `core` fs2-specific

When I started this library, fs2 wasn't compiling to SN, and I had established a pretty arbitrary separation ... Standardising over fs2 would simplify some parts of the code a fair bit, and I'm not interested in implementing json-rpc for anything but fs2.

Use `fs2.concurrent.Channel` instead of `Queue`

For possibly more graceful shutdown

Update mill-tpolecat and publish

Just dropping this in here as a reminder once the Steward PR comes in. There was just a new release of mill-tpolecat that includes DavidGregory084/mill-tpolecat#18. The goal is to get the currently ignored libraries (including this one) removed from the filtered projects list in the community build https://github.com/VirtusLab/community-build3/blob/927f3751011d120c52a5217dfe8ccd3321f49c42/env/prod/config/filtered-projects.txt#L67-L69. Once that plugin is updated here with that fix I can remove it there.

CallId codec doesn't handle strings

Whereas I think it should, right?

//> using lib "tech.neander::jsonrpclib-fs2:0.0.3"

import com.github.plokhotnyuk.jsoniter_scala.core.*

@main def hello = 
  readFromStringReentrant[jsonrpclib.CallId]("25")
  readFromStringReentrant[jsonrpclib.CallId](""" "25" """.trim)

$ scli test.scala
Exception in thread "main" com.github.plokhotnyuk.jsoniter_scala.core.JsonReaderException: expected end of input, offset: 0x00000002, buf:
+----------+-------------------------------------------------+------------------+
|          |  0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f | 0123456789abcdef |
+----------+-------------------------------------------------+------------------+
| 00000000 | 22 32 35 22                                     | "25"             |
+----------+-------------------------------------------------+------------------+