What is stackato-cli?

This repository contains the source code to the Stackato Platform-as-a-Service command line client, written in Tcl.

Prerequisites

1. Install ActiveTcl 8.5 somewhere (INSTALLDIR)

2. Put the INSTALLDIR/bin directory of the above installation on the PATH.

3. Install Tcl library dependencies using one of the following options:

   • (UNIX-only) run tools/depends.sh to automatically install the below list of packages.

   • run the command INSTALLDIR/bin/teacup update to get and install all packages provided by ActiveState's TEApot repository for your platform.

   • Run the command INSTALLDIR/bin/teacup install <package> for the following packages (may require sudo privileges depending on platform)

   • TclOO

   • Tclx

   • Trf

   • autoproxy

   • base64

   • cmdline

   • control

   • crc32

   • fileutil

   • fileutil::decode

   • fileutil::magic::mimetype

   • fileutil::magic::rt

   • fileutil::traverse

   • json

   • json::write

   • linenoise

   • logger

   • md5

   • ncgi

   • report

   • sha1

   • snit 2

   • struct::list

   • struct::matrix

   • tar

   • tcl::chan::cat

   • tcl::chan::core

   • tcl::chan::events

   • tcl::chan::string

   • tcllibc ; # to speed up md5, sha1, crc32, base64

   • tclyaml

   • term::ansi::code

   • term::ansi::code::attr

   • term::ansi::code::ctrl

   • term::ansi::ctrl::unix

   • textutil::adjust

   • textutil::repeat

   • textutil::string

   • tls

   • twapi ; # windows only

   • uri

   • uuid

   • zipfile::decode

   • zipfile::encode

   • zlibtcl

4. Either

   • make a link INSTALLDIR/bin/tclsh to INSTALLDIR/bin/tclsh8.5
   • copy the file
   • edit bin/stackato to use 'tclsh8.5' instead of 'tclsh' in its #! line

5. Run bin/stackato as you see fit.

Structure of the client

See the file doc/devguide.txt for more information on the internals.