manimpango 0.2.4__tar.gz → 0.2.5__tar.gz

ManimPango-0.2.5/.coveragerc

@@ -0,0 +1,26 @@
+[run]
+plugins = Cython.Coverage
+omit =
+    packing
+data_file = .coverage/data
+source = manimpango
+
+[report]
+skip_empty = true
+ignore_errors = true
+exclude_lines =
+    pragma: no cover
+    def __repr__
+    if self.debug:
+    raise AssertionError
+    raise NotImplementedError
+    except Exception as e:
+
+[html]
+directory = .coverage/html
+
+[xml]
+output = .coverage/coverage.xml
+
+[json]
+output = .coverage/coverage.json

ManimPango-0.2.5/CODE_OF_CONDUCT.md

@@ -0,0 +1,5 @@
+# Code of Conduct
+
+
+If you haven't read our code of conduct, please do so at the
+[manim repository](https://github.com/ManimCommunity/manim/blob/master/CODE_OF_CONDUCT.md#code-of-conduct).

ManimPango-0.2.5/MANIFEST.in

@@ -0,0 +1,7 @@
+global-include *.pyx *.pxd
+recursive-include tests *.py *.ttf LICENSE.txt
+recursive-include docs *.rst *.py make* _*/*
+prune docs/_build
+include *.md
+include *.txt
+include .coveragerc

{ManimPango-0.2.4 → ManimPango-0.2.5/ManimPango.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ManimPango
-Version: 0.2.4
+Version: 0.2.5
 Summary: Bindings for Pango for using with Manim.
 Home-page: https://manimpango.manim.community/
 Author: Naveen M K
@@ -16,7 +16,7 @@ Description: # ManimPango
             <a href="https://pypi.org/project/manimpango/"><img src="https://img.shields.io/pypi/v/manimpango.svg?style=flat&logo=pypi" alt="PyPI Latest Release"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Wheel" src="https://img.shields.io/pypi/wheel/manimpango"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/manimpango"></a>
-            <a href="http://choosealicense.com/licenses/mit/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
+            <a href="https://choosealicense.com/licenses/gpl-3.0/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pangocffi.svg?style=flat"></a>
             <a href='https://manimpango.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/manimpango/badge/?version=latest' alt='Documentation Status' /></a>
             <br>

{ManimPango-0.2.4 → ManimPango-0.2.5}/ManimPango.egg-info/SOURCES.txt

@@ -1,7 +1,10 @@
+.coveragerc
+CODE_OF_CONDUCT.md
 LICENSE
 MANIFEST.in
 README.md
 pyproject.toml
+requirements-dev.txt
 setup.cfg
 setup.py
 ManimPango.egg-info/PKG-INFO
@@ -9,6 +12,14 @@ ManimPango.egg-info/SOURCES.txt
 ManimPango.egg-info/dependency_links.txt
 ManimPango.egg-info/not-zip-safe
 ManimPango.egg-info/top_level.txt
+docs/RELEASE.rst
+docs/conf.py
+docs/index.rst
+docs/make.bat
+docs/reference.rst
+docs/_static/favicon.ico
+docs/_templates/autosummary/class.rst
+docs/_templates/autosummary/module.rst
 manimpango/__init__.py
 manimpango/_version.py
 manimpango/cairo.pxd
@@ -21,8 +32,17 @@ manimpango/register_font.pxd
 manimpango/register_font.pyx
 manimpango/utils.py
 tests/__init__.py
+tests/_manim.py
+tests/conftest.py
+tests/svg_tester.py
 tests/test_fonts.py
 tests/test_import.py
 tests/test_list_fonts.py
 tests/test_markup.py
-tests/test_version.py
+tests/test_utils.py
+tests/test_version.py
+tests/fonts/AdobeVFPrototype.ttf
+tests/fonts/BungeeColor-Regular_colr_Windows.ttf
+tests/fonts/BungeeOutline-Regular.ttf
+tests/fonts/LICENSE.txt
+tests/fonts/NotoNastaliqUrdu-Regular.ttf

{ManimPango-0.2.4/ManimPango.egg-info → ManimPango-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ManimPango
-Version: 0.2.4
+Version: 0.2.5
 Summary: Bindings for Pango for using with Manim.
 Home-page: https://manimpango.manim.community/
 Author: Naveen M K
@@ -16,7 +16,7 @@ Description: # ManimPango
             <a href="https://pypi.org/project/manimpango/"><img src="https://img.shields.io/pypi/v/manimpango.svg?style=flat&logo=pypi" alt="PyPI Latest Release"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Wheel" src="https://img.shields.io/pypi/wheel/manimpango"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/manimpango"></a>
-            <a href="http://choosealicense.com/licenses/mit/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
+            <a href="https://choosealicense.com/licenses/gpl-3.0/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
             <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pangocffi.svg?style=flat"></a>
             <a href='https://manimpango.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/manimpango/badge/?version=latest' alt='Documentation Status' /></a>
             <br>

{ManimPango-0.2.4 → ManimPango-0.2.5}/README.md

@@ -4,7 +4,7 @@
     <a href="https://pypi.org/project/manimpango/"><img src="https://img.shields.io/pypi/v/manimpango.svg?style=flat&logo=pypi" alt="PyPI Latest Release"></a>
     <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Wheel" src="https://img.shields.io/pypi/wheel/manimpango"></a>
     <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dm/manimpango"></a>
-    <a href="http://choosealicense.com/licenses/mit/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
+    <a href="https://choosealicense.com/licenses/gpl-3.0/"><img alt="PyPI - License" src="https://img.shields.io/pypi/l/manimpango"></a>
     <a href="https://pypi.org/project/manimpango/"><img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/pangocffi.svg?style=flat"></a>
     <a href='https://manimpango.readthedocs.io/en/latest/?badge=latest'><img src='https://readthedocs.org/projects/manimpango/badge/?version=latest' alt='Documentation Status' /></a>
     <br>

ManimPango-0.2.5/docs/RELEASE.rst

@@ -0,0 +1,52 @@
+Release Procedure
+=================
+
+This is the **maintainer** note on how to Release.
+All versioning is in accordance to
+`Semantic Versioning 2.0.0 <https://semver.org/>`_.
+This means older version would have a backport of bugs fixes.
+
+1. Check whether the test suite passes on the main branch.
+
+2. Revert any changes which seems to be not working, and check
+   for the milestone if PR are merged accordingly.
+
+3. Check whether the `Wheels Build`_,
+   against the main branch works as expected.
+
+4. Clone the repository locally.
+
+5. Bump the version in `manimpango/_version`_ accordingly.
+
+6. Make a commit with the changes done, as ``Release v<version here>``
+
+7. Create a tag, locally with
+
+.. code-block:: sh
+
+   git tag -s v<version-number>
+
+.. note::
+
+    Here, ``-s`` is used to sign the tag with gpg so that users
+    can later verify it, and a tag shouldn't be created with
+    signing because Github shows it unverified.
+.. important::
+
+    The message should include the changelog of the release.
+
+8. Push the tag to remote.
+
+9. Go to `Github`_, and `draft a new release`_ with the same tag pushed.
+
+10. Check whether the CI uploads the wheels and the ``.tar.gz`` file to
+    PyPi.
+
+11. Finally, test the ``.tar.gz`` which was uploaded to `PyPi`_, and install
+    it in a new virtual environment.
+
+.. _Wheels Build: https://github.com/ManimCommunity/ManimPango/actions?query=workflow%3A%22Build+Wheels%22
+.. _manimpango/_version: https://github.com/ManimCommunity/ManimPango/blob/main/manimpango/_version.py
+.. _Github: https://github.com
+.. _draft a new release: https://docs.github.com/en/free-pro-team@latest/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release
+.. _PyPi: https://pypi.org/project/manimpango/

ManimPango-0.2.5/docs/_templates/autosummary/class.rst

@@ -0,0 +1,19 @@
+{{ fullname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+   :show-inheritance:
+   :members:
+
+   {% block methods %}
+   {%- if methods %}
+   .. rubric:: {{ _('Methods') }}
+
+   .. autosummary::
+      :nosignatures:
+      {% for item in methods if item != '__init__' and item not in inherited_members %}
+      ~{{ name }}.{{ item }}
+      {%- endfor %}
+   {%- endif %}
+   {%- endblock %}

ManimPango-0.2.5/docs/_templates/autosummary/module.rst

@@ -0,0 +1,50 @@
+{{ fullname | escape | underline }}
+
+.. currentmodule:: {{ fullname }}
+
+.. automodule:: {{ fullname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Module Attributes
+
+   .. autosummary::
+   {% for item in attributes %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block classes %}
+   {% if classes %}
+   .. rubric:: Classes
+
+   .. autosummary::
+      :toctree: .
+      :nosignatures:
+      {% for class in classes %}
+        {{ class }}
+      {% endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block functions %}
+   {% if functions %}
+   .. rubric:: {{ _('Functions') }}
+
+   {% for item in functions %}
+   .. autofunction:: {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block exceptions %}
+   {% if exceptions %}
+   .. rubric:: {{ _('Exceptions') }}
+
+   .. autosummary::
+   {% for item in exceptions %}
+      {{ item }}
+   {%- endfor %}
+   {% endif %}
+   {% endblock %}

ManimPango-0.2.5/docs/conf.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*-
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath(".."))
+
+
+from pathlib import Path
+
+# -- Project information -----------------------------------------------------
+from pkg_resources import get_distribution
+
+project = "ManimPango"
+copyright = "2021, The Manim Community Dev Team"
+author = "The Manim Community Dev Team"
+
+release = get_distribution("ManimPango").version
+version = ".".join(release.split(".")[:2])
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+    "sphinx.ext.extlinks",
+    "sphinx.ext.intersphinx",
+    "sphinxext.opengraph",
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "furo"
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ["_static"]
+html_favicon = str(Path("_static/favicon.ico"))
+autosummary_generate = True
+
+# generate documentation from type hints
+autodoc_typehints = "description"
+autoclass_content = "both"
+
+# controls whether functions documented by the autofunction directive
+# appear with their full module names
+add_module_names = False
+
+intersphinx_mapping = {
+    "manim": ("https://docs.manim.community/en/v0.2.0", None),
+    "python": ("https://docs.python.org/3", None),
+}
+
+ogp_image = "https://www.manim.community/logo.png"
+ogp_site_name = "Manim Pango | Documentation"
+ogp_site_url = "https://manimpango.manim.community/"

ManimPango-0.2.5/docs/index.rst

@@ -0,0 +1,16 @@
+ManimPango's documentation!
+===========================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+   reference
+   RELEASE
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

ManimPango-0.2.5/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

ManimPango-0.2.5/docs/reference.rst

@@ -0,0 +1,22 @@
+Manimpango Reference
+====================
+
+.. autosummary::
+   :toctree: reference
+
+   manimpango.TextSetting
+   manimpango.PangoUtils
+   manimpango.text2svg
+   manimpango.MarkupUtils
+   manimpango.register_font
+   manimpango.unregister_font
+   manimpango.list_fonts
+
+Enums
+=====
+.. autosummary::
+   :toctree: reference
+
+   manimpango.Style
+   manimpango.Weight
+   manimpango.Variant

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/__init__.py

@@ -3,7 +3,7 @@ import os
 
 from ._version import __version__  # noqa: F403,F401
 
-if os.name == "nt":
+if os.name == "nt":  # pragma: no cover
     os.environ["PATH"] = (
         f"{os.path.abspath(os.path.dirname(__file__))}"
         f"{os.pathsep}"
@@ -13,5 +13,5 @@ try:
     from .cmanimpango import *  # noqa: F403,F401
     from .enums import *  # noqa: F403,F401
     from .register_font import *  # noqa: F403,F401
-except ImportError:
+except ImportError:  # pragma: no cover
     raise ImportError("Couldn't load the necessary Shared Libraries.")

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/_version.py

@@ -1,2 +1,2 @@
 # -*- coding: utf-8 -*-
-__version__ = "0.2.4"
+__version__ = "0.2.5"

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/cmanimpango.pyx

@@ -1,5 +1,7 @@
 from xml.sax.saxutils import escape
 from .utils import *
+from .enums import Alignment
+import warnings
 
 class TextSetting:
     """Formatting for slices of a :class:`manim.mobject.svg.text_mobject.Text` object."""
@@ -138,13 +140,18 @@ class MarkupUtils:
         slant: str,
         weight: str,
         size: int,
-        line_spacing: int,
+        _: int, # for some there was a keyword here.
         disable_liga: bool,
         file_name: str,
         START_X: int,
         START_Y: int,
         width: int,
         height: int,
+        *, # keyword only arguments below
+        justify: bool = None,
+        indent: float = None,
+        line_spacing: float = None,
+        alignment: Alignment = None
     ) -> int:
         """Render an SVG file from a :class:`manim.mobject.svg.text_mobject.MarkupText` object."""
         cdef cairo_surface_t* surface
@@ -152,8 +159,9 @@ class MarkupUtils:
         cdef PangoFontDescription* font_desc
         cdef PangoLayout* layout
         cdef cairo_status_t status
-        cdef double width_layout = width
+        cdef double width_layout = width - 50
         cdef double font_size = size
+        cdef int temp_int # a temporary C integer for conversion
 
         file_name_bytes = file_name.encode("utf-8")
 
@@ -182,8 +190,32 @@ class MarkupUtils:
             cairo_destroy(context)
             cairo_surface_destroy(surface)
             raise MemoryError("Pango.Layout can't be created from Cairo Context.")
+
         pango_layout_set_width(layout, pango_units_from_double(width_layout))
 
+        if justify:
+            pango_layout_set_justify(layout, justify)
+
+        if indent:
+            temp_int = pango_units_from_double(indent)
+            pango_layout_set_indent(layout, temp_int)
+
+        if line_spacing:
+            # Typical values are: 0, 1, 1.5, 2.
+            ret = set_line_width(layout, line_spacing)
+            if not ret:
+                # warn that line spacing don't work
+                # because of old Pango version they
+                # have
+                warnings.warn(
+                    "Pango Version<1.44 found."
+                    "Impossible to set line_spacing."
+                    "Expect Ugly Output."
+                )
+
+        if alignment:
+            pango_layout_set_alignment(layout, alignment.value)
+
         font_desc = pango_font_description_new()
         if font_desc==NULL:
             cairo_destroy(context)

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/enums.pyx

@@ -90,3 +90,21 @@ class Variant(Enum):
     """
     NORMAL = PANGO_VARIANT_NORMAL
     SMALL_CAPS = PANGO_VARIANT_SMALL_CAPS
+
+class Alignment(Enum):
+    """
+    An enumeration specifying alignment.
+
+    Attributes
+    ----------
+
+    NORMAL :
+        A normal font.
+
+    SMALL_CAPS :
+        A font with the lower case characters replaced by smaller variants
+        of the capital characters.
+    """
+    LEFT = PANGO_ALIGN_LEFT
+    CENTER = PANGO_ALIGN_CENTER
+    RIGHT = PANGO_ALIGN_RIGHT

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/pango.pxd

@@ -37,6 +37,10 @@ cdef extern from "pango/pangocairo.h":
         PANGO_WRAP_WORD
         PANGO_WRAP_CHAR
         PANGO_WRAP_WORD_CHAR
+    ctypedef enum PangoAlignment:
+        PANGO_ALIGN_LEFT
+        PANGO_ALIGN_CENTER
+        PANGO_ALIGN_RIGHT
     PangoLayout* pango_cairo_create_layout(cairo_t* cr)
     void pango_cairo_show_layout(
         cairo_t* cr,
@@ -121,3 +125,34 @@ cdef extern from "pango/pangocairo.h":
     const char* pango_font_family_get_name(
         PangoFontFamily *family
     )
+    void pango_layout_set_justify(
+        PangoLayout *layout,
+        gboolean justify
+    )
+    void pango_layout_set_indent(
+        PangoLayout *layout,
+        int indent
+    )
+    void pango_layout_set_alignment(
+        PangoLayout *layout,
+        PangoAlignment alignment
+    )
+
+cdef extern from *:
+    """
+    #if PANGO_VERSION_CHECK(1,44,0)
+        int set_line_width(PangoLayout *layout,float spacing)
+        {
+          pango_layout_set_line_spacing(layout, spacing);
+          return 1;
+        }
+    #else
+        int set_line_width(PangoLayout *layout,float spacing){return 0;}
+    #endif
+    """
+    # The above docs string is C which is used to
+    # check for the Pango Version there at run time.
+    # pango_layout_set_line_spacing is only avaiable only for
+    # pango>=1.44.0 but we support pango>=1.30.0 that why this
+    # conditionals.
+    bint set_line_width(PangoLayout *layout,float spacing)

{ManimPango-0.2.4 → ManimPango-0.2.5}/manimpango/utils.py

@@ -30,8 +30,6 @@ class PangoUtils:
             return Weight.ULTRALIGHT
         elif string == "LIGHT":
             return Weight.LIGHT
-        elif string == "SEMILIGHT":
-            return Weight.SEMILIGHT
         elif string == "BOOK":
             return Weight.BOOK
         elif string == "MEDIUM":

ManimPango-0.2.5/requirements-dev.txt

@@ -0,0 +1,5 @@
+pytest-cov
+pytest
+Cython
+coverage
+manim>0.2.0

{ManimPango-0.2.4 → ManimPango-0.2.5}/setup.cfg

@@ -6,6 +6,11 @@ license_files =
 [flake8]
 max-line-length = 88
 
+[tool:pytest]
+testpaths = 
+	tests
+addopts = --cov --no-cov-on-fail --basetemp=.pytest_temp
+
 [egg_info]
 tag_build = 
 tag_date = 0

{ManimPango-0.2.4 → ManimPango-0.2.5}/setup.py

@@ -19,6 +19,11 @@ try:
 except ImportError:
     USE_CYTHON = False
 
+coverage = False
+if sys.argv[-1] == "--coverage":
+    coverage = True
+    sys.argv.pop()
+
 
 def get_version():
     version_file = "manimpango/_version.py"
@@ -166,7 +171,6 @@ class PKG_CONFIG:
             known_cflags, unknown_cflags = self.parse_cflags(raw_cflags.decode("utf8"))
             if unknown_cflags:
                 known_cflags["extra_compile_args"] = unknown_cflags.split()
-            # return update_dict(known_cflags, known_libs)
             return known_cflags
         return dict()
 
@@ -197,6 +201,9 @@ if sys.platform == "win32":
         returns["define_macros"] += [("UNICODE", 1)]
     else:
         returns["define_macros"] = [("UNICODE", 1)]
+if coverage:
+    returns["define_macros"] += [("CYTHON_TRACE", 1)]
+    returns["define_macros"] += [("CYTHON_TRACE_NOGIL", 1)]
 
 ext_modules = [
     Extension(
@@ -221,6 +228,7 @@ if USE_CYTHON:
         language_level=3,
         include_path=["manimpango"],
         gdb_debug=DEBUG,
+        compiler_directives={"linetrace": coverage},
     )
 with open("README.md") as fh:
     long_description = fh.read()
@@ -259,6 +267,6 @@ setup(
     },
     ext_modules=ext_modules,
     package_data={
-        "manimpango": ["*.pxd"],
+        "manimpango": ["*.pxd", "*.pyx"],
     },
 )

{ManimPango-0.2.4 → ManimPango-0.2.5}/tests/__init__.py

@@ -29,3 +29,13 @@ def delete_media_dir():
 
 set_dll_search_path()
 delete_media_dir()
+CASES_DIR = Path(Path(__file__).parent, "cases").absolute()
+FONT_DIR = Path(__file__).parent / "fonts"
+
+import manimpango  # noqa: E402
+
+font = str((FONT_DIR / "BungeeOutline-Regular.ttf").absolute())
+orig = manimpango.list_fonts()
+assert manimpango.register_font(font)
+final = manimpango.list_fonts()
+main_font = list(set(final) - set(orig))[0]

ManimPango-0.2.5/tests/_manim.py

@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""This file contains helpers for the tests copied and modified
+from Manim.
+"""
+
+import os
+from pathlib import Path
+
+from manimpango import Alignment, MarkupUtils
+
+
+class MarkupText:
+    def __init__(
+        self,
+        text: str,
+        *,
+        size: int = 1,
+        line_spacing: int = None,
+        font: str = None,
+        slant: str = "NORMAL",
+        weight: str = "NORMAL",
+        tab_width: int = 4,
+        disable_ligatures: bool = False,
+        justify: bool = None,
+        indent: float = None,
+        alignment: Alignment = None,
+        # for the tests
+        filename: str = "test.svg",
+        **kwargs,
+    ):
+        self.text = text
+        self.size = size
+        self.line_spacing = line_spacing
+        self.font = font
+        self.slant = slant
+        self.weight = weight
+        self.tab_width = tab_width
+        self.filename = filename
+        self.original_text = text
+        self.disable_ligatures = disable_ligatures
+
+        self.justify = justify
+        self.indent = indent
+        self.alignment = alignment
+        if not MarkupUtils.validate(self.text):
+            raise ValueError(
+                f"Pango cannot parse your markup in {self.text}. "
+                "Please check for typos, unmatched tags or unescaped "
+                "special chars like < and &."
+            )
+        self.text2svg()
+
+    def text2svg(self):
+        """Convert the text to SVG using Pango."""
+        size = self.size * 10
+        dir_name = Path(self.filename).parent
+        disable_liga = self.disable_ligatures
+        if not os.path.exists(dir_name):
+            os.makedirs(dir_name)
+        file_name = self.filename
+        return MarkupUtils.text2svg(
+            f"{self.text}",
+            self.font,
+            self.slant,
+            self.weight,
+            size,
+            True,  # stray positional argument
+            disable_liga,
+            file_name,
+            20,
+            20,
+            600,  # width
+            400,  # height
+            justify=self.justify,
+            indent=self.indent,
+            line_spacing=self.line_spacing,
+            alignment=self.alignment,
+        )
+
+    def __repr__(self):
+        return f"MarkupText({repr(self.original_text)})"

ManimPango-0.2.5/tests/conftest.py

@@ -0,0 +1,10 @@
+# -*- coding: utf-8 -*-
+import manimpango
+
+
+def pytest_report_header(config):
+    return (
+        f"ManimPango version {manimpango.__version__}\n"
+        f"Pango version {manimpango.pango_version()}\n"
+        f"Cairo version {manimpango.cairo_version()}"
+    )

ManimPango-0.2.5/tests/fonts/LICENSE.txt

@@ -0,0 +1,6 @@
+NotoNastaliqUrdu-Regular.ttf from https://github.com/googlei18n/noto-fonts
+BungeeColor-Regular_colr_Windows.ttf, from https://github.com/djrrb/bungee
+AdobeVFPrototype.ttf, from https://github.com/adobe-fonts/adobe-variable-font-prototype
+BungeeOutline-Regular.ttf, from https://fonts.google.com/specimen/Bungee+Outline
+
+All of the above fonts are published under the SIL Open Font License (OFL) v1.1 (http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=OFL), which allows you to copy, modify, and redistribute them if you need to.

ManimPango-0.2.5/tests/svg_tester.py

@@ -0,0 +1,134 @@
+# -*- coding: utf-8 -*-
+from pathlib import Path
+from typing import Dict
+from xml.parsers.expat import ParserCreate
+
+
+class SVGUtils:
+    SVG_DEFAULT_ATTRIBUTES: Dict[str, str] = {
+        "fill": "black",
+        "fill-opacity": "1",
+        "stroke": "none",
+        "stroke-opacity": "1",
+    }
+
+    def __init__(self) -> None:
+        pass
+
+    def parse_color_string(self, color_spec: str) -> str:
+        # copied from Manim's SVG parser.
+        if color_spec[0:3] == "rgb":
+            # these are only in integer form,
+            # but the Colour module wants them in floats.
+            splits = color_spec[4:-1].split(",")
+            if splits[0][-1] == "%":
+                # if the last character of the first number is a percentage,
+                # then interpret the number as a percentage
+                parsed_rgbs = [float(i[:-1]) / 100.0 for i in splits]
+            else:
+                parsed_rgbs = [int(i) / 255.0 for i in splits]
+
+            # hex_color = rgb_to_hex(parsed_rgbs)
+
+        else:
+            # not necessary for web2hex case and hex
+            raise NotImplementedError
+
+        return parsed_rgbs
+
+    def str2styledict(self, style_specs: str) -> Dict[str, str]:
+        # helper for parse style
+        # copied from manim's svg parser.
+        style = {}
+
+        # the style attribute should be handled separately in order to
+        # break it up nicely. furthermore, style takes priority over other
+        # attributes in the same element.
+        if style_specs:
+            for style_spec in style_specs.split(";"):
+                try:
+                    key, value = style_spec.split(":")
+                except ValueError as e:
+                    if not style_spec:
+                        # there was just a stray semicolon
+                        # at the end, producing an
+                        # emptystring
+                        pass
+                    else:
+                        raise e
+                else:
+                    style[key] = value
+
+        return style
+
+    def parse_style(self, stylestr: str) -> Dict:
+        # Originally written by @MrMallIronmaker
+        # Copied from Manim.
+        # https://github.com/ManimCommunity/manim/
+        # blob/aa873e0f8e5c4f35c864568213b04b88af5b4769/manim/mobject/svg/style_utils.py#L143
+        SVG_DEFAULT_ATTRIBUTES = self.SVG_DEFAULT_ATTRIBUTES
+        manim_style = {}
+        svg_style = self.str2styledict(stylestr)
+        for key in SVG_DEFAULT_ATTRIBUTES:
+            if key not in svg_style:
+                svg_style[key] = SVG_DEFAULT_ATTRIBUTES[key]
+
+        if "fill-opacity" in svg_style:
+            manim_style["fill_opacity"] = float(svg_style["fill-opacity"])
+
+        if "stroke-opacity" in svg_style:
+            manim_style["stroke_opacity"] = float(svg_style["stroke-opacity"])
+
+        # nones need to be handled specially
+        if "fill" in svg_style:
+            if svg_style["fill"] == "none":
+                manim_style["fill_opacity"] = 0
+            else:
+                manim_style["fill_color"] = self.parse_color_string(svg_style["fill"])
+
+        if "stroke" in svg_style:
+            if svg_style["stroke"] == "none":
+                # In order to not break animations.creation.Write,
+                # we interpret no stroke as stroke-width of zero and
+                # color the same as the fill color, if it exists.
+                manim_style["stroke_width"] = 0
+                if "fill_color" in manim_style:
+                    manim_style["stroke_color"] = manim_style["fill_color"]
+            else:
+                manim_style["stroke_color"] = self.parse_color_string(
+                    svg_style["stroke"]
+                )
+
+        return manim_style
+
+
+class SVGStyleTester(SVGUtils):
+    def __init__(self, gotSVG: Path, expectedSVG: Path) -> None:
+        self.expected_file = expectedSVG
+        self.got_file = gotSVG
+        self.prepare()
+
+    def get_handler(self, final_setter):
+        def func(name, attrs):
+            styles = []
+            if name == "g":
+                if "style" in attrs:
+                    styles.append(self.parse_style(attrs["style"]))
+            if styles:
+                # need to think of better way than this.
+                exec(f"self.{final_setter} += [styles]")
+
+        return func
+
+    def prepare(self):
+        self.got_svg_style = []
+        self.expected_svg_style = []
+        got_parser = ParserCreate()
+        got_parser.StartElementHandler = self.get_handler("got_svg_style")
+        with open(self.got_file, "rb") as f:
+            got_parser.ParseFile(f)
+
+        expected_parser = ParserCreate()
+        expected_parser.StartElementHandler = self.get_handler("expected_svg_style")
+        with open(self.expected_file, "rb") as f:
+            expected_parser.ParseFile(f)

{ManimPango-0.2.4 → ManimPango-0.2.5}/tests/test_fonts.py

@@ -8,7 +8,9 @@ import pytest
 
 import manimpango
 
-FONT_DIR = Path(__file__).parent / "fonts"
+from . import FONT_DIR, main_font
+from ._manim import MarkupText
+
 font_lists = {
     (FONT_DIR / "AdobeVFPrototype.ttf").absolute(): "Adobe Variable Font Prototype",
     (
@@ -76,4 +78,20 @@ def test_fail_just_unregister():
 )
 @pytest.mark.skipif(sys.platform.startswith("darwin"), reason="unsupported api for mac")
 def test_unregister_linux():
-    manimpango.unregister_font("random")
+    assert manimpango.unregister_font("random")
+
+
+@pytest.mark.skipif(
+    sys.platform.startswith("linux"), reason="unsupported api for linux"
+)
+def test_adding_dummy_font(tmpdir):
+    dummy = tmpdir / "font.ttf"
+    with open(dummy, "wb") as f:
+        f.write(b"dummy")
+    assert not manimpango.register_font(str(dummy)), "Registered a dummy font?"
+
+
+def test_fonts_render(tmpdir):
+    filename = str(Path(tmpdir) / "hello.svg")
+    MarkupText("Hello World", font=main_font, filename=filename)
+    assert Path(filename).exists()

ManimPango-0.2.5/tests/test_markup.py

@@ -0,0 +1,99 @@
+# -*- coding: utf-8 -*-
+from pathlib import Path
+
+import manimpango
+
+from . import CASES_DIR
+from ._manim import MarkupText
+from .svg_tester import SVGStyleTester
+
+ipsum_text = (
+    "<b>Lorem ipsum dolor</b> sit amet, <i>consectetur</i> adipiscing elit,"
+    "sed do eiusmod tempor incididunt ut labore et dolore"
+    "magna aliqua. Ut enim <b>ad</b> minim veniam, quis nostrud"
+    "exercitation ullamco laboris nisi ut aliquip"
+    "ex ea commodo consequat. Duis aute irure dolor"
+    "in reprehenderit in voluptate velit esse cillum"
+    "dolore eu fugiat nulla pariatur. Excepteur sint"
+    "occaecat cupidatat non proident, sunt in culpa qui"
+    "officia deserunt mollit anim id est laborum."
+)
+
+
+def test_good_markup():
+
+    assert manimpango.MarkupUtils.validate(
+        "foo",
+    ), '"foo" should not fail validation'
+    assert manimpango.MarkupUtils.validate(
+        "<b>bar</b>"
+    ), '"<b>bar</b>" should not fail validation'
+    assert manimpango.MarkupUtils.validate(
+        "வணக்கம்",
+    ), '"வணக்கம்" should not fail'
+
+
+def test_bad_markup():
+
+    assert not manimpango.MarkupUtils.validate(
+        "<b>foo"
+    ), '"<b>foo" should fail validation (unbalanced tags)'
+    assert not manimpango.MarkupUtils.validate(
+        "<xyz>foo</xyz>"
+    ), '"<xyz>foo</xyz>" should fail validation (invalid tag)'
+
+
+def test_markup_text(tmpdir):
+    loc = Path(tmpdir, "test.svg")
+    assert not loc.exists()
+    MarkupText(
+        '<span underline="error"><b><i>Hello Manim</i></b></span>', filename=str(loc)
+    )
+    assert loc.exists()
+
+
+def test_markup_justify(tmpdir):
+    # don't know how to verify this correctly
+    # it varies upon diffent system so, we are
+    # just check whether it runs
+    loc = Path(tmpdir, "test.svg")
+    assert not loc.exists()
+    MarkupText(ipsum_text, justify=True, filename=str(loc))
+    assert loc.exists()
+
+
+def test_markup_indent(tmpdir):
+    # don't know how to verify this correctly
+    # it varies upon diffent system so, we are
+    # just check whether it runs
+    loc = Path(tmpdir, "test.svg")
+    assert not loc.exists()
+    MarkupText(ipsum_text, indent=10, filename=str(loc))
+    assert loc.exists()
+
+
+def test_markup_alignment(tmpdir):
+    # don't know how to verify this correctly
+    # it varies upon diffent system so, we are
+    # just check whether it runs
+    loc = Path(tmpdir, "test.svg")
+    assert not loc.exists()
+    MarkupText(
+        ipsum_text,
+        alignment=manimpango.Alignment.CENTER,
+        filename=str(loc),
+    )
+    assert loc.exists()
+
+
+def test_markup_style(tmpdir):
+    test_case = CASES_DIR / "hello_blue_world_green.svg"
+    expected = tmpdir / "expected.svg"
+    text = "<span foreground='BLUE'>Hello</span>\n<span foreground='GREEN'>World</span>"
+    MarkupText(
+        text,
+        filename=str(expected),
+    )
+    s = SVGStyleTester(gotSVG=expected, expectedSVG=test_case)
+    assert len(s.got_svg_style) == len(s.expected_svg_style)
+    assert s.got_svg_style == s.expected_svg_style

ManimPango-0.2.5/tests/test_utils.py

@@ -0,0 +1,40 @@
+# -*- coding: utf-8 -*-
+import pytest
+
+from manimpango.enums import Style, Weight
+from manimpango.utils import PangoUtils
+
+
+def test_str2style():
+    p = PangoUtils()
+
+    assert p.str2style("NORMAL") == Style.NORMAL
+    assert p.str2style("ITALIC") == Style.ITALIC
+    assert p.str2style("OBLIQUE") == Style.OBLIQUE
+
+    with pytest.raises(AttributeError) as exc_info:
+        p.str2style("DNE")
+    exception_raised = exc_info.value
+    assert "There is no Style Called DNE" == str(exception_raised)
+
+
+def test_str2weight():
+    p = PangoUtils()
+
+    assert p.str2weight("NORMAL") == Weight.NORMAL
+    assert p.str2weight("BOLD") == Weight.BOLD
+    assert p.str2weight("THIN") == Weight.THIN
+    assert p.str2weight("THIN") == Weight.THIN
+    assert p.str2weight("ULTRALIGHT") == Weight.ULTRALIGHT
+    assert p.str2weight("LIGHT") == Weight.LIGHT
+    assert p.str2weight("BOOK") == Weight.BOOK
+    assert p.str2weight("MEDIUM") == Weight.MEDIUM
+    assert p.str2weight("SEMIBOLD") == Weight.SEMIBOLD
+    assert p.str2weight("ULTRABOLD") == Weight.ULTRABOLD
+    assert p.str2weight("HEAVY") == Weight.HEAVY
+    assert p.str2weight("ULTRAHEAVY") == Weight.ULTRAHEAVY
+
+    with pytest.raises(AttributeError) as exc_info:
+        p.str2weight("DNE")
+    exception_raised = exc_info.value
+    assert "There is no Font Weight Called DNE" == str(exception_raised)

ManimPango-0.2.4/MANIFEST.in

@@ -1,4 +0,0 @@
-global-include *.pyx
-recursive-include tests *.py
-prune docs/_build
-recursive-include docs

ManimPango-0.2.4/tests/test_markup.py

@@ -1,24 +0,0 @@
-# -*- coding: utf-8 -*-
-def test_good_markup():
-    import manimpango  # noqa: F401
-
-    assert manimpango.MarkupUtils.validate(
-        "foo",
-    ), '"foo" should not fail validation'
-    assert manimpango.MarkupUtils.validate(
-        "<b>bar</b>"
-    ), '"<b>bar</b>" should not fail validation'
-    assert manimpango.MarkupUtils.validate(
-        "வணக்கம்",
-    ), '"வணக்கம்" should not fail'
-
-
-def test_bad_markup():
-    import manimpango  # noqa: F401
-
-    assert not manimpango.MarkupUtils.validate(
-        "<b>foo"
-    ), '"<b>foo" should fail validation (unbalanced tags)'
-    assert not manimpango.MarkupUtils.validate(
-        "<xyz>foo</xyz>"
-    ), '"<xyz>foo</xyz>" should fail validation (invalid tag)'