Create stub package to use cairocffi as drop in replacement for pycairo

[kozea]

Create stub package to use cairocffi as drop in replacement for pycairo

[SimonSapin]

Hi,

I think you’re looking for cairocffi.install_as_pycairo(). What this function does is that if import cairo for from cairo import … is run later, cairocffi is imported instead of pycairo.

So if you’re using a Python library that itself uses pycairo, run this code:

import cairocffi
cairocffi.install_as_pycairo()

… before importing that library. Every thing should just work.

For a Python command-line tool where you’re not writing any Python code it’s a bit more tricky. Either:

1. Patch the tool to add the code above so that it’s run as early as possible
2. Write your own command line script that has the above code and then calls the tool’s main() function. Hopefully the tool has a well-delimited main function that you can import.

Does this help?

[codeodor]

Yes, I think I'm going to have to do the latter, though I was hoping there was a way for you to distribute it that way for other folks who may not be comfortable or knowledgable enough to consider patching it themselves.

Thanks for the advice!

[SimonSapin]

Yet another option is to have a cairo.py in your sys.path containing this:

from cairocffi import *

But this is more brittle because you have to make sure it takes priority over pycairo (or that pycairo is not installed, or use a virtualenv with --no-site-packgaes, …)

[codeodor]

Actually, that's probably easier for my case. Thanks!

I did already have the virtualenv set up with that flag, and did not have pycairo set up to begin with.

[SimonSapin]

I documented this trick: http://pythonhosted.org/cairocffi/overview.html#compatibility-with-pycairo

[codeodor]

👍