Metadata-Version: 2.1
Name: uharfbuzz
Version: 0.16.1
Summary: Streamlined Cython bindings for the harfbuzz shaping engine
Home-page: https://github.com/trufont/uharfbuzz
Author: Adrien Tétar
Author-email: adri-from-59@hotmail.fr
License: Apache License 2.0
Description: [![Githun CI Status](https://github.com/harfbuzz/uharfbuzz/workflows/Build%20+%20Deploy/badge.svg)](https://github.com/harfbuzz/uharfbuzz/actions?query=workflow%3A%22Build+%2B+Deploy%22)
        [![Appveyor Build status](https://ci.appveyor.com/api/projects/status/k52t0vwqb9rhcl9v/branch/master?svg=true)](https://ci.appveyor.com/project/fonttools/uharfbuzz/branch/master)
        [![PyPI](https://img.shields.io/pypi/v/uharfbuzz.svg)](https://pypi.org/project/uharfbuzz)
        
        ## uharfbuzz
        
        Streamlined Cython bindings for the [HarfBuzz][hb] shaping engine.
        
        
        ### Example
        
        ```python
        import sys
        
        import uharfbuzz as hb
        
        
        with open(sys.argv[1], 'rb') as fontfile:
            fontdata = fontfile.read()
        
        text = sys.argv[2]
        
        face = hb.Face(fontdata)
        font = hb.Font(face)
        
        buf = hb.Buffer()
        buf.add_str(text)
        buf.guess_segment_properties()
        
        features = {"kern": True, "liga": True}
        hb.shape(font, buf, features)
        
        infos = buf.glyph_infos
        positions = buf.glyph_positions
        
        for info, pos in zip(infos, positions):
            gid = info.codepoint
            cluster = info.cluster
            x_advance = pos.x_advance
            x_offset = pos.x_offset
            y_offset = pos.y_offset
            print(f"gid{gid}={cluster}@{x_advance},{x_offset}+{y_offset}")
        ```
        
        
        ### How to make a release
        
        Use `git tag -a` to make a new annotated tag, or `git tag -s` for a GPG-signed annotated tag, if you prefer.
        
        Name the new tag with with a leading ‘v’ followed by three MAJOR.MINOR.PATCH digits, like in semantic versioning. Look at the existing tags for examples.
        
        In the tag message write some short release notes describing the changes since the previous tag.
        
        Finally, push the tag to the remote repository (e.g. assuming upstream is called origin):
        
            $ git push origin v0.4.3
        
        This will trigger the CI to build the distribution packages and upload them to the Python Package Index automatically, if all the tests pass successfully. The CI will also automatically create a new Github Release and use the content of the annotated git tag for the release notes.
        
        
        [hb]: https://github.com/harfbuzz/harfbuzz
        
Platform: UNKNOWN
Requires-Python: >=3.5
Description-Content-Type: text/markdown
