ManimPango 0.6.0__cp313-cp313-macosx_10_13_x86_64.whl

ManimPango-0.6.0.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.1
+Name: ManimPango
+Version: 0.6.0
+Summary: Bindings for Pango for using with Manim.
+Home-page: https://manimpango.manim.community/
+Author: Naveen M K
+Author-email: naveen@manim.community
+Maintainer: The Manim Community Developers
+License: MIT
+Project-URL: Documentation, https://manimpango.manim.community/
+Project-URL: Source, https://github.com/ManimCommunity/manimpango
+Project-URL: Release notes, https://github.com/ManimCommunity/ManimPango/releases/
+Keywords: cython,pango,cairo,manim
+Platform: Linux
+Platform: macOS
+Platform: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Cython
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.bin
+
+# ManimPango
+
+<p align="center">
+    <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="https://choosealicense.com/licenses/mit/"><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/ManimPango.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>
+    <img src="https://github.com/ManimCommunity/manimpango/workflows/Build%20Wheels/badge.svg">
+</p>
+
+**ManimPango** is a C binding for [Pango](https://pango.gnome.org/) using [Cython](https://cython.org/), which is internally used in [Manim](https://www.manim.community) to render (non-LaTeX) text.
+
+
+
+## INSTALL
+
+Installing **ManimPango** is super easy, just use `pip`. It is [`manimpango`](https://pypi.org/project/manimpango/) in PyPi.
+
+```sh
+pip install manimpango
+```
+
+For **Linux Users**, there are no Wheels. You must have a C compiler as well as **Pango** and its dependencies along with the **Pango** development headers. See [BUILDING](#BUILDING) for more information.
+
+## WORKFLOW SETUP / CONTRIBUTING
+
+To make it easier for developers to contribute, we have a pre-commit workflow that will check for `black` formatting and `flake` checking.
+
+```sh
+pip install pre-commit
+pre-commit install
+```
+
+## BUILDING
+
+### Linux/MacOS
+
+For building **ManimPango**, you need
+* a C compiler
+* Python's development headers
+* [`pkg-config`](https://www.freedesktop.org/wiki/Software/pkg-config/)
+* [Pango](https://pango.gnome.org) along with its development headers and its dependencies.
+
+If you are on MacOS, you can use [brew](https://brew.sh) to install those. Using [MacPorts](https://www.macports.org) is also possible.
+
+```sh
+brew install pango pkg-config
+```
+
+If you are on Linux, you can use a system package manager to do so. For example, if you are on Debian based system, you can use `apt`
+
+```sh
+apt install libpango1.0-dev pkg-config python3-dev
+```
+
+**Arch Linux:** `pacman -S pango pkgconf`
+
+**Fedora:** `dnf install pango-devel pkg-config python3-devel`
+
+Or similar in your system's package manager.
+
+#### Using `tar` archives
+
+If you don't want to contribute to this repository, you can use the tar archives published in PyPi, or just use `pip` to install using
+
+```sh
+pip install manimpango --no-binary :all:
+```
+
+**Note**: `pip` by default uses wheels, so make sure to pass the `--no-binary` parameter.
+
+#### Using `git` clones / Contributing
+
+Please remember to do this inside your virtual environment, if you want to use your **Manimpango** with **Manim**.
+
+```sh
+python -m venv ./venv
+source venv/bin/activate # Linux/macOS
+venv\Scripts\activate # Windows
+```
+
+If you are using a clone of this repository, you will need [Cython](https://cython.org) which can be easily installed using `pip`:
+
+```sh
+pip install Cython
+```
+
+After that you can use `pip` to install the clone with the following command:
+
+```sh
+pip install -e .
+pip install -r requirements-dev.txt .
+```
+
+Next, run the setup script:
+
+```sh
+python setup.py build_ext -i
+```
+
+After installation is complete, you should be able to run pytest:
+
+```sh
+pytest
+```
+
+You will need to this way if you want to *contribute* to **ManimPango**.
+
+### Contributing with Windows
+
+*If you are a normal user, don't read this, you have wheels which you can just install directly using pip.*
+
+If you want to contribute to **ManimPango** and you are on Windows, this section is for you.
+
+As Windows does not include a C compiler by default, you will first need to install one. You have two choices:
+
+1. MinGW/Msys2
+
+2. Visual Studio
+
+#### MinGW/Msys2
+
+1. Download **MSYS2** from the download link provided on their page https://www.msys2.org/#installation and install it according to their instructions.
+2. Once you have **MSYS2** installed,  it offers you three different shells: the **MinGW32** shell, the **MinGW64** shell and **MSYS** shell. In order for the following steps to work, you have to open the **MSYS2 MinGW64** shell (you can search for this). Small hint: it has a blue color logo.
+3. Run the following commands to install Python, Pango, Cython, Numpy, Scipy, Pillow, Pycairo and ffmpeg
+```sh
+pacman -S mingw-w64-x86_64-python
+pacman -S mingw-w64-x86_64-python-pip
+pacman -S mingw-w64-x86_64-pango
+pacman -S mingw-w64-x86_64-cython
+pacman -S mingw-w64-x86_64-python-numpy
+pacman -S mingw-w64-x86_64-python-scipy
+pacman -S mingw-w64-x86_64-python-pillow
+pacman -S mingw-w64-x86_64-python-cairo
+pacman -S mingw-w64-x86_64-ffmpeg
+```
+4. Still in the same shell, install **Manim** using `pip install manim`.
+5. Finally, get your clone of **ManimPango**, `cd` into that directory and then run `pip install -e .`.
+**Note** You can't use it with your regular Python version. It will cause weird errors if you do so. For working with **ManimPango**, you must be inside the `MSYS2 MINGW64 shell`.
+6. You can then use `manim` inside that shell, to run **Manim**.
+**Hint**: If you want to try out Python interactively, you can open `idle` using the command `python -m idlelib`  inside that shell.
+
+#### Visual Studio
+
+First, install Visual Studio as specified in https://wiki.python.org/moin/WindowsCompilers. Possibly Visual Studio Build Tools 2022 with Windows10 SDK.
+
+Then run the script at `packing/download_dlls.py`. This will get a **Pango** build along with `pkg-config` and install it at `C:\cibw\vendor`. Add `C:\cibw\vendor\bin` to PATH.
+
+**Note:** You can change the install location by editing line 24 of the file `packing/download_dlls.py`.
+
+Then set an environment variable `PKG_CONFIG_PATH`=`C:\cibw\vendor\lib\pkgconfig`.
+
+Then you can install Cython using
+
+```sh
+pip install Cython
+```
+
+Finally, you can install your local **ManimPango** clone just like any other python package by typing:
+
+```sh
+pip install .
+```
+
+## Code of Conduct
+
+Our full code of conduct, and how we enforce it, can be read on [our website](https://docs.manim.community/en/latest/conduct.html).
+
+## License
+
+This project is licensed under MIT License. The wheels distributed on PyPI contains compiled version of Pango and Cairo subject to terms of the GNU LGPL and other licenses. Consult the licenses of each library for more informations.

ManimPango-0.6.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+ManimPango-0.6.0.dist-info/RECORD,,
+ManimPango-0.6.0.dist-info/LICENSE,sha256=PkzdSXTMd8X-B3IFjUlsGc9eDGAM9x7DAt8iBgLj7sg,1067
+ManimPango-0.6.0.dist-info/WHEEL,sha256=D4knibqS7go0mKn2AokLuLqlOVIDup2AjlFmMoS-Dks,111
+ManimPango-0.6.0.dist-info/top_level.txt,sha256=_7RXNU2cbck8IbstWHzYv6YV58wtKUDBX-pmUjE6SKs,11
+ManimPango-0.6.0.dist-info/LICENSE.bin,sha256=qM2kte-MyVxokaHNRdgyYS0aH1yP2uLXfOwzqkLPtlA,160378
+ManimPango-0.6.0.dist-info/METADATA,sha256=OFxqPaRwxK9SJi8QCf5qTgN0UdWBJPRIxHo3c7DgcRU,7956
+manimpango/cmanimpango.pxd,sha256=qmQydFpNgEPYcDtfDhcaiAhu6-WyvQA0Tth09fO0sl4,62
+manimpango/_version.py,sha256=tBvPR0sOsOC0mL_wGk5l2NiZwbLwYUDP1D3S3jG7zOA,46
+manimpango/_register_font.pxd,sha256=0xKRYafsvYhOT2LdNuh9XfvfNQRYs4XDTCgYJTLFZ8E,2028
+manimpango/_register_font.cpython-313-darwin.so,sha256=VK9QHZChxAa0gdFECYJ5LP8bGfnGATjxCrCh8Ibb29U,7001040
+manimpango/__init__.py,sha256=ga7wc-Qp5exvu1OJqt3VhySoWUpqUIWsZCE_Fh3-_jc,1097
+manimpango/cairo.pxd,sha256=qI50gJGUuAJy9A6hRZbMMwMWqfCmG5H6Tz-EWkqmvTo,771
+manimpango/enums.pyx,sha256=ltZjDhviuWzi8pRDDkbRp3rYiZIassSpezOEOx0x3xw,2461
+manimpango/register_font.py,sha256=KMZwJlZK1liXFWl4TslOnV-2_8A_AViecQXjMdpX5UQ,3951
+manimpango/cmanimpango.cpython-313-darwin.so,sha256=CY3zN1r-KaGJj6azcDF_8VTu-1RCU7NkvUZu_5F_DnE,7206424
+manimpango/utils.py,sha256=khEmMGksIdblHNbM-Rlv4r3Cj2QmP0Jf3Eb6xP1imnc,1621
+manimpango/pango.pxd,sha256=yKu5nJUj_WP--KXshX_5i868Bc8NmdbYWoAWjaEPNBg,5344
+manimpango/_register_font.pyx,sha256=gQGvAVMMwdEqEsz148lLzODsX-E5VRPzjObwpmpYqTM,5135
+manimpango/cmanimpango.pyx,sha256=7X4q6SZGg7WpDGR23THbqqNQaPoYBxejQuG7M6fMxgk,11046
+manimpango/glib.pxd,sha256=-Ua7DTGh1FCHZc7fnOUGuCsYfl5WlW7LFpGXAq6VUNM,374
+manimpango/enums.cpython-313-darwin.so,sha256=LJmDJ6cqtBwLpFKfJBu38anhHpFNZHuWyWYhzymEICg,3975680

ManimPango-0.6.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (74.1.2)
+Root-Is-Purelib: false
+Tag: cp313-cp313-macosx_10_13_x86_64
+

ManimPango-0.6.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+manimpango

manimpango/__init__.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+import os
+import sys
+
+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 .register_font import *  # isort:skip # noqa: F403,F401
+    from .cmanimpango import *  # noqa: F403,F401
+    from .enums import *  # noqa: F403,F401
+except ImportError as ie:  # pragma: no cover
+    py_ver = ".".join(map(str, sys.version_info[:3]))
+    msg = f"""
+
+ManimPango could not import and load the necessary shared libraries.
+This error may occur when ManimPango and its dependencies are improperly set up.
+Please make sure the following versions are what you expect:
+
+    * ManimPango v{__version__}, Python v{py_ver}
+
+If you believe there is a greater problem,
+feel free to contact us or create an issue on GitHub:
+
+    * Discord: https://www.manim.community/discord/
+    * GitHub: https://github.com/ManimCommunity/ManimPango/issues
+
+Original error: {ie}
+"""
+    raise ImportError(msg)

manimpango/_register_font.pxd

@@ -0,0 +1,71 @@
+from libc.stddef cimport wchar_t
+from pango cimport *
+
+
+cdef extern from "Python.h":
+    wchar_t* PyUnicode_AsWideCharString(
+        object unicode,
+        Py_ssize_t* size
+    )
+
+cdef extern from "fontconfig/fontconfig.h":
+    ctypedef int FcBool
+    ctypedef struct FcConfig:
+        pass
+    FcBool FcConfigAppFontAddFile(
+        FcConfig* config,
+        const unsigned char* file_name
+    )
+    FcConfig* FcConfigGetCurrent()
+    void FcConfigAppFontClear(void *)
+
+# Windows and macOS specific API's
+IF UNAME_SYSNAME == "Windows":
+    cdef extern from "windows.h":
+        ctypedef const wchar_t* LPCWSTR
+        ctypedef enum DWORD:
+            FR_PRIVATE
+        int AddFontResourceExW(
+            LPCWSTR name,
+            DWORD fl,
+            unsigned int res
+        )
+        bint RemoveFontResourceExW(
+            LPCWSTR name,
+            DWORD  fl,
+            unsigned int pdv
+        )
+
+        ctypedef void* HANDLE
+        HANDLE CreateMutexA(void* lpMutexAttributes, int bInitialOwner, const char* lpName)
+        int ReleaseMutex(HANDLE hMutex)
+        int WaitForSingleObject(HANDLE hHandle, unsigned long dwMilliseconds)
+        int CloseHandle(HANDLE hObject)
+
+ELIF UNAME_SYSNAME == "Darwin":
+    cdef extern from "Carbon/Carbon.h":
+        ctypedef struct CFURLRef:
+            pass
+        ctypedef enum CTFontManagerScope:
+            kCTFontManagerScopeProcess
+        ctypedef unsigned int UInt8
+        ctypedef long CFIndex
+        ctypedef unsigned int UInt32
+        ctypedef UInt32 CFStringEncoding
+        CFURLRef CFURLCreateWithBytes(
+            void*,
+            unsigned char *URLBytes,
+            CFIndex length,
+            CFStringEncoding encoding,
+            void*
+        )
+        bint CTFontManagerRegisterFontsForURL(
+            CFURLRef fontURL,
+            CTFontManagerScope scope,
+            void* error
+        )
+        bint CTFontManagerUnregisterFontsForURL(
+            CFURLRef fontURL,
+            CTFontManagerScope scope,
+            void* error
+        )

manimpango/_register_font.pyx

@@ -0,0 +1,160 @@
+from pathlib import Path
+from pango cimport *
+
+import os
+from dataclasses import dataclass
+
+include "utils.pxi"
+
+@dataclass(frozen=True)
+class RegisteredFont:
+    """A class to represent a font file.
+
+    Attributes
+    ----------
+    path : :class:`str`
+        The path to the font file.
+    """
+
+    path: str
+    type: "fontconfig" | "win32" | "macos"
+
+cpdef bint _fc_register_font(set registered_fonts, str font_path):
+    a = Path(font_path)
+    assert a.exists(), f"font doesn't exist at {a.absolute()}"
+    font_path = os.fspath(a.absolute())
+    font_path_bytes = font_path.encode('utf-8')
+    cdef const unsigned char* fontPath = font_path_bytes
+    fontAddStatus = FcConfigAppFontAddFile(FcConfigGetCurrent(), fontPath)
+    if fontAddStatus:
+        registered_fonts.add(RegisteredFont(font_path, "fontconfig"))
+        return True
+    else:
+        return False
+
+
+cpdef bint _fc_unregister_font(set registered_fonts, str font_path):
+    FcConfigAppFontClear(NULL)
+    # remove all type "fontconfig" files
+    copy = registered_fonts.copy()
+    for font in copy:
+        if font.type == 'fontconfig':
+            registered_fonts.remove(font)
+
+    return True
+
+
+IF UNAME_SYSNAME == "Linux":
+    _register_font = _fc_register_font
+    _unregister_font = _fc_unregister_font
+
+
+ELIF UNAME_SYSNAME == "Windows":
+    cpdef bint _register_font(set registered_fonts, str font_path):
+        a = Path(font_path)
+        assert a.exists(), f"font doesn't exist at {a.absolute()}"
+        font_path = os.fspath(a.absolute())
+        cdef LPCWSTR wchar_path = PyUnicode_AsWideCharString(font_path, NULL)
+        fontAddStatus = AddFontResourceExW(
+            wchar_path,
+            FR_PRIVATE,
+            0
+        )
+
+        if fontAddStatus > 0:
+            registered_fonts.add(RegisteredFont(font_path, "win32"))
+            return True
+        else:
+            return False
+
+
+    cpdef bint _unregister_font(set registered_fonts, str font_path):
+        a = Path(font_path)
+        assert a.exists(), f"font doesn't exist at {a.absolute()}"
+        font_path = os.fspath(a.absolute())
+
+        font = RegisteredFont(font_path, "win32")
+        if font in registered_fonts:
+            registered_fonts.remove(font)
+
+        cdef LPCWSTR wchar_path = PyUnicode_AsWideCharString(font_path, NULL)
+        return RemoveFontResourceExW(
+            wchar_path,
+            FR_PRIVATE,
+            0
+        )
+
+
+ELIF UNAME_SYSNAME == "Darwin":
+    cpdef bint _register_font(set registered_fonts, str font_path):
+        a = Path(font_path)
+        assert a.exists(), f"font doesn't exist at {a.absolute()}"
+        font_path_bytes_py = str(a.absolute().as_uri()).encode('utf-8')
+        cdef unsigned char* font_path_bytes = <bytes>font_path_bytes_py
+        b = len(a.absolute().as_uri())
+        cdef CFURLRef cf_url = CFURLCreateWithBytes(NULL, font_path_bytes, b, 0x08000100, NULL)
+        res = CTFontManagerRegisterFontsForURL(
+            cf_url,
+            kCTFontManagerScopeProcess,
+            NULL
+        )
+        if res:
+            registered_fonts.add(RegisteredFont(os.fspath(a.absolute()), "macos"))
+            return True
+        else:
+            return False
+
+
+    cpdef bint _unregister_font(set registered_fonts, str font_path):
+        a = Path(font_path)
+        assert a.exists(), f"font doesn't exist at {a.absolute()}"
+        font_path_bytes_py = str(a.absolute().as_uri()).encode('utf-8')
+        cdef unsigned char* font_path_bytes = <bytes>font_path_bytes_py
+        b = len(a.absolute().as_uri())
+        cdef CFURLRef cf_url = CFURLCreateWithBytes(NULL, font_path_bytes, b, 0x08000100, NULL)
+        res = CTFontManagerUnregisterFontsForURL(
+            cf_url,
+            kCTFontManagerScopeProcess,
+            NULL
+        )
+        if res:
+            font = RegisteredFont(os.fspath(a.absolute()), "macos")
+            if font in registered_fonts:
+                registered_fonts.remove(font)
+            return True
+        else:
+            return False
+
+
+cpdef list _list_fonts(tuple registered_fonts):
+    cdef PangoFontMap* fontmap = pango_cairo_font_map_new()
+    if fontmap == NULL:
+        raise MemoryError("Pango.FontMap can't be created.")
+
+    for font in registered_fonts:
+        if font.type == 'win32':
+            add_to_fontmap(fontmap, font.path)
+
+    cdef int n_families=0
+    cdef PangoFontFamily** families=NULL
+    pango_font_map_list_families(
+        fontmap,
+        &families,
+        &n_families
+    )
+    if families is NULL or n_families == 0:
+        raise MemoryError("Pango returned unexpected length on families.")
+
+    family_list = []
+    for i in range(n_families):
+        name = pango_font_family_get_name(families[i])
+        # according to pango's docs, the `char *` returned from
+        # `pango_font_family_get_name`is owned by pango, and python
+        # shouldn't interfere with it. I hope Cython handles it.
+        # https://cython.readthedocs.io/en/stable/src/tutorial/strings.html#dealing-with-const
+        family_list.append(name.decode())
+
+    g_free(families)
+    g_object_unref(fontmap)
+    family_list.sort()
+    return family_list

manimpango/_version.py

@@ -0,0 +1,2 @@
+# -*- coding: utf-8 -*-
+__version__ = "0.6.0"

manimpango/cairo.pxd

@@ -0,0 +1,27 @@
+cdef extern from "cairo.h":
+    ctypedef struct cairo_surface_t:
+        pass
+    ctypedef struct cairo_t:
+        pass
+    ctypedef enum cairo_status_t:
+        CAIRO_STATUS_SUCCESS
+        CAIRO_STATUS_NO_MEMORY
+    cairo_t* cairo_create(cairo_surface_t* target)
+    void cairo_move_to(
+        cairo_t* cr,
+        double x,
+        double y
+    )
+    void cairo_destroy(cairo_t* cr)
+    void cairo_surface_destroy(cairo_surface_t* surface)
+
+    cairo_status_t cairo_status(cairo_t *cr)
+    const char* cairo_status_to_string(cairo_status_t status)
+    const char* cairo_version_string()
+
+cdef extern from "cairo-svg.h":
+    cairo_surface_t* cairo_svg_surface_create(
+        const char* filename,
+        double width_in_points,
+        double height_in_points
+    )

manimpango/cmanimpango.pxd

@@ -0,0 +1,3 @@
+from cairo cimport *
+from glib cimport *
+from pango cimport *