nimtk

High level wrapper for Tk

Installation

You may install using nimble

nimble install nimtk

This library only depends upon nimtcl.

Usage/Documentation

Please see the examples for library usage. This wrapper should be similar enough to tkinter and Tk to still be intuitive to use.

Differences from tkinter

In tkinter, the Tk object both serves as a the Tcl interpreter and the root window in for Tk. Instead, this is separated in nimtk, in which Tk only holds the Tcl interpreter, and Root is the root window. Below is common code in all of the examples:

import nimtk/all

let
  tk = newTk()
  root = tk.getRoot()

...

If you want to emulate tkinter's behavior with nimtk (for whatever reason?), nimtk/tkinter contains some converters which may be of use. Still discouraged though!

Wrapped functionality from Tk

See https://github.com/neroist/nimtk/issues/1

Identifying Tk errors

Compile Nim with the -d:nimtk.exitOnError:false argument, which enables the display Tcl/Tk errors.

For example, configuring a Frame with an undefined option of ipadx and value of 123 will display a [TkError] about the unknown -ipadx option, like the following:

nim c -r -d:release -d:nimtk.exitOnError:false mycode.nim

...

Error: unhandled exception: Error when evaluating Tcl!

Command: .frame_6a50171ac3851be45cbfd0a2 configure -ipadx 123
Result: unknown option "-ipadx" [TkError]
Error: execution of an external program failed: 'mycode'