#streaming-parser #parser #streaming #nom #async #parser-combinator

nom-bufreader-rp

nom 解析器的 BufReader 适配器

1 个不稳定版本

0.2.0 2023年5月24日

#237 in 解析工具


rustyproxy-srv 中使用

GPL-3.0-only

40KB
584

nom-bufreader,nom周围的BufReader适配器

*/!\正在进行中,如果你将其用于生产,请修复它/!*

使用此crate,您可以使用BufReader的替代方案构建nom解析器,同步或异步。由于不兼容的缓冲策略,std::io::BufReaderfutures::io::BufReader 不能直接使用。此crate提供了兼容的分支,位于 bufreaderasync_bufreader 模块中。

它将为您隐藏nom流解析器的Incomplete处理,自动重试和填充缓冲区。

示例

同步

use nom_bufreader::bufreader::BufReader;
use nom_bufreader::{Error, Parse};
use std::{net::TcpListener, str::from_utf8};

fn main() -> Result<(), Error<()>> {
    let listener = TcpListener::bind("127.0.0.1:8080")?;
    let mut i = BufReader::new(listener.incoming().next().unwrap()?);

    // method, space and path are nom parsers
    let m = i.parse(method)?;
    let _ = i.parse(space)?;
    let p = i.parse(path)?;
    println!("got method {}, path {}", m, p);
    Ok(())
}

异步

tokio

use nom_bufreader::async_bufreader::BufReader;
use nom_bufreader::{AsyncParse, Error};
use std::str::from_utf8;
use tokio_util::compat::TokioAsyncReadCompatExt;
use tokio::net::TcpListener;

#[tokio::main]
async fn main() -> Result<(), Error<()>> {
    let listener = TcpListener::bind("127.0.0.1:8080").await?;
    let mut i = BufReader::new(listener.accept().await?.0.compat());

    let m = i.parse(method).await?;
    let _ = i.parse(space).await?;
    let p = i.parse(path).await?;
    println!("got method {}, path {}", m, p);
    Ok(())
}

async-std

use nom_bufreader::async_bufreader::BufReader;
use nom_bufreader::{AsyncParse, Error};
use std::str::from_utf8;
use async_std::net::TcpListener;

#[async_std::main]
async fn main() -> Result<(), Error<()>> {
    let listener = TcpListener::bind("127.0.0.1:8080").await?;
    let mut i = BufReader::new(listener.accept().await?.0);

    let m = i.parse(method).await?;
    let _ = i.parse(space).await?;
    let p = i.parse(path).await?;
    println!("got method {}, path {}", m, p);
    Ok(())
}

依赖项

~0.9–1.3MB
~25K SLoC