Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
doc
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 

croatoan

Introduction

croatoan is a set of bindings to the ncurses terminal library for Common Lisp.

It is inspired by, but not derived from, cl-ncurses and cl-charms.

The API is not yet stable, but the already finished parts are not expected to change much.

It is developed and tested on Ubuntu 20.04 x86_64 and SBCL 2.0.10.

The only supported ncurses version is 6.x –with-abi-version=6. Version 5.9 mostly works, but I will focus new efforts on 6.x.

If your distribution still ships ncurses –with-abi-version=5, for full compatibility (wide characters, 256 colors and extended mouse support), you will have to manually build ncurses 6.x.

Goals

Its main goal is to provide a higher-level, lispy/CLOSy interface, whereas the existing bindings clone the cryptic C API.

As of now, the library is in an early, but hopefully usable stage. Ncurses is old and huge and it will take a while to cover completely.

A second goal is to reimplement the extension libraries forms, menu and dialog in Lisp instead of wrapping the C libraries.

A third, distant goal is to provide direct bindings for ANSI escape sequences, so that basic terminal control functions can be used from Lisp on systems without terminfo and ncurses.

Usage

The library is available in Quicklisp and can be installed with

(ql:quickload "croatoan")

Systems and packages

LibrarySystemPackageShort nickname
Higl-level CLOS APIcroatoancroatoancrt
Low-level ncurses bindingscroatoan-ncursesncurses
ANSI X3.64 escape sequencesansi-escapeansi-escapeesc

Documentation

The documentation is currently provided by the docstrings and the commented examples.

SLIME/Thread support

Since ncurses is not thread-safe, all IO has to occur in the main thread of the REPL running in a terminal.

This makes it difficult to interact with ncurses from the Emacs SLIME REPL which runs in its own thread.

A workaround is to pass all ncurses IO to the main thread via a thread-safe queue. Basic support for this has been implemented.

A tutorial on interacting with ncurses from swank/slime is available in docs/slime.md

Contributing

You are welcome to contribute and any form of help would be greatly appreciated.