https://github.com/harfbuzz/uharfbuzz

A HarfBuzz Python binding
https://github.com/harfbuzz/uharfbuzz

cython fonts opentype

Last synced: 3 months ago
JSON representation

A HarfBuzz Python binding

• Host: GitHub
• URL: https://github.com/harfbuzz/uharfbuzz
• Owner: harfbuzz
• License: apache-2.0
• Created: 2018-03-11T18:58:12.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-06-28T10:58:22.000Z (4 months ago)
• Last Synced: 2024-07-12T12:29:39.353Z (4 months ago)
• Topics: cython, fonts, opentype
• Language: Cython
• Homepage:
• Size: 587 KB
• Stars: 65
• Watchers: 17
• Forks: 23
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![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)

[![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

fontfile = sys.argv[1]

text = sys.argv[2]

blob = hb.Blob.from_file_path(fontfile)

face = hb.Face(blob)

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

    glyph_name = font.glyph_to_string(gid)

    cluster = info.cluster

    x_advance = pos.x_advance

    x_offset = pos.x_offset

    y_offset = pos.y_offset

    print(f"{glyph_name} gid{gid}={cluster}@{x_advance},{y_offset}+{x_advance}")

```

### 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. The subject line will be the release name and the message body will be the release notes.

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