Skip to main content

A bridge from Glyphs source files (.glyphs) to UFOs

Project description

Travis Build Status PyPI Version Codecov Join the chat at https://gitter.im/fonttools-dev/glyphsLib

glyphsLib

This library provides a bridge from Glyphs source files (.glyphs) to UFOs and Designspace files via defcon and designspaceLib.

The main methods for conversion are found in __init__.py. Intermediate data can be accessed without actually writing UFOs, if needed.

Write and return UFOs

The following code will write UFOs and a Designspace file to disk.

import glyphsLib

master_dir = 'master_ufos'
ufos, designspace_path = glyphsLib.build_masters('MyFont.glyphs', master_dir)

If you want to interpolate instances, please use fontmake instead. It uses this library under the hood when dealing with Glyphs files.

Load UFO objects without writing

import glyphsLib

ufos = glyphsLib.load_to_ufos('MyFont.glyphs')

Read and write Glyphs data as Python objects

from glyphsLib import GSFont

font = GSFont(glyphs_file)
font.save(glyphs_file)

The glyphsLib.classes module aims to provide an interface similar to Glyphs.app’s Python Scripting API.

Note that currently not all the classes and methods may be fully implemented. We try to keep up to date, but if you find something that is missing or does not work as expected, please open a issue.

Go back and forth between UFOs and Glyphs

  1. You can use the ufo2glyphs and glyphs2ufo command line scripts to round-trip your source files. By default, the scripts try to preserve as much metadata as possible.

    # Generate master UFOs and Designspace file
    glyphs2ufo Example.glyphs
    
    # Go back
    ufo2glyphs Example.designspace
    
    # You can also combine single UFOs into a Glyphs source file.
    ufo2glyphs Example-Regular.ufo Example-Bold.ufo
  2. Without a designspace file, using for example the Inria fonts by Black[Foundry]:

    import glob
    from defcon import Font
    from glyphsLib import to_glyphs
    
    ufos = [Font(path) for path in glob.glob('*Italic.ufo')]
    # Sort the UFOs because glyphsLib will create masters in the same order
    ufos = sorted(ufos, key=lambda ufo: ufo.info.openTypeOS2WeightClass)
    font = to_glyphs(ufos)
    font.save('InriaSansItalic.glyphs')

    Here is the resulting glyphs file

  3. With a designspace, using Spectral from Production Type:

    import glob
    from fontTools.designspaceLib import DesignSpaceDocument
    from glyphsLib import to_glyphs
    
    doc = DesignSpaceDocument()
    doc.read('spectral-build-roman.designspace')
    font = to_glyphs(doc)
    font.save('SpectralRoman.glyphs')

    Here is the resulting glyphs file

  4. In both programmatic cases, if you intend to go back to UFOs after modifying the file with Glyphs, you should use the minimize_ufo_diffs parameter to minimize the amount of diffs that will show up in git after the back and forth. To do so, the glyphsLib will add some bookkeeping values in various userData fields. For example, it will try to remember which GSClass came from groups.plist or from the feature file.

The same option exists for people who want to do Glyphs->UFOs->Glyphs: minimize_glyphs_diffs, which will add some bookkeeping data in UFO lib. For example, it will keep the same UUIDs for Glyphs layers, and so will need to store those layer UUIDs in the UFOs.

import glob
import os
from fontTools.designspaceLib import DesignSpaceDocument
from glyphsLib import to_glyphs, to_designspace, GSFont

doc = DesignSpaceDocument()
doc.read('spectral-build-roman.designspace')
font = to_glyphs(doc, minimize_ufo_diffs=True)
doc2 = to_designspace(font, propagate_anchors=False)
# UFOs are in memory only, attached to the doc via `sources`
# Writing doc2 over the original doc should generate very few git diffs (ideally none)
doc2.write(doc.path)
for source in doc2.sources:
    path = os.path.join(os.path.dirname(doc.path), source.filename)
    # You will want to use ufoNormalizer after
    source.font.save(path)

font = GSFont('SpectralRoman.glyphs')
doc = to_designspace(font, minimize_glyphs_diffs=True, propagate_anchors=False)
font2 = to_glyphs(doc)
# Writing font2 over font should generate very few git diffs (ideally none):
font2.save(font.filepath)

In practice there are always a few diffs on things that don’t really make a difference, like optional things being added/removed or whitespace changes or things getting reordered…

Project details


Release history Release notifications | RSS feed

This version

3.3.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glyphsLib-3.3.1.zip (901.4 kB view details)

Uploaded Source

Built Distribution

glyphsLib-3.3.1-py2.py3-none-any.whl (733.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file glyphsLib-3.3.1.zip.

File metadata

  • Download URL: glyphsLib-3.3.1.zip
  • Upload date:
  • Size: 901.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3

File hashes

Hashes for glyphsLib-3.3.1.zip
Algorithm Hash digest
SHA256 bdae5f4f13627ecb94098693c870ba5fbc1e773c3642ca7af05026b04571c98f
MD5 d52db65b465f960e811960e980838dcd
BLAKE2b-256 90882d37c6869784fd68ca6e925ac9c6bf51e4a0df1a922d36b1febdbb5846af

See more details on using hashes here.

Provenance

File details

Details for the file glyphsLib-3.3.1-py2.py3-none-any.whl.

File metadata

  • Download URL: glyphsLib-3.3.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 733.8 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.6.3

File hashes

Hashes for glyphsLib-3.3.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 cec8309a1105ccb2aeed0a543a1f2a056ef5851418a6ea5ebdc00742e25fa106
MD5 384ac65e4b2aad130ba3af0dfa938053
BLAKE2b-256 14d51e716b2065699267ce8fe3591e51a915c22ec963a43b56570490ce86c56d

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page