go2hx

warning: experimental version.

Compile Go to Haxe.

Use Go libs with ease!

Standard Library compatibility/api docs

Library compilation and test results

module	docs	tests	hl
stdgo._internal.bufio	❌	yes	❌
stdgo._internal.bytes	✅	yes	❌
stdgo._internal.compress.bzip2	✅	yes	❌
stdgo._internal.compress.flate	✅	yes	❌
stdgo._internal.compress.zlib	✅	yes	❌
stdgo._internal.context	✅	no	_
stdgo._internal.crypto	❌	no	_
stdgo._internal.crypto.internal.randutil	✅	no	_
stdgo._internal.crypto.rand	❌	yes	❌
stdgo._internal.crypto.sha1	❌	yes	❌
stdgo._internal.encoding	❌	no	_
stdgo._internal.encoding.base64	✅	yes	❌
stdgo._internal.encoding.binary	✅	yes	❌
stdgo._internal.encoding.gob	❌	yes	❌
stdgo._internal.encoding.hex	✅	yes	❌
stdgo._internal.encoding.json	❌	yes	❌
stdgo._internal.errors	✅	yes	❌
stdgo._internal.flag	❌	yes	❌
stdgo._internal.fmt	✅	yes	❌
stdgo._internal.hash	❌	yes	❌
stdgo._internal.hash.adler32	✅	yes	❌
stdgo._internal.image	❌	yes	❌
stdgo._internal.image.color	✅	yes	❌
stdgo._internal.internal	✅	no	_
stdgo._internal.internal.abi	✅	no	_
stdgo._internal.internal.bisect	✅	no	_
stdgo._internal.internal.bytealg	✅	no	_
stdgo._internal.internal.cpu	✅	no	_
stdgo._internal.internal.fmtsort	✅	yes	❌
stdgo._internal.internal.godebug	✅	no	_
stdgo._internal.internal.godebugs	✅	no	_
stdgo._internal.internal.oserror	✅	no	_
stdgo._internal.internal.platform	✅	no	_
stdgo._internal.internal.poll	✅	no	_
stdgo._internal.internal.race	✅	no	_
stdgo._internal.internal.reflect	✅	no	_
stdgo._internal.internal.reflectlite	✅	no	_
stdgo._internal.internal.saferio	✅	no	_
stdgo._internal.internal.testenv	✅	no	_
stdgo._internal.internal.types.errors	✅	no	_
stdgo._internal.io	❌	yes	❌
stdgo._internal.io.fs	❌	yes	❌
stdgo._internal.log	❌	yes	❌
stdgo._internal.log.internal	✅	no	_
stdgo._internal.math	❌	yes	❌
stdgo._internal.math.big	❌	yes	❌
stdgo._internal.math.bits	✅	yes	❌
stdgo._internal.math.cmplx	✅	yes	❌
stdgo._internal.math.rand	❌	yes	❌
stdgo._internal.os	❌	yes	❌
stdgo._internal.os.exec	❌	yes	❌
stdgo._internal.path	❌	yes	❌
stdgo._internal.path.filepath	❌	yes	❌
stdgo._internal.reflect	✅	no	_
stdgo._internal.regexp	✅	yes	❌
stdgo._internal.regexp.syntax	✅	yes	❌
stdgo._internal.runtime	✅	no	_
stdgo._internal.runtime.debug	✅	no	_
stdgo._internal.slices	❌	yes	❌
stdgo._internal.sort	✅	yes	❌
stdgo._internal.strconv	✅	yes	❌
stdgo._internal.strings	✅	yes	❌
stdgo._internal.sync	❌	yes	❌
stdgo.internal.sync.atomic	✅	no	_
stdgo._internal.syscall	✅	no	_
stdgo._internal.syscall.js	✅	no	_
stdgo._internal.testing	✅	no	_
stdgo._internal.testing.fstest	✅	yes	❌
stdgo._internal.testing.internal.testdeps	✅	no	_
stdgo._internal.testing.iotest	✅	yes	❌
stdgo._internal.testing.quick	✅	yes	❌
stdgo._internal.text.scanner	✅	yes	❌
stdgo._internal.text.template	❌	yes	❌
stdgo._internal.time	❌	yes	❌
stdgo._internal.unicode	✅	yes	❌
stdgo._internal.unicode.utf16	✅	yes	❌
stdgo._internal.unicode.utf8	✅	yes	❌
stdgo._internal.unsafe	✅	no	_
stdgo.bufio	✅	no	_
stdgo.bytes	✅	no	_
stdgo.compress.bzip2	✅	no	_
stdgo.compress.flate	❌	no	_
stdgo.context	❌	no	_
stdgo.crypto	❌	no	_
stdgo.crypto.internal.randutil	✅	no	_
stdgo.crypto.rand	❌	no	_
stdgo.crypto.sha1	❌	no	_
stdgo.encoding	❌	no	_
stdgo.encoding.base64	✅	no	_
stdgo.encoding.binary	❌	no	_
stdgo.encoding.gob	❌	no	_
stdgo.encoding.hex	✅	no	_
stdgo.encoding.json	❌	no	_
stdgo.errors	❌	no	_
stdgo.flag	❌	no	_
stdgo.fmt	✅	no	_
stdgo.hash	❌	no	_
stdgo.hash.adler32	✅	no	_
stdgo.image	❌	no	_
stdgo.image.color	❌	no	_
stdgo.internal.abi	✅	no	_
stdgo.internal.bisect	❌	no	_
stdgo.internal.bytealg	✅	no	_
stdgo.internal.cpu	✅	no	_
stdgo.internal.fmtsort	✅	no	_
stdgo.internal.godebug	❌	no	_
stdgo.internal.godebugs	✅	no	_
stdgo.internal.oserror	✅	no	_
stdgo.internal.platform	✅	no	_
stdgo.internal.poll	✅	no	_
stdgo.internal.race	✅	no	_
stdgo.internal.saferio	✅	no	_
stdgo.internal.testenv	✅	no	_
stdgo.internal.types.errors	✅	no	_
stdgo.io	❌	no	_
stdgo.io.fs	❌	no	_
stdgo.log	❌	no	_
stdgo.log.internal	✅	no	_
stdgo.math	❌	no	_
stdgo.math.big	❌	no	_
stdgo.math.bits	✅	no	_
stdgo.math.cmplx	✅	no	_
stdgo.math.rand	❌	no	_
stdgo.os	❌	no	_
stdgo.os.exec	✅	no	_
stdgo.path	✅	no	_
stdgo.path.filepath	✅	no	_
stdgo.reflect	❌	no	_
stdgo.regexp	✅	no	_
stdgo.regexp.syntax	✅	no	_
stdgo.runtime	❌	no	_
stdgo.runtime.debug	✅	no	_
stdgo.slices	❌	no	_
stdgo.sort	✅	no	_
stdgo.strconv	✅	no	_
stdgo.strings	✅	no	_
stdgo.sync	❌	no	_
stdgo.sync.atomic_	❌	no	_
stdgo.syscall	❌	no	_
stdgo.syscall.js	✅	no	_
stdgo.testing.fstest	❌	no	_
stdgo.testing.internal.testdeps	❌	no	_
stdgo.testing.iotest	❌	no	_
stdgo.testing.quick	✅	no	_
stdgo.text.scanner	❌	no	_
stdgo.text.template	❌	no	_
stdgo.time	❌	no	_
stdgo.unicode	✅	no	_
stdgo.unicode.utf16	✅	no	_
stdgo.unicode.utf8	✅	no	_

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.