milankinen / cljs-rx

RxJS bindings for ClojureScript

cljs-rx

Complete RxJS 5 bindings for ClojureScript

Example usage

(ns example.app
  (:require [cljs-rx.core :as rx]
            [cljs-rx.ajax :as ajax]))

(-> (rx/interval 5000)
    (rx/switch-map (fn [_] (ajax/request {:url "/status" :method "GET" :response-type "json"}))
    (rx/map #(js->clj (:response %) :keywordize-keys true))
    (rx/filter identity)
    (rx/subscribe! {:next     #(js/console.log %)
                    :error    #(js/console.error %)
                    :complete #(js/console.log "complete")}))

Available namespaces

cljs-rx.core

Core functions and factories

cljs-rx.ajax

Observable AJAX functions

cljs-rx.scheduler

RxJS schedulers

cljs-rx.subject

Subjects and related functions

Differences to JS version

• rx/from accepts ClojureScript sequences and IWatchables (= Atoms)
• Every object satisfying either Fn or IFn can be used with operators in addition to normal JS functions, e.g. (rx/filter obs #{:lol :bal})
• Operator functions (e.g. predicates and transform functions) receive only the mapped/tested values. If you need to access event indexes as well, use :all-args meta flag, e.g.

(-> ...
    (rx/map (fn [x i] (+ x i)))  ; ATTENTION! i == undefined
    ...)
    
(-> ...
    (rx/map ^:all-args (fn [x i] (+ x i)))  ; now works
    ...)

License

• Bindings: MIT
• RxJS: Apache 2.0

cljs-rx's Issues

(rx/switch) not working

Bug.

Implement web-socket binding

Perhaps under cljs-rx.subject namespace because it's WebSocketSubjet in Rx

(rx/tap) does not accept observers

Maps implement IFn which causes no-op behaviour. Must fix

(rx/switch) not working

Must fix

(rx/from atom) swallows distinct subsequent values on reset!

Library should not control this. Must remove equality check from watchable->ish

IFn instances not accepted as functions

Add (ifn?) as a valid alternative to pre-assertions

Now e.g. (rx/map obs :foo) fails 😖

cljs-rx.subject functions next! complete! and error! do not work with observers

Now they support only subjects although they should work with (cljs) osbervers as well.

Move RxJS to CLJSJS

RxJS JS library should be moved to http://cljsjs.github.io/

ConnectableObservable operators missing

The current build does not have ConnectableObservable operators such as connect and refCount

Add observable check for operator

Add check for each operator that the given obs is really an Observable

Auto-generate docs

Auto-generate function doc-strings from RxJS TSDocs.