A fast, flexible UFO source file formatter based on the Rust Norad library
ufofmt is a Rust executable that supports customizable UFO source file formatting.
| glif | plist | fea | |
|---|---|---|---|
| line endings | line feed | line feed | line feed |
| indentation spacing | single tab per level | single tab per level | n/a |
| XML declaration attributes | double quotes | double quotes | n/a |
Custom formatting options are described in the Usage section below.
The installation process installs the ufofmt executable.
Install Rust, then follow the instructions below.
The following command installs the latest release build:
$ cargo install ufofmt
Upgrade a previous installation to a new release version with:
$ cargo install --force ufofmt
The following command installs a build from the latest commit in the main branch of the repository:
$ git clone https://github.com/source-foundry/ufofmt.git
$ cd ufofmt && cargo install --path .
Pass one or more UFO source directory paths to the ufofmt executable:
$ ufofmt [OPTIONS] [UFO PATH 1] ... [UFO PATH N]
Use the command ufofmt --help to view all available command line options.
Single tab indentation spacing per level is the default. Switch to space characters with the --indent-space command line option. See the section below to define the number of indentation spacing characters per level.
Define between 1 - 4 tab or space indentation chars with the --indent-number [NUMBER] command line option. See the section above to use spaces instead of tabs.
XML declaration attributes are enclosed in double quotes by default. Convert to single quotes with the --singlequotes command line option.
Contributions to the project are welcomed! All contributions are accepted under the project license defined in the License section below.
Test local changes in the executable with:
$ cargo run -- [ARGS]
Add tests to cover your source changes and run the test suite locally with:
$ cargo test
Please open a GitHub pull request with your change proposal.
Please build and review your documentation changes locally with:
$ cargo doc --open
Please open a GitHub pull request with your change proposal.