vfbLib 0.4.2__tar.gz → 0.4.3__tar.gz

vfbLib-0.4.3/DESCRIPTION.md

@@ -0,0 +1,103 @@
+# vfbLib
+
+Converter and deserializer for FontLab Studio 5 VFB files.
+
+FontLab’s own `vfb2ufo` converter is from 2015, only outputs UFO v2, and
+contains serious bugs that are never going to be fixed. Its support on macOS is
+subject to Apple’s mercy (no native support for Apple Silicon).
+
+That’s why a single determined programmer with a hex editor set out to rectify
+this situation.
+
+
+## Improvements Over vfb2ufo
+
+- Outputs normalized UFO v3
+- Outputs FontLab user data (font and glyph level)
+- Mark colors are written to the official UFO v3 lib key
+- Guideline data is written to the official UFO v3 elements
+- Anchors are preserved in composite glyphs
+- PostScript hinting is written correctly, but to the Adobe lib key
+- Supports more UFO font info attributes:
+  - `openTypeGaspRangeRecords`
+  - `openTypeHeadLowestRecPPEM`
+  - `openTypeNameRecords`
+  - `openTypeOS2WeightClass` is written correctly
+
+
+## Command Line Script Usage
+
+### vfb3ufo
+
+Convert a VFB to one UFO per master. Command line options are compatible to
+FontLab’s `vfb2ufo`, but not all of them are implemented yet.
+
+```bash
+$ vfb3ufo MyFile.vfb
+```
+
+will convert the file to `MyFile.ufo` in the same directory. Existing files will
+not be overwritten unless you specify the `-fo` option.
+
+```
+vfb3ufo -h
+usage: vfb3ufo [-h] [-p PATH] [-fo] [-ttx] [-64] [-s] [-nops] [-z] [-m] inputpath [outputpath]
+
+VFB3UFO Converter Copyright (c) 2022 by LucasFonts Build 2022-12-12
+
+positional arguments:
+  inputpath             input file path (.vfb)
+  outputpath            output file path (.ufo[z])
+
+options:
+  -h, --help            show this help message and exit
+  -p PATH, --path PATH  output folder
+  -fo, --force-overwrite
+                        force overwrite
+  -64, --base64         write GLIF lib 'data' section using base64 (recommended)
+  -s, --silent          no display (silent mode)
+
+Additional options:
+
+  -m, --minimal         parse only minimal amount of data, drop missing glyphs from groups, etc.
+  -nops, --no-postscript-hints
+                        Don't output PostScript hinting
+
+Unimplemented options:
+
+  -ttx, --ttx           convert binary OpenType Layout data using TTX-like format
+  -z, --zip             write UFOZ (compressed UFO)
+```
+
+
+### vfb2json
+
+Generate a representation that closely adheres to the VFB structure.
+
+```bash
+$ vfb2json MyFile.vfb
+```
+
+will convert the file to `MyFile.json` in the same directory. Existing files will be overwritten.
+
+We expect this to be mostly used for debugging purposes.
+
+```
+vfb2json -h
+usage: vfb2json [-h] [-m] [-p PATH] inputpath
+
+VFB2JSON Converter Copyright (c) 2022 by LucasFonts Build 2022-11-08
+
+positional arguments:
+  inputpath             input file path (.vfb)
+
+options:
+  -h, --help            show this help message and exit
+  -m, --minimal         parse only minimal amount of data
+  -p PATH, --path PATH  output folder
+```
+
+
+## Copyright
+
+© 2022 by [LucasFonts GmbH](https://www.lucasfonts.com/), Berlin

{vfbLib-0.4.2 → vfbLib-0.4.3}/Lib/vfbLib/ufo/__init__.py

@@ -248,11 +248,12 @@ class VfbToUfoWriter:
                     name = "%s%02i" % (dname, i)
                     i += 1
                 if name in lib:
-                    logger.error(
-                        f"ERROR: Duplicate TrueType stem name '{name}'. "
-                        "Make stem names unique in VFB."
+                    oldname = name
+                    name = "%s#%02i" % (oldname, i)
+                    logger.warning(
+                        f"Duplicate TrueType stem name '{oldname}', renamed to '{name}'"
+                        ". Preferably make stem names unique in VFB."
                     )
-                    raise KeyError
                 lib[name] = stem
         if lib:
             self.lib[TT_LIB_KEY]["stems"] = lib

{vfbLib-0.4.2 → vfbLib-0.4.3}/Lib/vfbLib/ufo/groups.py

@@ -48,17 +48,22 @@ def transform_groups(
                         logger.warning("Not adding empty kerning group to the UFO.")
                         continue
 
-            key_glyph = glyphs[0]  # Keyglyph is used for group name
-            if key_glyph in missing:
-                if num_missing != num_glyphs:
-                    logger.warning(
-                        f"Key glyph '{key_glyph}' for group '{name}' is missing "
-                        "from the font."
-                    )
-
-            # Sort group glyphs by glyphOrder
-            if not missing:
-                glyphs.sort(key=lambda n: glyphOrder.index(n))
+            if glyphs:
+                key_glyph = glyphs[0]  # Keyglyph is used for group name
+                if key_glyph in missing:
+                    if num_missing != num_glyphs:
+                        logger.warning(
+                            f"Key glyph '{key_glyph}' for group '{name}' is missing "
+                            "from the font."
+                        )
+
+                # Sort group glyphs by glyphOrder
+                if not missing:
+                    glyphs.sort(key=lambda n: glyphOrder.index(n))
+            else:
+                # The group is empty, use its original name to build the ufo group name
+                groups[name] = []
+                key_glyph = name
 
             if name in kerning_class_flags:
                 flags = kerning_class_flags[name][0]

{vfbLib-0.4.2 → vfbLib-0.4.3}/Lib/vfbLib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vfbLib
-Version: 0.4.2
+Version: 0.4.3
 Summary: Tools for converting FontLab Studio 5 (VFB) files.
 Home-page: https://pypi.org/project/vfblib/
 Author: Jens Kutilek

{vfbLib-0.4.2 → vfbLib-0.4.3}/Lib/vfbLib.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+DESCRIPTION.md
 LICENSE
 README.md
 pyproject.toml

{vfbLib-0.4.2 → vfbLib-0.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vfbLib
-Version: 0.4.2
+Version: 0.4.3
 Summary: Tools for converting FontLab Studio 5 (VFB) files.
 Home-page: https://pypi.org/project/vfblib/
 Author: Jens Kutilek

{vfbLib-0.4.2 → vfbLib-0.4.3}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = vfbLib
-version = 0.4.2
+version = 0.4.3
 description = Tools for converting FontLab Studio 5 (VFB) files.
 long_description = file: DESCRIPTION.md
 long_description_content_type = text/markdown; charset=UTF-8