Packages in Tcl allow you to define a file of code that's going to be loaded as required at run time. Namespaces allow you to define a new set of variable and proc names that doesn't conflict with the variable and proc names in your main program - rather like giving all the variable and procs in part of your code a surname.

Although packages and namespaces are different facilities and technically not linked in any way, in practise they're often used together. I've often been asked for a simple example showing the mechanism of packages and namespaces working together ...

Here's a main program:

lappend auto_path /home/trainee/ltcl/bowbells
package require amerifruit 1.0
puts [usa::grapefruit]

Here's the file that defines the amerifruit package - it happens to be called florida.tcl in a directory called bowbells:

package provide amerifruit 1.0
namespace eval usa {
proc grapefruit {} {
puts "Big water melons"
}
}

The file bowbells/pkgIndex.tcl provides an index that links the amerifruit package to the florida.tcl file:

package ifneeded amerifruit 1.0 [list source [file join $dir florida.tcl]]
package ifneeded fruit 1.0 [list source [file join $dir clements.tcl]]

If you're worried about the syntax of this, don't be; it was genarated by the command
pkg_mkIndex . *.tcl
run in interactive mode in the bowbells directory

For further details and examples, see our training module on the subject
(written 2004-12-10, updated 2006-06-05)

 T213 - Tcl/Tk - Libraries, Packages and Namespaces
  [3418] Tcl packages, pkg_mkIndex, pkgIndex.tcl -what are they and why use them. - (2011-09-03)
  [3417] What is a namespace and why do we need them? - (2011-09-03)
  [3066] Separating groups of variables into namespaces - (2010-11-24)
  [2476] Tcl - uplevel to run code at calling level - (2009-10-24)
  [1529] Tcl - learning how to use namespaces, packages and libraries together - (2008-02-02)
  [1339] Packages and Namespaces are like Suitcases and Aircraft - (2007-09-09)

Back to a comment on comments

Previous and next or Horse's mouth home

Forward to Recent technical articles

Confession
Fish stocks
Programming in isolation
Recent technical articles
example of Tcl namespaces and packages
a comment on comments
Tcl sandwich - lists in Tcl
Network Camera
Colour for access
Too technical?