{ "info": { "author": "Source Foundry Authors", "author_email": "chris@sourcefoundry.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7" ], "description": "\n
\n\n## An OpenType table diff tool for fonts\n\n[![PyPI](https://img.shields.io/pypi/v/fdiff?color=blueviolet&label=PyPI&logo=python&logoColor=white)](https://pypi.org/project/fdiff/)\n[![GitHub license](https://img.shields.io/github/license/source-foundry/fdiff?color=blue)](https://github.com/source-foundry/fdiff/blob/master/LICENSE)\n[![Build Status](https://travis-ci.org/source-foundry/fdiff.svg?branch=master)](https://travis-ci.org/source-foundry/fdiff)\n[![Build status](https://ci.appveyor.com/api/projects/status/eafvbkc4iyv78dip/branch/master?svg=true)](https://ci.appveyor.com/project/chrissimpkins/fdiff/branch/master)\n[![codecov](https://codecov.io/gh/source-foundry/fdiff/branch/master/graph/badge.svg)](https://codecov.io/gh/source-foundry/fdiff)\n[![Codacy Badge](https://api.codacy.com/project/badge/Grade/b58954eda44b4fd88ad8f4fa06e8010b)](https://www.codacy.com/app/SourceFoundry/fdiff)\n\n\n## About\n\n`fdiff` is a Python command line comparison tool for assessment of differences in the OpenType table data between font files. The tool provides cross-platform support on macOS, Windows, and Linux systems with a Python v3.6+ interpreter.\n\n

\n\n

\n\n## What it does\n\n- Takes two font file path (or URL for remote fonts) arguments for the font comparison\n- Dumps OpenType table data in the fontTools library TTX format (XML)\n- Compares the OpenType table data across the two files using the unified diff format with 3 lines of surrounding context\n\n## Optional Features\n\n- View colored diffs in the terminal with the `-c` or `--color` flag\n- Filter OpenType tables with the `--include` or `--exclude` options\n- Modify the number of context lines displayed in the diff with the `-l` or `--lines` option\n- Display the first n lines of the diff output with the `--head` option\n- Display the last n lines of the diff output with the `--tail` option\n\n\nRun `fdiff --help` to view all available options.\n\n## Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n- [Issues](#issues)\n- [Contributing](#contributing)\n- [Acknowledgments](#acknowledgments)\n- [Licenses](#licenses)\n\n## Installation\n\n`fdiff` requires a Python 3.6+ interpreter.\n\nInstallation in a [Python3 virtual environment](https://docs.python.org/3/library/venv.html) is recommended.\n\nUse any of the following installation approaches:\n\n### pip install from PyPI\n\n```\n$ pip3 install fdiff\n```\n\n### pip install from source\n\n```\n$ git clone https://github.com/source-foundry/fdiff.git\n$ cd fdiff\n$ pip3 install .\n```\n\n### Developer install from source\n\nThe following approach installs the project and associated optional developer dependencies so that source changes are available without the need for re-installation.\n\n```\n$ git clone https://github.com/source-foundry/fdiff.git\n$ cd fdiff\n$ pip3 install --ignore-installed -r requirements.txt -e \".[dev]\"\n```\n\n## Usage\n\n#### Local font files\n\n```\n$ fdiff [OPTIONS] [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n#### Remote font files\n\n`fdiff` supports GET requests for publicly accessible remote font files. Replace the file path arguments with URL:\n\n```\n$ fdiff [OPTIONS] [PRE-FONT FILE URL] [POST-FONT FILE URL]\n```\n\n`fdiff` works with any combination of local and remote font files. For example, to compare a local post font file with a remote pre font file to assess local changes against a font file that was previously pushed to a remote, use the following syntax:\n\n```\n$ fdiff [OPTIONS] [PRE-FONT FILE URL] [POST-FONT FILE FILE PATH]\n```\n\n\u2b50 **Tip**: Remote git repository hosting services (like Github) support access to files on different git branches by URL. Use these repository branch URL to compare fonts across git branches in your repository.\n\n### Options\n\n#### Color diffs\n\nUncolored diffs are performed by default.\n\nTo view a colored diff in your terminal, include either the `-c` or `--color` option in your command:\n\n```\n$ fdiff --color [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n#### Filter OpenType tables\n\nTo include only specified tables in your diff, use the `--include` option with a comma separated list of table names:\n\n```\n$ fdiff --include head,post [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\nTo exclude specified tables in your diff, use the `--exclude` option with a comma separated list of table names:\n\n```\n$ fdiff --exclude glyf,OS/2 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n**Do not include spaces** between the comma separated table name values!\n\n#### Change number of context lines\n\nTo change the number of lines of context above/below lines that have differences, use the `-l` or `--lines` option with an integer value for the desired number of lines. The following command reduces the contextual information to a single line above and below lines with differences: \n\n```\n$ fdiff -l 1 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n#### Display the first n lines of output\n\nUse the `--head` option followed by an integer for the number of lines at the beginning of the output. For example, the following command displays the first 20 lines of the diff:\n\n```\n$ fdiff --head 20 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n#### Display the last n lines of output\n\nUse the `--tail` option followed by an integer for the number of lines at the end of the output. For example, the following command displays the last 20 lines of the diff:\n\n```\n$ fdiff --tail 20 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]\n```\n\n### Other Options\n\nUse `fdiff -h` to view all available options.\n\n## Issues\n\nPlease report issues on the [project issue tracker](https://github.com/source-foundry/fdiff/issues).\n\n## Contributing\n\nContributions are warmly welcomed. A development dependency environment can be installed in editable mode with the developer installation documentation above. \n\nPlease use the standard Github pull request approach to propose source changes.\n\n### Source file linting\n\nPython source files are linted with `flake8`. See the Makefile `test-lint` target for details.\n\n### Source file static type checks\n\nStatic type checks are performed on Python source files with `pytype`. See the Makefile `test-type-check` target for details.\n\n### Testing\n\nThe project runs continuous integration testing on [Travis CI](https://travis-ci.org/source-foundry/fdiff) and [Appveyor CI](https://ci.appveyor.com/project/chrissimpkins/fdiff) with the `pytest` and `tox` testing toolchain. Test modules are located in the `tests` directory of the repository.\n\nLocal testing by Python interpreter version can be performed with the following command executed from the root of the repository:\n\n```\n$ tox -e [PYTHON INTERPRETER VERSION]\n```\n\nPlease see the `tox` documentation for additional details.\n\n### Test coverage\n\nUnit test coverage is executed with the `coverage` tool. See the Makefile `test-coverage` target for details.\n\n## Acknowledgments\n\n`fdiff` is built with the fantastic [fontTools free software library](https://github.com/fonttools/fonttools) and performs text diffs of binary font files using dumps of the TTX OpenType table data serialization format as defined in the fontTools library. The implementation of unified text file diffs is based on a (slightly) modified version of the Python `difflib` standard library source. The modifications address diff performance issues with the lengthy text output from TTX dumps of font OpenType data. \n\n## Licenses\n\n### fdiff\n\nCopyright 2019 Source Foundry Authors and Contributors\n\nLicensed 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\n\n[http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)\n\nUnless 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.\n\n### Third Party Licenses\n\n#### CPython `difflib` library\n\nThis project distributes a modified version of third party source code from the [Python programming language standard library](https://github.com/python/cpython). The `difflib.py` v3.7.4 module is Copyright \u00a9 2001-2019 Python Software Foundation; All Rights Reserved. This source is modified and distributed in this project under the [PSF LICENSE AGREEMENT FOR PYTHON 3.7.4](https://github.com/source-foundry/fdiff/blob/master/lib/fdiff/thirdparty/PYTHON_LICENSE). The module is renamed to `fdifflib.py` to distinguish it from the upstream source and modifications made here are documented in comments at the head of the module.\n\n\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/source-foundry/fdiff", "keywords": "", "license": "Apache License v2.0", "maintainer": "", "maintainer_email": "", "name": "fdiff", "package_url": "https://pypi.org/project/fdiff/", "platform": "Any", "project_url": "https://pypi.org/project/fdiff/", "project_urls": { "Homepage": "https://github.com/source-foundry/fdiff" }, "release_url": "https://pypi.org/project/fdiff/0.5.1/", "requires_dist": [ "fontTools (>=4.0.0)", "aiohttp (>=3.6.0)", "aiodns (>=2.0.0)", "aiofiles (>=0.4.0)", "coverage ; extra == 'dev'", "pytest ; extra == 'dev'", "pytest-asyncio ; extra == 'dev'", "tox ; extra == 'dev'", "flake8 ; extra == 'dev'", "pytype ; extra == 'dev'", "wheel ; extra == 'maintain'", "setuptools ; extra == 'maintain'", "twine ; extra == 'maintain'" ], "requires_python": ">=3.6.0", "summary": "An OpenType table diff tool for fonts", "version": "0.5.1" }, "last_serial": 5847552, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "398126d4ed1600304c7f20bf4d4e0282", "sha256": "d3773d300743c75a553ceaf407905cff330bca984455d97101dbe453d8a93790" }, "downloads": -1, "filename": "fdiff-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "398126d4ed1600304c7f20bf4d4e0282", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 6423, "upload_time": "2019-09-04T21:31:29", "url": "https://files.pythonhosted.org/packages/ef/b9/250d93471b3b19a639c45b26bae1158a97194501486720e58f06877660c3/fdiff-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "15a646536c05c865691f2b52a22eedd7", "sha256": "43f55450a2e96f9f2114ebcfad8525314628dab6b3bc1bf031f5514fc9e76ccd" }, "downloads": -1, "filename": "fdiff-0.0.1.tar.gz", "has_sig": false, "md5_digest": "15a646536c05c865691f2b52a22eedd7", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 6369, "upload_time": "2019-09-04T21:31:31", "url": "https://files.pythonhosted.org/packages/b2/1c/223ac3bdd512409bf6d6de02ecb7804bd8736b0c52c29d06fd9506dd2c5d/fdiff-0.0.1.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "940e1a81ea7f210010075f9fd919843f", "sha256": "6b67716a991cbbe4c5df87fb7a83c4c86f3379e1f2b7fa90e847508cc8cce110" }, "downloads": -1, "filename": "fdiff-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "940e1a81ea7f210010075f9fd919843f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 34706, "upload_time": "2019-09-06T19:48:14", "url": "https://files.pythonhosted.org/packages/c6/f7/99209e1f42ac503c7d4ae50c7bb702a4d0979f5975f4936adf9ee06efb43/fdiff-0.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "88c94b3c90bc52b8862a71578cd6574c", "sha256": "d497af8e1018d6ce821f06eac0ab3a0c21a5a48ec5f3985d13a392afe62e38e8" }, "downloads": -1, "filename": "fdiff-0.1.0.tar.gz", "has_sig": false, "md5_digest": "88c94b3c90bc52b8862a71578cd6574c", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 36523, "upload_time": "2019-09-06T19:48:16", "url": "https://files.pythonhosted.org/packages/52/5d/07e65725b91a175de89e4908da9eec029382e9ffe86b81f3aeb117fd379b/fdiff-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "e729a3e0a0dcf2beb9c5e26ceed001ba", "sha256": "5cb4b5a909f0671f6dbd3b4e2605ea31640cebda43e7eadf3daf9049f17231e6" }, "downloads": -1, "filename": "fdiff-0.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e729a3e0a0dcf2beb9c5e26ceed001ba", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 36439, "upload_time": "2019-09-07T05:40:30", "url": "https://files.pythonhosted.org/packages/8d/ed/e7c06c3be564de06576879e8dab562e40868824e7408ecdeb1218a8f6211/fdiff-0.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1fe4bc24053c03bd714534fa9da98749", "sha256": "dfefc923cb730c03e88db482a04fc5ba8e257107b3f76dcd76ac50af784fa3a1" }, "downloads": -1, "filename": "fdiff-0.2.0.tar.gz", "has_sig": false, "md5_digest": "1fe4bc24053c03bd714534fa9da98749", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 38527, "upload_time": "2019-09-07T05:40:32", "url": "https://files.pythonhosted.org/packages/a9/22/8dce4370bf2ddc321469e844586ae9ba2666e8161eba236ff35f807563ac/fdiff-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "5b80d7146da20f04695461834604ef97", "sha256": "d6b104a06baf6aeece8a175c647ca48748de12baa072e4e34e2b8b0095c1bc3d" }, "downloads": -1, "filename": "fdiff-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "5b80d7146da20f04695461834604ef97", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 37098, "upload_time": "2019-09-08T02:41:08", "url": "https://files.pythonhosted.org/packages/6c/d6/65002524a56aaaaadb08aa01e51658a1d72cf578b63ec9d0353adacc94ab/fdiff-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7110db143fe04b4c1e6c55d0f31c31ec", "sha256": "2625462bf99f07bcd9f2a64c9477f2ed4e25d7f3c0d220d45433ccbfea4750d9" }, "downloads": -1, "filename": "fdiff-0.3.0.tar.gz", "has_sig": false, "md5_digest": "7110db143fe04b4c1e6c55d0f31c31ec", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 39302, "upload_time": "2019-09-08T02:41:10", "url": "https://files.pythonhosted.org/packages/ab/56/184fbb9665919b3f52494fa866e956df28f3f98ae2218ec15ca210de2df0/fdiff-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "b6d97510dcf6968f747166781c1a9e9c", "sha256": "487d3bf5fb19b9ea158be0a764b015e5bdc2af7cd1c2fe35f5fa305dca60ed2d" }, "downloads": -1, "filename": "fdiff-0.4.0-py3-none-any.whl", "has_sig": false, "md5_digest": "b6d97510dcf6968f747166781c1a9e9c", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 39434, "upload_time": "2019-09-16T20:59:09", "url": "https://files.pythonhosted.org/packages/87/35/79ee0cc1edee17357e553b962685ddb97ddee8686fe02d58f358f352f2ad/fdiff-0.4.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "1910229f4e4167179dbac90a4b4f824d", "sha256": "c0045a673cc64b961c54fd432bc787ea3f20af097b2047d855da95d6a6556918" }, "downloads": -1, "filename": "fdiff-0.4.0.tar.gz", "has_sig": false, "md5_digest": "1910229f4e4167179dbac90a4b4f824d", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 41715, "upload_time": "2019-09-16T20:59:10", "url": "https://files.pythonhosted.org/packages/c6/9f/4d1ad61d9f27b599418a7f902c5756f3d368d0d6f9a15bf39cc9ea7f5a5b/fdiff-0.4.0.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "e2ff8398f7c806b979d94a2e274dec1a", "sha256": "38c84ca27f68e769eb287c0b740ebe4c4d70e0f90e767de79c97aac932f62529" }, "downloads": -1, "filename": "fdiff-0.5.0-py3-none-any.whl", "has_sig": false, "md5_digest": "e2ff8398f7c806b979d94a2e274dec1a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 39986, "upload_time": "2019-09-18T03:04:26", "url": "https://files.pythonhosted.org/packages/fa/ee/433cd3f17165f7dbff596d7c6938b7abd71aba3ff1c9dd512e54cee24b99/fdiff-0.5.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c25f0e2903826f9754c5fa02410c0a6e", "sha256": "b09d56bde9efde83f96957a4c232427c0ff598ff6cbb900be820316483e855a4" }, "downloads": -1, "filename": "fdiff-0.5.0.tar.gz", "has_sig": false, "md5_digest": "c25f0e2903826f9754c5fa02410c0a6e", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 42445, "upload_time": "2019-09-18T03:04:27", "url": "https://files.pythonhosted.org/packages/0b/3b/08aca54b326d72e56dc9fff9256edc0789338c12e5efa7dd655c6ffb89e7/fdiff-0.5.0.tar.gz" } ], "0.5.1": [ { "comment_text": "", "digests": { "md5": "a08812e5605bfda30fd60684d84dcd87", "sha256": "419bff9cbfcd64074234f03f76ca954378ae3d99e1bf2f0237e070d882d91b88" }, "downloads": -1, "filename": "fdiff-0.5.1-py3-none-any.whl", "has_sig": false, "md5_digest": "a08812e5605bfda30fd60684d84dcd87", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 39991, "upload_time": "2019-09-18T03:25:47", "url": "https://files.pythonhosted.org/packages/02/4a/8cb8e6632dbc39727e9923195a2a912cdb821e76186a59686aab390dbb3c/fdiff-0.5.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "05486bd0dfeed02a931754f4c3e700f3", "sha256": "ac646f6e17ec212219b2b92575f9315ef78c17ea946915e2d1c10efdde177d76" }, "downloads": -1, "filename": "fdiff-0.5.1.tar.gz", "has_sig": false, "md5_digest": "05486bd0dfeed02a931754f4c3e700f3", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 42506, "upload_time": "2019-09-18T03:25:49", "url": "https://files.pythonhosted.org/packages/2a/58/c19036d60911a2beeaa83f488bffb08c66fbd44bdd6a1fbc3f6cabd3ec38/fdiff-0.5.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "a08812e5605bfda30fd60684d84dcd87", "sha256": "419bff9cbfcd64074234f03f76ca954378ae3d99e1bf2f0237e070d882d91b88" }, "downloads": -1, "filename": "fdiff-0.5.1-py3-none-any.whl", "has_sig": false, "md5_digest": "a08812e5605bfda30fd60684d84dcd87", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.0", "size": 39991, "upload_time": "2019-09-18T03:25:47", "url": "https://files.pythonhosted.org/packages/02/4a/8cb8e6632dbc39727e9923195a2a912cdb821e76186a59686aab390dbb3c/fdiff-0.5.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "05486bd0dfeed02a931754f4c3e700f3", "sha256": "ac646f6e17ec212219b2b92575f9315ef78c17ea946915e2d1c10efdde177d76" }, "downloads": -1, "filename": "fdiff-0.5.1.tar.gz", "has_sig": false, "md5_digest": "05486bd0dfeed02a931754f4c3e700f3", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.0", "size": 42506, "upload_time": "2019-09-18T03:25:49", "url": "https://files.pythonhosted.org/packages/2a/58/c19036d60911a2beeaa83f488bffb08c66fbd44bdd6a1fbc3f6cabd3ec38/fdiff-0.5.1.tar.gz" } ] }