Skip to content

Latest commit

 

History

History
60 lines (41 loc) · 1.91 KB

README.md

File metadata and controls

60 lines (41 loc) · 1.91 KB

sass-lookup

CI npm version npm downloads

Get the file associated with a Sass import

This module replaces the Sass compiler's lookup algorithm for resolving a partial's path.

  • Handles underscored/non-underscored partials, partials with filenames, partials within subdirectories, partials with the .scss in the name, all of it.

Originally built for Dependents

Usage

const sassLookup = require('sass-lookup');

sassLookup({
  dependency: 'foo',
  filename: 'path/to/filename',
  directory: 'path/to/directory'
})
  • dependency: The partial's name
    • If your sass file had @import "foo";, then "foo" would be the dependency name
  • filename: The file importing the dependency
  • directory: The location(s) of all sass files
    • A list of multiple directories is also supported for this argument.

Example:

const sassLookup = require('sass-lookup');

sassLookup({
  dependency: 'variables',
  filename: 'app/styles/styles.scss',
  directory: 'app/styles'
}); // yields app/styles/variables.scss
  • This assumes that the file app/styles/styles.scss has @import "variables"; and that all of the other sass files are located within app/styles.
  • Would yield app/styles/_variables.scss if the partial had an underscored filename.

CLI

Assumes a global install of sass-lookup with npm install -g sass-lookup

sass-lookup [options] path/to/file

Run sass-lookup --help to see all the options.

License

MIT