feat!: compatibility with matplotlib 3.11

[miloth]

Matplotlib 3.11 reworked the style module, changing the APIs that were used here. This aims at solving that and a bit more:

• Vendor the styles using the docs guidelines:
  • Style files generated in the module root, so they can be imported as "catppuccin.<flavor>".
  • Removed legacy vendoring.
• Removed all the public functions in the catppuccin.extras.matplotlib module. Their functionality can be replicated with a one liner of Matplotlib's APIs. All the examples now use these one liners.
• Removed the assets and their generation. The users can run the example themselves to generate them. They were ~2 MB images, not used anywhere. I think these could pollute the git size if left there.
• Helper file for the codegen moved outside of the module in the repo root, so it is not shipped to Pypi.
• Update tests to cover the cmaps as well.
• Updated cmaps to be colored and not mono.
• Updated palette from upstream.
• Updated dev dependencies.

[backwardspy]

@brambozz any chance you could give this a review? you know it better than i do i think :)

[brambozz]

Yes, I will try to have a look this week!

[brambozz]

@miloth Thanks for the comprehensive PR, overall looks good to me! Especially really like the addition of a default (non-mono) colormap! That makes a lot of sense, and is something I could have used for a while.

Only thing I am not a fan of is the removal of the get_colormap_from_list function, in lieu of the matplotlib one-liner. This is a function I actually use frequently, to e.g. easily define a diverging colormap. While I understand that this is maybe not a functionality unique to catppuccin, I do think there is a difference in ease of use/clarity between these two:

Original:

from catppuccin.extras.matplotlib import get_colormap_from_list

cmap = get_colormap_from_list(
       catppuccin.PALETTE.frappe.identifier,
       ["red", "peach", "yellow", "green"],
)

PR suggestion:

from matplotlib.colors import LinearSegmentedColormap

cmap = LinearSegmentedColormap.from_list(
    "my_custom_palette",
    [
        getattr(catppuccin.PALETTE.frappe.colors, color_name).hex
        for color_name in ["red", "peach", "yellow", "green"]
    ],
)

@backwardspy:I think it would be good if you have a quick look too, as there are some changes to files I did not write (e.g. build.py). But looks good to me! One specific thing I spotted:

• The PR upgrades minimum versions of python and matplotlib to 3.11. Seems fine to me, but maybe this is something you have thoughts about. The PR also goes from 2.5 to 3.0, so would amount to a new release.

[miloth]

Hi @brambozz, please find the replies below:

• Removal of less common matplotlib APIs. This was intentional. I had a look at some PRs in their repo and it is fairly common to remove or change public APIs without a major bump. This got me thinking about what the purpose of this package should be. Is it intended to provide the user with palette for the four flavors, or to be a plotting library with added functionality? Given the versioning of matplotlib, I thought the first option would be better and easier to maintain. All at very limited cost, since it's fairly easy to define these from the matplotlib APIs. Btw, I edited the cmap call in the example you mentioned. Now it's much cleaner.
• The 3.11 requirement is where matplotlib dropped their APIs used by this repo (and other similar plotting tools). I believe the major bump is recommended here, as this completely overhauls the calls.

[brambozz]

@miloth Thanks for the update! You have me convinced, it is probably indeed cleaner and more appropriate here to keep the API minimal.

Also the reasoning for the versioning is fine with me, but still something I would like to give @backwardspy the final word on.

So @backwardspy: For me it's all good now! But my earlier suggestion of you having a quick look still stands :)