fontParts

Fontparts

Une API pour interagir avec les parties des polices pendant le processus de développement des polices. Fontparts est le remplacement du robofab. Le projet a une licence open source du MIT.

La documentation est sur FontParts.readthedocs.io.

Ceci est un travail en cours. Nous travaillons toujours sur l'API, la mise en œuvre abstraite, l'exemple de l'implémentation, la suite de tests et la documentation.

Vous voulez contribuer?

Merci! Veuillez consulter le fichier contribution.RST pour un guide sur la façon d'aider.

De plus, les commentaires sont très bienvenus, veuillez ouvrir un problème lorsque vous rencontrez quelque chose que vous souhaitez que Fontparts ait fait / n'a pas fait.

Installation

Fontparts nécessite Python 3.8 ou ultérieure.

Le package est répertorié dans l'index de package Python (PYPI), vous pouvez donc l'installer avec PIP:

pip install fontParts

Si vous souhaitez contribuer à son développement, vous pouvez cloner le référentiel à partir de GitHub, installer le package en mode «modifiable» et modifier le code source en place. Nous vous recommandons de créer un environnement virtuel, en utilisant le module VirtualEnv ou VENV.

 # download the source code to 'fontParts' folder
git clone https://github.com/robofab-developers/fontParts.git
cd fontParts

# create new virtual environment called e.g. 'fontParts-venv', or anything you like
python -m virtualenv fontParts-venv

# source the `activate` shell script to enter the environment (Un*x); to exit, just type `deactivate`
. fontParts-venv/bin/activate

# to activate the virtual environment in Windows `cmd.exe`, do
fontParts-venv S cripts a ctivate.bat

# install in 'editable' mode
pip install -e . 

Feuille de route

Nous travaillons actuellement vers la version 1.0.

• 0,8 versions initiales. Python 2 & 3.
• 0,9 Python 3 uniquement.
• 1.0 Documentation et tests terminés.
• 1.5 Retrait de Deprecated . Sorti 1 an après 1,0.

Essai

Le test est configuré de sorte que chaque environnement qui inclut Fontparts peut fournir les objets nécessaires pour exécuter un ensemble commun de tests. Cela rend les tests très faciles pour les environnements qui utilisent Fontparts (par exemple, voir le script Fonshell Test.py.py), mais cela signifie que le test est différent des autres packages Python.

Les tests automatisés du package sont effectués dans l'environnement Fonshell. Fonshell est Fontparts pour la ligne de commande, implémenté avec DefCon et est inclus dans le package FontParts.

Avant de pouvoir exécuter la suite de test, vous devrez installer les dépendances de test:

pip install -r requirements-dev.txt

Pour exécuter la suite de test, vous pouvez faire:

python Lib/fontParts/fontshell/test.py

Pour tester dans d'autres environnements, exécutez le script de test fourni par cet environnement.

Vous pouvez également utiliser TOX pour exécuter automatiquement des tests sur différentes versions Python dans des environnements virtuels isolés.

pip install tox
tox

Notez que lorsque vous exécutez tox sans arguments, les tests sont exécutés pour tous les environnements répertoriés dans envlist de Tox.ini. Dans notre cas, il s'agit de Python 3.6, donc pour que cela fonctionne, les exécutables python3.6 doivent être disponibles sur votre PATH .

Vous pouvez spécifier une liste d'environnement alternative via l'option -e ou la variable d'environnement TOXENV :

tox -e py39-nocov
TOXENV= " py36-cov,htmlcov " tox