arabic-reshaper

Settings based on a TrueType® font

If you intend to render the text in a TrueType® font, you can tell the library to generate its configuration by reading the font file to figure out what's supported in the font and what's not.

To use this feature you need to install the library with an extra option (not necessary when you install it with conda):

pip install --upgrade arabic-reshaper[with-fonttools]

Then you can use the reshaper like this:

import arabic_reshaper

reshaper = arabic_reshaper.ArabicReshaper(
    arabic_reshaper.config_for_true_type_font(
        '/path/to/true-type-font.ttf',
        arabic_reshaper.ENABLE_ALL_LIGATURES
    )
)

This will parse the font file, and figure out what ligatures it supports and enable them, as well as whether it has isolated forms or use_unshaped_instead_of_isolated should be enabled.

The second parameter to config_for_true_type_font can be one of

• ENABLE_NO_LIGATURES
• ENABLE_SENTENCES_LIGATURES
• ENABLE_WORDS_LIGATURES
• ENABLE_LETTERS_LIGATURES
• ENABLE_ALL_LIGATURES (default)

which controls what ligatures to look for, depending on your usage, see default-config.ini to know what ligatures are there.

Same as v2.0.14 but different license.

New option use_unshaped_instead_of_isolated to get around some fonts missing the isolated form for letters.

Use Exception instead of Error

Use pkg_resources.resource_filename instead of depending on __file__ to access default-config.ini.

• Totally rewrote the code;
• Faster and better performance;
• Added the ability to configure and customise the reshaper.