Path Inspector is a quadratic font curve path inspection application. The Python package installs the pathins command line executable and requires a Python v3.6+ interpreter.
The following sub-commands are available:
contours: path contour number reportcoordinates: path coordinates reportdirection: outermost contour path direction reportpath: curve path reportsegments: curve segment report, with line distances and quadratic curve arc lengths
pathins requires a Python 3.6+ interpreter.
Installation in a Python3 virtual environment is recommended.
Use any of the following installation approaches:
$ pip3 install pathins
$ git clone https://github.com/source-foundry/path-inspector.git
$ cd path-inspector
$ pip3 install -r requirements.txt .
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/path-inspector.git
$ cd path-inspector
$ pip3 install --ignore-installed -r requirements.txt -e ".[dev]"
$ pathins [SUB-COMMAND] [OPTIONS] [FILEPATH] [OPTIONAL GLYPH NAME]
See pathins --help for additional details.
Please report issues on the project issue tracker.
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.
Python source files are linted with flake8. See the Makefile test-lint target for details.
The project runs continuous integration testing on the GitHub Actions service with the pytest 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.
Unit test coverage is executed with the coverage tool. See the Makefile test-coverage target for details.
The Path Inspector project is built with the fantastic fontTools and skia-pathops free software libraries.
Copyright 2020 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.
