prettierx

prettierx - less opinionated code formatter fork of prettier

Unofficial fork, intended to provide some additional options to help improve consistency with feross/standard and Flet/semistandard. This fork is an attempt to pick up where arijs/prettier-miscellaneous left off.

Language parsers are supported with old language parsers deprecated as if this were prettier version 1.18.0.

Minimum Node.js version supported: Node.js 8 - deprecated; Node.js 10 is recommended as described in: brodybits/prettierx#6

prettierx as a Prettier plugin

Provides the additional formatting options in a prettier plugin (or two).

Status: experimental

• brodybits/prettier-plugin-prettierx-babel
• brodybits/prettier-plugin-prettierx-typescript

Major TODO items:

• support option to use Babel parser to parse TypeScript ref: brodybits/prettierx#54
• support the additional formatting options from the command line, somehow

ref: brodybits/prettierx#8

CLI Usage

Quick CLI usage:

prettierx <options> <file(s)>

Additional prettierx options

Option	Default value	CLI Override	API Override	Description
Align object properties	false	--align-object-properties	alignObjectProperties: <bool>	Align colons in multiline object literals (not applied with any of the JSON parsers).
Space before function parentheses	false	--space-before-function-paren	spaceBeforeFunctionParen: <bool>	Put a space before function parenthesis.
Spaces around the star (*) in generator functions	false	--generator-star-spacing	generatorStarSpacing: <bool>	Add spaces around the star (*) in generator functions (before and after - from eslint).
Spaces around the star (*) in yield* expressions	false	--yield-star-spacing	yieldStarSpacing: <bool>	Add spaces around the star (*) in yield* expressions (before and after - from eslint).
Indent chains	true	--no-indent-chains	indentChains: <bool>	Print indents at the start of chained calls.
Align ternary lines	true	--no-align-ternary-lines	alignTernaryLines: <bool>	Align ternary lines in case of multiline ternery term (default behavior, which is in conflict with ESLint/StandardJS behavior). Should be disabled for consistency with ESLint/StandardJS behavior.
paren spacing	false	--paren-spacing	parenSpacing: <bool>	Print spaces between parens, WordPress style.

standard-like formatting

The following options should be used to format the code according to standard js:

• --generator-star-spacing (generatorStarSpacing: true)
• --space-before-function-paren (spaceBeforeFunctionParen: true)
• --single-quote (singleQuote: true)
• --jsx-single-quote (jsxSingleQuote: true)
• --no-semi (semi: false)
• --yield-star-spacing (yieldStarSpacing: true)
• --no-align-ternary-lines (alignTernaryLines: false)

Note that this tool does not follow any of the other standard js rules. It is recommended to use this tool together with eslint, in some form, to achive correct formatting according to standard js.

Any known conflicts with standard js will be tracked in open issues with the conflict-with-standard tag.

Input

foo(reallyLongArg(), omgSoManyParameters(), IShouldRefactorThis(), isThereSeriouslyAnotherOne());

Output

foo(
  reallyLongArg(),
  omgSoManyParameters(),
  IShouldRefactorThis(),
  isThereSeriouslyAnotherOne()
);

Integration with eslint

A couple packages by @aMarCruz (Alberto Martínez):

• eslint-plugin-prettierx
• eslint-config-standardized

---

Contributing

See CONTRIBUTING.md.

Changelog

prettierx 0.11.3

• yaml@1.8.3 explicitly in dependencies - needed for extra npm dist build test to keep working, due to an issue between @babel/parser & recent yaml@1.9.0 update
• update and fix some comments for prettierx-specific code
• remove lib entry from package files (not needed)

compare prettierx-0.11.2...dev