Metadata-Version: 2.4
Name: fonts
Version: 0.1.0
Summary: Python Fonts
Author-email: Philip Howard <phil@pimoroni.com>
License-Expression: MIT
Project-URL: GitHub, https://github.com/pimoroni/fonts-python
Keywords: font,fonts
Classifier: Development Status :: 5 - Production/Stable
Classifier: Operating System :: POSIX :: Linux
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Dynamic: license-file

Python Fonts
============

A Python framework for distributing and managing fonts.

Why
===

While Python can access system fonts, it has no direct way of guaranteeing a particular font is available, or any way of including it as a dependency.

Fonts aims to tackle this problem with tools for packaging and distributing fonts via PyPi, which can be easily located and used in Python using PIL or otherwise.

How
===

Fonts uses ``entry_points`` to expose the font files located in each package.

To use these fonts in your project you should include them as a dependency and either grab the font paths using ``importlib.metadata.entry_points(group='fonts_ttf')`` or use this fonts module to collate them for you.

For example::

    from PIL import ImageFont
    from fonts.ttf import AmaticSC
    font = ImageFont.truetype(AmaticSC)

Fonts
=====

- Fredoka One (Sans-Serif, OFL) - https://pypi.org/project/font-fredoka-one
- Amatic SC (Hand-Drawn, OFL) - https://pypi.org/project/font-amatic-sc

