proselint

To help you get started, we've collected the most common ways that proselint is being used within popular public projects.

amperser / proselint / tests / test_existence_check.py View on Github

def test_multiple_matches(self):
        """Test that multiple matches are found correctly."""
        assert len(
            chk("""abc and abc are as easy as 123""",
                self.l, self.err, self.msg)) == 2
        assert len(
            chk("""ABC and abc are as easy as 123""",
                self.l, self.err, self.msg, ignore_case=True)) == 2
        assert chk(
            """abcabc are easy as 123""", self.l, self.err, self.msg) == []

View more ways to use proselint

Writing is notoriously hard, even for the best writers, and it's not for lack of good advice — a tremendous amount of knowledge about the craft is strewn across usage guides, dictionaries, technical manuals, essays, pamphlets, websites, and the hearts and minds of great authors and editors. But poring over Strunk & White hardly makes one a better writer — it turns you into neither Strunk nor White. And nobody has the capacity to apply all the advice from Garner’s Modern English Usage, an 1100-page usage guide, to everything they write. In fact, the whole notion that one becomes a better writer by reading advice on writing rests on untenable assumptions about learning and memory. The traditional formats of knowledge about writing are thus essentially inert, waiting to be transformed.

We devised a simple solution: proselint, a linter for English prose. A linter is a computer program that, akin to a spell checker, scans through a file and detects issues — like how a real lint roller helps you get unwanted lint off of your shirt.

proselint places the world's greatest writers and editors by your side, where they whisper suggestions on how to improve your prose. You’ll be guided by advice inspired by Bryan Garner, David Foster Wallace, Chuck Palahniuk, Steve Pinker, Mary Norris, Mark Twain, Elmore Leonard, George Orwell, Matthew Butterick, William Strunk, Elwyn White, Philip Corbett, Ernest Gowers, and the editorial staff of the world’s finest literary magazines and newspapers, among others. Our goal is to aggregate knowledge about best practices in writing and to make that knowledge immediately accessible to all authors in the form of a linter for prose; all in a neat command-line utility that you can integrate into other tools, scripts, and workflows.

Installation

To get this up and running, install it using pip:

pip install proselint

Fedora

sudo dnf install proselint

Debian

sudo apt install python3-proselint

Ubuntu

sudo add-apt-repository universe
sudo apt install python3-proselint

Plugins for other software

proselint is available on:

• A demo editor
• Sublime Text
• Atom Editor (thanks to Clay Miller).
• Emacs via Flycheck or via Flymake
• Vim via ALE or Syntastic (thanks to @lcd047, @Carreau, and Daniel M. Capella)
• Neovim via null-ls (null-ls has diagnostics and code actions for proselint)
• Phabricator's arc CLI (thanks to Jeff Verkoeyen)
• Danger (thanks to David Grandinetti and Orta Therox)
• Visual Studio Code (thanks to Patryk Peszko)
• coala (thanks to the coala Development Group)
• IntelliJ (by Victor Kropp)
• pre-commit (by Andy Airey)
• Statick
• MegaLinter

Usage

Suppose you have a document text.md with the following text:

John is very unique.

You can run proselint over the document using the command line:

proselint text.md

This prints a list of suggestions to stdout, one per line. Each suggestion has the form:

text.md: