Skip to main content

A tool for the removal of TrueType instruction sets (hints) in fonts

Project description


Build Status Build status codecov Codacy Badge

About

dehinter is a Python command line application that removes TrueType instruction sets, global hinting tables, and other associated OpenType table data in font files. The tool provides cross-platform support on macOS, Windows, and Linux systems with a Python v3.6+ interpreter.

What it does

Options allow you to maintain the original version of any of these tables.

Installation

dehinter requires a Python 3.6+ interpreter.

Installation in a Python3 virtual environment is recommended as dependencies are pinned to versions that are confirmed to work with this project.

Use any of the following installation approaches:

pip install from PyPI

$ pip3 install dehinter

pip install from source

$ git clone https://github.com/source-foundry/dehinter.git
$ cd dehinter
$ pip3 install .

Developer install from source

The following approach installs the project and associated optional developer dependencies so that source changes are available without the need for re-installation.

$ git clone https://github.com/source-foundry/dehinter.git
$ cd dehinter
$ pip3 install --ignore-installed -r requirements.txt -e ".[dev]"

Usage

$ dehinter [OPTIONS] [HINTED FILE PATH]

By default, a new dehinted font build write occurs on the path [ORIGINAL HINTED FONT NAME]-dehinted.ttf in the [HINTED FILE PATH] directory.

Use dehinter -h to view available options.

Issues

Please report issues on the project issue tracker.

Contributing

Contributions are warmly welcomed. A development dependency environment can be installed in editable mode with the developer installation documentation above.

Please use the standard Github pull request approach to propose source changes.

Source file linting

Python source files are linted with flake8. See the Makefile test-lint target for details.

Source file static type checks

Static type checks are performed on Python source files with pytype. See the Makefile test-type-check target for details.

Testing

The project runs continuous integration testing on Travis CI and Appveyor CI with the pytest and tox testing toolchain. Test modules are located in the tests directory of the repository.

Local testing by Python interpreter version can be performed with the following command executed from the root of the repository:

$ tox -e [PYTHON INTERPRETER VERSION]

Please see the tox documentation for additional details.

Test coverage

Unit test coverage is executed with the coverage tool. See the Makefile test-coverage target for details.

Acknowledgments

dehinter is built with the fantastic fontTools free software library and is based on the dehinting approach used in the ttfautohint free software project.

License

Copyright 2019 Source Foundry Authors and Contributors

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for dehinter, version 0.4.2
Filename, size File type Python version Upload date Hashes
Filename, size dehinter-0.4.2-py3-none-any.whl (14.8 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size dehinter-0.4.2.tar.gz (14.3 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page