Awesome
Pulsar<br/>Fibers, Channels and Actors for Clojure
Pulsar wraps the Quasar library with a Clojure API that's very similar to Erlang.
Requirements
Java 7 and up and Clojure 1.5 and up are required to run Pulsar.
Getting started
Add the following dependencies to Leiningen's project.clj:
[co.paralleluniverse/quasar-core "0.7.9"]
[co.paralleluniverse/pulsar "0.7.9"]
Then, the following must be added to the project.clj file:
:java-agents [[co.paralleluniverse/quasar-core "0.7.9"]]
or, add the following to the java command line:
-javaagent:path-to-quasar-jar.jar
Alternatively, to build Pulsar from the source, clone the repository and run:
lein midje
You can run the examples like this:
lein -o run -m co.paralleluniverse.pulsar.examples.pingpong
For benchmarks, you should use lein trampoline
, like so:
lein trampoline run -m co.paralleluniverse.pulsar.examples.ring-benchmark 1000 1000
Usage
Documentation and examples can be found here.
You can also read the introductory blog post.
When running code that uses Pulsar, the instrumentation agent must be run by adding the following
to the java
command line
or to the :jvm-opts
section in project.clj:
-javaagent:path-to-quasar-jar.jar
Documentation
- User Guide
- API
- Marginalia (of tests and examples)
Community
Contributions (including Pull Requests)
Please have a look at some brief information for contributors.
License
Pulsar is free software published under the following license:
Copyright © 2013-2017 Parallel Universe
This program and the accompanying materials are dual-licensed under
either the terms of the Eclipse Public License v1.0 as published by
the Eclipse Foundation
or (per the licensee's choosing)
under the terms of the GNU Lesser General Public License version 3.0
as published by the Free Software Foundation.