9.0.3 • Published 5 months ago

@envsa/prettier-config v9.0.3

Weekly downloads
-
License
MIT
Repository
github
Last release
5 months ago

@envsa/prettier-config

NPM Package @envsa/prettier-config License: MIT

Prettier configuration for @envsa/shared-config.

Overview

It's a shared Prettier config, plus a command-line tool envsa-prettier to perform Prettier-related project initialization, linting, and fixing.

!IMPORTANT

You can use this package on its own, but it's recommended to use @envsa/shared-config instead for a single-dependency and single-package approach to linting and fixing your project.

This package is included as a dependency in @envsa/shared-config, which also automatically invokes the command line functionality in this package via its envsa command

Setup

To use just this Prettier config in isolation:

  1. Install the .npmrc in your project root. This is required for correct PNPM behavior:

    pnpm dlx @envsa/repo-config init
  2. Add the package:

    pnpm add -D @envsa/prettier-config
  3. Add the starter prettier.config.js and .prettierignore files to your project root, and add any customizations you'd like:

    pnpm exec envsa-prettier init

Usage

The Prettier binary should be picked up automatically by VS Code plugins.

You can call it directly, or use the script bundled with the config.

Integrate with your package.json scripts as you see fit, for example:

{
  "scripts": {
    "lint": "envsa-prettier lint",
    "fix": "envsa-prettier fix"
  }
}

You might need to pass certain plugins in explicitly if you're calling prettier directly. The envsa-prettier fix and envsa-prettier lint scripts take care of this for you.

Configuration

To create a prettier.config.js in your project root:

pnpm exec envsa-prettier init

(Note that this will delete the prettier property in your package.json!)

Or

To create a prettier property in package.json:

pnpm exec envsa-prettier init --location package

(Note that this will delete the prettier.config.js file in your project root!)

CLI

Command: envsa-prettier

Envsa's Prettier shared configuration tools.

This section lists top-level commands for envsa-prettier.

Usage:

envsa-prettier <command>
CommandArgumentDescription
initInitialize by copying starter config files to your project root or to your package.json file.
lint[files..]Check that files are formatted according to your Prettier configuration. Matches files below the current working directory by default.
fix[files..]Format files according to your Prettier configuration. Matches files below the current working directory by default.
print-configPrint the effective Prettier configuration. Package-scoped.. Searches up to the root of a monorepo if necessary..
OptionDescriptionType
--help-hShow helpboolean
--version-vShow version numberboolean

See the sections below for more information on each subcommand.

Subcommand: envsa-prettier init

Initialize by copying starter config files to your project root or to your package.json file.

Usage:

envsa-prettier init
OptionDescriptionTypeDefault
--locationTK"file" "package""file"
--help-hShow helpboolean
--version-vShow version numberboolean

Subcommand: envsa-prettier lint

Check that files are formatted according to your Prettier configuration. Matches files below the current working directory by default.

Usage:

envsa-prettier lint [files..]
Positional ArgumentDescriptionTypeDefault
filesFiles or glob pattern to lint.array"."
OptionDescriptionType
--help-hShow helpboolean
--version-vShow version numberboolean

Subcommand: envsa-prettier fix

Format files according to your Prettier configuration. Matches files below the current working directory by default.

Usage:

envsa-prettier fix [files..]
Positional ArgumentDescriptionTypeDefault
filesFiles or glob pattern to fix.array"."
OptionDescriptionType
--help-hShow helpboolean
--version-vShow version numberboolean

Subcommand: envsa-prettier print-config

Print the effective Prettier configuration. Package-scoped.. Searches up to the root of a monorepo if necessary..

Usage:

envsa-prettier print-config
OptionDescriptionType
--help-hShow helpboolean
--version-vShow version numberboolean

Credits

Eric Mika is the author of the original @kitschpatrol/shared-config project on which this is based.

License

MIT © Liam Rella