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.

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, in all declarations. (Default is to put a space before function parenthesis for anonymous functions only.)
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). (Default is after only.)
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 ternary 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 (not recommended with default `arrowParens: "always" setting).
break before else	false	--break-before-else	breakBeforeElse: <bool>	Always add a line break before else.
Formatting of import statements	auto	see ./docs/options.md	see ./docs/options.md	Formatting of import statements, may be oneline to avoid conflict with VSCode "Organize Imports" feature.

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)
• --trailing-comma none (trailingComma: "none")

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 archive correct formatting according to standard js.

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

other recommended settings

• --arrow-parens avoid (arrowParens: "avoid"), especially in combination with --paren-spacing (parenSpacing: true).

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.14.2

• Add tslib to avoid a peerDependencies warning
• Update some dependencies
  • @babel/code-frame -> 7.12.11
  • @babel/parser -> 7.12.0
  • camelcase -> 6.2.0
  • lodash -> 4.17.20
  • unified -> 9.2.0

compare prettierx-0.14.0...prettierx-0.14.2

NOTE: prettierx release 0.14.1 was inadvertently skipped in package.json.