What: Jim
Where: http://jim.berlios.de/ Description: Small footprint implementation of Tcl. It is a work in progress, but as an interpreter, it already is able to run many tcl scripts. Note this is NOT an attempt to implement a Tcl 7.x interpreter - Tcl 8.5 features already are present in Jim. Currently at version 0.51. Updated: 02/2005 Contact: See web site
Recent Changes of this page
Index
Features
Welcome to Jim version 0.50, Copyright (c) 2005 Salvatore Sanfilippo 0 jim> set a(foo) 10 10 0 jim> set a(bar) 20 20 0 jim> puts $a foo 10 bar 20 0 jim> set b "1 2 3 4" 1 2 3 4 0 jim> puts $b(1) 2
0 jim> proc foo {increment} {{value 0}} {incr value $increment} 0 jim> foo 1 1 0 jim> foo 1 2 0 jim> foo 1 3 0 jim> foo 10 13 0 jim> foo 10 23
0 jim> set x 10 10 0 jim> proc bar {} x {puts $x} 0 jim> bar 10
# Write a function foo that takes a number n and returns a function that # takes a number i, and returns n incremented by i. Note: (a) that's number, # not integer, (b) that's incremented by, not plus. proc accumulator n { lambda increment n { set n [expr {$n+$increment}] } } set f [accumulator 100] puts [$f 10] puts [$f 20] puts [$f 1.25]
The output is
110 130 131.25
RS: As Jim has prefix operators, I'd write it like this:
proc accumulator n { lambda increment n {set n [+ $n $increment]} }
Other Jim documentation in this Wiki
Commands already implemented
. lsort [info commands] * + - / append break catch collect concat continue debug dict env error eval exit expr finalize for foreach format getref global if incr info join lambda lambdaFinalizer lappend lindex linsert list llength lmap load lrange lreverse lset lsort proc puts ref rename return scan set setref source split string subst switch time unset uplevel upvar while
Note that the format command is ... virtual, a very subset for now. Also info may not have everything, but important stuff are mostly there.
Benckmarks
Here is a comparison of a recent (21 Mar 2005) version of Jim. Note that Jim appears three times, compiled with -O3, -O2, -Os.
Jim benchmarks - time in milliseconds Jim-O3 Jim-02 Jim-Os 8.4.9 8.5a3 7.6p2 sieve [dict] 580 650 680 F 499 F [for] busy loop 190 250 230 315 325 3531 sieve 850 950 950 258 236 1213 heapsort 590 600 620 159 148 F upvar 430 460 450 359 359 691 expand 170 180 180 F 184 F dynamic code 600 610 610 725 419 445 nested loops 700 710 690 231 291 2795 repeat 490 500 560 3014 2667 3752 wiki.tcl.tk/8566 700 780 760 426 261 F mini loops 370 390 420 282 337 3440 ary 630 710 720 313 297 770 PI digits 930 990 1030 484 408 F dynamic code (list) 180 160 170 198 301 457 [while] busy loop 380 430 440 254 276 3588 fibonacci(25) 550 570 570 299 287 1316 rotate 70 80 80 F F F
For now the work goes in the direction of making Jim more capable and not faster. Once the expected feature level will be reached I'll try to make it faster, being the current speed acceptable for most Jim-target purposes IMHO, at least for this initial stage!
Note that if you plan to write very dyamic code, with a lot of eval/upvar, Jim is probably currently the faster of the three. (See the repeat test).
The source for the benchmarks can be found at [L1 ]
License
Jim is under the APACHE 2.0 license, this means that it's GPL compatible, but like Tcl itself can be used in commercial software without need to distribute the modified source code. In one word Jim is free for both the opensource and the commercial world!.
Commercial Support
Salvatore Sanfilippo, the main author of Jim, will be glad to support in the extension and integration of Jim in embedded systems, as scripting language of existing application, and any other need. For more information write an email to antirez at gmail dot com.
Interested in Jim?
If you want to stay informed about Jim you can subscribe to the jim-devel mailing list. There is a web form to subscribe at https://lists.berlios.de/mailman/listinfo/jim-devel . If you are a developer and want to help check the Jim development page, that is the way Jim developers try to organize the work.
Here is a place for your comments about Jim
02mar05 jcw - Jim is fascinating. Great engineering, IMO!
I've got an experimental reader for Metakit database files as well as a tiny Zlib decompressor based on the Vlerq project I'm working on. Should make it possible to support R/O starkits with very low footprint overhead (my guesstimate would be 25..35 Kb on top of Jim itself). The main issue is how to handle opens and globs and reads from things which are not files. As far as I can see, Jim has no I/O yet. Might be an idea to use a lightweight OO model ("$file read") so one can create objects that end up reading from a starkit. Could also be memory-mapped. Lots of ways to go from here...
SS 3-Mar-2005: Thanks for the good words! I followed the metakit discussion on the Feature Request thread but fortunately my lack of skills in metakits makes me unable to help from this point of view, with the exception that I can focus on the I/O extensions ASAP. For the OO, there will be Odys (with some change probably) integrated into the core (assuming I'll be able to implement it in max 1000 lines of code, otherwise I'll be forced to make it an extension, even if the Jim model is "little core, all extension" I really consider the OOP system to be a core language feature). Btw... I'm thinking that for startkits in unix-land another strategy that's possible to follow is to put POSIX I/O things into the jim-posix extension, and write an higher level interface directly in Tcl.
Yes, the Odys object system could work. No need for POSIX I/O if you *only* want to read from a starkit (which could make Jim secure, sort of). The code I have supports mem-mapped access on Windows, Linux, Mac OS X. -jcw
Googie - How about speed? Are there any benchmarks available? I'm interested much in expr operations, but also others.
SS 2Mar2005: Hello Googie! Jim is currently slower than Tcl, but is faster than Tcl 7.6.
PT 3-Mar-2005: Jim supports dynamically loaded extensions. One of them supports a certain degree of COM automation under windows....
load jim-win32com set ie [ole32 create InternetExplorer.Application] ole32.invoke $ie Navigate2 http://wiki.tcl.tk/jim ole32.invoke -put $ie Visible True
The above script results in Internet Explorer displaying this page.
SS 3-Mar-2005: That's cool! And is all merit of Pat. Also there is a start of win32 API binding. To hack with it:
load jim-win32.dll info commands win32.* ...
SEH -- 2005/03/01 -- I've often thought that a good way to demonstrate Tcl's power and to smooth the process of Tcl's development and improvement would be to control the compiling of Tcl and its extensions primarily with Tcl itself (I'm sure I'm not the only one). A mostly pure-Tcl build process would significantly lower core development participation barriers.
Of course there is the bootstrap problem, which I thought might be solved by using Ettcl or TinyTcl. Now Jim provides an intriguing new option.
A one-file implementation of a basic set of Tcl commands ought to be a great tool for bootstrapping problems. If a script could be run using Jim to compile a basic tclsh, then that tclsh could be used to control the rest of the compiling and packaging process.
A viable Jim -> tclsh -> cc compile toolchain that could conceivably replace existing bash -> m4 -> autoconf -> automake -> make -> cc toochain nightmares might greatly widen the appeal of Tcl in the software development world.
SS 5Mar2005 - Update: in order to explore the proposal of SEH as well as the ability to run simple starkits with Jim, I'm working on a very simple Jim extension called AIO (Ansi I/O) that exports ANSI C file capabilities to Jim with a OOP Interface (and it is very simple to provide Tcl file API compatibility via some glue procedure). The intial version is on the CVS, people interested in this issue my follow the thread in the Feature Request at http://developer.berlios.de/feature/?group_id=3204 .
On the last days Jim reached a better shape, there are more core commands, it's more binary safe (now all the parsers are binary-safe), and robust. Also the exported C API is more complete.
That's how the AIO extension looks like:
load jim-aio.so set f [aio.open /etc/passwd] set f2 [aio.open /tmp/FOOBAR w] while {[$f gets line] != -1} { $f2 puts "~~ $line ~~" } $f close $f2 close
Very similar to cfile.
SEH, that is an excellent idea! I would love to see something like this - davidw.
It also looks very interesting to me :) SS.
SEH -- Jim + Critcl might be the basis for a dandy cross-platform autoconf replacement.
LV Anyone have a table comparing features of Tcl and Jim, so that one can more easily understand the differences?
RS Jim is a rapidly moving target, but here's a quick sketch of what I can think of at the moment (see also Jim development for further differences):
On Jimulation I've started to "back-port" some useful Jim features to pure-Tcl, but most recently Jim seduces me to do even C fun projects... see below.
RS: See also Tiny OO with Jim - Jimulation / 2005-03-20: Here's this evening's fun project - adding an ** operator to jim.c (only added lines shown - "Doctor, somehow writing C doesn't hurt any more" :): ... snip... SS: ** added some time ago, thanks. For now it is supported only for integers because every mathlib realted thing will probably go inside the math extension. This is so because the Jim core should not depend on the C math library.
RS was heard to aphorize, "Jim - because even simplicity can get simpler".
I'm having problems compiling the extensions to Jim under Mac OS X.2.8. I get the following when I try to do a "make aio":
ld -G -z text -o jim-aio-1.0.so jim-aio.xo -ldl -lc ld: unknown flag: -G make: *** [jim-aio-1.0.so] Error 1
I do have dlcompat installed and am using gcc 3.3. BMA
LV The -G flag is used on most systems to indicate that the resulting file should be a dynamic shared object. Perhaps on MacOS X there is a different flag for this?
SS Unfortunately it is more complex than this. Basically MacosX does not have a dlopen()-like interface for shared library but is using something special. So even if the extensions can be built providing the right flags to LD, still Jim under MacosX is currently not able to load dynamic libraries. A simple solution is to link Jim with a library provided in most MacosX environments that emulates dlopen(), but I think I'll address the issue with the native calls like what happens for win32.
LV I'd think there would be examples of how to do this in the Tcl core code, right?
SS Probably, there are also may examples in the MacOSX doc itself. To use this functions is not hard at all, there is just to find some time... and I hope that a developer more expert than me about MacOSX programming will contribute it for Jim like Pat Thoyts did for the win32 dynamic library loading code (together with many other win32-related and not things).
Category Language, Category Jim, Category Tcl Implementations