postcss-load-options

WebJar for postcss-load-options

License	MIT
GroupId	org.webjars.npm
ArtifactId	postcss-load-options
Last Version	1.2.0
Release Date	May 8, 2017
Type	jar
Description	postcss-load-options WebJar for postcss-load-options
Project URL	http://webjars.org
Source Code Management	https://github.com/michael-ciniawsky/postcss-load-options

Download postcss-load-options

Filename	Size
postcss-load-options-1.2.0.pom
postcss-load-options-1.2.0.jar	7 KB
postcss-load-options-1.2.0-sources.jar	22 bytes
postcss-load-options-1.2.0-javadoc.jar	22 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-options/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>postcss-load-options</artifactId>
    <version>1.2.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-options/
implementation 'org.webjars.npm:postcss-load-options:1.2.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/org.webjars.npm/postcss-load-options/
implementation ("org.webjars.npm:postcss-load-options:1.2.0")

Apache Buildr

'org.webjars.npm:postcss-load-options:jar:1.2.0'

Apache Ivy

<dependency org="org.webjars.npm" name="postcss-load-options" rev="1.2.0">
  <artifact name="postcss-load-options" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='org.webjars.npm', module='postcss-load-options', version='1.2.0')
)

Scala SBT

libraryDependencies += "org.webjars.npm" % "postcss-load-options" % "1.2.0"

Leiningen

[org.webjars.npm/postcss-load-options "1.2.0"]

Dependencies

compile (2)

Group / Artifact	Type	Version
org.webjars.npm : cosmiconfig	jar	[2.1.0,3)
org.webjars.npm : object-assign	jar	[4.1.0,5)

Project Modules

There are no modules declared in this project.

Load Options

Install

npm i -D postcss-load-options

Usage

package.json

Create postcss section in your projects package.json.

App
  |– client
  |– public
  |
  |- package.json

{
  "dependencies": {
    "sugarss": "0.2.0"
  },
  "postcss": {
    "parser": "sugarss",
    "map": false,
    "from": "path/to/src/file.css",
    "to": "path/to/dest/file.css"
  }
}

.postcssrc

Create a .postcssrc file.

App
  |– client
  |– public
  |
  |- (.postcssrc|.postcssrc.json|.postcssrc.yaml)
  |- package.json

JSON

{
  "parser": "sugarss",
  "map": false,
  "from": "path/to/src/file.css",
  "to": "path/to/dest/file.css"
}

YAML

parser: sugarss
map: false
from: "/path/to/src.sss"
to: "/path/to/dest.css"

postcss.config.js or .postcssrc.js

You may need some JavaScript logic to generate your config. For this case you can use a file named postcss.config.js or .postcssrc.js.

App
  |– client
  |– public
  |
  |- (postcss.config.js|.postcssrc.js)
  |- package.json

module.exports = (ctx) => {
  return {
    parser: ctx.sugar ? 'sugarss' : false,
    map: ctx.env === 'development' ? ctx.map || false,
    from: 'path/to/src/file.css',
    to: 'path/to/dest/file.css'
  }
}

Options

parser:

'parser': 'sugarss'

syntax:

'syntax': 'postcss-scss'

stringifier:

'stringifier': 'midas'

map:

'map': 'inline'

from:

from: 'path/to/dest/file.css'

to:

to: 'path/to/dest/file.css'

Context

When using a function (postcss.config.js), it is possible to pass context to postcss-load-options, which will be evaluated before loading your options. By default ctx.env (process.env.NODE_ENV) and ctx.cwd (process.cwd()) are available.

Example

const { readFileSync } = require('fs')

const postcss = require('postcss')
const optionsrc = require('postcss-load-options')

const sss =  readFileSync('index.sss', 'utf8')

const ctx = { sugar: true,  map: 'inline' }

optionsrc(ctx).then((options) => {
  postcss()
    .process(sss, options)
    .then(({ css }) => console.log(css))
}))

Maintainers

Michael Ciniawsky

Versions

Version
1.2.0 May 8, 2017