decasify for Mac

[][rock]

A CLI utility, Rust crate, Lua rock, Python module, JavaScript module, Neovim or VIM plugin, SILE package, and Typst package to cast strings to title-case (and other cases) according to locale specific style guides including Turkish support.

This project was born out of frustration with authors and editors leaving ALL CAPS TITLES in Markdown sources. No tooling I could find properly supported casting these to title-cased strings (which are more versatile for typesetting purposes). The problem was doubly hard because most of my work is adjacent to Turkish, and even less tooling was available and has special issues with case conversions. Many tools can handle casing single words, some programmer specific tools handle re-casing tokens and identifiers, and yet a few others can handle English strings. But nothing seemed to be out there for changing the case of Turkish prose.

The CLI defaults to titlecase and English, but lower, upper, and sentence case options are also available. The Rust, Lua, Python, and JavaScript library APIs have functions specific to each operation. Where possible the APIs currently default to English rules and (for English) the Gruber style guide, but others are available.

The Spanish style roughly follows optional stylistic exceptions noted by Real Academia Española. Keep in mind most Spanish style guides eschew title casing and use sentence-case for many things that would traditionally be title-cased in English. This library implements a best-guess at title-casing when asked to, it does not help you understand when (not) to use it in the first place.

The Turkish style follows the Turkish Language Institute's guidelines.

For English, three style guides are known: Associated Press (AP), Chicago Manual of Style (CMOS), and John Gruber's Daring Fireball (Gruber). The Gruber style is by far the most complete, being implemented by the titlecase crate. The CMOS style handles a number of parts of speech but has punctuation related issues. The AP style is largely unimplemented.

Contributions are welcome for better style guide support or further languages.

Use as a CLI tool

Use of the CLI is pretty simple. Input may be either shell arguments or STDIN. Arguments can control the various options. For full usage information check decasify --help or man decasify.

Installation

To install, first check your distro for packages, e.g. for Arch Linux just install via pacman -S decasify or for Homebrew via brew install decasify.

Otherwise for many platforms you can run it directly or install it to a shell using Nix Flakes:

To do a full install from source, grab the tarball attached to the latest release or use Git to clone the repository. Don't use the "source code" zip/tar.gz files linked from releases, go for the tar.zst source file. If you use a Git close, first run ./bootstrap.sh after checkout. This isn't needed in the source release tarballs. Next, configure and install with: