yass2

• yass2 is
  • a small Kotlin Multiplatform library
  • for efficient asynchronous/non-blocking Coroutines based peer-to-peer communication
  • enforcing type-safe contracts with interfaces and data transfer objects

                         contract library
                       +-----------------------------------------+
                       | // contract definition                  |
                       | interface Calculator {                  |
                       |   suspend fun add(a: Int, b: Int): Int  |
                       | }                                       |
                       +-----------------------------------------+

  client process                             server process
+----------------------------------+       +----------------------------------------------+
| // contract usage                |       | // contract implementation                   |
| val calculator: Calculator = ... |       | class CalculatorImpl : Calculator {          |
| println(calculator.add(1, 2))    |       |   override suspend fun add(a: Int, b: Int) = |
|                                  |       |     a + b                                    |
|                                  |       | }                                            |
|..................................|       |..............................................|
|         contract library         |       |              contract library                |
|..................................|       |..............................................|
|          yass2 library           |       |               yass2 library                  |
|..................................|       |..............................................|
|        transport library         | <---> |             transport library                |
+----------------------------------+       +----------------------------------------------+

• provides unidirectional and session-based bidirectional remoting

• provides Ktor transport adaptors for Http, WebSocket and Socket

• generates code (works on any platform and is fast) either with KSP or with reflection

  • fast, compact and extendable binary serializer for high throughput and low latency
  • extendable string-based serializers: TextSerializer, JsonSerializer and KotlinSerializer (serializes Kotlin source code)
  • interceptor (around advice, aspect-oriented programming)

• yass2 has multiple modules with the following dependencies

yass2-core <-- yass2-generate
     ^
     |
yass2-coroutines --> kotlinx-coroutines-core
     ^
     |
yass2-ktor --> Ktor

• artifacts on Maven Central (GroupId: ch.softappeal.yass2)

• API doc on javadoc.io

• uses Semantic Versioning

• Tutorial

• Open Source (BSD-3-Clause license)

• supersedes yass