#quote #smart #convert #command-line #line #command #command-line-tool

app squ

Simple command-line utility for converting quotation marks in plaintext files to "smart quotes"

1 unstable release

0.1.0 Dec 16, 2022

#2698 in Command line utilities

MIT license

6KB

squ

Simple command-line utility for converting quotation marks in plaintext files to "smart quotes". A very, very, very thin wrapper around the crowbook-text-processing crate.

Why?

Writing and typesetting should be two separate processes. Unfortunately, mankind has inflicted upon itself the diabolical torments of WYSIWYG/"rich text" editing, bringing writing and typesetting together in an exceedingly unhappy marriage.

If you like writing in plaintext editors with regular quotes, but need to convert your writing to "smart quotes" for publication/distribution and the tools you're using don't already support doing so, squ is a fast, flexible option.

Installation

  1. Install Rust
  2. cargo install squ

Usage

squ attempts to convert the quotes in an existing file to "smart quotes". It can either output the result to stdout or replace the contents of the input file in place. It can't, yet, operate on stdin. Sorry.

$ squ --help    
Convert plain quotes (single and double) in a file to matched "smart" quotes

Usage: squ [OPTIONS] <FILE>

Arguments:
  <FILE>  The file to convert

Options:
  -i, --in-place  
  -h, --help      Print help information
  -V, --version   Print version information

Example

The file foo.txt contains text quoted with reqular quotation marks. After processing by squ, those quotes have been converted to matching "smart quotes", making foo.txt a dirty liar. Note the use of the -i flag to operate on foo.txt in-place.

$ cat foo.txt 
"This file doesn't have smart quotes!"
$ squ -i foo.txt 
$ cat foo.txt   
“This file doesn’t have smart quotes!”

TODO

  • Inverted operation, converting "smart quotes" to plain quotes. This is really easy to do with sed and similar but could still be handy.
  • Operate on stdin.
  • Other related functionality: emdashes, extraneous space removal, etc.

Dependencies

~3.5–5MB
~89K SLoC