python-fontbro 0.23.0__tar.gz → 0.24.0__tar.gz

{python_fontbro-0.23.0/python_fontbro.egg-info → python_fontbro-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-fontbro
-Version: 0.23.0
+Version: 0.24.0
 Summary: friendly font operations on top of fontTools.
 Author-email: Fabio Caccamo <fabio.caccamo@gmail.com>
 Maintainer-email: Fabio Caccamo <fabio.caccamo@gmail.com>
@@ -118,6 +118,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_style_flag`](#get_style_flag)
 -   [`get_style_flags`](#get_style_flags)
 -   [`get_style_name`](#get_style_name)
+-   [`get_svg`](#get_svg)
 -   [`get_ttfont`](#get_ttfont)
 -   [`get_unicode_block_by_name`](#get_unicode_block_by_name)
 -   [`get_unicode_blocks`](#get_unicode_blocks)
@@ -133,6 +134,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_vertical_metrics`](#get_vertical_metrics)
 -   [`get_weight`](#get_weight)
 -   [`get_width`](#get_width)
+-   [`is_color`](#is_color)
 -   [`is_monospace`](#is_monospace)
 -   [`is_static`](#is_static)
 -   [`is_variable`](#is_variable)
@@ -449,6 +451,23 @@ Gets the style name reading the name records with priority order (17, 22, 2).
 style_name = font.get_style_name()
 ```
 
+#### `get_svg`
+```python
+"""
+Gets an SVG representation of the font rendering
+some text using the given options.
+
+:param text: The text to be rendered as SVG paths.
+:type text: str
+:param size: The size of the font to be used for rendering the text, in points.
+:type size: int
+
+:returns: An SVG string that represents the rendered text.
+:rtype: str
+"""
+svg_str = font.get_svg(text="Hello!", size=48)
+```
+
 #### `get_ttfont`
 ```python
 """
@@ -642,11 +661,25 @@ Gets the font width value and name.
 width = font.get_width()
 ```
 
+#### `is_color`
+```python
+"""
+Determines if the font is a color font.
+
+:returns: True if color font, False otherwise.
+:rtype: bool
+"""
+color = font.is_color()
+```
+
 #### `is_monospace`
 ```python
 """
 Determines if the font is a monospace font.
 
+:param threshold: The threshold (0.0 <= n <= 1.0) of glyphs with the same width to consider the font as monospace.
+:type threshold: float
+
 :returns: True if monospace font, False otherwise.
 :rtype: bool
 """

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/README.md

@@ -56,6 +56,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_style_flag`](#get_style_flag)
 -   [`get_style_flags`](#get_style_flags)
 -   [`get_style_name`](#get_style_name)
+-   [`get_svg`](#get_svg)
 -   [`get_ttfont`](#get_ttfont)
 -   [`get_unicode_block_by_name`](#get_unicode_block_by_name)
 -   [`get_unicode_blocks`](#get_unicode_blocks)
@@ -71,6 +72,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_vertical_metrics`](#get_vertical_metrics)
 -   [`get_weight`](#get_weight)
 -   [`get_width`](#get_width)
+-   [`is_color`](#is_color)
 -   [`is_monospace`](#is_monospace)
 -   [`is_static`](#is_static)
 -   [`is_variable`](#is_variable)
@@ -387,6 +389,23 @@ Gets the style name reading the name records with priority order (17, 22, 2).
 style_name = font.get_style_name()
 ```
 
+#### `get_svg`
+```python
+"""
+Gets an SVG representation of the font rendering
+some text using the given options.
+
+:param text: The text to be rendered as SVG paths.
+:type text: str
+:param size: The size of the font to be used for rendering the text, in points.
+:type size: int
+
+:returns: An SVG string that represents the rendered text.
+:rtype: str
+"""
+svg_str = font.get_svg(text="Hello!", size=48)
+```
+
 #### `get_ttfont`
 ```python
 """
@@ -580,11 +599,25 @@ Gets the font width value and name.
 width = font.get_width()
 ```
 
+#### `is_color`
+```python
+"""
+Determines if the font is a color font.
+
+:returns: True if color font, False otherwise.
+:rtype: bool
+"""
+color = font.is_color()
+```
+
 #### `is_monospace`
 ```python
 """
 Determines if the font is a monospace font.
 
+:param threshold: The threshold (0.0 <= n <= 1.0) of glyphs with the same width to consider the font as monospace.
+:type threshold: float
+
 :returns: True if monospace font, False otherwise.
 :rtype: bool
 """

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/fontbro/font.py

@@ -1,10 +1,12 @@
 from __future__ import annotations
 
 import copy
+import math
 import os
 import re
 import sys
 import tempfile
+from collections import Counter
 from curses import ascii
 from io import BytesIO
 from pathlib import Path
@@ -13,6 +15,7 @@ from typing.io import IO
 import fsutil
 import ots
 from fontTools import unicodedata
+from fontTools.pens.svgPathPen import SVGPathPen
 from fontTools.subset import Options as SubsetterOptions
 from fontTools.subset import Subsetter
 from fontTools.ttLib import TTCollection, TTFont, TTLibError
@@ -812,7 +815,7 @@ class Font:
         format_ = ""
         if flavor in [self.FORMAT_WOFF, self.FORMAT_WOFF2] and not ignore_flavor:
             format_ = str(flavor)
-        elif version == "OTTO" and "CFF " in font:
+        elif version == "OTTO" and ("CFF " in font or "CFF2" in font):
             format_ = self.FORMAT_OTF
         elif version == "\0\1\0\0":
             format_ = self.FORMAT_TTF
@@ -1032,6 +1035,61 @@ class Font:
             or ""
         )
 
+    def get_svg(
+        self,
+        *,
+        text: str,
+        size: int,
+    ) -> str:
+        """
+        Gets an SVG representation of the font rendering
+        some text using the given options.
+
+        :param text: The text to be rendered as SVG paths.
+        :type text: str
+        :param size: The size of the font to be used for rendering the text, in points.
+        :type size: int
+
+        :returns: An SVG string that represents the rendered text.
+        :rtype: str
+        """
+        font = self.get_ttfont()
+
+        # get font metrics
+        units_per_em = font["head"].unitsPerEm
+        scale = size / units_per_em
+        hhea = font["hhea"]
+        ascent = hhea.ascent * scale
+        descent = hhea.descent * scale
+        width = 0
+        height = ascent - descent
+
+        # get glyph set and character map
+        glyphset = font.getGlyphSet()
+        cmap = font["cmap"].getBestCmap()
+
+        # generate svg path for each glyph in text
+        glyphs: list[str] = list(filter(None, [cmap.get(ord(char)) for char in text]))
+        paths = ""
+        for glyph_name in glyphs:
+            glyph = glyphset[glyph_name]
+            pen = SVGPathPen(glyphset)
+            glyph.draw(pen)
+            commands = pen.getCommands()
+            transform = f"translate({width:.2f} {ascent:.2f}) scale({scale} -{scale})"
+            paths += f"""<path d="{commands}" transform="{transform}" />"""
+            width += glyph.width * scale
+
+        # round width and height
+        width = int(math.ceil(width))
+        height = int(math.ceil(height))
+        viewbox = f"0 0 {width} {height}"
+        xmlns = "http://www.w3.org/2000/svg"
+
+        # generate svg string
+        svg_str = f"""<svg width="{width}" height="{height}" viewBox="{viewbox}" xmlns="{xmlns}">{paths}</svg>"""
+        return svg_str
+
     def get_ttfont(
         self,
     ) -> TTFont:
@@ -1394,18 +1452,41 @@ class Font:
         width["value"] = width_value
         return width
 
+    def is_color(
+        self,
+    ) -> bool:
+        """
+        Determines if the font is a color font.
+
+        :returns: True if color font, False otherwise.
+        :rtype: bool
+        """
+        font = self.get_ttfont()
+        tables = {"COLR", "CPAL", "CBDT", "CBLC"}
+        for table in tables:
+            if table in font:
+                return True
+        return False
+
     def is_monospace(
         self,
+        threshold: float = 0.85,
     ) -> bool:
         """
         Determines if the font is a monospace font.
 
+        :param threshold: The threshold (0.0 <= n <= 1.0) of glyphs with the same width to consider the font as monospace.
+        :type threshold: float
+
         :returns: True if monospace font, False otherwise.
         :rtype: bool
         """
         font = self.get_ttfont()
-        widths = {metrics[0] for metrics in font["hmtx"].metrics.values()}
-        return len(widths) == 1
+        widths = [metrics[0] for metrics in font["hmtx"].metrics.values()]
+        widths_counter = Counter(widths)
+        same_width_count = widths_counter.most_common(1)[0][1]
+        same_width_amount = same_width_count / self.get_glyphs_count()
+        return same_width_amount >= threshold
 
     def is_static(
         self,

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/fontbro/metadata.py

@@ -4,4 +4,4 @@ __description__ = "friendly font operations on top of fontTools."
 __email__ = "fabio.caccamo@gmail.com"
 __license__ = "MIT"
 __title__ = "python-fontbro"
-__version__ = "0.23.0"
+__version__ = "0.24.0"

{python_fontbro-0.23.0 → python_fontbro-0.24.0/python_fontbro.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-fontbro
-Version: 0.23.0
+Version: 0.24.0
 Summary: friendly font operations on top of fontTools.
 Author-email: Fabio Caccamo <fabio.caccamo@gmail.com>
 Maintainer-email: Fabio Caccamo <fabio.caccamo@gmail.com>
@@ -118,6 +118,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_style_flag`](#get_style_flag)
 -   [`get_style_flags`](#get_style_flags)
 -   [`get_style_name`](#get_style_name)
+-   [`get_svg`](#get_svg)
 -   [`get_ttfont`](#get_ttfont)
 -   [`get_unicode_block_by_name`](#get_unicode_block_by_name)
 -   [`get_unicode_blocks`](#get_unicode_blocks)
@@ -133,6 +134,7 @@ with open("fonts/MyFont.ttf") as fh:
 -   [`get_vertical_metrics`](#get_vertical_metrics)
 -   [`get_weight`](#get_weight)
 -   [`get_width`](#get_width)
+-   [`is_color`](#is_color)
 -   [`is_monospace`](#is_monospace)
 -   [`is_static`](#is_static)
 -   [`is_variable`](#is_variable)
@@ -449,6 +451,23 @@ Gets the style name reading the name records with priority order (17, 22, 2).
 style_name = font.get_style_name()
 ```
 
+#### `get_svg`
+```python
+"""
+Gets an SVG representation of the font rendering
+some text using the given options.
+
+:param text: The text to be rendered as SVG paths.
+:type text: str
+:param size: The size of the font to be used for rendering the text, in points.
+:type size: int
+
+:returns: An SVG string that represents the rendered text.
+:rtype: str
+"""
+svg_str = font.get_svg(text="Hello!", size=48)
+```
+
 #### `get_ttfont`
 ```python
 """
@@ -642,11 +661,25 @@ Gets the font width value and name.
 width = font.get_width()
 ```
 
+#### `is_color`
+```python
+"""
+Determines if the font is a color font.
+
+:returns: True if color font, False otherwise.
+:rtype: bool
+"""
+color = font.is_color()
+```
+
 #### `is_monospace`
 ```python
 """
 Determines if the font is a monospace font.
 
+:param threshold: The threshold (0.0 <= n <= 1.0) of glyphs with the same width to consider the font as monospace.
+:type threshold: float
+
 :returns: True if monospace font, False otherwise.
 :rtype: bool
 """

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/python_fontbro.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ tests/test_characters.py
 tests/test_clone.py
 tests/test_close.py
 tests/test_collection.py
+tests/test_color.py
 tests/test_context_manager.py
 tests/test_family_classification.py
 tests/test_family_name.py
@@ -47,6 +48,7 @@ tests/test_str.py
 tests/test_style_flags.py
 tests/test_style_name.py
 tests/test_subset.py
+tests/test_svg.py
 tests/test_unicode_blocks_and_scripts.py
 tests/test_update_unicode_data.py
 tests/test_variable.py

python_fontbro-0.24.0/tests/test_color.py

@@ -0,0 +1,21 @@
+from tests import AbstractTestCase
+
+
+class ColorTestCase(AbstractTestCase):
+    """
+    This class describes a color test case.
+    """
+
+    def test_is_monospace(self):
+        with self._get_font("/Honk/static/Honk-Regular.ttf") as font:
+            self.assertTrue(font.is_color())
+        with self._get_font("/Inter/static/Inter-Regular.ttf") as font:
+            self.assertFalse(font.is_color())
+        with self._get_font("/Nabla/static/Nabla-Regular.ttf") as font:
+            self.assertTrue(font.is_color())
+        with self._get_font("/Noto_Sans_TC/NotoSansTC-Regular.otf") as font:
+            self.assertFalse(font.is_color())
+        with self._get_font("/Open_Sans/static/OpenSans-Regular.ttf") as font:
+            self.assertFalse(font.is_color())
+        with self._get_font("/Roboto_Mono/static/RobotoMono-Regular.ttf") as font:
+            self.assertFalse(font.is_color())

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/tests/test_monospace.py

@@ -10,7 +10,7 @@ class MonospaceTestCase(AbstractTestCase):
         with self._get_font("/Inter/static/Inter-Regular.ttf") as font:
             self.assertFalse(font.is_monospace())
         with self._get_font("/Noto_Sans_TC/NotoSansTC-Regular.otf") as font:
-            self.assertFalse(font.is_monospace())
+            self.assertTrue(font.is_monospace())
         with self._get_font("/Open_Sans/static/OpenSans-Regular.ttf") as font:
             self.assertFalse(font.is_monospace())
         with self._get_font("/Roboto_Mono/static/RobotoMono-Regular.ttf") as font:

{python_fontbro-0.23.0 → python_fontbro-0.24.0}/tests/test_sanitize.py

@@ -24,6 +24,7 @@ class SanitizeTestCase(AbstractTestCase):
                 try:
                     font = Font(font_file)
                 except Exception:
+                    # there are some ttc files
                     continue
                 try:
                     font.sanitize(strict=strict)
@@ -64,7 +65,7 @@ class SanitizeTestCase(AbstractTestCase):
         self._test_sanitize(
             "fonts-ots/good",
             strict=False,
-            expected_errors_count=10,
+            expected_errors_count=2,  # should reduce to 0
         )
 
     def test_sanitize_strict_with_good_fonts(self):
@@ -72,5 +73,5 @@ class SanitizeTestCase(AbstractTestCase):
         self._test_sanitize(
             "fonts-ots/good",
             strict=True,
-            expected_errors_count=10,
+            expected_errors_count=2,  # should reduce to 0
         )

python_fontbro-0.24.0/tests/test_svg.py

@@ -0,0 +1,20 @@
+from tests import AbstractTestCase
+
+
+class SVGTestCase(AbstractTestCase):
+    """
+    This class describes an image test case.
+    """
+
+    def test_generate_svg(self):
+        # font = self._get_font("/Noto_Sans_TC/NotoSansTC-Regular.otf")
+        font = self._get_font("/Inter/static/Inter-Black.ttf")
+        svg = font.get_svg(
+            text="Hello World!",
+            size=16,
+        )
+        # print(svg)
+        self.assertTrue(svg.startswith("<svg "))
+        self.assertTrue(svg.endswith("</svg>"))
+        self.assertFalse("{" in svg)
+        self.assertFalse("}" in svg)