I. CLIENT ========= This is a very basic implementation of a Teapot client. It will fetch all requested packages and their dependencies from a remote TEAPOT server. 1. Installing ------------- The supplied Makefile only installs the client library. A sample client that makes use of this library is included. The sample library is called "teapot-client.tcl". a. To install with all the default options and auto configuration, execute: # make install b. If you wish to install the package into a particular directory, execute: # make install TCLDIR=your_particular_directory (note that it will create a "teapotclient0.1" directory and but no "lib" or similar directory) c. If you wish to install into an alternate root directory (i.e., for packaging), execute: # make install DESTDIR=your_new_rootdir This will search for a "tclConfig.sh" in the destination directory. Note that the install directory is not encoded in the script in any way so it can be safely moved after installation. 2. Using -------- a. teapotclient: i. get_extensions SYNOPSIS package require teapotclient ::teapotclient::get_extensions \ ?? ?? DESCRIPTION get_extensions gets the extensions that are available from a list of TEAPOT servers, for a particular operating system and CPU tuple (which can be glob patterns). The default OS and CPU patterns are both "*" which will match all operating system and cpus. RETURN VALUE The returned value is a list in the format of: {Extension_1} {ExtensionInfo_1} {Extension_2} {ExtensionInfo_2} ... Where ExtensionInfo_N is a list in the format of: ExtensionVersion ExtensionPlatformInfo ii. download_extensions SYNOPSIS package require teapotclient ::teapotclient::download_extensions \ \ \ ?? DESCRIPTION download_extensions will download the list of extensions for a given operating system and CPU tuple, and download their dependencies recursively. It will place each downloaded extensions in its own subdirectory beneath the specified "rootdir". The latest version available for the given OS and CPU tuple of each extension will be downloaded. You may optionally specify a list of extensions that you do not wish to be downloaded. RETURN VALUE The return value is a list of extensions actually downloaded. This may contain items that were not requested (if they were needed to satisfy a dependency), and may not contain all items that were requested (if they were unavailable). iii. setcachedir SYNOPSIS package require teapotclient ::teapotclient::setcachedir DESCRIPTION The download_extensions and get_extensions commands use a local disk cache to improve performance. The default cache directory is a directory in the user's home directory, or a temporary directory if a home directory is not found. setcachedir specifies an alternate location to store the cache. setcachedir should be called before any other commands if it is intended to be used. RETURN VALUE Unspecified. iv. Example 1: package require teapotclient puts "The following extensions are available:" foreach {extension extensioninfo} [::teapotclient::get_extensions \ [list teapot.activestate.com] \ {*} {*}] { puts " $extension [join $extensioninfo {, }]" } v. Example 2: package require teapotclient set os $tcl_platform(os) if {$tcl_platform(platform) == "windows"} { set os $tcl_platform(platform) } puts "Downloading md5 and sha1 packages for the current system" ::teapotclient::download_extensions "." \ [list teapot.activestate.com] [list md5 sha1] $os \ $tcl_platform(machine) b. teapot-client.tcl (not installed): i. teapot-client get Downloads all the requested extensions/packages for the OS+CPU pair into the "lib" directory of the directory specified. ii. teapot-client list ?? ?? Lists all available extensions and their most recent versions, optionally restricted to an OS+CPU pair. II. SERVER ========== This is not yet implemented.