27 releases
new 0.1.58 | Apr 26, 2024 |
---|---|
0.1.57 | Apr 22, 2024 |
0.1.49 | Mar 31, 2024 |
0.1.38 | Feb 21, 2024 |
0.0.16 | Jul 26, 2022 |
#68 in Programming languages
1,421 downloads per month
19KB
186 lines
YAMLScript
Program in YAML
Synopsis
#!/usr/bin/env ys-0
defn main(name):
say: "Hello, $name!"
Description
YAMLScript is a functional programming language with a stylized YAML syntax.
YAMLScript can be used for:
- Writing new programs and applications
- Run with
ys file.ys
- Or compile to binary executable with
ys -C file.ys
- Run with
- Enhancing ordinary YAML files with new functional magics
- Import parts of other YAML files to any node
- String interpolation including function calls
- Any other functionality you can dream up!
- Writing reusable shared libraries
- High level code instead of C
- Bindable to almost any programming language
YAMLScript should be a drop-in replacement for your YAML loader!
Most existing YAML files are already valid YAMLScript files. This means that YAMLScript works as a normal YAML loader, but can also evaluate functional expressions if asked to.
Under the hood, YAMLScript code compiles to the Clojure programming language. This makes YAMLScript a complete functional programming language right out of the box.
Even though YAMLScript compiles to Clojure, and Clojure compiles to Java, there
is no dependency on Java or the JVM.
YAMLScript is compiled to a native shared library (libyamlscript.so
) that can
be used by any programming language that can load shared libraries.
To see the Clojure code that YAMLScript compiles to, you can use the YAMLScript
command line utility, ys
, to run:
$ ys --compile file.ys
Rust Usage
Create a new Rust project:
$ cargo new --bin prog
$ cd prog
Add the file src/main.rs
:
use std::fs::File;
use std::io::prelude::*;
use yamlscript::YAMLScript;
fn main() -> std::io::Result<()> {
let mut file = File::open("file.ys")?;
let mut input = String::new();
file.read_to_string(&mut input)?;
let ys = YAMLScript::new().unwrap();
let data = ys.load::<serde_json::Value>(&input).unwrap();
println!("{data:?}");
Ok(())
}
Add file file.ys
:
!yamlscript/v0
name =: "World"
=>::
foo: [1, 2, ! inc(41)]
bar:: load("other.yaml")
baz:: "Hello, $name!"
Add file other.yaml
:
oh: Hello
Run:
$ curl https://yamlscript.org/install | bash
$ cargo add yamlscript
$ cargo add serde_json
$ cargo run
Finished dev [unoptimized + debuginfo] target(s) in 0.02s
Running `target/debug/prog`
Object {"bar": Object {"oh": String("Hello")}, "baz": String("Hello, World!"), "foo": Array [Number(1), Number(2), Number(42)]}
Installation
You can install this module like any other Rust module:
$ cargo add yamlscript
but you will need to have a system install of libyamlscript.so
.
One simple way to do that is with:
$ curl https://yamlscript.org/install | bash
Note: The above command will install the latest version of the YAMLScript command line utility,
ys
, and the shared library,libyamlscript.so
, into~/.local/bin
and~/.local/lib
respectively.
See https://github.com/yaml/yamlscript/wiki/Installing-YAMLScript for more info.
See Also
Authors
License & Copyright
Copyright 2022-2024 Ingy döt Net ingy@ingy.net
This project is licensed under the terms of the MIT
license.
See LICENSE for
more details.
Dependencies
~3MB
~62K SLoC