# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-psautohint
VERSION=		2.4.0
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		Wrapper for Adobe's PostScript autohinter (3.12)
SDESC[v13]=		Wrapper for Adobe's PostScript autohinter (3.13)
HOMEPAGE=		https://github.com/adobe-type-tools/psautohint
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPI/p/psautohint
DISTFILE[1]=		psautohint-2.4.0.tar.gz:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		psautohint-2.4.0

GENERATED=		yes

INSTALL_REQ_TOOLCHAIN=	yes

[PY312].BUILDRUN_DEPENDS_ON=		python-fonttools:single:v12
					python-setuptools-scm:single:v12
[PY312].USES_ON=			python:v12,sutools

[PY313].BUILDRUN_DEPENDS_ON=		python-fonttools:single:v13
					python-setuptools-scm:single:v13
[PY313].USES_ON=			python:v13,sutools

[FILE:1726:descriptions/desc.single]
![Test and Build]
[Codecov]
[PyPI]
[![Language grade:
C/C++]](https://lgtm.com/projects/g/adobe-type-tools/psautohint/context:cpp)
[![Language grade:
Python]](https://lgtm.com/projects/g/adobe-type-tools/psautohint/context:python)
[Total alerts]

PSAutoHint
==========

A standalone version of [AFDKO]’s
autohinter.

Building and running
--------------------

This repository currently consists of a core autohinter written in C, a
Python C extension providing an interface to it, and helper Python code.

To build the C extension:

    python setup.py build

To install the C extension and the helper scripts globally:

    pip install -r requirements.txt .

Alternatively to install them for the current user:

    pip install -r requirements.txt --user .

The autohinter can be used by running:

    psautohint

To build just the `autohintexe` binary:

    python setup.py build_exe

Testing
-------

We have a test suite that can be run with:

    pytest

Debugging
---------

For standard debugging, build with:

    python setup.py build --debug

It is also possible to build a debug version with [AddressSanitizer]
("ASan") support (currently _for Mac OS X only_)  with:

    python setup.py build --asan
    pip install .

Once it is installed, you can use the `util/launch-asan.sh` shell script to
launch a Python process that invokes the ASan libraries needed for
debugging. Attach Xcode the launched process, then execute code in the
process that triggers memory usage problems and wait for ASan to do its
magic.

NOTE: be sure to build and install `psautohint` as described above; using
other techniques such as `python setup.py install` will cause a re-build
_without_ ASan and debug support, which won't work.


[FILE:113:distinfo]
d50edea8f6121c3383f0d82f881bf7a18bdd476cc2d354737672ce193c3cff7f       185568 python-src/psautohint-2.4.0.tar.gz