A friendly programming language from the future
Go to file
Greg Pfeil 1c4312ef20
Fix source locations in transcript parser
The source is initially parsed by CMark and then this code parses
individual fenced code blocks.

This sets the initial state for the code block parser so that source
locations and error excerpts match the source file.

__NB__: I think the “invalid-api-requests” transcript is intended to
        fail on the `DELETE`, not the unsupported `:error` tag, so I
        fixed that.
2024-10-02 22:58:34 -06:00
.github parameterize some tests' caching 2024-10-02 11:14:28 -04:00
.vscode Pin Haskell tool versions for VS Code 2024-07-09 13:57:42 -06:00
codebase2 Move recursion schemes to separate package 2024-09-26 12:59:14 -06:00
contrib Move recursion schemes to separate package 2024-09-26 12:59:14 -06:00
deps Bump to lts-15.13 2020-05-24 10:20:52 -04:00
docs No longer need special instructions for Mac Silicon. 2024-06-12 21:54:43 +01:00
editor-support Added symbol class for consistency. 2024-08-22 17:12:11 +03:00
lib Move recursion schemes to separate package 2024-09-26 12:59:14 -06:00
nix Kill Configurator and Unison Config 2024-08-25 15:21:27 -07:00
parser-typechecker Merge pull request #5382 from unisonweb/name-capture-bug 2024-10-01 13:38:27 -04:00
scheme-libs/racket Add a flag to compile.native that enables profiling 2024-09-24 11:27:39 -04:00
scripts Test that docs.to-html actually writes files 2024-06-23 20:21:16 -05:00
unison-cli Fix source locations in transcript parser 2024-10-02 22:58:34 -06:00
unison-cli-integration Add unused package warning 2024-08-29 12:55:31 -07:00
unison-cli-main move cli-integration tests to their own package 2024-03-25 05:20:13 -06:00
unison-core Merge pull request #5382 from unisonweb/name-capture-bug 2024-10-01 13:38:27 -04:00
unison-hashing-v2 Add unused package warning 2024-08-29 12:55:31 -07:00
unison-merge revert to storing top level components in the typechecker env instead because 2024-09-25 18:15:30 -04:00
unison-runtime Module cleanup 2024-09-26 14:17:23 -07:00
unison-share-api Add unused package warning 2024-08-29 12:55:31 -07:00
unison-share-projects-api Add unused package warning 2024-08-29 12:55:31 -07:00
unison-src Fix source locations in transcript parser 2024-10-02 22:58:34 -06:00
unison-syntax Separate Unison lexer unit tests 2024-09-26 14:58:47 -06:00
yaks/easytest Ormolu-ify the codebase and update development.markdown docs 2023-02-13 13:03:08 -06:00
.editorconfig Don't limit max line length on .u scratch files 2024-07-22 10:11:10 -04:00
.gitattributes support windows in ci (#2913) 2022-02-28 20:05:02 -06:00
.gitignore Docs and transcripts 2024-07-10 10:37:08 -07:00
.mailmap Update Mat Ess 2021-06-07 14:26:39 -04:00
.mergify.yml Update .mergify.yml 2024-06-13 16:53:30 -04:00
.ormolu Inform Ormolu of some operator precedences 2024-07-18 19:44:34 -06:00
config added dev notes document, updated logging defaults 2016-10-06 13:11:38 -04:00
CONTRIBUTORS.markdown Merged trunk branch and resolved conflicts. 2024-08-27 10:53:23 +03:00
CREDITS.md Kill Configurator and Unison Config 2024-08-25 15:21:27 -07:00
dev-ui-install.sh Fix dev-ui-install.sh 2024-08-20 11:56:20 -06:00
development.markdown Merge pull request #5238 from neduard/jit-update-readme 2024-07-25 18:55:58 +00:00
Dockerfile use relative paths in Dockerfile 2024-01-22 15:25:56 -08:00
flake.lock Get Nix build working with GHC 9.6.5 2024-06-27 20:40:35 -06:00
flake.nix Pin Haskell tool versions for VS Code 2024-07-09 13:57:42 -06:00
hie.yaml Split off unison-runtime package 2024-08-29 12:49:20 -07:00
LICENSE Update copyright 2024-02-25 12:20:25 -05:00
package.yaml Clean up packages from test components 2024-08-29 15:10:34 -07:00
README.md No longer need special instructions for Mac Silicon. 2024-06-12 21:54:43 +01:00
stack.yaml Move recursion schemes to separate package 2024-09-26 12:59:14 -06:00
stack.yaml.lock Remove unused guid stack-dep 2024-08-30 09:28:36 -07:00
weeder.dhall pull some weeds 2021-05-06 23:19:11 -06:00

The Unison language

CI Status Pre-Release Status

Overview

Unison is a modern, statically-typed purely functional language with the ability to describe entire distributed systems using 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 = forkAt loc '(mapReduce loc fn ifEmpty reduce !left)
    fr = forkAt loc '(mapReduce loc fn ifEmpty reduce !right)
    reduce (await fl) (await fr)

This function can be either simulated locally (possibly with faults injected for testing purposes), or run atop a distributed pool of compute. See this article for more in-depth coverage of how to build distributed computing libraries like this.

Other resources:

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 the Unison Local UI while building from source, you can use the /dev-ui-install.sh script. It will download the latest release of unison-local-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 Unison Local UI is running.

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

Language Server Protocol (LSP)

View Language Server setup instructions here.

Codebase Server

When ucm starts it starts a Codebase web server that is used by the Unison Local 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.

Configuration

See the documentation for configuration here