Golang to C# Converter
Recent example usages of
go2csallow the use of Golang as the scripting language for the Unity and Godot game engine platforms. See the GoUnity and GodotGo projects.
Project has been updated to use .NET 5.0 and supports publishing as a self-contained executable.
asyncfunctions. Instead conversions make things operate the way they do in Go, e.g., simply running a function on the current thread or running it in on the thread pool when using a
.dylib. Even so, the philosophy is to always attempt to use managed code, i.e., not to lean towards native code libraries, regardless of possible performance implications. Simple first.
Not all converted standard library code will compile yet in C# yet - work remaining to properly parse and convert all Go source library files, with its many use cases and edge cases, can be inferred by examining the warnings in the
builtinGo library functions will always require some special attention since many of its features are implemented outside normal Go code, such as with assembly routines.
Converted code now targets .NET 5.0 and C# 9.0.
Currently, work to improve code conversions is progressing by walking through each of the behavioral testing projects. Iterating through each of these simple use cases improves overall automated code conversion quality.
Sets of common Go sample code have been manually converted to C# using the current C# Go Library. As an example, all relevant code samples from the "Tour of Go" have been converted to C#, see converted code. Ultimately would like to see this in head-to-head mode using Try .NET, for example: Currently converted code will not execute with latest release of Try .NET (see posted issue). Will be watching for an update.
As releases are made for updated
go2csexecutables, this will also include updates to pre-converted Go Standard Library libraries for reference from NuGet.
Before attempting conversions it is important that Go coding environment is already properly setup, especially
GOPATHenvironmental variable. See Getting Started with Go.
Current Go to C# code conversions reference compiled assemblies of the go2cs core library code from the configured
%GOPATH%\src\go2cs\. Run the
deploy-gocore.batscript located in the
go2cs\srcfolder to handle copying source to target path and then building needed debug and release assemblies.
Once a compiled version of the current go2cs core library has been deployed, you can test conversions. For example:
go2cs -o -i C:\Projects\go2cs\src\Tests\Behavioral\ArrayPassByValue
This will convert Go code to C#. You can then build and run both the Go and C# versions and compare results.
Debugging with Visual Studio: After running thedeploy-gocore.batscript you can run conversion code from within Visual Studio by right-clicking on the go2cs project, selecting "Properties" then clicking on the "Debug" tab. In the "Application arguments:" text box you can enter the command line test parameters, e.g.,-o -i -h C:\Projects\go2cs\src\Tests\Behavioral\ArrayPassByValue. When the active solution configuration targets "Debug" you can run the go2cs project to convert Go code, then run converted code.
There's no official release yet, but you can compile the code to produce ago2csexecutable.
%GOPATH%\binpath. This should compile as a standalone executable for your target platform with no external dependencies, see publish profiles.
Before posting an issue for usage related questions consider using the go2cs discussions forum.
Make sure source application already compiles with Go (e.g.,
go build) before starting conversion. That means any needed dependencies should already be downloaded and available, e.g., with
go2csspecifying the Go source path or specific file name to convert. For example:
go2cs -l Main.go
go2cs -s -r C:\\Go\src\\
| Option | Description |
| -l | (Default: false) Set to only convert local files in source path. Default is to recursively convert all encountered "import" packages. |
| -o | (Default: false) Set to overwrite, i.e., reconvert, any existing local converted files. |
| -i | (Default: false) Set to overwrite, i.e., reconvert, any existing files from imported packages. |
| -h | (Default: false) Set to exclude header conversion comments which include original source file path and conversion time. |
| -t | (Default: false) Set to show syntax tree of parsed source file. |
| -e | (Default: $.^) Regular expression to exclude certain files from conversion, e.g., "^.+_test\.go$". Defaults to exclude none. |
| -s | (Default: false) Set to convert needed packages from Go standard library files found in "%GOROOT%\src". |
| -r | (Default: false) Set to recursively convert source files in subdirectories when a Go source path is specified. |
| -m | (Default: false) Set to force update of pre-scan metadata. |
| -g | (Default: %GOPATH%\src\go2cs) Target path for converted Go standard library source files. |
| ‑‑help | Display this help screen. |
| ‑‑version | Display version information. |
| value 0 | Required. Go source path or file name to convert. | | value 1 | Target path for converted files. If not specified, all files (except for Go standard library files) will be converted to source path. |
A new command line option to prefer explicit types over
varwould be handy, e.g., specifying
-xwould request explicit type definitions; otherwise, without applying setting, conversion would default to using
If converted code ever gets manually updated, e.g., where a new
importis added, a command line option that would "rescan" the imports in a project and augment the project file to make sure all the needed imports are referenced could be handy.
If you were looking to "go" in the other direction, a full code based conversion from C# to Go is currently not an option. Even for the most simple projects, automating the conversion would end up being a herculean task with so many restrictions that it would likely not be worth the effort. However, for using compiled .NET code from within your Go applications you have options:
For newer .NET Core applications, I would suggest trying the following project from Matias Insaurralde: https://github.com/matiasinsaurralde/go-dotnet -- this codes uses the CLR Hosting API which allows you to directly use .NET based functions from within your Go applications.
For more background information, see here.