Grimoire CSS Transmute (gcsst)

A tool for seamlessly transforming standard CSS into Grimoire CSS spells.
gcsst is available both as a CLI tool and as a Rust library crate. It helps you convert your CSS files or inline CSS content into a structured JSON format suitable for use with the Grimoire CSS system.

Features

• Batch conversion: Process multiple CSS files or patterns at once.
• Inline content: Convert CSS provided as a string.
• Flexible output: Save results to a file or print to stdout.
• Oneliner support: Optionally include a one-line representation for each class.

Installation

You need Rust installed.

cargo install --path .

Usage

gcsst [OPTIONS] [INPUT]

Options

• -p, --paths Process comma-separated list of CSS file paths or glob patterns
• -c, --content Process CSS content provided as a string
• -o, --output Specify output file (default: ./grimoire/transmuted.json)
• -l, --with-oneliner Include oneliner property in output (default: disabled)
• -h, --help Display help message

Examples

Convert multiple CSS files:

gcsst -p styles.css,components.css

Convert all CSS files in a directory:

gcsst -p "src/**/*.css"

Convert inline CSS content:

gcsst -c '.button { color: red; }' -l

Custom output file:

gcsst -p '*.css' -o custom_output.json --with-oneliner

Output

The output is a JSON file (or stdout) containing an array of objects, each representing a CSS class and its corresponding Grimoire CSS spells. Example:

{
  "scrolls": [
    {
      "name": "button",
      "spells": ["color=red"],
      "oneliner": ".button { color: red; }"
    }
  ]
}

Library and CLI Usage

You can use gcsst both as a command-line tool and as a Rust library crate.

As a library

Add gcsst_lib to your Cargo.toml dependencies and use it in your Rust code:

use gcsst_lib::transmute_from_content;
let (duration, json) = transmute_from_content(".foo { color: blue; }", false).unwrap();
println!("{}", json);

License

MIT

Links

• Grimoire CSS
• Documentation
• Repository