everslick / push Goto Github PK

The Petite Un*x Shell.

push is a very small, yet feature rich shell for embedded systems. It is built on top of a stripped down version of the linenoise line editing library.

push thus inherits TAB completion, history and hints (suggestions at the right of the prompt as you type) while providiing rich line editing features like cursor movment, inserting text at the current cursor position, jumping to the first (HOME) or last (END) position of the input buffer, deleting the last word and more.

push is intended to be cross platform. Currently it builds on GNU/Linux (gcc) for easy testing and development, and can be cross compiled for:

• C64 with cc65
• ZX Spectrum with z88dk
• Atari800 with cc65
• Spectrum Next with z88dk
• MEGA65 with kickc

While it builds successfully for all those target platforms, it is only really working well on Linux and C64 (and most recently on ZX-Spectrum). The main reason is lacking/broken support for some features from the C runtime libraries on some platforms, most important CONIO and heap management. Hopefully over time the toolchains will provide those APIs.

Please keep in mind, that push, at its current state, is an experiment (proof-of-concept) and not of much practical use. Nevertheless it is fun to see the test command do its work, so give it a shot.

You need the toolchain you want to build with installed parallel to the push source like this:

cc65/  kickc/  push/  z88dk/

The Makefile in ./push/src contains various targets for compiling and testing:

• make (build linux binary)
• make c64 (build C64 prg)
• make m65 (build MEGA65 prg)
• make zx (build zx spectrum tap)
• make zx64 (build zx spectrum tap with 64 columns)
• make zxn (build spectrum next tap)
• make c64emu (start prg in vice)
• make m65emu (start prg in xemu)
• make zxemu (start tap in zesarux)
• make zx64emu (start 64 columns tap in zesarux)

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 should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.