Expand description
§snapper
Semantic line break formatter for prose documents. Reformats text so each sentence occupies its own line, producing minimal git diffs when collaborating on papers and documentation.
The crate is published as snapper-fmt on crates.io; the binary it
installs is called snapper.
§Supported formats
- Org-mode: blocks, drawers, tables, keywords preserved
- LaTeX: preamble, math, environments, comments preserved
- Markdown: code blocks, front matter, headings preserved
- Plaintext: everything treated as prose
§Library usage
use snapper_fmt::{format_text, FormatConfig};
use snapper_fmt::format::Format;
let input = "Hello world. This is a test. Another sentence.";
let config = FormatConfig {
format: Format::Plaintext,
..Default::default()
};
let output = format_text(input, &config).unwrap();
assert_eq!(output, "Hello world.\nThis is a test.\nAnother sentence.");Modules§
- abbreviations
- cli
- code_
block - Comment-aware reflow inside a
Region::Code. - config
- diff
- files
- format
- Document format detection and representation.
- git_
diff - init
- lsp
- output
- parser
- reflow
- sdiff
- sentence
- watch
Structs§
- Format
Config - Configuration for the formatting pipeline.
Functions§
- build_
splitter - Build the appropriate sentence splitter from config.
- format_
range - Format only lines within a range (1-indexed, inclusive). Lines outside the range pass through unchanged.
- format_
text - Format text with semantic line breaks.
- format_
text_ with_ splitter - Format text using a pre-constructed splitter (avoids reloading models per file).