docx-lite 0.2.0

Lightweight, fast DOCX text extraction library with minimal dependencies
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

use std::fs::File;
use std::io::{BufReader, Cursor};
use std::path::Path;

use crate::error::Result;
use crate::parser::DocxParser;
use crate::types::Document;

/// Extract text from a DOCX file at the given path
pub fn extract_text<P: AsRef<Path>>(path: P) -> Result<String> {
    let file = File::open(path)?;
    let reader = BufReader::new(file);
    extract_text_from_reader(reader)
}

/// Extract text from DOCX bytes
pub fn extract_text_from_bytes(bytes: &[u8]) -> Result<String> {
    let cursor = Cursor::new(bytes);
    extract_text_from_reader(cursor)
}

/// Extract text from any reader containing DOCX data
pub fn extract_text_from_reader<R: std::io::Read + std::io::Seek>(reader: R) -> Result<String> {
    let document = parse_document(reader)?;
    Ok(document.extract_text())
}

/// Parse a DOCX file and return the structured Document
pub fn parse_document<R: std::io::Read + std::io::Seek>(reader: R) -> Result<Document> {
    let parser = DocxParser::new(reader)?;
    parser.parse()
}

/// Parse a DOCX file from a path and return the structured Document
pub fn parse_document_from_path<P: AsRef<Path>>(path: P) -> Result<Document> {
    let file = File::open(path)?;
    let reader = BufReader::new(file);
    parse_document(reader)
}