source-foundry/ufodiff is a open-source project on GitHub, written primarily in Python. It has 29 stars. UFO source file diff application
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
ufodiff is a command line UFO source file diff tool for collaborative typeface development projects.
It examines git repositories for changes to files that are part of the UFO source spec only (i.e. all file changes in the repository external to the UFO source code are not considered by the tool). It supports reporting of UFO source file additions, deletions, and modifications as well as colored and uncolored text diffs for UFO source files that were modified between branches or across one or more commits.
UFO versions 2 and 3 are fully supported in the current release.
Contents
Contents
Install
Quickstart Examples
Plain Text
Markdown
JSON
Colored text diff
For terminals with ANSI color code support
Uncolored text diff
Usage
View Results in Terminal
Piping Data to Other Applications
File Writes
ufodiff Subcommands
Subcommand List
Issues
License
Install
Installation with pip is recommended:
$ pip install ufodiff
Upgrade a previous installation with:
$ pip install --upgrade ufodiff
Quickstart Examples
List UFO source file additions, deletions, and modifications
Plain Text
For the last two commits:
$ ufodiff delta all commits:2
For the last five commits:
$ ufodiff delta all commits:5
For the last five commits, only from the Test-Regular.ufo source directory (note: not a filepath to source, only include UFO directory name):
$ ufodiff delta all commits:5 Test-Regular.ufo
Between the current branch and the development branch
# ufodiff delta all branch:development
Markdown
For the last two commits in current branch:
$ ufodiff deltamd all commits:2
For the last five commits in current branch:
$ ufodiff deltamd all commits:5
For the last five commits in current branch, only from the Test-Regular.ufo source directory (note: not a filepath to source, only include UFO directory name):
$ ufodiff deltamd all commits:5 Test-Regular.ufo
Between the current branch and the development branch
# ufodiff deltamd all branch:development
JSON
For the last two commits in current branch:
$ ufodiff deltajson all commits:2
For the last five commits in current branch:
$ ufodiff deltajson all commits:5
For the last five commits in current branch, only from the Test-Regular.ufo source directory (note: not a filepath to source, only include UFO directory name):
$ ufodiff deltajson all commits:5 Test-Regular.ufo
Between the current branch and the development branch
# ufodiff deltajson all branch:development
Text diff UFO source files
Colored text diff
For terminals with ANSI color code support
All modified UFO files, last two commits:
$ ufodiff diff commits:2
All modified UFO files, last five commits:
$ ufodiff diff commits:5
All modified files, current branch vs. development branch:
$ ufodiff diff branch:development
Uncolored text diff
All modified UFO files, last two commits:
$ ufodiff diffnc commits:2
All modified UFO files, last five commits:
$ ufodiff diffnc commits:5
All modified files, current branch vs. development branch:
$ ufodiff diffnc branch:development
Usage
ufodiff is a command line executable. Application features are accessed via subcommands to the ufodiff executable.
Execute ufodiff inside the git repository where you develop your typeface. It will recursively test for the repository root from up to 4 levels of repository directory depth. If you are receiving exceptions due to inability to instantiate your git repository object, try bumping your working directory
up a few levels closer to the root. There are otherwise no restrictions to where ufodiff is executed inside the repository. The source directory does not need to be the current working directory.
View Results in Terminal
By default, data are displayed in your terminal. Use one of the following approaches to either pipe data to another application or write data to a file.
Piping Data to Other Applications
On Unix/Linux/OS X platforms, use the | idiom to pipe the standard output stream from ufodiff to another application for further processing like this:
$ ufodiff deltajson all commits:3 | anotherapp --dosomething-with-json
File Writes
On Unix/Linux/OS X platforms, use the > idiom to write the data in the standard output stream to a filepath like this:
$ ufodiff delta all commits:1 > myfont_delta.txt
ufodiff Subcommands
Subcommand List
delta
deltajson
deltamd
diff
diffnc
The commit history for all commands is compared with the HEAD~N git idiom. The branch comparisons across all commands are performed with the test_branch..current_branch git idiom.
delta
ufo delta generates file modification, addition, and deletion reports over a user specified number of commits or across git branches. The data are streamed in plain text format through standard output with indicators for the type of file change.
The file change indicators include:
[A] file added
[D] file deleted
[M] file modified
For Markdown formatted data, see the deltamd command. For JSON formatted data, see the deltajson subcommand.
where N is an integer value that represents the number of commits in the git commit history to examine and name is the name of an existing git branch in the repository. These are mutually exclusive arguments.
Examples:
$ ufodiff delta all commits:3
$ ufodiff delta all commits:5
$ ufodiff delta all commits:3 Test-Regular.ufo
$ ufodiff delta all branch:development
$ ufodiff delta all branch:development Test-Regular.ufo
Increase or decrease the integer value after the commits: argument to change the depth of the git commit history that you want to examine. Include an existing git branch name following the branch: argument to perform a branch vs. branch comparison.
Add one or more optional UFO source base directory names (e.g. Font-Regular.ufo) as last positional arguments in your command to filter the delta analysis by individual source directories.
deltajson
ufo deltajson generates file modification, addition, and deletion reports over a user specified number of commits or across git branches. The data are streamed in JSON format through standard output.
For plain text formatted data, see the delta subcommand. For Markdown formatted data, see the deltamd command.
where N is an integer value that represents the number of commits in the git commit history to examine and name is the name of an existing git branch in the repository. These are mutually exclusive arguments.
Examples:
$ ufodiff deltajson all commits:3
$ ufodiff deltajson all commits:5
$ ufodiff deltajson all commits:3 Test-Regular.ufo
$ ufodiff deltajson all branch:development
$ ufodiff deltajson all branch:development Test-Regular.ufo
JSON data for commit history analyses are formatted as:
Increase or decrease the integer value after the commits: argument to change the depth of the git commit history that you want to examine. Include an existing git branch name following the branch: argument to perform a branch vs. branch comparison.
Add one or more optional UFO source base directory name (e.g. Font-Regular.ufo) as last positional arguments in your command to filter the delta analysis by individual source directories.
deltamd
ufodiff deltamd generates file modification, addition, and deletion reports over a user specified number of commits or across git branches. The data are streamed in Github flavored Markdown format through standard output.
For plain text formatted data, see the delta command. For JSON formatted data, see the deltajson command.
where N is an integer value that represents the number of commits in the git commit history to examine and name is an existing git branch name for a branch vs. branch comparison.
Examples:
$ ufodiff deltamd all commits:3
$ ufodiff deltamd all commits:5
$ ufodiff deltamd all commits:3 Test-Regular.ufo
Increase or decrease the integer value after the commits: argument to change the depth of the git commit history that you want to examine. Include an existing git branch name following the branch: argument to perform a branch vs. branch comparison.
Add one or more optional UFO source base directory name (e.g. Font-Regular.ufo) as last positional arguments in your command to filter the delta analysis by individual source directories.
diff
ufodiff diff provides colored text diffs for all UFO files that were modified across one or more commits in the working branch, or between the HEAD of the working branch and any other branch in the repository.
For uncolored diffs, see the diffnc command.
The command syntax is:
ufodiff diff [commits:[N] | branch:[name]]
where N is an integer value that represents the number of commits in the git commit history to examine and name is the name of an existing git branch in the repository. These are mutually exclusive arguments.
ufodiff diffnc provides uncolored text diffs for all UFO files that were modified across one or more commits in the working branch, or between the HEAD of the working branch and any other branch in the repository.
For colored diffs intended for use in terminals that support ANSI color codes, see the diff command.
The command syntax is:
ufodiff diffnc [commits:[N] | branch:[name]]
where N is an integer value that represents the number of commits in the git commit history to examine and name is the name of an existing git branch in the repository. These are mutually exclusive arguments.
Does source-foundry/ufodiff have a project website?
No homepage URL was recorded for source-foundry/ufodiff in TopGit's last sync. The README tab above frequently contains screenshots and demo links, or check the repository description on GitHub.
How active is development on source-foundry/ufodiff?
The most recent commit recorded on source-foundry/ufodiff was 3.8 years ago, based on the GitHub push timestamp. The repository has 1 forks — one of the better signals of community interest.
How many stars does source-foundry/ufodiff have?
source-foundry/ufodiff has 29 GitHub stars — refresh the page for the live number, or check github.com/source-foundry/ufodiff. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is source-foundry/ufodiff written in?
source-foundry/ufodiff is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What topics is source-foundry/ufodiff associated with?
GitHub's repository topics for source-foundry/ufodiff: "diff", "font", "json-data", "source-code", "typeface", "ufo", "ufo-source". TopGit's editorial category is open-source.
Where do I read more about source-foundry/ufodiff?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/source-foundry/ufodiff is the definitive source.
Read full README in the tab above.
Want a second opinion on ufodiff?
Ask an AI that can read this page — one click and you get its take on ufodiff.