fonttools 4.55.1__tar.gz → 4.55.3__tar.gz

fonttools-4.55.3/Doc/source/afmLib.rst

@@ -0,0 +1,15 @@
+###############################################
+afmLib: Read and write Adobe Font Metrics files
+###############################################
+
+.. rubric:: Overview:
+   :heading-level: 2
+		   
+.. automodule:: fontTools.afmLib
+   :members: 
+   :undoc-members:
+
+
+    .. rubric:: Module members:
+       :heading-level: 2
+ 

fonttools-4.55.3/Doc/source/agl.rst

@@ -0,0 +1,16 @@
+######################################
+agl: Interface to the Adobe Glyph List
+######################################
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+.. automodule:: fontTools.agl
+   :members: 
+   :undoc-members:
+   :member-order: bysource
+
+    
+    .. rubric:: Module members:
+       :heading-level: 2
+ 

fonttools-4.55.3/Doc/source/conf.py

@@ -0,0 +1,191 @@
+# -*- coding: utf-8 -*-
+#
+# fontTools documentation build configuration file, created by
+# sphinx-quickstart on Thu Apr 20 11:07:39 2017.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+needs_sphinx = "1.3"
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    "sphinx.ext.napoleon",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.coverage",
+    "sphinx.ext.autosectionlabel",
+]
+
+autodoc_mock_imports = ["gtk", "reportlab", "Quartz"]
+
+autodoc_default_options = {
+    "members": True,
+    "inherited-members": False,
+    "show-inheritance": True,
+    "member-order": "bysource",
+}
+
+# This option allows show-inheritace to work but not clutter up the output
+# with the (surplus) full inheritance stack.
+autodoc_inherit_docstrings = False
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = ".rst"
+
+# The master toctree document.
+master_doc = "index"
+
+# General information about the project.
+project = "fontTools"
+copyright = (
+    "2020, Just van Rossum, Behdad Esfahbod, and the fontTools Authors. CC BY-SA 4.0"
+)
+author = "Just van Rossum, Behdad Esfahbod, and the fontTools Authors"
+
+# HTML page title
+html_title = "fontTools Documentation"
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = "4.0"
+# The full version, including alpha/beta/rc tags.
+release = "4.0"
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = "en"
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = []
+
+# The programming language to be used by default in syntax highlighting.
+highlight_language = "python"
+
+# The name of the Pygments (syntax highlighting) style to use.
+# pygments_style = "sphinx" (the default sphinx docs style on RTD)
+pygments_style = "default"
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = True
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "sphinx_rtd_theme"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+html_theme_options = {"display_version": False}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+# html_static_path = ["_static"]
+
+html_favicon = "assets/img/favicon.ico"
+
+# display the Sphinx attribution in the footer
+html_show_sphinx = False
+
+
+# -- Options for HTMLHelp output ------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "fontToolsDoc"
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (
+        master_doc,
+        "fontTools.tex",
+        "fontTools Documentation",
+        "Just van Rossum, Behdad Esfahbod et al.",
+        "manual",
+    )
+]
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [(master_doc, "fonttools", "fontTools Documentation", [author], 1)]
+
+
+# -- Options for Texinfo output -------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "fontTools",
+        "fontTools Documentation",
+        author,
+        "fontTools",
+        "A library for manipulating fonts, written in Python.",
+        "Typography",
+    )
+]

fonttools-4.55.3/Doc/source/config.rst

@@ -0,0 +1,7 @@
+###########################
+config: Configure fontTools
+###########################
+
+.. automodule:: fontTools.config
+   :members:
+   :undoc-members:

fonttools-4.55.3/Doc/source/index.rst

@@ -0,0 +1,131 @@
+.. image:: ../../Icons/FontToolsIconGreenCircle.png
+   :width: 200px
+   :height: 200px
+   :alt: Font Tools
+   :align: center
+
+
+---fontTools Documentation---
+=============================
+About
+-----
+
+fontTools is a family of libraries and utilities for manipulating fonts in Python.
+
+The project is licensed under the `MIT open-source license <https://github.com/fonttools/fonttools/blob/main/LICENSE>`_, allowing free usage.
+
+Installation
+------------
+
+.. note::
+
+    fontTools requires `Python <http://www.python.org/download/>`_ 3.8 or later.
+
+To install fontTools, use `pip <https://pip.pypa.io/>`_:
+
+
+    pip install fonttools
+
+Utilities
+---------
+
+fontTools includes the following command-line utilities:
+
+- ``pyftmerge``: Tool for merging fonts; see :py:mod:`fontTools.merge`
+- ``pyftsubset``: Tool for subsetting fonts; see :py:mod:`fontTools.subset`
+- ``ttx``: Tool for converting between OTF and XML representation; see :py:mod:`fontTools.ttx`
+- ``fonttools``: Meta-tool for accessing other fontTools components.
+
+For ``fonttools``, you can use subcommands like:
+
+- ``cffLib.width``: Calculate optimum defaultWidthX/nominalWidthX values
+- ``cu2qu``: Convert a UFO font from cubic to quadratic curves
+- ``feaLib``: Add features from a feature file (.fea) into a OTF font
+- ``merge``: Merge multiple fonts into one
+- ``subset``: OpenType font subsetter and optimizer
+- ``ttx``: Convert OpenType fonts to XML and back
+- ``varLib``: Build a variable font from a designspace file and masters
+- ``varLib.instancer``: Partially instantiate a variable font
+- ``voltLib.voltToFea``: Convert MS VOLT to AFDKO feature files.
+
+Libraries
+---------
+
+The main library for font engineering is :py:mod:`fontTools.ttLib.ttFont`, which handles TrueType/OpenType fonts. Other libraries include:
+
+- :py:mod:`fontTools.afmLib`: Read and write AFM files
+- :py:mod:`fontTools.agl`: Access the Adobe Glyph List
+- :py:mod:`fontTools.cffLib`: Tools for Adobe CFF fonts
+- :py:mod:`fontTools.colorLib`: Handle colors in CPAL/COLR fonts
+- :py:mod:`fontTools.cu2qu`: Convert cubic to quadratic curves
+- :py:mod:`fontTools.designspaceLib`: Read and write designspace files
+- :py:mod:`fontTools.encodings`: Support for font-related encodings
+- :py:mod:`fontTools.feaLib`: Read and write AFDKO feature files
+- :py:mod:`fontTools.fontBuilder`: Construct TTF/OTF fonts from scratch
+- :py:mod:`fontTools.merge`: Tools for merging font files
+- :py:mod:`fontTools.subset`: OpenType font subsetting and optimization
+- :py:mod:`fontTools.svgLib.path`: Draw SVG paths onto glyphs
+- :py:mod:`fontTools.ttLib`: Read/write OpenType and TrueType fonts
+- :py:mod:`fontTools.ttx`: Convert between OTF and XML representation
+- :py:mod:`fontTools.ufoLib`: Read and write UFO files
+- :py:mod:`fontTools.unicodedata`: Convert between Unicode and OpenType script info
+- :py:mod:`fontTools.varLib`: Deal with 'gvar'-style font variations
+- :py:mod:`fontTools.voltLib`: Deal with Visual OpenType Layout Tool (VOLT) files
+
+Optional Dependencies
+---------------------
+
+fontTools has no external dependencies besides the Python Standard Library. Some optional features require additional modules; see the :doc:`optional requirements </optional>` page for details.
+
+Developer Information
+---------------------
+
+For developer resources, refer to the :doc:`developer information </developer>`.
+
+License
+-------
+
+fontTools is licensed under the `MIT license <https://github.com/fonttools/fonttools/blob/main/LICENSE>`_. Refer to the full text of the license for details.
+
+
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+   afmLib
+   agl
+   cffLib/index
+   colorLib/index
+   config
+   cu2qu/index
+   designspaceLib/index
+   encodings/index
+   feaLib/index
+   merge
+   misc/index
+   mtiLib
+   otlLib/index
+   pens/index
+   qu2cu/index
+   subset/index
+   svgLib/index
+   t1Lib
+   tfmLib
+   ttLib/index
+   ttx
+   ufoLib/index
+   unicodedata/index
+   varLib/index
+   voltLib/index
+
+.. |Travis Build Status| image:: https://travis-ci.org/fonttools/fonttools.svg
+   :target: https://travis-ci.org/fonttools/fonttools
+.. |Appveyor Build status| image:: https://ci.appveyor.com/api/projects/status/0f7fmee9as744sl7/branch/master?svg=true
+   :target: https://ci.appveyor.com/project/fonttools/fonttools/branch/master
+.. |Coverage Status| image:: https://codecov.io/gh/fonttools/fonttools/branch/main/graph/badge.svg
+   :target: https://codecov.io/gh/fonttools/fonttools
+.. |PyPI| image:: https://img.shields.io/pypi/v/fonttools.svg
+   :target: https://pypi.org/project/FontTools
+.. |Gitter Chat| image:: https://badges.gitter.im/fonttools-dev/Lobby.svg
+   :alt: Join the chat at https://gitter.im/fonttools-dev/Lobby
+   :target: https://gitter.im/fonttools-dev/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge

fonttools-4.55.3/Doc/source/merge.rst

@@ -0,0 +1,13 @@
+####################################
+merge: Merge multiple fonts into one
+####################################
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+:mod:`fontTools.merge` provides both a library and a command line interface
+(``fonttools merge``) for merging multiple fonts together.
+
+.. autoclass:: fontTools.merge.Merger
+   :members:
+   :undoc-members:

fonttools-4.55.3/Doc/source/mtiLib.rst

@@ -0,0 +1,28 @@
+###########################################
+mtiLib: Read Monotype FontDame source files
+###########################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+FontTools provides support for reading the OpenType Layout tables produced by
+Monotype's FontDame and Font Chef font editors. These tables are written in a
+simple textual format. The :py:mod:`mtiLib` library parses these text files and creates
+table objects representing their contents.
+
+Additionally, running the ``fonttools mtiLib`` command will convert a text file to TTX XML.
+
+
+.. rubric:: Module members:
+   :heading-level: 2
+
+		   
+.. autofunction:: fontTools.mtiLib.build
+
+.. autofunction:: fontTools.mtiLib.main
+
+		       
+.. automodule:: fontTools.mtiLib
+   :members: 
+   :undoc-members:
+   :exclude-members: build, main

fonttools-4.55.3/Doc/source/qu2cu/cli.rst

@@ -0,0 +1,13 @@
+###################################################
+cli: Quadratic-to-cubic converter command-line tool
+###################################################
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+.. automodule:: fontTools.qu2cu.cli
+   :members:
+   :undoc-members:
+     
+    .. rubric:: Module members:
+       :heading-level: 2

fonttools-4.55.3/Doc/source/qu2cu/index.rst

@@ -0,0 +1,38 @@
+########################################
+qu2cu: Convert quadratic curves to cubic
+########################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+
+Routines for converting quadratic curves to cubic splines, suitable for use
+in TrueType to CFF-flavored OpenType outline conversion.
+
+The basic curve conversion routines are implemented in the
+:mod:`fontTools.qu2cu.qu2cu` module.
+
+.. note:: The redundancy in the module name is a workaround made
+	  made necessary by :mod:`fontTools.qu2cu`'s usage of
+	  `Cython <https://cython.org/>`_. Providing Cython support
+	  for the module enables faster execution on systems where
+	  Cython is available. However, the module remains fully
+	  available on systems without Cython, too.
+
+.. automodule:: fontTools.qu2cu.qu2cu
+   :members:
+   :undoc-members:
+
+    qu2cu also includes a submodule that implements the
+    ``fonttools qu2cu`` command for converting a UFO format font with
+    quadratic curves into one with cubic curves:
+		   
+     .. toctree::
+        :maxdepth: 1
+
+        cli
+
+    
+     .. rubric:: Package contents
+        :heading-level: 2
+

fonttools-4.55.3/Doc/source/t1Lib.rst

@@ -0,0 +1,18 @@
+#############################################
+t1Lib: Read and write PostScript Type 1 fonts
+#############################################
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+Note also that :mod:`t1Lib` supports some :doc:`optional </optional>`
+external libraries.
+
+.. automodule:: fontTools.t1Lib
+   :members:
+   :undoc-members:
+
+    
+    .. rubric:: Module members:
+       :heading-level: 2
+ 

fonttools-4.55.3/Doc/source/tfmLib.rst

@@ -0,0 +1,19 @@
+###########################################
+tfmLib: Read TeX Font Metrics files
+###########################################
+
+.. rubric:: Overview
+   :heading-level: 2
+
+
+.. automodule:: fontTools.tfmLib
+   :members: TFM
+   :undoc-members:
+   :exclude-members: TFMException
+
+          
+    .. rubric:: Module contents:
+       :heading-level: 2
+
+		       
+.. autoexception:: fontTools.tfmLib.TFMException

fonttools-4.55.3/Doc/source/ttLib/tables/B_A_S_E_.rst

@@ -0,0 +1,9 @@
+``BASE``: Baseline table
+------------------------
+
+The ``BASE`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.B_A_S_E_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/Bitmap_related.rst

@@ -0,0 +1,36 @@
+##########################
+Bitmap-data helper modules
+##########################
+
+.. contents:: On this page:
+    :local:
+
+.. rubric:: Overview:
+   :heading-level: 2
+
+The modules documented on this page are helpers for
+:mod:`fontTools.ttLib` that implement lower-level support for various
+table converters that need to interact with bitmapped data. The
+:mod:`.BitmapGlyphMetrics` module is used for the ``EBDT``/``EBLC`` and
+``CBDT``/``CBLC`` tables, and :mod:`.sbixGlyph` and :mod:`.sbixStrike`
+are used for the ``sbix`` table.
+
+fontTools.ttLib.tables.BitmapGlyphMetrics
+-----------------------------------------
+.. automodule:: fontTools.ttLib.tables.BitmapGlyphMetrics
+   :members:
+   :undoc-members:
+
+      
+fontTools.ttLib.tables.sbixGlyph
+--------------------------------
+.. automodule:: fontTools.ttLib.tables.sbixGlyph
+   :members:
+   :undoc-members:
+
+      
+fontTools.ttLib.tables.sbixStrike
+---------------------------------
+.. automodule:: fontTools.ttLib.tables.sbixStrike
+   :members:
+   :undoc-members:

fonttools-4.55.3/Doc/source/ttLib/tables/C_B_D_T_.rst

@@ -0,0 +1,13 @@
+``CBDT``: Color Bitmap Data table
+---------------------------------
+
+The ``CBDT`` table is an OpenType table.
+
+This ``CBDT`` table converter module depends on the
+:mod:`.BitmapGlyphMetrics` module, which it shares with the ``EBDT``,
+``EBLC``, and ``CBLC`` converters.
+
+.. automodule:: fontTools.ttLib.tables.C_B_D_T_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/C_B_L_C_.rst

@@ -0,0 +1,13 @@
+``CBLC``: Color Bitmap Location table
+-------------------------------------
+
+The ``CBLC`` table is an OpenType table.
+
+This ``CBLC`` table converter module depends on the
+:mod:`.BitmapGlyphMetrics` module, which it shares with the ``EBDT``,
+``EBLC``, and ``CBDT`` converters.
+
+.. automodule:: fontTools.ttLib.tables.C_B_L_C_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/C_F_F_.rst

@@ -0,0 +1,9 @@
+``CFF``: Compact Font Format table
+----------------------------------
+
+The ``CFF`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.C_F_F_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/C_F_F__2.rst

@@ -0,0 +1,9 @@
+``CFF2``: Compact Font Format (CFF) Version 2 table
+---------------------------------------------------
+
+The ``CFF2`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.C_F_F__2
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/C_O_L_R_.rst

@@ -0,0 +1,8 @@
+``COLR``: Color table
+---------------------
+
+The ``COLR`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.C_O_L_R_
+   :members:
+   :undoc-members:

fonttools-4.55.3/Doc/source/ttLib/tables/C_P_A_L_.rst

@@ -0,0 +1,9 @@
+``CPAL``: Color Palette table
+-----------------------------
+
+The ``CPAL`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.C_P_A_L_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/D_S_I_G_.rst

@@ -0,0 +1,9 @@
+``DSIG``: Digital Signature table
+---------------------------------
+
+The ``DSIG`` table is an OpenType table.
+
+.. automodule:: fontTools.ttLib.tables.D_S_I_G_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/E_B_D_T_.rst

@@ -0,0 +1,13 @@
+``EBDT``: Embedded Bitmap Data table
+------------------------------------
+
+The ``EBDT`` table is an OpenType table.
+
+This ``EBDT`` table converter module depends on the
+:mod:`.BitmapGlyphMetrics` module, which it shares with the ``EBLC``,
+``CBDT``, and ``CBLC`` converters.
+
+.. automodule:: fontTools.ttLib.tables.E_B_D_T_
+   :members:
+   :undoc-members:
+

fonttools-4.55.3/Doc/source/ttLib/tables/E_B_L_C_.rst

@@ -0,0 +1,12 @@
+``EBLC``: Embedded Bitmap Location table
+----------------------------------------
+
+The ``EBLC`` table is an OpenType table.
+
+This ``EBLC`` table converter module depends on the
+:mod:`.BitmapGlyphMetrics` module, which it shares with the ``EBDT``,
+``CBDT``, and ``CBLC`` converters.
+
+.. automodule:: fontTools.ttLib.tables.E_B_L_C_
+   :members:
+   :undoc-members:

fonttools-4.55.3/Doc/source/ttLib/tables/F_F_T_M_.rst

@@ -0,0 +1,10 @@
+``FFTM``: FontForge Time Stamp table
+------------------------------------
+
+The ``FFTM`` table is used by the FontForge font editor.
+
+.. automodule:: fontTools.ttLib.tables.F_F_T_M_
+   :members:
+   :undoc-members:
+
+

fonttools-4.55.3/Doc/source/ttLib/tables/F__e_a_t.rst

@@ -0,0 +1,10 @@
+``Feat``: Graphite Feature table
+--------------------------------
+
+The ``Feat`` table is a Graphite table.
+
+.. automodule:: fontTools.ttLib.tables.F__e_a_t
+   :members:
+   :undoc-members:
+
+