# Created by: Adam Saponara <as@php.net>

# $FreeBSD

PORTNAME=		termbox

DISTVERSION=	1.1.2

PORTREVISION=	1

CATEGORIES=		devel

MAINTAINER=		as@php.net

COMMENT=		Legacy-free alternative to ncurses

USES=			python:2.7,build waf

USE_GITHUB=		yes

GH_ACCOUNT=		nsf

GH_TAGNAME=		v1.1.2

PLIST_FILES=	include/termbox.h \

				lib/libtermbox.so.1.0.0 \

				lib/libtermbox.so.1 \

				lib/libtermbox.so \

				lib/libtermbox.a

.include <bsd.port.mk>

Termbox is a library that provides minimalistic API which allows the 

programmer to write text-based user interfaces.

It is based on a very simple abstraction. The main idea is viewing 

terminals as a table of fixed-size cells and input being a stream of 

structured messages. Would be fair to say that the model is inspired 

by windows console API. The abstraction itself is not perfect and it 

may create problems in certain areas. The most sensitive ones are 

copy & pasting and wide characters (mostly Chinese, Japanese, Korean 

(CJK) characters). When it comes to copy & pasting, the notion of 

cells is not really compatible with the idea of text. And CJK runes 

often require more than one cell to display them nicely. Despite the 

mentioned flaws, using such a simple model brings benefits in a form 

of simplicity. And KISS principle is important.

At this point one should realize, that CLI (command-line interfaces) 

aren't really a thing termbox is aimed at. But rather 

pseudo-graphical user interfaces.

WWW: https://github.com/nsf/termbox