A friendly programming language from the future
Go to file
2022-04-12 13:35:58 -05:00
.github Use stack test suites (#2656) 2022-04-07 10:16:13 -06:00
codebase2 partially broken stuff 2022-04-12 13:14:46 -05:00
contrib Adds unison-cli package to cabal.project 2021-11-07 20:23:10 -08:00
deps Bump to lts-15.13 2020-05-24 10:20:52 -04:00
docs updating website url references to new website 2022-03-04 14:20:24 -08:00
editor-support vim-completion: don't include bang 2022-02-18 08:21:35 -08:00
lib ⅄ trunk → arya/ooo-sync 2022-04-11 10:12:11 -04:00
parser-typechecker Merge pull request #3032 from unisonweb/cp/syncm-concrete 2022-04-08 15:50:30 -04:00
scripts Use stack test suites (#2656) 2022-04-07 10:16:13 -06:00
unison-cli maybe done with download? 2022-04-12 13:35:58 -05:00
unison-core ⅄ trunk → arya/ooo-sync 2022-04-11 10:12:11 -04:00
unison-share-api maybe done with download? 2022-04-12 13:35:58 -05:00
unison-src refresh a transcript 2022-04-07 00:53:34 -05:00
yaks/easytest updating website url references to new website 2022-03-04 14:20:24 -08:00
.gitattributes support windows in ci (#2913) 2022-02-28 20:05:02 -06:00
.gitignore Commit stack.yaml.lock as is recommended. 2022-03-31 15:23:49 -06:00
.mailmap Update Mat Ess 2021-06-07 14:26:39 -04:00
.mergify.yml let mergify wait for windows build 2022-03-02 17:32:38 -05:00
config added dev notes document, updated logging defaults 2016-10-06 13:11:38 -04:00
CONTRIBUTORS.markdown Don't say what's been contributed. 2022-02-14 06:25:03 -05:00
CREDITS.md Create CREDITS.md 2020-09-29 13:37:01 -04:00
dev-ui-install.sh Match UI release zip file of unisonLocal.zip 2021-11-29 10:30:22 -05:00
development.markdown Use stack test suites (#2656) 2022-04-07 10:16:13 -06:00
hie.yaml Add unison-share-api package with Sync APIs (#3018) 2022-04-01 10:14:01 -06:00
LICENSE Update and standardize licenses 2021-10-12 13:47:08 -06:00
README.md Use stack test suites (#2656) 2022-04-07 10:16:13 -06:00
sql this symlink for haskell-language-server's sake 2021-02-01 21:13:58 -05:00
stack.yaml Add unison-share-api package with Sync APIs (#3018) 2022-04-01 10:14:01 -06:00
stack.yaml.lock Commit stack.yaml.lock as is recommended. 2022-03-31 15:23:49 -06:00
weeder.dhall pull some weeds 2021-05-06 23:19:11 -06:00

The Unison language

Build Status

Unison is a new programming language, currently under active development. It's a modern, statically-typed purely functional language, similar to Haskell, but with the ability to describe entire distributed systems with a single program. Here's an example of a distributed map-reduce implementation:

-- comments start with `--`
mapReduce loc fn ifEmpty reduce data = match split data with
  Empty          -> ifEmpty
  One a          -> fn a
  Two left right ->
    fl = at loc '(mapReduce loc fn ifEmpty reduce !left)
    fr = at loc '(mapReduce loc fn ifEmpty reduce !right)
    reduce !fl !fr

This function can be either simulated locally (possibly with faults injected for testing purposes), or run atop a distributed pool of compute.

If you'd like to learn more about the project, this Strange Loop talk is a good introduction. You can also follow along with project website or you can also say hello or lurk in the Slack chat.

We are currently alpha testing Unison. If you'd like to participate in alpha testing, you can go to the docs site to get started.

Building using Stack

If these instructions don't work for you or are incomplete, please file an issue.

The build uses Stack. If you don't already have it installed, follow the install instructions for your platform. (Hint: brew update && brew install stack)

$ git clone https://github.com/unisonweb/unison.git
$ cd unison
$ stack --version # we'll want to know this version if you run into trouble
$ stack build --fast --test && stack exec unison

To run a local codebase-ui while building from source, you can use the /dev-ui-install.sh script. It will download the latest release of the codebase-ui and put it in the expected location for the unison executable created by stack build. When you start unison, you'll see a url where the codebase-ui is running.

See development.markdown for a list of build commands you'll likely use during development.

Codebase Server

When ucm starts it starts a Codebase web server that is used by the Codebase UI. It selects a random port and a unique token that must be used when starting the UI to correctly connect to the server.

The port, host and token can all be configured by providing environment variables when starting ucm: UCM_PORT, UCM_HOST, and UCM_TOKEN.