taped 1.5.1

A lightweight cursor for non-linear parsing of slices.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# taped


A lightweight cursor for non-linear parsing of byte slices.

[![Rust](https://github.com/aeckar/taped/actions/workflows/rust.yml/badge.svg)](https://github.com/aeckar/taped/actions/workflows/rust.yml)
[![Crates.io](https://img.shields.io/crates/v/taped.svg)](https://crates.io/crates/taped)

## Documentation


[https://docs.rs/taped](https://docs.rs/taped)

## Overview


`Tape` wraps a byte slice with a position cursor, providing methods for
scanning, backtracking, and consuming bytes without allocating.

- Optimized character and string search via [`memchr`](https://github.com/BurntSushi/memchr)
    - Controlled by `intrinsics` feature flag
- Simple lookahead and lookbehind of whitespace characters
- Indentation counting and paragraph/line awareness

Originally developed as the byte reader for [`bincake`](https://github.com/aeckar/bincake),
extracted as a standalone primitive after the same pattern appeared
across multiple projects.

## Example


```rust
use taped::Tape;

let data = b"hello world";
let mut tape = Tape::new(data);

tape.seek(|&b| b == b' '); // advance to space
let word = tape.consume(|&b| b != b' '); // consume "hello"
assert_eq!(word, b"hello");
```

## When to use this


- Writing a parser for a binary or text format
- Scanning byte sequences without regex or [`nom`](https://github.com/rust-bakery/nom)
- Anywhere you need backtracking via cheap position snapshots (`tape.clone()`)

## When not to use this


- Full parser combinator framework → use [`nom`](https://github.com/rust-bakery/nom) or [`winnow`](https://github.com/winnow-rs/winnow)
- Lexer generation → use [`logos`](https://github.com/maciejhirsz/logos)
- Async byte streams → use [`tokio::io::AsyncBufRead`](https://docs.rs/tokio/latest/tokio/io/trait.AsyncBufRead.html)