https://github.com/healeycodes/adventlang

🎅 A programming language (+ code playground) for Advent of Code.
https://github.com/healeycodes/adventlang

advent-of-code interpreter programming-language

Last synced: 2 days ago
JSON representation

🎅 A programming language (+ code playground) for Advent of Code.

• Host: GitHub
• URL: https://github.com/healeycodes/adventlang
• Owner: healeycodes
• License: mit
• Created: 2021-11-11T20:52:11.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2021-12-26T20:51:19.000Z (almost 3 years ago)
• Last Synced: 2024-06-21T16:43:11.457Z (4 months ago)
• Topics: advent-of-code, interpreter, programming-language
• Language: Go
• Homepage: https://healeycodes.com/designing-a-programming-language-for-advent-of-code
• Size: 2.59 MB
• Stars: 31
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![CI Tests](https://github.com/healeycodes/adventlang/actions/workflows/ci-tests.yml/badge.svg)](https://github.com/healeycodes/adventlang/actions/workflows/ci-tests.yml)

# 🎅 Adventlang

> My blog posts: [Designing a Programming Language for Advent of Code](https://healeycodes.com/designing-a-programming-language-for-advent-of-code) and [Designing a Code Playground for Adventlang](https://healeycodes.com/designing-a-code-playground-for-adventlang)




A strongly typed but highly dynamic programming language interpreter written in Go.

```js

log("Hello, World!");

```

Try it out in the [code playground](https://healeycodes.github.io/adventlang/)!

### Why

In the second half of November, I designed and implemented this programming language for Advent of Code (AoC). I'll be using it to solve AoC's daily puzzles and adding to the standard library as I go. Will this language make it easier for you to solve the puzzles? No, certainly not. Here be dragons, etc. But it will increase my level of fun as I tap into the joyous energy that comes with forced-creativity-through-restriction.

### Getting Started

Look in the [tests](/tests) folder for examples of how to use most language features.

If you're developing, you can use `go run` and pass a file as an argument. In the root project directory:

```bash

go run cmd/adventlang.go tests/__run_tests.adv

```

### An Example Program

```js

// An if statement

if (true) {}

// An assignment expression declaring and setting a variable

// to an Immediately Invoked Function Expression (IIFE)

let result = (func(x) { return x + 1 })(4);

// Implemention of a Set using a closure over a dictionary

// `let my_set = set([]);` or `let items = set([1, 2])`

let set = func(list) {

    let store = {};

    if (type(list) == "list") {

        for (let i = 0; i < len(list); i = i + 1) {

            let key = list[i];

            store[key] = true;

        }

    }

    return {

        "add": func(x) { store[x] = true; },

        "has": func(x) { return store[x] == true }

    }

};

// An example of a computed key

let key = "a";

let f = {key: 2};

// A runtime assert call, used in test programs

assert(f.a, 2);

```

### Build

Build for common platforms:

```bash

./build.sh

```

### Run Tests

```bash

./run_tests.sh

```

### Experimental features

Run Adventlang programs via WebAssembly.

Try it on https://healeycodes.github.io/adventlang/

On local, you can:

```bash

./build_wasm.sh

python docs/dev.py

```

And then Navigate to `http://localhost:8000`

### Did You Complete AoC2021?

😅 I solved nine and a half puzzles .. and got distracted building out the language, creating a code playground, and writing blog posts. 

### License

MIT.