https://github.com/japgolly/scala-graal

Make usage of Graal features easy and safe from Scala. Also features Scala-based React SSR.
https://github.com/japgolly/scala-graal

fp graal graalvm react scala scalajs ssr

Last synced: 2 days ago
JSON representation

Make usage of Graal features easy and safe from Scala. Also features Scala-based React SSR.

• Host: GitHub
• URL: https://github.com/japgolly/scala-graal
• Owner: japgolly
• License: apache-2.0
• Created: 2018-11-03T09:44:35.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-08-21T16:10:22.000Z (5 months ago)
• Last Synced: 2024-10-12T18:45:07.279Z (4 months ago)
• Topics: fp, graal, graalvm, react, scala, scalajs, ssr
• Language: Scala
• Homepage:
• Size: 1.29 MB
• Stars: 194
• Watchers: 8
• Forks: 4
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
# scala-graal

```scala

libraryDependencies ++= Seq(

  "com.github.japgolly.scala-graal"  %% "core"           % "2.0.0"

  "com.github.japgolly.scala-graal" %%% "core-js"        % "2.0.0"

  "com.github.japgolly.scala-graal" %%% "ext-boopickle"  % "2.0.0"

  "com.github.japgolly.scala-graal"  %% "ext-prometheus" % "2.0.0"

)

```

# Goals

* Make it quick, easy and safe to interface with embedded languages from Scala

* Hide and automate a lot of required [GraalVM](https://www.graalvm.org) boilerplate

* Support [React SSR](https://css-tricks.com/server-side-react-rendering/) for [Scala.JS](https://www.scala-js.org/) applications

# Demo

```scala

import japgolly.scalagraal._

// Use semantics and implicit config for JS

// (GraalVM also supports Python, R, Ruby, LLVM)

import japgolly.scalagraal.js._

import GraalJs._

// 1. Pre-compile expression functions for fast invocation.

// 2. Typeclasses translate and/or marshall data between JVM and JS.

val expr: (Int, Int) => Expr[String] =

  Expr.apply2((a, b) => s"($a + $b) * 2 + '!'").compile(_.asString)

// Use a basic synchronous JS environment

val ctx = GraalContext()

val result = ctx.eval(expr(3, 8))

assert(result == Right("22!"))

```

# Learning

* [API & how to use](doc/API.md)

* [Recipes](doc/RECIPES.md)

* [Scala SSR tutorial (part 1)](https://blog.shipreq.com/post/scala_react_and_ssr_part_1)

* [Scala SSR tutorial (part 2)](https://blog.shipreq.com/post/scala_react_and_ssr_part_2)

# Features

* Expressions

  * composition

  * purity

  * result parsing

  * error handling

  * null handling

  * binding typeclasses

  * binding codecs (eg binary/json/whatever)

* Service

  * single-threaded

  * multi-threaded pool

  * synchronous

  * asynchronous

  * optional time limits

  * before/around/after hooks

  * automatic metrics

* Warmup

  * ability to warmup VM

  * rules (eg. `up to 10000 reps/thread & up to 30 sec | until completes within 20ms`)

* React SSR (Server-Side Rendering)

  * support for rendering JS components from JVM

  * conversion to constant-time (conditionally)

  * `window` and especially `window.location` management

* Integrations

  * [Prometheus](https://prometheus.io) - export metrics to Prometheus

  * [BooPickle](https://github.com/suzaku-io/boopickle) - marshall data back and forth using binary codecs