An open API service indexing awesome lists of open source software.

https://github.com/goplus/ixgo

The Go/XGo Interpreter
https://github.com/goplus/ixgo

data-science golang goplus igop interpreter ixgo low-code programming-language scientific-computing stem stem-education xgo

Last synced: 1 day ago
JSON representation

The Go/XGo Interpreter

Awesome Lists containing this project

README

          

# iXGo The Go/XGo Interpreter

[![Go1.19](https://github.com/goplus/ixgo/workflows/Go1.19/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go119.yml)
[![Go1.20](https://github.com/goplus/ixgo/workflows/Go1.20/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go120.yml)
[![Go1.21](https://github.com/goplus/ixgo/workflows/Go1.21/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go121.yml)
[![Go1.22](https://github.com/goplus/ixgo/workflows/Go1.22/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go122.yml)
[![Go1.23](https://github.com/goplus/ixgo/workflows/Go1.23/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go123.yml)
[![Go1.24](https://github.com/goplus/ixgo/workflows/Go1.24/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go124.yml)
[![Go1.25](https://github.com/goplus/ixgo/workflows/Go1.25/badge.svg)](https://github.com/goplus/ixgo/actions/workflows/go125.yml)
[![Go Reference](https://pkg.go.dev/badge/github.com/goplus/ixgo.svg)](https://pkg.go.dev/github.com/goplus/ixgo)

A fast and fully compatible Go language interpreter.

### Go Version

- Go1.19 ~ Go1.25
- macOS Linux Windows WebAssembly GopherJS and more.

### ABI

support ABI0 and ABIInternal

- ABI0 stack-based ABI
- ABIInternal [register-based Go calling convention proposal](https://golang.org/design/40724-register-calling)

- Go1.17: amd64
- Go1.18: amd64 arm64 ppc64/ppc64le
- Go1.19: amd64 arm64 ppc64/ppc64le riscv64
- Go1.20: amd64 arm64 ppc64/ppc64le riscv64
- Go1.21: amd64 arm64 ppc64/ppc64le riscv64
- Go1.22: amd64 arm64 ppc64/ppc64le riscv64 loong64
- Go1.23: amd64 arm64 ppc64/ppc64le riscv64 loong64
- Go1.24: amd64 arm64 ppc64/ppc64le riscv64 loong64
- Go1.25: amd64 arm64 ppc64/ppc64le riscv64 loong64

### Generics

- support typeparams (Go1.19 ~ Go1.24)
- support alias typeparams (Go1.24 ~ Go1.25)

### runtime.GC

`ixgo.Mode ExperimentalSupportGC`

experimental support runtime.GC and runtime.SetFinalizer

### install ixgo command line

Go version <= 1.22:

```shell
go install github.com/goplus/ixgo/cmd/ixgo@latest
```

Go version >= 1.23
```shell
go install -ldflags="-checklinkname=0" github.com/goplus/ixgo/ixgo@v0.3.5
```

### install ixgo export command line
```shell
go install github.com/goplus/ixgo/cmd/qexp@latest
```

### ixgo command

```
ixgo # ixgo repl mode
ixgo run # run a Go/XGo package
ixgo build # compile a Go/XGo package
ixgo test # test a package
ixgo verson # print version
ixgo export # export Go package to ixgo builtin package
```

### ixgo run mode
```
Usage: ixgo run [build flags] [package] [arguments...]
-exp-gc
experimental support runtime.GC
-mod value
module download mode to use: readonly, vendor, or mod.
-ssa
print SSA instruction code
-ssa-trace
trace SSA interpreter code
-tags value
a comma-separated list of build tags to consider satisfied during the build
-v print the names of packages as they are compiled.
-x print the commands.
```

### ixgo repl mode

```shell
ixgo # run repl mode, support Go/XGo
ixgo repl # run repl mode, support Go/XGo
ixgo repl -go # run repl mode, disable XGo syntax
```

### ixgo test unsupport features

- test -fuzz
- test -cover

### ixgo demo

#### The XGo Playground (WebAssembly)

-
-

#### The XGo REPL Playground (WebAssembly)

-
-

#### ispx

[ispx](https://github.com/goplus/spx/tree/dev/cmd/igox)

#### run simple Go source demo

```go
package main

import (
"github.com/goplus/ixgo"
_ "github.com/goplus/ixgo/pkg/fmt"
)

var source = `
package main

import "fmt"

func main() {
fmt.Println("Hello, World")
}
`

func main() {
_, err := ixgo.RunFile("main.go", source, nil, 0)
if err != nil {
panic(err)
}
}
```

#### run simple XGo source demo

```go
package main

import (
"github.com/goplus/ixgo"
_ "github.com/goplus/ixgo/xgobuild"
)

var source = `
fields := [
"engineering",
"STEM education",
"and data science",
]

echo "The XGo language for", fields.join(", ")
`

func main() {
_, err := ixgo.RunFile("main.xgo", source, nil, 0)
if err != nil {
panic(err)
}
}
```

#### ixgo more demo