# Hadron

Hadron is an implementation of a [SuperCollider](https://supercollider.github.io/) language
interpreter.

## Goals

The SuperCollider programming language has a unique community of artists, scholars, and
technologists that have created extensive library code and works of art using the existing tooling.
With Hadron, we hope to create an alternative platform for making music and digital media, broadly
compatible with existing code, but built from the ground up with clear governance and modern
software engineering best practices. With Hadron, we hope to sustain the SuperCollider ecosystem
for the next 25 years and beyond.

## Getting Started

We keep a recent version of the web build at [hadron.run](https://hadron.run), which makes a nice
way to try out Hadron without installing any tooling or building any code.

Hadron is written in Rust and uses standard Rust tooling for development.
Issue [#42](https://solitarybees.us/hadron/hadron/-/issues/42) calls for writing detailed developer
documentation (PRs welcome!), but for now we provide this brief overview:

Install the Rust toolchain and check out the code, then use:

```shell
cargo build
```

to build Hadron, and:

```shell
cargo test
```

to test. The pre-submit testing checks formatting and also runs `clippy`, so before uploading a PR
it's convenient to check the code with:

```shell
cargo xtask ci
```

Which will run the exact pre-submit testing sequence.