From 1eccbda85271a7c7fb6dbd0a79f758ecf9a203fb Mon Sep 17 00:00:00 2001
From: Cosimo Lupo <clupo@google.com>
Date: Thu, 14 Dec 2023 11:43:09 +0000
Subject: [PATCH] specify pycairo as 'interpolatable' extra dependency

Fixes https://github.com/fonttools/fonttools/issues/3382
---
 README.rst | 7 +++++++
 setup.py   | 3 +++
 2 files changed, 10 insertions(+)

diff --git a/README.rst b/README.rst
index bcb7f0d47..d84282fc7 100644
--- a/README.rst
+++ b/README.rst
@@ -138,6 +138,13 @@ are required to unlock the extra features named "ufo", etc.
   * `munkres <https://pypi.python.org/pypi/munkres>`__: a pure-Python
     module that implements the Hungarian or Kuhn-Munkres algorithm.
 
+  To plot the results to a PDF or HTML format, you also need to install:
+
+  * `pycairo <https://pypi.org/project/pycairo/>`__: Python bindings for the
+    Cairo graphics library. Note that wheels are currently only available for
+    Windows, for other platforms see pycairo's `installation instructions
+    <https://pycairo.readthedocs.io/en/latest/getting_started.html>`__.
+
   *Extra:* ``interpolatable``
 
 - ``Lib/fontTools/varLib/plot.py``
diff --git a/setup.py b/setup.py
index 10e639de3..02e456525 100755
--- a/setup.py
+++ b/setup.py
@@ -120,6 +120,9 @@ extras_require = {
         # use pure-python alternative on pypy
         "scipy; platform_python_implementation != 'PyPy'",
         "munkres; platform_python_implementation == 'PyPy'",
+        # to output PDF or HTML reports. NOTE: wheels are only available for
+        # windows currently, other platforms will need to build from source.
+        "pycairo",
     ],
     # for fontTools.varLib.plot, to visualize DesignSpaceDocument and resulting
     # VariationModel