zshellcli - Call the Zope Zshell Externally

shellcli allows the execution of Zope Zshell commands from the command line or from script files.

You must have a running instance of Zope to use this, with an a Zope zshell "External Method" instantiated on the "acquisition path" from the initial folder of the open command (see below), and the user specified in the must be have the "View" permission to the zshell instance.

See zope-zshell(3) for description on how to create the Zope Zshell instance, and for a list of the commands that zope-zshell offers. Full details of the Zope Zshell commands can be found using the URL as given in the zope-zshell man page.

Additionally, zshellcli supports five more commands. These are open, close, help, exit, and quit. Exit and quit are synonymous.

The open command has format:

open URI user_id password

An example is:

open http://localhost:9673/ joe some_pass

Note that if folder foo is in your zope root, you can use;

open http://localhost:9673/foo joe some_pass

with the expected result of having foo as your current working folder.

The help command lists the five available commands.

The close command closes the currently opened connection.

The exit or the quit command close the instance of zshellcli and exit the process. You may also close the instance by using control-d or otherwise reaching end-of-file (EOF).

Commands may either be entered from the prompt, or may be fed as the standard input of zshellcli. That is, if my_script is a file containing an open, a sequence of valid Zope zshell commands, and then a quit or exit, then:

zshellcli <my_script

will execute the sequence of commands.

If you are using script files, a valid userid and password are available to anyone who can read the script. Do not make script files world readable!

Commands may be editted using all of the usual readline capabilities. Tab completion is functional, but only in the current working directory.

To accomplish this, a command history is kept. The directory conmtaining this file, and the file itself have been created in mode 0700. Be extremely careful about changing the permissions on the and passwords may be in the history file.

Zope security is subtle. Be sure that you trust any user given the ability to use zshellcli!

zope-zshell(3)

Your command history is kept in a file, ~/.zope-zshell/history.

This manual page was written by James W. Penny <jpenny@debian.org> for the Debian GNU/Linux system (but may be used by others).