A port of the python library fabulous to C
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
include
src
test
.gitignore
.travis.yml
LICENSE
Makefile
README.md
Tupfile
test.c

README.md

libfab - Version 0.1.0

A port of the python library fabulous to C

The python library fabulous is as the name implies, fabulous. however it hasn't seen an update in a while. libfab is a port of the core functionality of fabulous to C. Once it is ported wrappers to other languages can be made. I'm working on this to improve my knowledge of C, and to improve upon a library I enjoy using.

Dependencies

  • ImageMagick

Building

You can use either make or tup to build libfab.

To use tup, clone it git clone https://github.com/gittup/tup and use their bootstrap.sh script to build the tup binary.

Once tup is built, you need to run tup init the first time, then all subsequent builds you can use tup upd or just tup to rebuild libfab and its libraries.

Testing

In order to run the unit tests you will need to install CUnit.

make test

Testing Status

  • Text formating
  • Colors
  • Highlight Colors
  • Background Colors
  • 256 colors
  • Images
  • Buffer Implementation

Porting Status

  • Text Formatting
  • Basic Text Coloring
  • 256color text Coloring
  • Color Complements
  • Advanced Color specification
  • Images -> ASCII

Bindings

libfab is designed to be used in conjunction with various language bindings. Currently there are bindings for Python and DLang

Attribution

The original Fabulous was a huge inspiration, and the existing code was a huge help in writing libfab

The xterm, RGB conversion code, the algorithm for rendering images in the terminal, and the rest of fabulous were created by Justine Tunney.