@svg-toolkit/svg-format

svg-format

Structural formatter for SVG documents.

npm install -g svg-format                 # unscoped alias
npm install -g @svg-toolkit/svg-format    # canonical package
svg-format icon.svg
npx svg-format icon.svg

@svg-toolkit/svg-format is the canonical package; unscoped svg-format is a thin alias that depends on it. Either install gives you the same bin. Or grab the whole toolkit at once with @kjanat/svg-toolkit.

The package resolves a prebuilt native binary for your platform via optionalDependencies — no postinstall step, no network access at runtime.

Formatting behavior and options: https://github.com/kjanat/svg#readme

API

use svg_format::{
    format,
    format_with_options,
    AttributeLayout,
    AttributeSort,
    FormatOptions,
    QuoteStyle,
    WrappedAttributeIndent,
};

let pretty = format(source);

let pretty_custom = format_with_options(
    source,
    FormatOptions {
        indent_width: 4,
        insert_spaces: false,
        max_inline_tag_width: 100,
        attribute_sort: AttributeSort::Canonical,
        attribute_layout: AttributeLayout::Auto,
        attributes_per_line: 1,
        space_before_self_close: true,
        quote_style: QuoteStyle::Preserve,
        wrapped_attribute_indent: WrappedAttributeIndent::OneLevel,
    },
);

CLI

svg-format is also available as a CLI binary from the same crate (cargo install svg-format, or npm install --global svg-format / @svg-toolkit/svg-format for the prebuilt binary).

# Format from stdin to stdout
cat icon.svg | svg-format --stdin

# Check whether a file would change
svg-format --check icon.svg

# Format file in place
svg-format --in-place icon.svg