https://github.com/dependents/node-detective-postcss

Find the dependencies of a CSS file (PostCSS dialect)
https://github.com/dependents/node-detective-postcss

ast css dependencies dependency-graph detective nodejs parser postcss

Last synced: 6 days ago
JSON representation

Find the dependencies of a CSS file (PostCSS dialect)

• Host: GitHub
• URL: https://github.com/dependents/node-detective-postcss
• Owner: dependents
• License: mit
• Created: 2018-04-12T13:07:48.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-10-01T08:40:57.000Z (about 1 month ago)
• Last Synced: 2024-10-31T18:21:12.697Z (14 days ago)
• Topics: ast, css, dependencies, dependency-graph, detective, nodejs, parser, postcss
• Language: TypeScript
• Homepage:
• Size: 1.06 MB
• Stars: 5
• Watchers: 3
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# node-detective-postcss

[![build](https://img.shields.io/github/actions/workflow/status/dependents/node-detective-postcss/node.js.yml?branch=main&label=CI&logo=github)](https://github.com/dependents/node-detective-postcss/actions/workflows/node.js.yml?query=branch%3Amain)

[![npm version](https://img.shields.io/npm/v/detective-postcss?logo=npm&logoColor=fff)](https://www.npmjs.com/package/detective-postcss) [![npm downloads](https://img.shields.io/npm/dm/detective-postcss)](https://www.npmjs.com/package/detective-postcss)

> Find the dependencies of a CSS file (PostCSS dialect)

Supports `@import` and [`@value ... from`](https://github.com/css-modules/postcss-icss-values).

```sh

npm install postcss detective-postcss

```

It's the CSS (PostCSS dialect) counterpart to [detective](https://github.com/browserify/detective), [detective-amd](https://github.com/dependents/node-detective-amd), [detective-es6](https://github.com/dependents/node-detective-es6), [detective-sass](https://github.com/dependents/node-detective-sass), [detective-scss](https://github.com/dependents/node-detective-scss).

- The AST is generated using [postcss](https://github.com/postcss/postcss) and [postcss-values-parser](https://github.com/shellscape/postcss-values-parser).

### Usage

```js

const fs = require('fs');

const detective = require('detective-postcss');

const content = fs.readFileSync('styles.css', 'utf8');

// list of imported file names (ex: 'bla.css', 'foo.css', etc.)

const dependencies = detective(content);

// or to also detect any url() references to images, fonts, etc.

const allDependencies = detective(content, { url: true });

```

### License

[MIT](LICENSE)

## Releasing

- Bump the version of `package.json` to a meaningful version for the changes since the last release (we follow semver).

- To do a dry-run of the release and what would go out in the package you can manually execute the [npm-publish](https://github.com/dependents/node-detective-postcss/actions/workflows/npm-publish.yml) workflow on the `main` branch. It will do a dry-run publish (not actually publish the new version).

- Draft a new release in the github project - please use a tag named `vX.X.X` (where `X.X.X` is the new to-be-releases semver of the package - please add as many detail as possible to the release description.

- Once you're ready, `Publish` the release. Publishing will trigger the [npm-publish](https://github.com/dependents/node-detective-postcss/actions/workflows/npm-publish.yml) workflow on the tag and do the actual publish to npm.