Forked from Horkonaut/gothic which was forked from nsf/gothic.

Recently Tcl/Tk 8.6 were released. I use them as a default, if you still have Tcl/Tk 8.5 use go get -tags tcl85 github.com/nsf/gothic.

In its current state the bindings are a bit Tk-oriented. You can't create an interpreter instance without Tk. In future it's likely it will be changed.

The API is very simple. In the package you have one type and one function:

type Interpreter struct
func NewInterpreter (init interface{}) *Interpreter

In order to launch an interpreter you have to call the "NewInterpreter" function, it will make a new instance of a tcl/tk interpreter in a separate goroutine, execute "init", block in Tk's main loop and then the function returns a pointer to the new instance of an "Interpreter".

"init" could be a string with tcl commands that are executed before Tk's main loop, or a function with this signature: func (*Interpreter). This function gets executed the same way as the string, that is - before Tk's main loop.

Here are the methods of the "Interpreter":

func (*Interpreter) ErrorFilter(filt func(error) error)
func (*Interpreter) Eval(args ...interface{}) error
func (*Interpreter) EvalAs(out interface{}, args ...interface{}) error
func (*Interpreter) Set(name string, val interface{}) error
func (*Interpreter) UploadImage(name string, img image.Image) error
func (*Interpreter) RegisterCommand(name string, cbfunc interface{}) error
func (*Interpreter) UnregisterCommand(name string) error
func (*Interpreter) RegisterCommands(name string, val interface{}) error
func (*Interpreter) UnregisterCommands(name string) error

As it was stated before, the "Interpreter" is being executed in a separate goroutine and each method is completely thread-safe. Also every method is synchronous. It will queue commands for execution and wait for their completion.

That's it. See "examples" directory it has the use cases for most of the API.

• Install Go. I used go1.4.2.linux-amd64.tar.gz.

• Install Git (e.g., msysGit, which includes useful shell commands). I used Git-1.9.5-preview20150319.exe.

• Install ActiveTCL Windows 64-bit to C:\Tcl (non-administrative install should suffice.) I used ActiveTcl8.6.3.1.298624-win32-x86_64-threaded.exe. If your install dir is different from C:\Tcl, update interpreter.go accordingly.

• Install MinGW-w64 and install to the directory of your choice (e.g., C:\mingw-w64). Add the bin directory to your path. I used mingw-w64-install.exe with the following install options:

  • Version: 4.9.2
  • Architecture: x86_64
  • Threads: posix
  • Exception: seh
  • Build Revision: 2

• Install pexports to the directory of your choice. Add this directory to your path. I used pexports-0.46-mingw32-bin.tar.xz.

• Reboot to ensure the installs are correctly referenced by the system (particularly for the sake of ActiveTcl working properly)

• Log in, open a command prompt and run the following build commands:

   :; Configure build environment variables
   set PATH=C:\mingw-w64\mingw64\bin;C:\git\bin;%PATH%
   set GOPATH=%HOMEDRIVE%%HOMEPATH%\Desktop\GoTcl
   set TCLPATH=C:\Tcl
   set CPLUS_INCLUDE_PATH=%TCLPATH%\include
   set C_INCLUDE_PATH=%TCLPATH%\include
   set LD_LIBRARY_PATH=%TCLPATH%\lib
   
   :; Create the Tcl libraries (once)
   cd %TCLPATH%\bin
   pexports tcl86.dll > tcl86.def
   dlltool -D tcl86.dll -d tcl86.def -l libtcl86.a
   pexports tk86.dll > tk86.def
   dlltool -D tk86.dll -d tk86.def -l libtk86.a
   
   :; Create a workspace and build the project
   mkdir "%GOPATH%"
   cd /d "%GOPATH%"
   go get github.com/MartyMacGyver/gothic
   
   :; Run unit tests
   cd /d %GOPATH%\src\github.com\MartyMacGyver\gothic
   go test -v
  
   :; Build the examples
   cd /d %GOPATH%\src\github.com\MartyMacGyver\gothic\_examples
   bash clean.bash && bash all.bash
  
   :; Try the examples
   colors.exe
   ...etc.

1. As the 64-bit version, but using 32-bit tools instead.