Ufolint ist eine Quelldatei -Linter für die Schriftentwicklung in Unified Font Object (UFO) Quellcode. Es wurde für kontinuierliche Integrationstests von UFO -Quellenbeiträgen zu Schriftprojekten entwickelt.
Die Anwendung führt eine UFO -Version spezifische statische Analyse der Quelltextdateien mit den Spezifikationen UFO V2 und V3 für Probleme aus, die enthalten:
Diese Tests werden durch eine Kombination von öffentlichen Methoden in der FontTools.Utolib -Bibliothek und zusätzlichen Tests durchgeführt, die in der UFOLINT -Anwendung implementiert sind. UFOLINT -Fangerfassungen in den Ufolib Public Lese -Methoden für alle _.Plist -Dateitypen und alle UFOLIB -Validierungen, die auf _.glif -Dateien durchgeführt werden. Diese werden an Benutzer mit informativen Fehlermeldungen zurückgegeben, die die von Sorge und dem Statuscode 1 begegneten Filepaths angeben.
Ufolint kann lokal oder mit Remote -CI -Testdiensten ausgeführt werden.
Verwenden Sie den Befehl:
$ pip install ufolint
Upgrade auf eine neue Version der Anwendung mit dem Befehl:
$ pip install --upgrade ufolint
Der Vorgang ist vollständig automatisiert. Zeigen Sie einfach Ufolint auf ein oder mehrere UFO -Quellverzeichnisse und es kümmert sich um den Rest. Ufolint beendet mit dem Statuscode 0, wenn alle Tests bestehen und mit dem Statuscode 1 beendet sind, wenn Tests fehlschlagen.
$ ufolint [UFO source path] ([UFO path 2] [UFO path3]...)
$ ufolint Awesome-Regular.ufo Awesome-Bold.ufo
Bei kritischen Ausfällen, die den Abschluss weiterer Tests verhindern, wird Ufolint sofort und andere Tests abgebrochen. Unter allen anderen Umständen werden Fehler in der gesamten Analyse erfasst und nach Abschluss aller Tests angezeigt.
Ufolint bietet ausführliche, nützliche Fehlermeldungen, die die von Sorge (en) von Bedeutung sind, den Fehlertyp und in vielen Fällen die problematische Zeile in der Datei.
Um Ihre UFO -Quellenänderungen auf Travis kontinuierlich zu testen, wobei jedes von Ihrem Github -Repository übermittelte Commit oder Pull -Anforderung diese ersten zwei Schritte aus dem Travis -Erste -Start -Leitfaden verwenden:
Dann in Ihrem Github -Repository,
.travis.yml im Stammvermögen Ihres Github -Repositorys, das den folgenden Text enthält: sudo : false
language : python
env :
- VARIANT=src/Test-Regular.ufo
- VARIANT=src/Test-Bold.ufo
- VARIANT=src/Test-Italic.ufo
- VARIANT=src/Test-BoldItalic.ufo
before_script : pip install ufolint
script : " ufolint $VARIANT "
notifications :
email : falseVARIANT=src/Test-*.ufo Zeilen in der Datei .travis.yml mit den tatsächlichen Pfaden zu Ihren UFO-Quelldateien nach = Charakter. Verwenden Sie eine Zeile pro Variante und fügen Sie Linien hinzu oder subtrahieren Sie sie nach Bedarf, um die gewünschten UFO -Verzeichnisse der Quelle im Repository zu testen. Dies sollten relative Pfade von der Wurzel Ihres Git -Repositorys sein. Diese Travis -Einstellungsstruktur führt die Variantentests parallel für jede der im Feld env der Travis -Einstellungsdatei angegebenen Varianten durch. Jede Variante wird auf der Travis -Testseite wie folgt gekennzeichnet:
Schritt 5 : Bei jedem neuen Commit in Ihr GitHub -Repository (oder eine neue Pull -Anfrage, die von anderen übermittelt wurde) wird Travis automatisch benachrichtigt und führt die UFOLINT -Tests für die geänderte (oder vorgeschlagene Änderungen für Pull -Anforderungen) UFO -Quelle durch. Sie können die Testergebnisse auf Ihrer Travis -Kontoseite für das Repository anzeigen.
Optional : Um Ihrem Repository ReadMe ein Travis -Testergebnisabzeichen hinzuzufügen, fügen Sie den folgenden Markdown in Ihre ReadMe -Seite ein und ändern Sie [ACCOUNT] und [REPOSITORY] mit Ihrem Travis -Konto und Repository -Details:
[](https://travis-ci.org/[ACCOUNT]/[REPOSITORY])
Erstellt mit der fantastischen Fonttools Ufolib Library, in der ein Großteil der UFO -Validierungsarbeiten durchgeführt wurde!
MIT -Lizenz