sasspile 0.2.0

A pure Rust SCSS compiler — functional style, type-safe pipeline
Documentation

sasspile

Crates.io Docs.rs License CI

纯 Rust 函数式 SCSS 编译器,使用 Rust 1.97 新特性构建。

sasspile 是一个学习 Rust 的实战项目,采用纯函数式风格实现 SCSS 编译管线。通过类型状态机(Type-State Pattern)确保编译阶段类型安全,使用 Iterator + fold + 不可变数据结构实现零副作用的编译流程。

特性

  • 类型状态机管线: Source → Lexed → Parsed → Evaluated → Serialized
  • 纯函数式风格: Iterator + fold + 不可变数据
  • 零依赖: 纯 Rust 实现,无外部 C 库
  • sass-spec 兼容: 通过官方测试套件验证
  • Bootstrap 5.3.8 验证: 核心功能测试通过

快速开始

添加依赖:

[dependencies]
sasspile = "0.2"

最小示例:

use sasspile::{compile_expanded, compile_compressed};

fn main() -> Result<(), sasspile::SassError> {
    // 展开式输出
    let css = compile_expanded("a { color: red; }")?;
    println!("{}", css);
    // => "a {\n  color: red;\n}\n"

    // 压缩式输出
    let css = compile_compressed("a { color: red; }")?;
    println!("{}", css);
    // => "a{color:red;}"

    Ok(())
}

使用示例

use sasspile::compile_expanded;

let scss = r#"
$primary: #3498db;

.btn {
    background: $primary;
    color: white;

    &:hover {
        background: darken($primary, 10%);
    }

    @media (max-width: 768px) {
        width: 100%;
    }
}
"#;

let css = compile_expanded(scss)?;
println!("{}", css);

支持的功能

变量与作用域

  • 全局变量与局部变量
  • 变量插值 #{$var}

嵌套规则

  • 选择器嵌套
  • 属性嵌套(font: { size: 14px; weight: bold; })
  • 父选择器引用 &

运算

  • 数学运算(+, -, *, /, %)
  • 颜色运算
  • 字符串拼接

颜色函数

函数 说明
rgba(r, g, b, a) RGBA 颜色值
darken(color, amount) 加深颜色
lighten(color, amount) 减淡颜色
mix(color1, color2, weight) 混合颜色
invert(color) 反色
grayscale(color) 灰度化

字符串函数

  • str-length, str-index, str-slice
  • to-upper-case, to-lower-case

列表函数

  • list-length, nth, append, join

Map 函数

  • map-get, map-keys, map-values, map-merge

数学函数

  • abs, ceil, floor, round, min, max
  • percentage, sqrt, sin, cos, tan, pow

指令

  • @media 媒体查询
  • // 单行注释
  • /* */ 多行注释

选择器

  • 通用选择器 *
  • 伪类 :hover, :focus, :nth-child(n)
  • 伪元素 ::before, ::after

测试

cargo test

110+ 测试全部通过,包括:

  • 75 单元测试
  • 21 sass-spec 合规测试
  • 13 Bootstrap 5.3.8 验证测试

架构设计

sasspile 使用类型状态机模式构建编译管线:

Source { content }  ──lex()──►  Lexed { tokens }
                                  │
                                  ▼
                             Parsed { ast }
                                  │
                                  ▼
                            Evaluated { css_tree }
                                  │
                                  ▼
                           Serialized { css_string }

每个阶段通过类型转换确保:

  • 必须先解析后求值
  • 必须先求值后序列化
  • 编译错误在类型层面被阻止

许可证

MIT