ManimPango 0.4.3__cp39-cp39-win_amd64.whl → 1.0.0a2__cp39-cp39-win_amd64.whl

{ManimPango-0.4.3.dist-info → ManimPango-1.0.0a2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ManimPango
-Version: 0.4.3
+Version: 1.0.0a2
 Summary: Bindings for Pango for using with Manim.
 Home-page: https://manimpango.manim.community/
 Author: Naveen M K
@@ -24,7 +24,7 @@ Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Cython
-Requires-Python: >=3.7
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: LICENSE.win32

ManimPango-1.0.0a2.dist-info/RECORD

@@ -0,0 +1,85 @@
+manimpango/__init__.py,sha256=ELRxGogKS5uPGatJzGmPAaj068ZOO-Sze88nenz4RE8,1153
+manimpango/_distributor_init.py,sha256=z3NAjz5oUeNo6Pbk6zuA9Lfi71rB3ucus0XDpZ3nSrk,1233
+manimpango/_version.py,sha256=Vq7ueDz68EUGVviee7EKuGy1u4lkrTzFM_-KtqwbrfY,50
+manimpango/buffer.pxi,sha256=NklqLNZ0462IL9CpZc9AFG8c1N2ULr6JAURJdhegQng,419
+manimpango/cmanimpango.c,sha256=63UNUSD2u4AFXxdIYsNK9PLzRCJXlclnUk3MDlHCFjc,418073
+manimpango/cmanimpango.cp39-win_amd64.pyd,sha256=aNMvuHHe8OCKM78Qjdu5OXPwXJRbmC4_KHCNo89du6A,73728
+manimpango/cmanimpango.pxd,sha256=Apb6qZMqtkL9ldE_nMxVtdsnTH2tkmYt94lrhsB0Qwc,65
+manimpango/cmanimpango.pyx,sha256=f3wr3BpOmIsr1yi7jQsaKv9ntyKyzRWJmbNo8JPLqig,10744
+manimpango/enums.c,sha256=25snfoX1sJVBRVmbaWSNzMI-aGAw5GHXBaLwIPA4Iz8,149445
+manimpango/enums.cp39-win_amd64.pyd,sha256=YjF865G4pqpNTcBsPUXMEkejKdPP_4JzDEjKQpgsLwk,26112
+manimpango/enums.pyx,sha256=5qEKGgt3ueVXJkDKo5f_gyfOcuYCQ_j3sHKuXXkrO14,2370
+manimpango/exceptions.py,sha256=sg8znK3Yr_Qw_BoACd4sS3ZiWLXgsStAi1tmK-9549o,146
+manimpango/register_font.c,sha256=YvUK6gK2tR-dCTgvhikBqapUuHZoy5w3gbEDnG9BNNw,199324
+manimpango/register_font.cp39-win_amd64.pyd,sha256=L1kmgdeWFWAPJSSOH5ODRXRwZPe2bxl9jCwjZyM7u7g,36352
+manimpango/register_font.pxd,sha256=8iZpMnQenfTdUUxhNdesi21GeGjHX07pvIWiQom6Jio,1653
+manimpango/register_font.pyx,sha256=H_fe5SLNue6H3vpB01aindxxNQEbtG7jiDhXCk0PZTo,7548
+manimpango/.libs/CORE_MANIM_cairo-2.dll,sha256=lttR5-2wVg3Y66a3wa-xOVB8gMPD3Vi1jMT0v7yEXhE,906240
+manimpango/.libs/CORE_MANIM_cairo-gobject-2.dll,sha256=TtDtutnPozNTT2uzhL40jnSzTXTwQTT1jMywiVdVlzY,27136
+manimpango/.libs/CORE_MANIM_cairo-script-interpreter-2.dll,sha256=KnfNrOIt9l7jhs1QdxwKR8I-ugBVmg7Cq18Z9cobnB8,132608
+manimpango/.libs/CORE_MANIM_expat.dll,sha256=caYNgwGfvmPdRf70408MgSfspUKHqZlJXA0qLup6gKk,139776
+manimpango/.libs/CORE_MANIM_ffi-7.dll,sha256=-AR4rzhVy4_omlrrDC_c_mxaAsj286a2_2qRpz4NF88,27136
+manimpango/.libs/CORE_MANIM_fontconfig-1.dll,sha256=cyYH5II1gEyAA8UXjokHvvjB6XsoHxUGRPgccciZSIU,280576
+manimpango/.libs/CORE_MANIM_freetype-6.dll,sha256=8wRw5DsluMR6qHuCjL-2UCBWnXjI6c72DgaAgrnwK6U,634368
+manimpango/.libs/CORE_MANIM_fribidi-0.dll,sha256=wh0pMSYG85i0so1zYcKBxrvCE5Mb5wVxdbnyBEk5qbI,117760
+manimpango/.libs/CORE_MANIM_gio-2.0-0.dll,sha256=VdsvhRL1qBOX8BGxcJ6X4uPbwyw-LIy1fh16hmVCaz8,1587712
+manimpango/.libs/CORE_MANIM_glib-2.0-0.dll,sha256=vH1rnJXFTarQVoHEpBk7B1HBYwZhJ0did3Ce-Y-Qbl0,1501696
+manimpango/.libs/CORE_MANIM_gmodule-2.0-0.dll,sha256=rFkuuKqoHHjDNUOvIxXTgnpMdLqX1x3I_cQ2QtcqFmE,18432
+manimpango/.libs/CORE_MANIM_gobject-2.0-0.dll,sha256=yORytG1ldqLOxHDH1O-pfNIyj21giXgdmfbbXgSuQeo,301056
+manimpango/.libs/CORE_MANIM_gthread-2.0-0.dll,sha256=uX7L-UUZ7NFBORorYsx806n7Lo4JvXeuiW2Xp2z8fxE,10752
+manimpango/.libs/CORE_MANIM_harfbuzz-gobject.dll,sha256=G_-KeQ40hg1TePxKe0QF8FPO8AWe4H3chVjD_aSKJmk,81920
+manimpango/.libs/CORE_MANIM_harfbuzz-subset.dll,sha256=ugpKOB9wTg8r3eDshdqRw4ZJe3UuIU6LI4uLnpsGARQ,711680
+manimpango/.libs/CORE_MANIM_harfbuzz.dll,sha256=se0KeSQ_Au9jq1lxuOoAQNFM_SMmiUKTMMtSnQVKxxk,904192
+manimpango/.libs/CORE_MANIM_intl-8.dll,sha256=WHJBXbqfjBKCjhbUv6kbqMfUbJkGhjRM8MRklfjpQ_0,10240
+manimpango/.libs/CORE_MANIM_pango-1.0-0.dll,sha256=vULIkx2V0loztNrRCgFzyD5AkgB0SV65-kaUq9onKy8,357376
+manimpango/.libs/CORE_MANIM_pangocairo-1.0-0.dll,sha256=mLuUzIIUeVPh6PSVIYVaG2RlODeXF_V7rddhZHGiaX4,53760
+manimpango/.libs/CORE_MANIM_pangoft2-1.0-0.dll,sha256=VNnK5EvPFYIh92iKCzy07SjxkhhQv2SV2PZ4-Epag1c,76800
+manimpango/.libs/CORE_MANIM_pangowin32-1.0-0.dll,sha256=dZBf-P9twhp7otB-TauGS36MnnDAj-w4Rl-SUfQQmxo,54272
+manimpango/.libs/CORE_MANIM_pixman-1-0.dll,sha256=UBZ080EGrc4NYRzRRwwKbzmfGxykSGfKnmjYtJ2jm9k,586752
+manimpango/.libs/CORE_MANIM_png16-16.dll,sha256=3doABQ79VhdEmLh71UQbhhfdjWJmQN9YTz_BSkXlihc,195072
+manimpango/.libs/CORE_MANIM_z.dll,sha256=gFJNdWYIKc5V8MCHCYIK-Z95st0LEQuvDFH_z1F8edE,86528
+manimpango/attributes/__init__.py,sha256=IqbS6YvnX_5YBcvhhh-jOuqsG26hywrwWxO7rf2eMH4,10777
+manimpango/attributes/attributes.pxi,sha256=o_EAkxTXVQa-GKXmjqjRpyl3rRM2oxqI2B8nGsCPxoY,6298
+manimpango/fonts/__init__.py,sha256=ijgoYEfA6oETMQZlb613YSGc7cAuWPyM9-jxgKMMznA,4142
+manimpango/fonts/_font_desc.c,sha256=TM7YBRCxaua213KTVFHoxqeQfZdP2Zm6-8pUZAWTEAo,306216
+manimpango/fonts/_font_desc.cp39-win_amd64.pyd,sha256=2IkKgCxS-_lg5wO-BFvyLQZaM_9X_9vhdZVTBe7jehA,41984
+manimpango/fonts/_font_desc.pxd,sha256=f7L1fDqWEqeANGliVzPLAabpsNf_S5hYZfYAHbA0Qjw,104
+manimpango/fonts/_font_desc.pyi,sha256=5K3qwRygAb6Am9B7I7mg3HhzxSw66UJR_eAnXTc1hBM,670
+manimpango/fonts/_font_desc.pyx,sha256=XWCfWLoWm3v7RHvfC3cmwj6neD89-40KyiKO9FjCpFM,3386
+manimpango/fonts/enums.c,sha256=m4MsJl-YHIw8pmgDTDRuM1srxTdDnmGyC7rzVL9CsgY,145914
+manimpango/fonts/enums.cp39-win_amd64.pyd,sha256=ChiG1aHxFz_7LCjIT7bzibHNwhPvb-GrTL-xo1kNi_g,25600
+manimpango/fonts/enums.pyi,sha256=F39pBJVtL7i74PkPcMScAWTNsprWg421XzBwrcEMR24,390
+manimpango/fonts/enums.pyx,sha256=3tpHGD28albK5_xrKMxf4xndyCggGGfBZAgtw9umh-E,2305
+manimpango/include/cairo.pxd,sha256=IhCmKOEvR8xc36M5Q7SzuQpdv1obgoXO9VjASi5QG3E,1369
+manimpango/include/glib.pxd,sha256=-rd7ww83I3unntJ7ZI1NbT25QaoGr7786DqFe5RrY8M,907
+manimpango/include/pango.pxd,sha256=ZEg-P74BE4nEvcafDldeacEpUUpGt33-QF3ZWbidAMQ,6201
+manimpango/include/pango_attributes.pxd,sha256=cJwiACUQmIAEk-26d-sKpO28Q4Fbd7V8WKJF44tfm4o,5240
+manimpango/layout/__init__.py,sha256=TPHpFluM2m8WwmBotcI5Ve6uYx3Y3Z_IvYYmnFlo8FY,7841
+manimpango/layout/_layout.c,sha256=hFgmtI6Vy0NaelCyt1x84Bq1w8h9bdMwAP9ncxgWZhc,360782
+manimpango/layout/_layout.cp39-win_amd64.pyd,sha256=StLWXVbmnA6n6QCfnMO7_cG6HqqWbI9XLLMf5MeMjTA,45568
+manimpango/layout/_layout.pyx,sha256=BYkon6U7KNmWgkvyxB9HfxncjhyPG2xGGLU0VsbfKd8,1784
+manimpango/layout/layout.pxi,sha256=N902NZq0ILyUnTY43yhP84WBSvQjM3bbCDwMDwStSgE,1389
+manimpango/renderer/__init__.py,sha256=krRnN0pgAQiyvnabo2Q2dHJgNK9ZpGebW6Al8TD4FIQ,191
+manimpango/renderer/cairo_utils.pxi,sha256=J-L17N5tiz87fUthMq-RBFFSU9V0_r2w8XepeFOgK0Q,2603
+manimpango/renderer/image_renderer.c,sha256=a7SxpZuV6MzIxpWEZkKgnfxBCYnOJenyOstlFFUwQ74,521783
+manimpango/renderer/image_renderer.cp39-win_amd64.pyd,sha256=d4K2DQnvseDx53gICZCccZbcoAcd90E-4QrCnACOmfY,72704
+manimpango/renderer/image_renderer.pxd,sha256=vLbnxD-KYaChrXY1w_FB-iiCJ6cE6U2ArpZHkyjuWCQ,560
+manimpango/renderer/image_renderer.pyi,sha256=zFir_N8OoPaH6Vn7Eov_E-j0J2eJCt50Icw4deC2Mcc,521
+manimpango/renderer/image_renderer.pyx,sha256=qRzHCSC8QEQFd16yMo9gOTdwiVP4LJjkX7AFXyyWosc,6757
+manimpango/renderer/svg_renderer.c,sha256=dSSInF7nYaRqSp-NJ2fZcy5coD6ZClGr4apgkg2V6lU,448017
+manimpango/renderer/svg_renderer.cp39-win_amd64.pyd,sha256=iSl65hBOtdQd63vF8m7Nl5qhOY3EGlVutLyz6Lz1G8A,61440
+manimpango/renderer/svg_renderer.pxd,sha256=LcVuCOc4x-8ZR8GLimFLvGG-dxhhcQ3Xx7bFk6wIy1o,562
+manimpango/renderer/svg_renderer.pyi,sha256=n6NN90qhGQun7Vu1xDgUmYW7rH8PIZ5m-DZHfv4uHBo,418
+manimpango/renderer/svg_renderer.pyx,sha256=5vf8x88bDDOmlSy62EqO_Dx_dMziujhuv9JtKuIVkic,5284
+manimpango/utils/__init__.py,sha256=w3VK15PRAEtSnedU9IzOosOi18rCCLDBDs2NPP9_0d0,110
+manimpango/utils/_utils.cp39-win_amd64.pyd,sha256=ytUjwRWy44jHtyJPPLaz8AyK-dI7Rykh19t3ZV1sA80,21504
+manimpango/utils/_utils.pyi,sha256=L4bczjAKJTKbq4FZercUiQEnuVOqTXbfePmp8FWbkrc,112
+manimpango/utils/utils.c,sha256=HWDlkhzD2l0xeNnHSA8E_i4sccYBxjQiQtw3aK1fg9o,136649
+manimpango/utils/utils.py,sha256=mYBmmr0bLk72bjcPBoD10q5dIBWdI06m9Tm2J-dEXrc,1699
+manimpango/utils/utils.pyx,sha256=ydDxtOMbqNexX-IzD6ZuFLfwamsmGqSxGKyRkvZ0nsA,658
+ManimPango-1.0.0a2.dist-info/LICENSE,sha256=ZB7Op1KnTg-rYuSNFk6dIaWt5fwrfsSWTuJW8Ql55ok,1088
+ManimPango-1.0.0a2.dist-info/LICENSE.win32,sha256=XJh88_PtJqmEAfFqLLztbIcxPCJaccrFbz1w6ux-9Zg,163586
+ManimPango-1.0.0a2.dist-info/METADATA,sha256=jpQ6EtG_iXvb9kPdS32XbE2oNGFaf2p06Ds3Zk_JTlk,8600
+ManimPango-1.0.0a2.dist-info/WHEEL,sha256=eep6QWEFiQfg2wcclssb_WY-D33AnLYLnEKGA9Rn-VU,100
+ManimPango-1.0.0a2.dist-info/top_level.txt,sha256=_7RXNU2cbck8IbstWHzYv6YV58wtKUDBX-pmUjE6SKs,11
+ManimPango-1.0.0a2.dist-info/RECORD,,

{ManimPango-0.4.3.dist-info → ManimPango-1.0.0a2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.38.4)
+Generator: bdist_wheel (0.40.0)
 Root-Is-Purelib: false
 Tag: cp39-cp39-win_amd64
 

manimpango/__init__.py

@@ -1,19 +1,17 @@
 # -*- coding: utf-8 -*-
-import os
 import sys
 
+from . import _distributor_init  # noqa: F401
 from ._version import __version__  # noqa: F403,F401
 
-if os.name == "nt":  # pragma: no cover
-    os.environ["PATH"] = (
-        f"{os.path.abspath(os.path.dirname(__file__))}"
-        f"{os.pathsep}"
-        f"{os.environ['PATH']}"
-    )
 try:
+    from .attributes import *  # noqa: F403,F401
     from .cmanimpango import *  # noqa: F403,F401
     from .enums import *  # noqa: F403,F401
+    from .fonts import *  # noqa: F403,F401
+    from .layout import *  # noqa: F403,F401
     from .register_font import *  # noqa: F403,F401
+    from .renderer import *  # noqa: F403,F401
 except ImportError as ie:  # pragma: no cover
     py_ver = ".".join(map(str, sys.version_info[:3]))
     msg = f"""

manimpango/_distributor_init.py

@@ -0,0 +1,36 @@
+"""
+Helper to preload windows dlls to prevent dll not found errors.
+Once a DLL is preloaded, its namespace is made available to any
+subsequent DLL. This file is created as part of the scripts that
+build the wheel.
+"""
+import glob
+import os
+
+if os.name == "nt":
+    # convention for storing / loading the DLL from
+    # ManimPango/.libs/, if present
+    basedir = os.path.dirname(__file__)
+    libs_dir = os.path.abspath(os.path.join(basedir, ".libs"))
+
+    # first add them to os.add_dll_directory
+    try:
+        if hasattr(os, "add_dll_directory"):
+            libs_dir = os.path.abspath(os.path.join(basedir, ".libs"))
+            if os.path.isdir(libs_dir):
+                os.add_dll_directory(libs_dir)
+    except Exception:
+        pass
+
+    try:
+        from ctypes import WinDLL
+    except Exception:
+        pass
+    else:
+        DLL_filenames = []
+        if os.path.isdir(libs_dir):
+            for filename in glob.glob(os.path.join(libs_dir, "*openblas*dll")):
+                # NOTE: would it change behavior to load ALL
+                # DLLs at this path vs. the name restriction?
+                WinDLL(os.path.abspath(filename))
+                DLL_filenames.append(filename)

manimpango/_version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = "0.4.3"
+__version__ = "1.0.0a2"

manimpango/attributes/__init__.py

@@ -0,0 +1,324 @@
+# -*- coding: utf-8 -*-
+from __future__ import annotations
+
+import typing as T
+
+from ..fonts.enums import Weight
+from ..utils import covert_hex_to_rbg
+
+__all__ = ["TextAttribute"]
+
+
+def _parse_color_output(val: T.Union[str, T.Iterable[int]]):
+    color_hex = None
+    red, green, blue = None, None, None
+    if isinstance(val, str):
+        color_hex = val
+    else:
+        if len(val) != 3:
+            raise ValueError("Either a Iterable of 3 items or a string must be passed.")
+        red, green, blue = val
+    if color_hex:
+        red, green, blue = covert_hex_to_rbg(color_hex)
+    if not ((0 <= red <= 65535) and (0 <= green <= 65535) and (0 <= blue <= 65535)):
+        raise ValueError("red, green, blue should be between 0 and 65535.")
+    return (red, green, blue)
+
+
+class TextAttribute:
+    """:class:`TextAttribute` defines the properties/attributes of the
+    text within a specific range of the text.
+
+
+    A :class:`TextAttribute` object can define multiple properties at
+    the same time, for example, it can change the :attr:`background_color`,
+    as well as, :attr:`foreground_color`. Also, a :class:`TextAttribute` can
+    be used for multiple times for different texts.
+    By default, an attribute has an inclusive range from ``0`` to the
+    end of the text ``-1``, ie. ``[0, -1]``.
+    """
+
+    def __init__(
+        self,
+        start_index: int = 0,
+        end_index: int = -1,
+        *,
+        allow_breaks: bool | None = None,
+        background_alpha: float | None = None,
+        background_color: T.Union[str, T.Iterable[int]] | None = None,
+        foreground_alpha: float | None = None,
+        foreground_color: T.Union[str, T.Iterable[int]] | None = None,
+        fallback: bool | None = None,
+        family: str | None = None,
+        weight: Weight | None = None,
+        line_height: float | None = None,
+    ) -> None:
+        """Initialize :class:`TextAttribute`.
+
+        Parameters
+        ----------
+        start_index : int, optional
+            The start index of the range, by default 0 (start of the string).
+        end_index : int, optional
+            End index of the range. The character at this index is not included
+            in the range, by default -1 (end of the string).
+        """
+        self.start_index = start_index
+        self.end_index = end_index
+        if allow_breaks:
+            self.allow_breaks = allow_breaks
+        if background_alpha:
+            self.background_alpha = background_alpha
+        if background_color:
+            self.background_color = background_color
+        if foreground_alpha:
+            self.foreground_alpha = foreground_alpha
+        if foreground_color:
+            self.foreground_color = foreground_color
+        if fallback:
+            self.fallback = fallback
+        if family:
+            self.family = family
+        if weight:
+            self.weight = weight
+        if line_height:
+            self.line_height = line_height
+
+    @property
+    def start_index(self) -> int:
+        """It is the end index of the range.
+
+        Raises
+        ------
+        ValueError
+            If the value is not an :class:`int`.
+        """
+        return self._start_index
+
+    @start_index.setter
+    def start_index(self, val: int) -> None:
+        if not isinstance(val, int):
+            raise ValueError("'start_index' should be an int")
+        # check if the value is negative
+        if val < 0:
+            raise ValueError("'start_index' should be a positive int")
+        self._start_index = val
+
+    @property
+    def end_index(self) -> int:
+        """It is the start of the range. The character at this index is not
+        included in the range.
+
+        Raises
+        ------
+        ValueError
+            If the value is not an :class:`int`.
+        """
+        return self._end_index
+
+    @end_index.setter
+    def end_index(self, val: int) -> None:
+        if not isinstance(val, int):
+            raise ValueError("'end_index' should be an int")
+        # check if the value is negative
+        if val < 0 and val != -1:
+            raise ValueError("'end_index' should be a positive int")
+        self._end_index = val
+
+    @property
+    def allow_breaks(self) -> T.Union[bool, None]:
+        """Whether to break text or not.
+
+        If breaks are disabled, the range will be kept in a single run,
+        as far as possible.
+        """
+        if hasattr(self, "_allow_breaks"):
+            return self._allow_breaks
+        return None
+
+    @allow_breaks.setter
+    def allow_breaks(self, val: bool) -> None:
+        self._allow_breaks = bool(val)
+
+    @property
+    def background_alpha(self) -> T.Union[float, None]:
+        """The background_alpha of the text.
+
+        Raises
+        ------
+        ValueError
+            If the value is not between 0 and 1.
+        """
+        if hasattr(self, "_background_alpha"):
+            return self._background_alpha
+        return None
+
+    @background_alpha.setter
+    def background_alpha(self, val: float) -> None:
+        if not (0 <= val <= 1):
+            raise ValueError("'val' should be between 0 and 1")
+        self._background_alpha = val
+
+    @property
+    def background_color(self) -> T.Union[T.Tuple[int], None]:
+        """The background color of the region.
+
+        If the input is a :class:`str` the value is considered as
+        string representation of color from
+        `CSS Specification <https://www.w3.org/TR/css-color-4/#named-colors>`_.
+        The color is then parsed and :class:`ValueError` is raised
+        if the color is invalid.
+
+        If the input is a :class:`collections.abc.Iterable` then the items
+        in them are parsed in the order of ``red, green, blue`` and checked
+        whether they are valid (between 0 and 65535).
+
+
+        Returns either ``None`` or a :class:`tuple` with 3 elements
+        representing red, green, blue respectively. The value of each
+        items in that tuple ranges from 0 to 65535.
+
+        Raises
+        ------
+        ValueError
+            If the value passed isn't a :class:`collections.abc.Iterable` of 3
+            elements or a string. Another condition when `ValueError` is
+            raised is when the color passed is invalid.
+
+        """
+        if hasattr(self, "_background_color"):
+            return self._background_color
+        return None
+
+    @background_color.setter
+    def background_color(self, val: T.Union[str, T.Iterable[int]]) -> None:
+        self._background_color = _parse_color_output(val)
+
+    @property
+    def foreground_alpha(self) -> T.Union[float, None]:
+        """The foreground_alpha of the text.
+
+        Raises
+        ------
+        ValueError
+            If the value is not between 0 and 1.
+        """
+        if hasattr(self, "_foreground_alpha"):
+            return self._foreground_alpha
+        return None
+
+    @foreground_alpha.setter
+    def foreground_alpha(self, val: float) -> None:
+        if not (0 <= val <= 1):
+            raise ValueError("'val' should be between 0 and 1")
+        self._foreground_alpha = val
+
+    @property
+    def foreground_color(self) -> T.Union[T.Tuple[int], None]:
+        """The foreground color attribute.
+
+        If the input is a :class:`str` the value is considered as
+        string representation of color from
+        `CSS Specification <https://www.w3.org/TR/css-color-4/#named-colors>`_.
+        The color is then parsed and :class:`ValueError` is raised
+        if the color is invalid.
+
+        If the input is a :class:`collections.abc.Iterable` then the items
+        in them are parsed in the order of ``red, green, blue`` and checked
+        whether they are valid (between 0 and 65535).
+
+
+        Returns either ``None`` or a :class:`tuple` with 3 elements
+        representing red, green, blue respectively. The value of each
+        items in that tuple ranges from 0 to 65535.
+
+        Raises
+        ------
+        ValueError
+            If the value passed isn't a :class:`collections.abc.Iterable` of 3
+            elements or a string. Another condition when `ValueError` is
+            raised is when the color passed is invalid.
+
+        """
+        if hasattr(self, "_foreground_color"):
+            return self._foreground_color
+        return None
+
+    @foreground_color.setter
+    def foreground_color(self, val: T.Union[str, T.Iterable[int]]) -> None:
+        self._foreground_color = _parse_color_output(val)
+
+    @property
+    def fallback(self) -> bool:
+        """Enable or disable fallbacks.
+
+        If fallback is disabled, characters will only be used from the
+        closest matching font on the system. No fallback will be done to
+        other fonts on the system that might contain the characters in
+        the text.
+        """
+        if hasattr(self, "_fallback"):
+            return self._fallback
+        return None
+
+    @fallback.setter
+    def fallback(self, val: bool) -> None:
+        self._fallback = bool(val)
+
+    @property
+    def family(self) -> T.Union[str, None]:
+        """The font family the text should render. Can be a comma seperated
+        list of fonts in a string.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a str.
+        """
+        if hasattr(self, "_family"):
+            return self._family
+        return None
+
+    @family.setter
+    def family(self, val: str) -> None:
+        if not isinstance(val, str):
+            raise ValueError("'family' must be a string")
+        self._family = val
+
+    @property
+    def weight(self) -> T.Union[Weight, None]:
+        """The font weight of the text.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a str.
+        """
+        if hasattr(self, "_weight"):
+            return self._weight
+        return None
+
+    @weight.setter
+    def weight(self, val: Weight) -> None:
+        if not isinstance(val, Weight):
+            raise ValueError("'weight' must be a Weight")
+        self._weight = val
+
+    @property
+    def line_height(self) -> T.Union[float, None]:
+        """The line height of the text.
+
+        Raises
+        ------
+        ValueError
+            If value isn't a float.
+        """
+        if hasattr(self, "_line_height"):
+            return self._line_height
+        return None
+
+    @line_height.setter
+    def line_height(self, val: float) -> None:
+        if not isinstance(val, float):
+            raise ValueError("'line_height' must be a float")
+        self._line_height = val