costamateus/bracketsmith

A lightweight PHP tool that polishes array formatting — keeping your brackets neat and consistent.

v0.1.2 2025-11-07 12:37 UTC

Requires

• php: >=8.1

MIT

• Mateus Costa

README

BracketSmith is a lightweight PHP tool for standardizing array spacing — keeping your square brackets [ ] clean and consistent.

🚀 Installations

composer require costamateus/bracketsmith

Or for global use:

composer global require costamateus/bracketsmith

💡 CLI usage

vendor/bin/bracketsmith --dry-run

Optional parameters:

• --dry-run → only checks, without altering files.
• --verbose → shows processed files.
• --help → displays help information.
• It is possible to pass specific files or directories:

  vendor/bin/bracketsmith app/Models/User.php    # Process single file
  vendor/bin/bracketsmith app/Models/            # Process directory

⚙️ Configuration

You can customize which directories and files to process by creating a bracketsmith.json file in your project root.

Example bracketsmith.json:

{
	"include": ["app/", "routes/"],
	"exclude": ["vendor/", "storage/", "node_modules/"]
}

• include: Array of directories/files to process (relative paths or patterns).
• exclude: Array of patterns to skip (substrings in file paths).

If no config file is found, default include and exclude patterns are used.

Copy bracketsmith.json.example to get started.

🧪 Tests

composer test

📄 License

MIT © Mateus Costa