go2hx

warning: experimental 0.1.0 version.

Compile Go to Haxe.

Use Go libs with ease!

Stdlib Api

Samples

Manual

In progress tracking graph

Getting started! [link to github README]

Standard Library compatibility/api docs

module	hl	interp	js	info
bufio	❌ error	❌ error	❌ log 75/79	imports
bytes	✅	✅	✅	imports
compress/bzip2	❌ log 3/4	❌ log 3/4	❌ log 3/4	imports
container/heap	❌ error	❌ error	❌ error	imports
container/list	❌ error	✅	❌ error	imports
container/ring	❌ error	✅	❌ error	imports
context	❌ error	❌ error	❌ error	imports
crypto	✅	✅	✅	imports
crypto/aes	❌ log 10/13	❌ log 10/13	❌ log 10/13	imports
crypto/cipher	❌ log 3/14	❌ log 3/14	❌ log 3/14	imports
crypto/des	❌ log 2/18	❌ log 6/18	❌ log 2/18	imports
crypto/md5	❌ error	❌ error	❌ error	imports
crypto/rand	❌ error	❌ error	❌ error	imports
crypto/rc4	❌ error	❌ error	❌ error	imports
crypto/sha1	❌ error	❌ error	❌ error	imports
crypto/sha256	❌ error	❌ error	❌ error	imports
crypto/sha512	❌ log 6/8	❌ log 6/8	❌ log 6/8	imports
encoding	❌ error	❌ error	❌ error	imports
encoding/ascii85	❌ error	✅	❌ error	imports
encoding/base32	❌ error	❌ error	❌ log 21/23	imports
encoding/base64	✅	✅	❌ log 16/17	imports
encoding/base64	✅	✅	❌ log 16/17	imports
encoding/binary	❌ log 4/14	❌ log 5/14	❌ log 4/11	imports
encoding/csv	❌ error	✅	❌ error	imports
encoding/gob	❌ error	❌ error	❌ error	imports
encoding/hex	✅	✅	✅	imports
encoding/json	❌ error	❌ error	❌ error	imports
errors	✅	✅	✅	imports
flag	❌ error	❌ log 16/24	❌ error	imports
fmt	❌ log 17/22	❌ log 17/22	❌ log 25/44	imports
go/ast	❌ error	❌ error	❌ error	imports
go/constant	❌ error	❌ error	❌ error	imports
go/format	❌ error	❌ error	❌ error	imports
go/importer	❌ error	❌ error	❌ error	imports
go/printer	❌ error	❌ error	❌ error	imports
go/scanner	❌ error	❌ error	❌ error	imports
go/token	❌ error	❌ error	❌ error	imports
go/token	❌ error	❌ error	❌ error	imports
go/types	❌ error	❌ error	❌ error	imports
hash	✅	✅	✅	imports
hash/adler32	✅	✅	✅	imports
hash/crc32	❌ log 7/8	❌ log 7/8	❌ log 7/8	imports
hash/crc64	✅	✅	✅	imports
hash/fnv	❌ error	✅	❌ error	imports
hash/html	❌ error	❌ error	❌ error	imports
image	❌ error	❌ error	❌ error	imports
image/color	✅	✅	✅	imports
image/draw	❌ error	❌ error	❌ error	imports
index/suffixarray	❌ error	❌ error	❌ error	imports
io	❌ error	❌ error	❌ error	imports
io/fs	❌ log 13/14	❌ log 13/14	❌ log 13/14	imports
log	❌ log 5/9	❌ log 5/9	❌ log 5/9	imports
math	✅	❌ log 79/76	✅	imports
math/big	❌ error	❌ error	❌ error	imports
math/bits	✅	✅	❌ log 23/26	imports
math/cmplx	❌ log 15/23	❌ log 15/24	❌ error	imports
math/rand	❌ log 12/17	❌ log 13/17	❌ error	imports
os	❌ error	❌ error	❌ error	imports
os/exec	❌ error	❌ error	❌ error	imports
path	✅	✅	✅	imports
path/filepath	❌ log 13/16	❌ log 13/16	❌ log 12/16	imports
reflect	❌ error	❌ error	❌ error	imports
regexp	❌ error	❌ error	❌ error	imports
regexp/syntax	✅	✅	✅	imports
runtime	❌ error	❌ error	❌ error	imports
runtime/debug	❌ error	❌ error	❌ error	imports
slices	❌ error	❌ error	❌ error	imports
sort	✅	✅	✅	imports
strconv	✅	✅	❌ log 3/4	imports
strings	✅	✅	✅	imports
sync	❌ error	❌ error	❌ error	imports
sync/atomic	❌ error	❌ error	❌ error	imports
syscall	❌ log 2/4	❌ log 2/4	❌ log 2/4	imports
syscall/js	❌ error	❌ error	❌ error	imports
testing/fstest	❌ log 2/3	❌ log 2/3	❌ log 2/3	imports
testing/iotest	❌ log 12/15	❌ log 12/15	❌ log 12/15	imports
testing/quick	❌ error	❌ error	❌ error	imports
text/scanner	✅	✅	✅	imports
text/tabwriter	❌ log 2/3	❌ log 2/3	❌ log 2/3	imports
text/template	❌ error	❌ error	❌ error	imports
time	❌ error	❌ error	❌ error	imports
unicode	✅	✅	✅	imports
unicode/utf16	✅	✅	✅	imports
unicode/utf8	✅	✅	✅	imports

FAQ

Can library X be compiled?

Maybe, to see if the library is supported at the moment go get library_here the library and then run:

go list -f '{{ .Imports }}' library here

Then check to see if the standard libraries used are all passing with the compatibility table above.

Does the compiler support Go as a Haxe target?

No and it's not within the scope of the project.

Why not use externs instead of compiling Go code into Haxe?

Because externs can target lock a code base and they require maintenance, abstraction code etc.

Cgo support?

Not available but planned and happily accepting contributions for it!

How does this compare to Gopherjs or Go wasm?

go2hx's design is built with Haxe devs in mind, therefore the goals align with Haxe dev advantages of the compiler, with that said go2hx does have some advantages already, smaller code generation, access to Haxe's compiler tooling such as dce and optimizations, and Haxe as a language being very portable, high level and statically typed.

What internals does stdlib use?

go2hx's compiler, compiles the standard library packages for example os. After compilation a Patcher system switches out functions/variables/structs for a Haxe equivalent, for example os.Open uses sys.io.File.read and sys.io.File.write.

Contributing:

The project is still at an experimental level, so expect undocumented problems to spring up. The best way to contribute is to simply use the compiler on code you would like and inevitably run into errors. From there we can answer some questions to see:

how to proceed!

What time is the error happening?:

Go compiler time (./export.go named: go4hx)
Haxe compiler time (src/Typer.hx and ./stdgo/internal/reflect/Reflect.hx etc)
compile time (Haxe build tools example: haxe build.hxml)
runtime (Code running example: hl build.hl or node build.js).

How can the code causing the error be reduced to a simple sample?

Use ./rnd/main.go as a testbed and run it with: haxe rnd.hxml
Modify the Go code with debug prints or the Haxe compiled code with traces and figure out where is the precise error point.
Copy over structs and interfaces if needed that are used by the erroring code sample.
Make usage of go2hx's reflection for example:

println(reflect.TypeOf(value).String())

Does the code throw "not implemented" error?

Look at the unimplemented function's documentation
Implement the missing functionality into the Patcher ./src/Patch.hx following the naming convention path:FunctionName or path.Type:FunctionName for recv functions.

Is the type casting invalid?

Look into ./src/Typer.hx and search for function checkType for implicit type conversions and for casts function castTranslate
A lot of helper type functions are called in ./stdgo/internal/reflect/Reflect for example getUnderlying and the entire module is imported into Typer.hx so you won't see clear reference that the code is there.