30个版本

0.18.2 2023年9月19日
0.18.0 2021年10月3日
0.17.2 2020年10月25日
0.16.1 2020年7月5日
0.6.2 2017年10月18日

#502编程语言

Download history 60/week @ 2024-03-11 80/week @ 2024-03-18 31/week @ 2024-03-25 155/week @ 2024-04-01 27/week @ 2024-04-08 40/week @ 2024-04-15 74/week @ 2024-04-22 58/week @ 2024-04-29 59/week @ 2024-05-06 66/week @ 2024-05-13 71/week @ 2024-05-20 62/week @ 2024-05-27 38/week @ 2024-06-03 40/week @ 2024-06-10 23/week @ 2024-06-17 31/week @ 2024-06-24

每月 136 下载
10 仓库中使用(直接使用4个)

MIT 许可证

370KB
11K SLoC

gluon

Build Status Documentation Book std

Gluon是一种小型、静态类型、面向函数的编程语言,旨在用于应用程序嵌入。

特点

  • 静态类型 - 静态类型使得编写gluon和宿主应用程序之间的安全且高效的接口变得更容易。

  • 类型推断 - 类型推断确保很少需要显式写出类型,从而在无需打字的情况下获得静态类型的所有好处。

  • 简单嵌入 - 将值从gluon传输到和从gluon传输需要几乎零样板代码,使得在Rust中定义的函数可以直接传递给gluon

  • 默认UTF-8 - Gluon支持Unicode,使用utf-8编码的字符串和Unicode代码点作为字符。

  • 独立的堆 - Gluon是一种垃圾回收语言,但为每个执行的gluon线程使用独立的堆。这使得每个堆保持较小,从而减少垃圾回收器的开销。

  • 线程安全 - Gluon是用Rust编写的,这保证了线程安全。Gluon保持了相同的保证,允许多个gluon程序并行运行(示例

* Gluon程序的并行执行是最近新增的功能,可能还存在死锁等问题。

示例

你好世界

let io = import! std.io
io.print "Hello world!"

阶乘

let factorial n : Int -> Int =
    if n < 2
    then 1
    else n * factorial (n - 1)

factorial 10

24

// # 24
//
// From http://rosettacode.org/wiki/24_game
//
// Write a program that randomly chooses and displays four digits, each from 1 ──► 9 (inclusive) with repetitions allowed.
//
// The program should prompt for the player to enter an arithmetic expression using just those, and all of those four digits, used exactly once each. The program should check then evaluate the expression.
//
// The goal is for the player to enter an expression that (numerically) evaluates to 24.
//
// * Only the following operators/functions are allowed: multiplication, division, addition, subtraction
// * Division should use floating point or rational arithmetic, etc, to preserve remainders.
// * Brackets are allowed, if using an infix expression evaluator.
// * Forming multiple digit numbers from the supplied digits is disallowed. (So an answer of 12+12 when given 1, 2, 2, and 1 is wrong).
// * The order of the digits when given does not have to be preserved.
//
//
// ## Notes
//
//     The type of expression evaluator used is not mandated. An RPN evaluator is equally acceptable for example.
//     The task is not for the program to generate the expression, or test whether an expression is even possible.


// The `import!` macro are used to load and refer to other modules.
// It gets replaced by the value returned by evaluating that module (cached of course, so that
// multiple `import!`s to the same module only evaluates the module once)
let io @ { ? } = import! std.io
let prelude = import! std.prelude
let { Result } = import! std.result
let array @ { ? } = import! std.array
let int = import! std.int
let string = import! std.string
let list @ { List, ? } = import! std.list
let random = import! std.random
let string = import! std.string

// Since imports in gluon returns regular values we can load specific parts of a module using pattern matches.
let char @ { ? } = import! std.char

let { (<>) } = import! std.semigroup
let { flat_map } = import! std.monad

let { (*>), (<*), wrap } = import! std.applicative

let { for } = import! std.traversable

type Op = | Add | Sub | Div | Mul
type Expr = | Int Int | Binop Expr Op Expr

let parse : String -> Result String Expr =
    // Gluon has a small parser combinator library which makes it easy to define an expression parser
    let parser @ {
        between,
        satisfy,
        satisfy_map,
        spaces,
        token,
        digit,
        skip_many1,
        recognize,
        lazy_parser,
        chainl1,
        (<?>),
        ? } = import! std.parser
    let { (<|>) } = import! std.alternative

    let lex x = x <* spaces

    let integer =
        // `do` expression provide a way to write monads in a way similiar to procedural code
        do i = lex (recognize (skip_many1 digit))
        match int.parse i with
        | Ok x -> wrap x
        | Err _ -> parser.fail "Unable to parse integer"

    let operator =
        satisfy_map (\c ->
            match c with
            | '*' -> Some Mul
            | '+' -> Some Add
            | '-' -> Some Sub
            | '/' -> Some Div
            | _ -> None)
            <?> "operator"

    rec
    let atom _ =
        parser.functor.map Int integer
            <|> between (lex (token '(')) (lex (token ')')) (lazy_parser expr)

    let binop _ =
        let op_parser =
            do op = lex operator
            wrap (\l r -> Binop l op r)
        chainl1 (atom ()) op_parser

    let expr _ = binop ()
    in

    // Gluon makes it possible to partially apply functions which we use here to scope all parser functions
    // inside the `let parse` binding above.
    let parse : String -> Result String Expr = parser.parse (expr () <* spaces)
    parse

/// Validates that `expr` contains exactly the same integers as `digits`
let validate digits expr : Array Int -> Expr -> Bool =
    let integers xs expr : List Int -> Expr -> List Int =
        match expr with
        | Int i -> Cons i xs
        | Binop l _ r -> integers (integers xs l) r
    let ints = integers Nil expr

    list.sort (list.of digits) == list.sort ints

let eval expr : Expr -> Int =
    match expr with
    | Int i -> i
    | Binop l op r ->
        let f =
            // Operators are just functions and can be referred to like any other identifier
            // by wrapping them in parentheses
            match op with
            | Add -> (+)
            | Sub -> (-)
            | Div -> (/)
            | Mul -> (*)
        f (eval l) (eval r)

do digits =
    let gen_digit = random.thread_rng.gen_int_range 1 10
    do a = gen_digit
    do b = gen_digit
    do c = gen_digit
    do d = gen_digit
    wrap [a, b, c, d]

let print_digits = for digits (\d ->
        seq io.print " "
        io.print (show d))
seq io.print "Four digits:" *> print_digits *> io.println ""

let guess_loop _ =
    do line = io.read_line
    // Exit the program if the line is just whitespace
    if string.is_empty (string.trim line) then
        wrap ()
    else
        match parse line with
        | Err err -> io.println err *> guess_loop ()
        | Ok expr ->
            if validate digits expr then
                let result = eval expr
                if result == 24
                then io.println "Correct!"
                else io.println ("Incorrect, " <> int.show.show result <> " != 24") *> guess_loop ()
            else
                io.println
                    "Expression is not valid, you must use each of the four numbers exactly once!"
                    *> guess_loop ()

guess_loop ()

源代码

入门

在线尝试

您可以在浏览器中尝试gluon,请访问 https://gluon-lang.org/try/。(Github

安装

可以通过使用Github上的预构建可执行文件来安装Gluon,或者您可以使用Cargo来安装gluon_repl crate。

cargo install gluon_repl

REPL

光子有一个小的可执行文件,可以用来直接运行光子程序或在小型REPL中运行。可以通过向构建的REPL可执行文件传递-i标志来启动REPL,该可执行文件可以通过以下命令运行:cargo run -p gluon_repl -- -i

REPL功能

  • 评估表达式(类型为IO的表达式将在IO环境中评估)。

  • 通过编写let <pattern> <identifier>* = <expr>来绑定变量(从正常的let绑定中省略in <expr>)示例

       let f x = x + 1
       let { x, y = z } = { x = 1, y = 2 }
       f z
    
  • 使用:h打印有关可用命令的帮助信息。

  • 使用:l path_to_file加载文件,加载文件中表达式的评估结果存储在无扩展名的文件名命名的变量中。

  • 使用:t expression检查表达式的类型。

  • 使用:i name打印有关名称的信息。
    示例

    :i std.prelude.List
    type std.prelude.List a = | Nil | Cons a (std.prelude.List a)
    /// A linked list type
    
  • 标识符和记录字段的缩写完成 repl completion

  • 通过编写:q退出REPL。

工具

语言服务器

光子有一个语言服务器,它提供代码补全和格式化支持。安装通过以下命令完成:cargo install gluon_language-server

Visual Studio Code 扩展

Visual Studio Code的gluon 扩展提供语法高亮和补全。要安装它,在扩展中搜索gluon。(Github

example

Vim 插件

vim-gluon提供语法高亮和缩进。

光子语言服务器已被测试与https://github.com/autozimu/LanguageClient-neovimhttps://github.com/prabirshrestha/vim-lsp一起工作。

示例配置(autozimu/LanguageClient-neovim)

let g:LanguageClient_serverCommands = {
    \ 'gluon': ['gluon_language-server'],
    \ }

" Automatically start language servers.
let g:LanguageClient_autoStart = 1

nnoremap <silent> K :call LanguageClient_textDocument_hover()<CR>
nnoremap <silent> gd :call LanguageClient_textDocument_definition()<CR>

文档

光子书

光子标准库API参考

Rust API 文档

用法

Rust

光子需要最新的Rust编译器来构建(1.9.0或更高版本),可在crates.io找到。可以通过添加以下行轻松将其包含在Cargo项目中。

[dependencies]
gluon = "0.18.2"

其他语言

目前,与光子虚拟机交互最简单的方法是通过Rust,但存在一个基本的C api,将来将扩展以使其接近Rust API。

贡献

贡献gluon的方式有很多。最简单的方法是打开问题或处理标记为初学者的问题。关于贡献的更多信息,您可以查看CONTRIBUTING.md。贡献还包括关于gluon的运行/开始测试的详细信息。

目标

随着时间的推移,这些目标可能会改变或被细化,因为我正在尝试语言可能实现的内容。

  • 可嵌入 - 与Lua相似 - 它旨在嵌入到另一个程序中,该程序可以使用虚拟机扩展其功能。

  • 静态类型 - 语言使用基于Hindley-Milner类型系统的某些扩展,允许简单和通用的类型推断。

  • 小巧 - 由于小巧,语言易于学习,并且实现占用空间小。

  • 严格 - 严格的语言通常更容易推理,尤其是在考虑到这是大多数人习惯的东西。对于需要惰性的情况,提供了一个显式的类型。

  • 模块化 - 库被分为解析器、类型检查器和虚拟机+编译器。这些组件可以独立于彼此使用,允许应用程序选择他们确切需要的内容。

灵感

这种语言的主要灵感来自LuaHaskellOCaml


lib.rs:

代码格式化器。

依赖项

~4–12MB
~125K SLoC