fonttools ダウンロード - fonttools ソースコードのダウンロード

fonttools

パイソン

4.55.2

ダウンロード

CI ビルドステータス

これは何ですか？

fontTools は、Python で書かれたフォントを操作するためのライブラリです。このプロジェクトには、TrueType フォントと OpenType フォントを XML テキスト形式 (TTX とも呼ばれる) に変換したり、XML テキスト形式から変換したりできる TTX ツールが含まれています。 TrueType、OpenType、AFM、およびある程度の Type 1 および一部の Mac 固有の形式をサポートします。このプロジェクトには MIT オープンソースライセンスが付与されています。

とりわけ、これは無料で使用できることを意味します。

ユーザードキュメントと開発者ドキュメントは、Read the Docs で入手できます。

インストール

FontTools には Python 3.8 以降が必要です。 Python の最小バージョンのサポートについては、NumPy と同じスケジュールに従うよう努めます (NEP 29 を参照)。

パッケージは Python Package Index (PyPI) にリストされているため、pip を使用してインストールできます。

pip install fonttools

開発に貢献したい場合は、GitHub からリポジトリのクローンを作成し、パッケージを「編集可能」モードでインストールし、ソースコードをその場で変更できます。 virtualenv または Python 3 venv モジュールを使用して仮想環境を作成することをお勧めします。

 # download the source code to 'fonttools' folder
git clone https://github.com/fonttools/fonttools.git
cd fonttools

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

# source the `activate` shell script to enter the environment (Unix-like); to exit, just type `deactivate`
. fonttools-venv/bin/activate

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

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

オプションの要件

fontToolsパッケージには現在、Python 標準ライブラリに含まれるモジュール以外に (必須の) 外部依存関係はありません。ただし、一部のモジュールでは、オプション機能のロックを解除するために必要な追加の依存関係がいくつか必要です。 fonttools PyPI ディストリビューションは、いわゆる「エクストラ」、つまり追加の依存関係のグループを記述するキーワードのセットもサポートしており、pip 経由でインストールするときや要件を指定するときに使用できます。例えば：

pip install fonttools[ufo,lxml,woff,unicode]

このコマンドは、フォントツールと、「ufo」などの追加機能のロックを解除するために必要なオプションの依存関係をインストールします。

Lib/fontTools/misc/etree.py
このモジュールは、XML ファイルの読み取り/書き込み用の ElementTree のような API をエクスポートし、組み込みのxml.etreeモジュールまたは lxml をバックエンドとして使用できるようにします。後者は、一般に高速かつ安全であるため、存在する場合には常に優先されます。
追加: lxml
Lib/fontTools/ufoLib
UFO ソースファイルの読み取りと書き込みのためのパッケージ。それには以下が必要です:
- fs: (別名pyfilesystem2 ) ファイルシステム抽象化レイヤー。
- enum34: 組み込みenumモジュールのバックポート (Python < 3.4 でのみ必要)。
番外編： ufo
Lib/fontTools/ttLib/woff2.py
WOFF 2.0 Web フォントを圧縮/解凍するモジュール。それには以下が必要です:
- Brotli: Brotli 圧縮ライブラリの Python バインディング。
おまけ: woff
Lib/fontTools/ttLib/sfnt.py
WOFF 1.0 Web フォントをより適切に圧縮するには、組み込みのzlibライブラリの代わりに次のモジュールを使用できます。
- zopfli: Zopfli 圧縮ライブラリの Python バインディング。
おまけ: woff
Lib/fontTools/unicode.py
ttxでcmapテーブルをダンプするときに Unicode 文字名を表示するには、標準ライブラリのunicodedataモジュールを使用します。そこに含まれるバージョンは、Python のバージョンごとに異なります。利用可能な最新のデータを使用するには、以下をインストールできます。
- unicodedata2: Python 3.x のunicodedataバックポートが最新の Unicode バージョン 15.0 に更新されました。
追加: unicode
Lib/fontTools/varLib/interpolatable.py
異なるマスター間の間違った輪郭/コンポーネントの順序を見つけるためのモジュール。いわゆる「二部グラフにおける最小重み完全一致問題」、または割り当て問題を解決するには、次のパッケージのいずれかが必要です。
- scipy: Python の科学ライブラリ。内部で NumPy 配列を使用するため、非常に高速です。
- munkres: ハンガリー語または Kuhn-Munkres アルゴリズムを実装する純粋な Python モジュール。
結果を PDF または HTML 形式でプロットするには、以下もインストールする必要があります。
- pycairo: Cairo グラフィックスライブラリの Python バインディング。ホイールは現在 Windows でのみ利用可能であることに注意してください。他のプラットフォームについては、pycairo のインストール手順を参照してください。
追加: interpolatable
Lib/fontTools/varLib/plot.py
DesignSpaceDocument と結果として得られる variationModel を視覚化するためのモジュール。
- matplotlib: 2D プロットライブラリ。
番外編： plot
Lib/fontTools/misc/symfont.py
シンボリックフォント統計分析のための高度なモジュール。それには以下が必要です:
- sympy: 記号数学用の Python ライブラリ。
追加: symfont
Lib/fontTools/t1Lib.py
Python 3 でファイル作成者と Macintosh PostScript Type 1 フォントの種類を取得するには、次のモジュールをインストールする必要があります。古いMacOSモジュールは Mac Python に含まれなくなったためです。
- xattr: 拡張ファイルシステム属性の Python ラッパー (macOS プラットフォームのみ)。
おまけ: type1
Lib/fontTools/ttLib/removeOverlaps.py
重なっている輪郭とコンポーネントを結合して、TrueType グリフを簡素化します。
- Skia-pathops: Skia ライブラリの PathOps モジュールの Python バインディング。パス上でブール演算 (和集合、交差など) を実行します。
番外編： pathops
Lib/fontTools/pens/cocoaPen.pyおよびLib/fontTools/pens/quartzPen.py
Cocoa NSBezierPathまたはCGPathを使用してグリフを描画するためのペンには、以下が必要です。
- PyObjC: Python と Objective-C ランタイム間のブリッジ (macOS プラットフォームのみ)。
Lib/fontTools/pens/qtPen.py
Qt のQPainterPathでグリフを描画するためのペンには、以下が必要です。
- PyQt5: Qt クロスプラットフォーム UI およびアプリケーションツールキット用の Python バインディング。
Lib/fontTools/pens/reportLabPen.py
ペンでグリフを PNG 画像として描画するには、次のものが必要です。
- reportlab: PDF とグラフィックを生成するための Python ツールキット。
Lib/fontTools/pens/freetypePen.py
FreeType を使用してグリフをラスターイメージとしてペンで描画するには、以下が必要です。
- freetype-py: FreeType ライブラリの Python バインディング。
Lib/fontTools/ttLib/tables/otBase.py
Harfbuzz ライブラリを使用して、 hb_repackメソッドを使用して GPOS/GSUB をシリアル化するには、次のものが必要です。
- uharfbuzz: harfbuzz シェーピングエンジン用の合理化された Cython バインディング
追加: repacker

新しいリリースの作り方

前回のリリース以降のすべての変更を反映してNEWS.rst更新します。 PR ごとに変更ログエントリを作成し、それを要約する 1 つまたは 2 つの短い文、PR へのリンク、および PR が対処する関連問題を記述します。新しいタイトルを付けないでください。次のコマンドが自動的に付けます。
セマンティックバージョニングを使用して、新しいリリースが「メジャー」リリース、「マイナー」リリース、「パッチ」リリースのいずれになるかを決定します。新しい下位互換性のある API が追加されたか、単にいくつかのバグが修正されたかによって、通常は後の 2 つのいずれかになります。
venv 内から、まずpip install -r dev-requirements.txtを実行し、次にmainブランチの先端からpython setup.py releaseコマンドを実行します。デフォルトでは、 --majorまたは--minor渡してそれぞれ 1 桁目または 2 桁目をバンプしない限り、3 桁目または「パッチ」桁のみがバンプされます。これにより、パッケージのバージョン文字列がバンプされ、 NEWS.rstから最新バージョン以降の変更が抽出され、そのテキストを使用して注釈付き git タグ (または--signオプションを渡し、git と Github アカウントが有効な場合は署名付き git タグ) が作成されます。 GPG キーを使用してコミットに署名するように構成されています）。また、その後の開発サイクルのためのメインブランチを開く追加のバージョンバンプもコミットします。
コマンドgit push --follow-tagsを実行して、タグとコミットの両方を上流リポジトリにプッシュします。注: 他のローカルタグもプッシュされる可能性があるため、注意してください。
CI にホイールとソースの配布パッケージを構築させ、両方が Python Package Index (PyPI) にアップロードされることを確認します。
(オプション) fonttools の Github リリースページに移動し、git タグメッセージの内容をコピーして貼り付けて新しいリリースを作成します。こうすることで、リリースノートはマークダウンとして適切にフォーマットされ、リポジトリを閲覧しているユーザーは電子メール通知を受け取ることになります。いつかそれも自動化するでしょう。

謝辞

アルファベット順:

アシュミッツ、オリヴィエ・ベルテン、サムヤク・ブータ、エリック・ファン・ブロックランド、ペトル・ファン・ブロックランド、ジェル・ボスマ、サシャ・ブラワー、トム・バイラー、アントニオ・カヴェドーニ、フレデリック・コワフィエ、ヴィンセント・コナーレ、デヴィッド・コーベット、サイモン・コーゼンズ、デイブ・クロスランド、サイモン・ダニエルズ、ピーター・デッカーズ、ベハダベナム、エスファボッドエスファボッド、ハンネス・ファミラ、サム・フィッシュマン、マット・フォンテイン、藤孝明、ロブ・ハーゲマンス、ヤニス・ハラランブース、グレッグ・ヒッチコック、ジェレミー・ホーナス、カレド・ホズニー、ジョン・ハドソン、デニス・モヨゴ・ジャクエリ、ジャック・ジャンセン、トム・カヴィンスキー、イェンス・クティレク、アントワーヌ・レカ、ヴェルナー・レンバーグ、タル・レミング、ピーター・ロフティング、コシモ・ルポ、オーリ・マイヤー、中村雅也、デイブ・オプスタッド、ローレンス・ペニー、ルーズベ・プルナダー、ギャレット・リーガー、リード・ロバーツ、コリン・ロフルス、グイド・ファン・ロッサム、ジャスト・ファン・ロッサム、アンドレアス・ザイデル、ゲオルク・サイフェルト、クリス・シンプキンス、ミゲル・スーザ、アダム・トワードック、エイドリアン・テタール、ヴィタリー・ヴォルコフ、ポール・ワイズ。