TerminalApps Windows, Mac, Linux, DOS game

# TerminalApps v 1.0.8

## Introduction
TerminalApps contains F.O.S.S. puzzle games that can be run on any terminal in any OS that has a gnat compiler.

There are 11 apps: trush, tslid, t7, taz, tsok, tpan, thio, thio4, t9, tdd, tpac.

=====================================================================
### terminal-pacman (tpac.adb)
A minimalist version of Pacman with 9 predefined levels. Playable now, with further improvements expected.

### terminal-7 (t7.adb), terminal-A2Z (taz.adb)

t7 is a flat representation of a 2x2x2 cube with one missing that allows sliding permutations. Here, the 8-1 elements are labelled 1..7.

taz is a flat representation of a 3x3x3 cube with one missing that allows sliding permutations. The 27-1 elements are conveniently labelled with the english alphabet.

Both the "taz" and "t7" puzzles work the same:

* note the original order, and blank location;
* mix;
* then restore.

A character in an adjacent row, column, or layer may be moved to the empty space using the keyboard.

Pressing the (home) key on a typical keyboard produces the character 'H'. So assuming that (home)=>'H', (end)=>'F', (up)=>'A', etc...
the key mapping follows:

* (1)..(5): mix; higher values are more difficult.

* (up),(i): north
* (dn),(k): south
* (rt),(l): east
* (lt),(j): west
* (home),(\),(u),(.),(-): layer-up
* (end),(/),(o),(+): layer-dn

* (?): help
* (q): quit

### terminal-rush (trush.adb)

Horizontal and vertical strings of letters represent cars and trucks in a crowded parking garage. The objective is to move them around lengthwise in order to be able to get car "a" to the exit, which is either at the right or top of the garage. Note that the last digits in each puzzle name represents the minimum number of moves to win.

### terminal-block (tslid.adb), terminal-dirtydozen (tdd.adb)

Blocks of letters can be moved wherever there is space. The objective is to move the block labelled "a" to an indicated goal position.

Also, a tslid solver named bfs has been added. The command line is "bfs puzzle-file-name". Compile it with the command "ccc.sh bfs".

#### Gameplay:
First, one selects a block or vehicle by typing its identifier letter. Then use the arrow keys to move it. Here, "?" toggles the help screen. Note that manual selection is not always necessary as there is an auto-select mechanism for those times when only one selection may move in a given direction. The "+" and "-" keys [next, previous] are used to cycle through the large number of predefined puzzles.

### terminal-sokoban (tsok.adb)

Move the pusher >< with the arrow keys in order to push all the boxes [] onto the goals :: in which case they look like {}. Various other functions available on the help screen. Includes a very large family of puzzle files.

A sokoban solver named trbfs has been added. It uses a brute-force reverse breadth-first search with no heuristics and a splay tree to store and check for previously seen configurations. The command line is "trbfs puzzle-file-name max-levels level-number". Note that the max-levels is embedded into the puzzle file name.

The output file (named similarly to the input file) contains directions from the set {u,d,l,r,U,D,L,R}, where upper case indicates a push. It is size-limited to 17 or fewer boxes, and 128 or fewer interior puzzle positions. Compile it with the command "ccc.sh trbfs".

There are many cases this solver cannot handle, but it is pretty good at sovling certain types of puzzles, particularly the more dense ones. It is not very good at the near-Lishout type, if you know what that means.

### Terminal-HoleInOne (thio.adb, thio4.adb)
Move the 2x2 'a' block into the center of the four L-shaped corner pieces.

### terminal-panama (tpan.adb)
Move letters to spell "panama canal" !

### terminal-Nine (t9.adb)
Reverse the order of the numbered blocks.

===============================================================
## Build Instructions:
Manually install GNAT GPL from libre.adacore.com/download/. If you don't like my key-mappings, edit the code as you like.

Next, edit the script "cmp.sh" so that the path to gnatmake is temporarily prepended to the PATH environment variable. This script streamlines the build process by allowing auxilliary libraries and files to be neatly hidden in subdirectories. And make sure it is executable.

Then type "cmp.sh game", where game is in the set {t7, taz, trush, tslid, tsok, tpan, thio, thio4, t9, tdd, tpac} to create a command-line executables for your system.

===============================================================
## Running:
Your terminal must accept the "clear" command, and must be 50 chars wide by 20 lines (57x35 for pacman). Simply type the executable name to begin.

===============================================================
## Legal Mumbo Jumbo:

TerminalApps is covered by the GNU GPL v3 as indicated in the sources:

Copyright (C) 2016 <fastrgv@gmail.com>

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You may read the full text of the GNU General Public License
at <http://www.gnu.org/licenses/>.

----------------------------------------------
## Other Credits and Thanks:
Serhiy Grabarchuk and Peter Grabarchuk for their "Hole in One", "Hole in One plus 4", and "Nine" puzzles.

Mike Billars [michael@gmail.com] for his C-version of Pacman for the console, after which this Ada version was modelled (gnu gpl).

----------------------------------------------
## Best Download Site for all my games:
Github.com