Package Repository Client

Package Client Toolset Source Code Repository

The Package Client Toolset is now considered production quality.

Download the Package Client Toolset installation script (Bash) for Linux and macOS

View documentation for version 1 of the Package Client Toolset

The Package Client Toolset, which is currently part of the Eagle project, allows users to obtain packages for both Tcl and Eagle.

It is implemented as a set of Tcl scripts, all of which support being evaluated in a native Tcl or Eagle interpreter.

It uses HTTPS to communicate with the Package Repository Server and the Package Downloads Server, which are just customized instances of Fossil.

All trunk check-ins on the Package Repository Server and Package Downloads Server are OpenPGP signed.

All files managed by the Package Repository Server and Package Downloads Server are OpenPGP signed.

The Package Downloads Client verifies the OpenPGP signatures on all downloaded files.

For each file that belongs to an Eagle package (e.g. script files), a Harpy script certificate file is also present.

This project is sponsored by Eyrie Solutions.

The Package Repository Server is used to keep track of all package metadata, e.g. the script used to obtain a given package and its associated cryptographic signatures. Here is an example package script that itself makes use of the public procedures exposed by the Package Client Toolset:

  apply [list [list] {
    set fileNames [list]

    lappend fileNames [file join Garuda1.0 dotnet.tcl]
    lappend fileNames [file join Garuda1.0 Garuda.dll]
    lappend fileNames [file join Garuda1.0 helper.tcl]
    lappend fileNames [file join Garuda1.0 msvcr100.dll]
    lappend fileNames [file join Garuda1.0 pkgIndex.tcl]
    lappend fileNames [file join Garuda1.0 Scripts ex_winForms.tcl]
    lappend fileNames [file join Garuda1.0 Tests all.tcl]

    set options [list \
        -persistent false -usePgp true -useAutoPath true]

    package require Eagle.Package.Downloader

    ::PackageDownloader::resetCookieAndLoginSimple
    ::PackageDownloader::downloadFiles tcl 8.4 "" $fileNames $options
    ::PackageDownloader::logoutAndResetCookie
  }]

And the associated OpenPGP signature for the above block is:

Also see

In order to use the Package Repository Client, the following prerequisites must be met:

The tls package available for use by the local Tcl installation; the IronTcl distribution already includes it.
An implementation of the OpenPGP standard that includes appropriate command-line tools (e.g. GPG ).
The Package Client Toolset , added to the auto_path of the local Tcl installation.
The Package Signing Key (dated "2003-06-09", with fingerprint C3C7 5138 83EE DD3A ED1F E425 502C 96AF 495D C2D9 ) on your local OpenPGP key ring.

Currently, Package Repository Client is in the beta testing phase.

There are an extremely limited set of packages available and all access is controlled via API keys.

To request access in order to add the packages that you maintain, please contact Joe Mistachkin. Please include your public OpenPGP key so that it can be added to the appropriate key ring(s).

For those simply wanting to examine the client code, which is Tcl licensed, it can be found here .

Important Notes

The GPG executable ("gpg2") must reside along the PATH.
When using Eagle, the Harpy packages and their associated license certificates must be available.

How to use with Eagle Beta 50 or later:

  # NOTE: When troubleshooting, use the following commands first...
  namespace eval ::Eagle::Tools::Common {variable verboseGetUrl true}
  namespace eval ::PackageRepository {variable verboseUnknownResult true; variable verboseUriDownload true}
  namespace eval ::PackageDownloader {variable quiet false; variable verboseTemporaryDirectory true}

  # NOTE: Download and load the Package Client Toolset...
  loadPackageClientToolset [downloadAndExtractPackageClientToolset]

  # NOTE: Test that the Package Client Toolset is working...
  package require ZZZ.Test; # NOTE: Should (eventually) result in "0.0"

How to use with IronTcl:

Download the Package Client Toolset from here .
Extract the resulting ZIP file to a local directory.
Add the local directory from the previous step joined with "client/1.0/neutral" to the auto_path.
Evaluate the following commands:

  # NOTE: When troubleshooting, use the following commands first...
  namespace eval ::Eagle::Tools::Common {variable verboseGetUrl true}
  namespace eval ::PackageRepository {variable verboseUnknownResult true; variable verboseUriDownload true}
  namespace eval ::PackageDownloader {variable quiet false; variable verboseTemporaryDirectory true}

  # NOTE: Load the Package Client Toolset...
  package require Eagle.Package.Repository

  # NOTE: Test that the Package Client Toolset is working...
  package require ping; # NOTE: Should (eventually) result in "0.0"

Other distributions of Tcl/Tk can also be used; however, they will need to have the http and tls packages already available as HTTPS is a hard-and-fast requirement.

Category Repository

Category Package