TclOO

TclOO , by Donal Fellows, is both a toolkit for creating object systems, and an object system in its own right. As of Tcl 8.6, is part of the core distribution.

It just works. Kudos to Donal
- Will Duquette,Twentieth Annual Tcl/Tk Conference (2013)

Examples

Playing with TclOO
TclOO Tricks
TclOO Channels
coroutine
contains a TclOO example by CMcC

See Also

TIP #257: Object Orientation for Tcl
Megawidgets with TclOO
TclOO and configure
Work in progress for a configuration system to go with above megawidgets stuff
Abstract base classes with TclOO
Fun with TclOO, coroutines and apply
TclOO Method Dispatch
Serializing TclOO objects
typedlist
TclOO trace filter
MeTOO
emulates TclOO for Tcl 8.4
Prototype Pattern in Tcl
Includes a small TclOO example by dkf.
TclOO Tutorial
JBR's tcloo.tcl
Self on a class-based OO system
Illustrates the trick of mixing a class into itself so that it can serve as a prototype in a prototype-oriented objected system. The TclOO variant of ycl shelf will also use this mechanism.
TclOO widget/object framework, by RZ
adds some features to vanilla TclOO, including private variables, some enhancements to constructor and destructor, new class methods like option ... and component ...
TclOO Introductory Article
Please redirect any comments or corrections to the BOOK Tcl Programming for Windows page.

C Interface

How to embed Tcl in C applications
Includes TclOO examples.
Writing a TclOO Method in C

Development

TclOO WishList and Work Roster

Commands

::oo::class
new in 8.6
::oo::copy
new in 8.6
::oo::define
new in 8.6
::oo::objdefine
::oo::object
info
info class
provides introspection of classes (many subcommands)
info object
provides introspection of objects (many subcommands)

Filters

Profiling a TclOO class
Uses a filter mix-in to time method calls.

Method Commands

The following commands are only available within the body of a method

my
new in 8.6
next
new in 8.6
self
new in 8.6

Description

DKF (mostly):

TclOO is a core for other OO extensions, but in order to do that job properly it also needs to be a basic OO framework itself. The other thing that it isn't is a class library. That can go in tcllib just nicely.

OO support in the core distribution can be completely ignored except when it is providing a specific benefit to a script. At an implementation level, the benefit is that it scopes the development and keeps the amount of work required sane and the delivery schedule practical. You might or might not think of this as a benefit... :-)

TclOO borrows many concepts from XOTcl, so there's definite continuity from Smalltalk in there. Not everything though; incr Tcl was an influence too and that's got C++ genes.

Developers may choose to use ::tcl::oo directly to do their work, or they may choose to use other object systems, e.g., snit, incr tcl, XOTcl, which themselves use TclOO and then provide additional functionality/flavour.

In terms of rewriting things to use TclOO, some classes probably will be rewritten, e.g. quite possibly code to support chan create better, maybe a megawidget framework, and TDBC of course) but there won't be a vast number. The whole world needn't be changed. Tcl was working fairly well beforehand.

News

TclOO 1.0.1 was released on 2013-09-26. It corresponds to the version included as part of Tcl 8.6.1. http://sourceforge.net/projects/tcl/files/TclOO%20Package/1.0.1/%|%Download%|% .

TclOO 1.0 was released on 2012-12-21. It corresponds to the version included as part of Tcl 8.6.0. http://sourceforge.net/projects/tcl/files/TclOO%20Package/1.0/%|%Download%|% .

TclOO 0.6 has been released on 2008-10-14. It corresponds to the version included as part of Tcl 8.6a3.

Original announcement on news:comp.lang.tcl on 01-Oct-2007 (note links are outdated now):

I'm very pleased to announce that TclOO version 0.1 is now released.
It's hosted in the Tcl project at [SourceForge], so you can download the
source package from:
http://sf.net/project/showfiles.php?group_id=10894&package_id=247402

It requires Tcl 8.5b1 to build and operate; see the enclosed `README.txt`
for details on how to build this TEA-based package. No promises on
whether I'll do a binary package for any platforms as yet. :-)

Details about this package can be found in the Wiki, naturally, at
https://wiki.tcl-lang.org/TclOO and any problems should be reported using Tcl's
issue trackers at http://sf.net/tracker/?group_id=10894&atid=110894 with
the summary field prefixed by "TclOO:".

Basic Example

package require TclOO;  #if loading for the first time; not required on Tcl 8.6
oo::class create summation {
    constructor {} {
        variable v 0
    }
    method add x {
        variable v
        incr v $x
    }
    method value {} {
        variable v
        return $v
    }
    destructor {
        variable v
        puts "Ended with value $v"
    }
}
set sum [summation new]
puts "Start with [$sum value]"
for {set i 1} {$i <= 10} {incr i} {
    puts "Add $i to get [$sum add $i]"
}
$sum destroy   ;# only destroy the $sum object. 'summation destroy' destroys ALL summation objects --Duoas

which gives:

Start with 0
Add 1 to get 1
Add 2 to get 3
Add 3 to get 6
Add 4 to get 10
Add 5 to get 15
Add 6 to get 21
Add 7 to get 28
Add 8 to get 36
Add 9 to get 45
Add 10 to get 55
Ended with value 55

Should you see the error message

attempt to provide package TclOO 0.1.1 failed: package TclOO 0.1 provided
instead

Duoas If I should see that message, then what?

DKF: Then stop using that old version! I really don't recommend using less than 1.0 nowadays…

TclOO::ext

I collected some TclOO extension in a package here: https://github.com/arthurschreiber/tcloo-ext

Currently included is a Reference Counting system inspired by ObjectiveC/Cocoa to make memory management easier and a class method inheritance through MetaClasses (not using mixins).

Discussion

APN I don't quite follow the discussion below about automatically bringing variables into scope. Isn't that what the variable inside a class definition does?

class create C { variable a b }

would have variables a and b automatically brought into scope in all methods. Perhaps the discussion originated before variable was implemented. If someone can confirm this, please delete this and the discussion below because it is misleading.

DKF: Indeed, that's what the variable declaration does. Now. It didn't when the discussion was held. It also doesn't bring in all variables because that turns out to be more problematic when mixed with inheritance.

jcw 2007-06-04:

Is there some nice idiom for the following?

my variable {*}[info vars [namespace current]::*]

IOW, set up methods to automatically have access to all object state as plain variables (as in Itcl). The above line would be added in front of all method definitions, using a small wrapper (am generating methods dynamically anyway).

This assumes that all variables are defined in the constructor.

escargo Does this use of variable contrast confusingly with the Tcl variable where something like that would assign the names of half the variables as the values of the other half of the variables?

jcw - Well, I'm just trying it out, so don't shoot me ;) - although so far I tend prefer this over the "variable" cmd.

escargo - I was just asking a question. It's just that having my variable work not like variable might be considered confusing.

jcw - Here's an example with some output which may help those who don't have TclOO yet:

oo::class create dog {
    method a {} {
        puts a1-[namespace current]
        puts a2-[namespace path]
        foreach x [namespace path] {
          puts a3-$x-[info commands ${x}::*]
        }
        puts a4-[info vars [namespace current]::*]
        my variable e
        set e f
        puts a5-[info vars [namespace current]::*]
    }
    self method b {} {
        puts b1-[namespace current]
        puts b2-[namespace path]
        foreach x [namespace path] {
            puts b3-$x-[info commands ${x}::*]
        }
        puts b4-[info vars [namespace current]::*]
        my variable e
        set e f
        puts b5-[info vars [namespace current]::*]
    }
}

dog create fifi
fifi a
dog b

# Output:
#   a1-::oo::Obj4
#   a2-::oo::Helpers
#   a3-::oo::Helpers-::oo::Helpers::self ::oo::Helpers::next
#   a4-
#   a5-::oo::Obj4::e
#   b1-::oo::Obj3
#   b2-::oo::Helpers ::oo
#   b3-::oo::Helpers-::oo::Helpers::self ::oo::Helpers::next
#   b3-::oo-::oo::InfoClass ::oo::class ::oo::InfoObject ::oo::object \
#                                                     ::oo::copy ::oo::define
#   b4-
#   b5-::oo::Obj3::e
MHo 2015-02-24 This doesn't work for me. There's no command 'dog b'. Should it be 'self method b…' instead of 'self.method b…' ? Would be fine if there where a 'TclOO for OO-Dummies' somewhere....
DKF: Yes, it should. The self.blah syntax was an interim thing that got removed once I had the more general self syntax.

As you can see, each class and each instance gets its own namespace. Note also that class Dog ended up as namespace Obj3, even though it was constructed with a specific name (which is not necessarily globally unique, though).

DKF: I've been experimenting for a while now with OO systems, and a my variable that brings every variable in the object into scope is probably not what you want as it causes great problems in subclasses (i.e. clashes between subclasses' variables and local variables). Instead, I think that being able to pick up all the variables defined within a particular class would be far more useful. OTOH, it's not at all trivial to implement (I think I expose enough API that it can be done through the use of class metadata, but I'm not certain) so I'm not in a hurry to change things.

It was a deliberate decision to make my variable different from variable. The latter has syntax that is almost never what anyone wants, and so is a priori suboptimal. Hence I went for something that was more likely to be what you need. :-)

escargo: Well, I wondered if you did it on purpose, and you did. And I see it was for what you think is a good reason.

Also, as noted, the internal namespaces have names that are not necessarily those of the created object, and their names are deliberately not documented (i.e. they could change between point releases with no warning). Use the introspection facilities to go from one to the other.

APW 2007-06-05:

@ jcw: I am working on an extended version of dkf's code suitable for Itcl, which would have solutions for some of the problems you have mentioned above. For example I am using apply and namespace upvar and namespace unknown to generate Itcl methods, which have access to all the class variables in the class hierarchy (if they are not private) etc. Using only the name of a variable as in Itcl is possible, same for call of Itcl methods without the "my" in front. If you are interested please contact me directly, the implementation is not yet ready for real testing.

@dkf: If I know what I really need additionally for Itcl I will contact you and we can try to perhaps get a merged version. At the moment all my modifications are additional functionality so that the original functionality should work as before with also running all your tests without problems.

Aspects with TclOO

DKF: The following example is ripped from the documentation of next:

oo::class create cache {
    filter Memoize
    method Memoize args {
        # Do not filter the core method implementations
        if {[lindex [self target] 0] eq "::oo::object"} {
            return [next {*}$args]
        }

        # Check if the value is already in the cache
        my variable ValueCache
        set key [self target],$args
        if {[info exist ValueCache($key)]} {
            return $ValueCache($key)
        }

        # Compute value, insert into cache, and return it
        return [set ValueCache($key) [next {*}$args]]
    }
    method flushCache {} {
        my variable ValueCache
        unset ValueCache
        # Skip the cacheing
        return -level 2 ""
    }
}

oo::object create demo
oo::objdefine demo {
    mixin cache
    method compute {a b c} {
        after 3000 ;# Simulate deep thought
        return [expr {$a + $b * $c}]
    }
    method compute2 {a b c} {
        after 3000 ;# Simulate deep thought
        return [expr {$a * $b + $c}]
    }
}
puts [demo compute  1 2 3]      ? prints "7" after delay
puts [demo compute2 4 5 6]      ? prints "26" after delay
puts [demo compute  1 2 3]      ? prints "7" instantly
puts [demo compute2 4 5 6]      ? prints "26" instantly
puts [demo compute  4 5 6]      ? prints "34" after delay
puts [demo compute  4 5 6]      ? prints "34" instantly
puts [demo compute  1 2 3]      ? prints "7" instantly
demo flushCache
puts [demo compute  1 2 3]      ? prints "7" after delay

jcw: ''Way cool, great separation of functionality. Next step: a Metakit backed cache? ;)

DKF: I've thought more about this, and have written an Aspect Support Class for TclOO.


APW 2007-06-06: For discussion of Itcl related topics for a new implementation based on this TIP see tclOO missing features for Itcl

Performance Measurement

DKF 2007-09-20: As seen in my Tck2k7 paper, TclOO is really quite fast. Here's those performance figures (correct with 8.5b1 on my ancient laptop).

OO System Objects Made (s?¹) Method Calls (s?¹)
TclOO 0.1 32800 206000
itcl 3.4.0 22500 128000
XOTcl 1.5.5 18500 87500
Snit 2.1 2080 54700
Snit 1.2 1020 24700
stooop 4.4.1 13900 26700

Notes: It turns out that stooop non-virtual methods are much faster, but they're not comparable with the other methods as they do not allow overriding of the method by subclasses, so I used the (comparable) virtual methods instead, which are much slower.

DKF: Reanalysed with modern hardware and new versions of XOTcl, TclOO and snit (~3 sig. figures) - this machine doesn't seem to have stooop:

OO System Objects Made (s?¹) Method Calls (s?¹)
TclOO 0.3 121000 981000
itcl 3.4.0 87900 573000
XOTcl 1.6.0 87200 404000
Snit 2.2.1 7190 881000

All are packages built by ActiveState, running on Tcl 8.5.2. (I see differences in my own tests, but can't tell what their origin is.)

Analyzing those figures, we see (from the itcl baseline) that the machine is about 4.25 times faster (average). We therefore can see that TclOO is getting a (little) better at method dispatch though it is slower at object construction. We also see that XOTcl has improved a lot on the construction front, though it is still not very fast at method dispatch. Looking at snit, we see that it is now very fast at method dispatch (nearly as fast as TclOO) but is still very slow to create objects.

Sarnold: Indeed snit is very slow at object instantiation, but building a snit-like system on top of XOtcl, namely xoins, give it far better creation times at the cost that method dispatch is slower. I do not know if William Duquette is still working on a TclOO snit implementation - I hope it will succeed, because snit is really good for Megawidgets and has a nice syntax that fits well upon Tcl's one.

DKF: I'm working on two sets of (independent) improvements to TclOO that should make doing snit on top of it easier. Firstly, I'm doing something to make variables easier to use, so you can declare them once per class instead of once per method. Secondly, I'm trying to make submethods work (one of the neatest features of Snit). Apart from these, I suspect that the current method forwarding implementation is over-simplistic in its model; need someone to point me at a use-case case or two in order to figure out how to improve on that.


The script used to create the performance data is below. (Well, I actually did it interactively over a few runs, so I don't warrant that this script will really work...)

Performance Analysis Script

package require Tcl 8.5b1

# Compute Calls Per Second of a script
# Note that this script is self-tuning; it prefers to execute a script for around a second

proc cps {script} {
    # Eat the script compilation costs
    uplevel 1 [list time $script]
    # Have a guess at how many iterations to run for around a second
    set s [uplevel 1 [list time $script 5]]
    set iters [expr {round(1/([lindex $s 0]/1e6))}]
    if {$iters < 50} {
        puts "WARNING: number of iterations low"
    }
    # The main timing run
    set s [uplevel 1 [list time $script $iters]]
    set cps [expr {round(1/([lindex $s 0]/1e6))}]
    puts "$cps calls per second of: $script"
}

#--------------------------------------------------------------------------
puts "using Itcl..."
package require Itcl 3.4
namespace path itcl

class foo {
    variable x
    constructor {} {
        set x 1
    }
    method bar {} {
        set x [expr {!$x}]
    }
}

foo f
cps {f bar}
delete object f

cps {delete object [foo f]}

delete class foo

#--------------------------------------------------------------------------
puts "using XOTcl..."
package require XOTcl 1.5.5
namespace path xotcl

Class create Foo
Foo parameter x
Foo instproc init {} {
    my set x 1
}
Foo instproc bar {} {
    my instvar x
    set x [expr {!$x}]
}

Foo create f
cps {f bar}
f destroy

cps {[Foo create f] destroy}

Foo destroy

#--------------------------------------------------------------------------
puts "using TclOO..."
package require TclOO 0.1
namespace path oo

class create foo {
    constructor {} {
        variable x 1
    }
    method bar {} {
        variable x
        set x [expr {!$x}]
    }
}

foo create f
cps {f bar}
f destroy

cps {[foo create f] destroy}

foo destroy

#--------------------------------------------------------------------------
puts "using snit..."
package require snit 2.1

snit::type foo {
    variable x
    constructor {} {
        set x 1
    }
    method foo {} {
        set x [expr {!$x}]
    }
}

foo f
cps {f bar}
f destroy

cps {[foo f] destroy}

foo destroy

#--------------------------------------------------------------------------
puts "using stooop..."
# Must go last because it plays games with proc which might disturb the
# performance of other OO systems. Note that stooop has both virtual and
# non-virtual methods, with very different performance profiles. The virtual
# ones are much more comparable in capability to other OO systems...
package require stooop 4.4.1
namespace path stooop

class foo {
    proc foo {this} {
        set ($this,x) 1
    }
    proc ~foo {this} {}
    virtual proc bar {this} {
        set ($this,x) [expr {!$($this,x)}]
    }
    proc bar-nv {this} {
        set ($this,x) [expr {!$($this,x)}]
    }
}

set f [new foo]
cps {$f bar}
cps {$f bar-nv}
delete $f

cps {delete [new foo]}

Simple examples of design patterns using TclOO