Upsh 2.3


Upsh stands for Unix to Prolog shell. It is a Prolog program which can be used to run Prolog programs from the command line or as scripts. It origianlly ran on three prolog engines: SICStus, SWI and Yap without changes to the source code.

With version 2.*, Upsh has all the features I had envisaged and many which I just thought of on the way. It is also fairly stable. The development now has switched to SWI and upsh is also provided as an easy to install SWI pack. It is unlikely there will be any major releases in the future. I will of course fix any bugs reported or add features that are interesting. For reporting a bug or feature requests contact me.

If you use Upsh for a while I would appreciate an email with the kind of scripts you using it with.

The pack has a single main predicate which creates an executable state that provides a convenient way of executing prolog scripts for the command line. The state can be invoked by calling the created executable (upsh) on command line. By default the upsh binary is placed in same directory as the swipl executable. Only tested on linux. Install:

?- pack_install(upsh).
Load the pack.
?- use_module(library(upsh)).
Create the executable.
?- upsh_make.
test.
?- halt.

cd /upsh/scripts
-- ask your shell to re-read its executables with something like: rehash
upsh say naku

%  /home/nicos/.rcpl compiled 0.00 sec, 8 clauses
% /home/nicos/bin/cline_upsh/say.pl compiled 0.00 sec, 5 clauses
naku
lykos;upsh/scripts% upsh v
Upsh (2:1:0)-swi(7:5:7)-(2017/6/3-0:49:0)

The executable will look at $HOME/bin/cline for scripts, so you use it for scripts
that operate on os objects.

It will also convert os friendly arguments to Prolog terms:

upsh say a=b

upsh say a=b
%  /home/nicos/.rcpl compiled 0.00 sec, 8 clauses
% /home/nicos/bin/cline_upsh/say.pl compiled 0.00 sec, 5 clauses
a(b)
The executable takes a number of one letter flags:
upsh say p a=b
%  /home/nicos/.rcpl compiled 0.00 sec, 8 clauses
a(b)

upsh say f p a=b
a(b)
By default the executable looks into script say.pl for main/0, main/1, main/n, say/0, say/1, say/n and calls it with the appropriate number of arguments.

Sources: upsh
ReleaseNotes.txt
upsh-manual.ps.gz
Readme.txt

The manual, which is effectively an extended version of my WLPE 2004 paper is also in doc/upsh-manual.ps in the above .tgz file.


Last update 2018/5/2
Nicos Angelopoulos