perfectionist

WebJar for perfectionist

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

perfectionist
Last Version

Last Version

2.4.0
Release Date

Release Date

Type

Type

jar
Description

Description

perfectionist
WebJar for perfectionist
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/ben-eb/perfectionist

Download perfectionist

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/perfectionist/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>perfectionist</artifactId>
    <version>2.4.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/perfectionist/
implementation 'org.webjars.npm:perfectionist:2.4.0'
// https://jarcasting.com/artifacts/org.webjars.npm/perfectionist/
implementation ("org.webjars.npm:perfectionist:2.4.0")
'org.webjars.npm:perfectionist:jar:2.4.0'
<dependency org="org.webjars.npm" name="perfectionist" rev="2.4.0">
  <artifact name="perfectionist" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='perfectionist', version='2.4.0')
)
libraryDependencies += "org.webjars.npm" % "perfectionist" % "2.4.0"
[org.webjars.npm/perfectionist "2.4.0"]

Dependencies

compile (10)

Group / Artifact Type Version
org.webjars.npm : write-file-stdout jar [0.0.2]
org.webjars.npm : postcss-value-parser jar [3.3.0,4)
org.webjars.npm : minimist jar [1.2.0,2)
org.webjars.npm : defined jar [1.0.0,2)
org.webjars.npm : string.prototype.repeat jar [0.2.0,0.3)
org.webjars.npm : read-file-stdin jar [0.2.0,0.3)
org.webjars.npm : vendors jar [1.0.0,2)
org.webjars.npm : comment-regex jar [1.0.0,2)
org.webjars.npm : postcss jar [5.0.8,6)
org.webjars.npm : postcss-scss jar [0.3.0,0.4)

Project Modules

There are no modules declared in this project.

perfectionist Build Status NPM version Dependency Status

Beautify CSS files.

Install

With npm do:

npm install perfectionist --save

Example

Input

h1   {
         color   :  red }

Expanded output

h1 {
    color: red;
}

Compact output

h1 { color: red; }

Compressed output

h1{color:red}

API

perfectionist.process(css, [options])

css

Type: string Required option.

Pass a CSS string to beautify it.

options

cascade

Type: boolean Default: true

Set this to false to disable visual cascading of vendor prefixed properties. Note that this transform only applies to the expanded format.

/* true */
h1 {
    -webkit-border-radius: 12px;
            border-radius: 12px;
}

/* false */
h1 {
    -webkit-border-radius: 12px;
    border-radius: 12px;
}
colorCase

Type: string Default: lower

Set either lower or upper to transform hexadecimal colors to the according case.

/* upper */
p { color: #C8C8C8 }

/* lower */
p { color: #c8c8c8 }
colorShorthand

Type: boolean Default: true

Set this to true to shorten hexadecimal colors.

/* true */
p { color: #fff }

/* false */
p { color: #ffffff }
format

Type: string Default: expanded

Pass either expanded, compact or compressed. Note that the compressed format only facilitates simple whitespace compression around selectors & declarations. For more powerful compression, see cssnano.

indentChar

Type: string Default: (space)

Specify \t here instead if you would like to use tabs for indentation.

indentSize

Type: number Default: 4

This number will be used as a basis for all indent levels, using the expanded format.

trimLeadingZero

Type: boolean Default: true

Set this to true to trim leading zero for fractional numbers less than 1.

/* true */
p { line-height: .8 }

/* false */
p { line-height: 0.8 }
trimTrailingZeros

Type: boolean Default: true

Set this to true to traim trailing zeros in numbers.

/* true */
div { top: 50px }

/* false */
div { top: 50.000px }
maxAtRuleLength

Type: boolean|number Default: 80

If set to a positive integer, set a maximum width for at-rule parameters; if they exceed this, they will be split up over multiple lines. If false, this behaviour will not be performed. Note that this transform only applies to the expanded format.

maxSelectorLength

Type: boolean|number Default: 80

If set to a positive integer, set a maximum width for a selector string; if it exceeds this, it will be split up over multiple lines. If false, this behaviour will not be performed. Note that this transform is excluded from the compressed format.

maxValueLength

Type: boolean|number Default: 80

If set to a positive integer, set a maximum width for a property value; if it exceeds this, it will be split up over multiple lines. If false, this behaviour will not be performed. Note that this transform only applies to the expanded format.

sourcemap

Type: boolean Default: false

Generate a sourcemap with the transformed CSS.

syntax

Type: string

Specify scss if you would like to also format SCSS-style single line comments. This loads the postcss-scss plugin.

zeroLengthNoUnit

Type: boolean Default: true

Set this to true to trim units after zero length.

/* true */
div { padding: 0 }

/* false */
div { padding: 0px }

postcss([ perfectionist(opts) ])

perfectionist can also be consumed as a PostCSS plugin. See the documentation for examples for your environment.

CLI

perfectionist also ships with a CLI app. To see the available options, just run:

$ perfectionist --help

Usage

See the PostCSS documentation for examples for your environment.

Integrations

Contributing

Pull requests are welcome. If you add functionality, then please add unit tests to cover it.

License

MIT © Ben Briggs

Versions

Version
2.4.0