Skip to content

YS Advent 2023

Seasons Greetings, my YAML friends!🔗

What if I told you that you could write a program in YAML that would generate a Christmas tree?

Well, you can! Here's how:

#!/usr/bin/env ys-0

defn main(width=5):
  say: tree(width)

defn tree(width):
  top =: (width .. 1)
    .map(\(line width _))
    .join("\n")

  trunk =: trunk(width) * 2

  =>: |-
    $top
    $trunk

defn trunk(num): "$spaces(num)*\n"

defn line(width, num):
  :: "`stars` is a lexically defined function"
  stars =: \(_.++ * '*')

  join '':
    spaces: num
    stars: (width - num) * 2

defn spaces(num): num * ' '

Let's get a tree!

$ ys tree.ys
     *
    ***
   *****
  *******
 *********
     *
     *

That's a pretty nice tree, but it's a little small. Let's make it bigger!

$ ys tree.ys 10
          *
         ***
        *****
       *******
      *********
     ***********
    *************
   ***************
  *****************
 *******************
          *
          *

Welcome to the first day of YS Advent 2023! We're going to be writing a lot of YS this month, so let's get started…

Wait! What is YS?

YS (aka YAMLScript) is a new programming language that uses YAML as its syntax. You can do anything in YS that you can do in a language like Python or JavaScript such as:

  • Defining functions
  • Using variables
  • String manipulation and interpolation
  • Loops and conditionals
  • Importing modules
  • And more!

YS looks and feels like an imperative programming language, but it's actually a functional programming language. This means that YS programs are made up of expressions that are evaluated to produce a result.

But why would you even want to write a program in YAML?

YS is a full-featured, general purpose programming language, but it's also designed to be a great language for writing YAML configuration files. To that point, almost all YAML files are valid YS programs! And they evaluate to the same result that a YAML loader would produce.

For example, here's a YAML file that defines a list of fruits:

# fruits.yaml
- apple
- banana
- cherry

Let's run this file as a YS program: 

$ ys fruits.yaml
$

Nothing happens!

But why would anything happen? The program doesn't do anything!

It's the same as running this Python program: 

$ python -c '["apple", "banana", "cherry"]'
$

To obtain the evaluation result of a YS program, we need to use the --load option: 

$ ys --load fruits.yaml
["apple", "banana", "cherry"]
$

We got some JSON back! That's because by default, --load evaluates the YS and prints the result as JSON.

What if we want to include these fruits in our YAML grocery list? Let's try it:

# grocery.yaml
- bread
- fruits: load('fruits.yaml')
- milk

Let's add the --yaml option to print the result as YAML:

$ ys --load grocery.yaml --yaml
- bread
- fruits: load('fruits.yaml')
- milk
$

That's not what we wanted! We wanted the contents of the fruits list to be included in the grocery list.

But if you think about it, this is exactly what we asked for. Since every YAML file is a valid YS program, it certainly should be loaded just like any other YAML loader would do it.

Let's fix this to do what we want:

# grocery.yaml
!YS v0:

:::
- bread
- fruits: ! load('fruits.yaml')
- milk

Now when we run it:

$ ys -l -Y grocery.yaml
- bread
- fruits:
  - apple
  - banana
  - cherry
- milk
$

There we go! We got our fruits!

So what did we do here? We added 2 things: * A !yamlscript/v0/data tag at the top * A ! tag before the load function call

We won't get into the details of what these tags mean today, but you'll learn about them soon enough.

YS Advent 2023 Teasers🔗

My name is Ingy döt Net ⧉. I'm one of the original creators of the YAML data language ⧉ and I lead the YAML Language Development Team ⧉.

I've been working on YS for about a year now, and I'm excited to finally share it with you. I believe that YS is going to take YAML to exciting new places, while remedying many of its shortcomings, limitations and frustrations. I hope you'll come to agree as you join me on this holiday season unwrapping of the gift that is YS!

I also hope that you enjoyed this first day of the YS Advent 2023! I'll be posting a new blog article every day this month, so stay tuned! Well at least until December 25th, but I might keep going after that. :-)

Here's a sneak peek of some of the things to come:

  • Installing and using ys — the YS interpreter
  • The history of YS
  • How YS is compiled and evaluated
  • How YS can fix many of YAML's problems
  • How to use YS like a YAML loader in any programming language
  • Is YS actually a Lisp???
  • Refactoring complicated YAML configurations with YS
  • Writing polyglot libraries in YS
  • What makes a YAML file a valid (or invalid) YS program?
  • Compiling YS to native binaries and shared libraries

Hopefully you're as excited as I am to learn more about YS!

See you tomorrow!