fontaine 1.3.7

Fontaine font tool

pyfontaine analyses fonts for their language and character/glyph-set support.

It has a straightforward pythonic set definition format:

• simple example

• medium example

• complex example

Additional definitions are downloaded from the Extensis, font-config and Unicode websites during installation, and can be updated without reinstalling.

Adding your own definitions is easy. All files in the internals directory are auto-detected, so just add definition files there.

Installation

On Mac OS X, install the pyicu dependency as follows:

CFLAGS=-I/usr/local/opt/icu4c/include LDFLAGS=-L/usr/local/opt/icu4c/lib pip install pyicu;

Install the latest release easily with the pip installer:

sudo pip install fontaine

To install the latest development version:

sudo pip install https://github.com/davelab6/pyfontaine.git;

Usage

Given a list of space separated font filenames, it returns a report with some general metadata and a language support analysis:

sh pyfontaine font.ttf;

Given a list of space separated unicode characters, or unicode values, it returns a list of character sets that include that character:

pyfontaine 0x0061;
pyfontaine ğ ø ∂;

To output font reports in various formats:

pyfontaine --xml font.ttf;
pyfontaine --json font.ttf;
pyfontaine --csv font.ttf;
pyfontaine --wiki font.ttf;

The –wiki format produces a MediaWiki table (example <https://en.wikipedia.org/wiki/DejaVu_fonts#Unicode_coverage>__)

To only show character sets from different collections:

pyfontaine --collections all font.ttf; # default
pyfontaine --collections pyfontaine font.ttf;
pyfontaine --collections uniblocks font.ttf;
pyfontaine --collections extensis font.ttf;
pyfontaine --collections fontconfig font.ttf;
pyfontaine --collections cldr font.ttf;
pyfontaine --collections subsets font.ttf;

To only show specific character sets:

pyfontaine --set African,'Basic Latin','GWF vietnamese' font.ttf;

To print a list of all the missing unicode values from each set:

pyfontaine --missing font.ttf;

To output visualisations of the coverage using Hilbert curves (thanks for the idea, Øyvind ‘pippin’ Kolås!):

sh pyfontaine –coverage font.ttf; ls -l coverage_pngs/;

The PNG files are stored in a new directory, coverage_pngs, under the current directory.

Update collection data

You can update remote collections data when you are online:

python –update-data 1;

Python Module

It has a python module. Here is an example script from the Font Bakery project.

Contributing

Your contributions under the GPLv3 are welcome!

pyfontaine is a python reimplementation of Fontaine by Ed Trager, and has been made by by Vitaly Volkov, Dave Crossland and Mikhail Kashkin.

Thanks

We would like to thank some upstream projects that make pyfontaine even more useful: * Thomas Phinney for the WebINK Character Sets * Behdad Esfabod for the font-config languages definitions * Unicode Consortium for the Unicode Blocks

Dependencies

• Mac OS X requires the XCode Command Line Tools to be installed

• fonttools (common) or freetype-py (fast)

• lxml

• PyICU

• simpleHilbertCurve

• matplotlib

Related Projects

• fontaine

• fontbakery

• libunicodenames