Download the PHP package peckphp/peck without Composer

Peck is a powerful CLI tool designed to identify wording or spelling mistakes in your codebase: filenames, class names, method names, property names, docs, and more. Built for speed, simplicity, and seamless integration, Peck fits naturally into your workflow, much like tools such as Pint or Pest.

Leveraging the robust capabilities of GNU Aspell, Peck inspects every corner of your codebase — ensuring your work maintains a high standard of clarity and professionalism.

Note: Peck is still under active development and is not yet ready for production use.

Installation

Requires PHP 8.3+ and GNU Aspell

Peck relies on GNU Aspell for its spell-checking functionality. Make sure GNU Aspell is installed on your system before using Peck.

Installing GNU Aspell

• If you are using Debian/Ubuntu:

• If you are using MacOS (using Homebrew):

• If you are using Windows:

  We recommend moving to the Windows Subsystem for Linux (WSL) and following the Debian/Ubuntu steps. Alternatively, if you prefer not to use WSL, you can install Aspell using Scoop, a package manager for Windows:

Installing Peck

You can require Peck using Composer with the following command:

Usage

To check your project for spelling mistakes, run:

On the very first run, Peck may detect a large number of spelling mistakes. You may use the ignore-all option to ignore all the mistakes at once:

Configuration

Peck can be configured using a peck.json file in the root of your project.

You can scaffold the peck.json file with:

Here's an example configuration:

You can also specify the path to the configuration file using the --config option:

Presets

In order to make it easier to get started with Peck, we've included a few presets that you can use to ignore common words in your project. The following presets are available:

• laravel

Command Options

The behaviour of peck can be modified with the following command options:

--init

If you don't have a peck.json file yet, you can create a blank configuration file by using the --init option.

--config

By default peck will check for a peck.json file in your project root. If one isn't available it will try to figure out the directory to check by itself.

--path

The path to check can be overwritten with the --path option. If the path is one you always need checking you can place it in your peck.json file.

--text

The --text option allows you to check a string of text for spelling mistakes. This is useful when you want to check a specific string, such as commit messages.

--ignore-all

This option will ignore all spelling mistakes in the current run. This is useful when you have a large number of mistakes and want to ignore them all at once.

CI / GitHub Actions

When running Peck on GitHub Actions, you can use the following workflow before running Peck:

Peck is an open-sourced software licensed under the MIT license.