use ress::{ManualScanner, prelude::*};

fn main() {
    let mut s = ManualScanner::new("let x = /[a-z]+/g");
    while let Some(Ok(item)) = s.next_token() {
        if item.token.matches_punct(Punct::ForwardSlash)
        || item.token.matches_punct(Punct::ForwardSlashEqual) {
            // it could be a 1 or 2 length prefix
            let regex = s.next_regex(1).unwrap().unwrap();
            println!("{:?}", regex);
        } else {
            println!("{:?}", item);
        }
    }
}

ES 标记

• 布尔文字
• 文件结束
• 标识符
• 关键字
• 空文字
• 数值文字
• 标点符号
• 字符串文字
• 正则表达式文字
• 模板字符串
• 注释

请注意，关键字在JavaScript中从ES3到ES2019之间有很多变化，所以在ES2019环境中可能会发现一些在ES3环境中不存在的解析为关键字的项目，这应该在更高层次上处理。一个很好的例子是yield，它有时是关键字，有时是标识符，这个包总是将其解析为关键字。截至本README的编写，ress支持所有第二阶段和第三阶段ECMAScript提议中的标记，除了#!注释和数字分隔符。

对于每个标记情况，都有一个结构或枚举来提供额外的信息，除了NullLiteral和EoF，这两个应该很容易理解。更复杂的项目实现了ToString，它应该能将您带回到该标记的原始JavaScript文本。此外，Token枚举还提供了一些辅助函数，用于构建该图片而无需从枚举中拉取内部数据。以Punct情况为例，辅助函数看起来像这样。

fn is_punct(&self) -> bool;
fn matches_punct(&self, p: Punct) -> bool;
fn matches_punct_str(&self, s: &str) -> bool;

每个情况都有类似的一组函数。

类似于所有Iterators，Scanner有一个next方法，它还有一个look_ahead方法，允许您在不前进的情况下解析下一个值。使用这个方法可以是一个方便的方式来获取下一个标记，而无需执行可变借用，但是您将承担解析该标记两次的成本。所有Iterators都可以通过一个peek方法转换成一个Peekable迭代器，这允许您只支付一次成本就向前看，但是peek执行可变借用，这意味着它需要在与next调用不同的作用域中。

// look_ahead
let js = "function() { return; }";
let mut s = Scanner::new(js);
let current = s.next();
let next = s.look_ahead();
let new_current = s.next();
assert_eq!(next, new_current);
// peekable (fails to compile)
let p = Scanner::new(js).peekable();
let current = s.next(); // <-- first mutable borrow
let next = p.peek(); // <-- second mutable borrow

对于更复杂的向前看场景，Scanner提供了get_state和set_state方法。这些方法允许您捕获当前位置和任何上下文的快照，然后稍后重置到该位置和上下文。

let js = "function() {
    return 0;
};";
let mut s = Scanner::new(js);
let start = s.get_state();
assert_eq!(s.next().unwrap().unwrap().token, Token::Keyword(Keyword::Function));
assert_eq!(s.next().unwrap().unwrap().token, Token::Punct(Punct::OpenParen));
assert_eq!(s.next().unwrap().unwrap().token, Token::Punct(Punct::CloseParen));
s.set_state(start);
assert_eq!(s.next().unwrap().unwrap().token, Token::Keyword(Keyword::Function));

为什么？

编写新的JavaScript开发工具不是很好吗？clear-comments示例证明了您如何使用这个crate来完成这项工作。这个示例将接受一个JavaScript文件，并输出一个带有所有注释都已被删除的版本。下面是如何看到它在行动的示例（假设在项目根目录中有一个名为in.js的文件）。

cargo run --example clear-comments -- ./in.js ./out.js

性能

以下统计数据是在运行cargo +nightly bench在MBP（2.9 GHz i9-8850H & 16bg RAM）上得到的。

如果您对性能感兴趣，而无需等待cargo bench完成，您可以运行以下命令。

cargo run --example major_libs

贡献

查看contributing.md