About

Futurama is a Clojure library for more deeply integrating async abstractions in the Clojure and JVM ecosystem with Clojure core.async.

It adds support for CompletableFuture and IDeferred to be used in approximately the same fashion as Clojure core.async channels, and for Future and IDeref to be read in a similar manner as well.

Usage

Here's a simple example.

(ns user
  (:require [futurama.core :refer [async async-for !<!! !<!]])
  (:import [java.util.concurrent CompletableFuture]))

(defn future-thing
  [what]
  (CompletableFuture/completedFuture (format "%s: done" what)))

(async
  (println (!<! (future-thing "laundry"))))
;;; => prints out: "laundry: done"

(!<!!
  (async-for
    [a (range 4)
     b (range 4)
     :let [c (+ a b)]
     :when (and (odd? a) (odd? b))]
    (!<! (timeout 50)) ;;; can use !<! inside `async-for` comprehension so the items are evaluated sequentially
    [a b c (+ a b c)]))
;;; => returns `[[1 1 2 4] [1 3 4 8] [3 1 4 8] [3 3 6 12]]` and takes slightly over 200ms total time.

(!<!!
  (async-for
    [a (range 4)
     b (range 4)
     :let [c (+ a b)]
     :when (and (odd? a) (odd? b))]
    (async
      (!<! (timeout 50)) ;;; here we use !<! inside an async block so we iterate faster through the items
      [a b c (+ a b c)])))
;;; => returns `[[1 1 2 4] [1 3 4 8] [3 1 4 8] [3 3 6 12]]` evaluated fully async and takes slightly over 50ms total time.

See the existing tests for more examples.

Building

Futurama is built, tested, and deployed using Clojure Tools Deps.

GNU Make is used to simplify invocation of some commands.

Availability

Futurama releases for this project are on Clojars. Simply add the following to your project:

Communication

• For any other questions or issues about Futurama free to browse or open a Github Issue.

Contributing

See CONTRIBUTING.md

YourKit

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

LICENSE

Copyright 2024 Jose Gomez

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.