Metadata-Version: 2.4
Name: pyfonts
Version: 1.1.3
Summary: A simple and reproducible way of using fonts in matplotlib
Author-email: Joseph Barbier <joseph.barbierdarnal@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://y-sunflower.github.io/pyfonts/
Project-URL: Issues, https://github.com/y-sunflower/pyfonts/issues
Project-URL: Documentation, https://y-sunflower.github.io/pyfonts/
Project-URL: Repository, https://github.com/y-sunflower/pyfonts
Keywords: matplotlib,font,reproducibility,google
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Framework :: Matplotlib
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: matplotlib
Requires-Dist: requests
Dynamic: license-file

# pyfonts

<img src="https://github.com/JosephBARBIERDARNAL/static/blob/main/python-libs/pyfonts/image.png?raw=true" alt="Pyfonts logo" align="right" width="150px"/>

A **simple** and **reproducible** way of using fonts in matplotlib. In short, `pyfonts`:

- allows you to use all **Google Font** fonts
- allows you to use any font from an **arbitrary URL**
- is **fast** (thanks to its cache system)

[![PyPI Downloads](https://static.pepy.tech/badge/pyfonts)](https://pepy.tech/projects/pyfonts)
![Coverage](coverage-badge.svg)

<br>

## Quick start

```python
import matplotlib.pyplot as plt
from pyfonts import load_google_font

font = load_google_font("Fascinate Inline")

fig, ax = plt.subplots()
ax.text(
    x=0.2,
    y=0.5,
    s="Hey there!",
    size=30,
    font=font
)
```

![](https://raw.githubusercontent.com/y-sunflower/pyfonts/refs/heads/main/quickstart.png)

[**See more examples**](https://y-sunflower.github.io/pyfonts/reference/load_google_font#examples)

<br>

## Installation

```bash
pip install pyfonts
```
