sphinx_inv 0.4.0

A rust library to parse Sphinx `objects.inv` files
Documentation
use std::io::{BufWriter, Write};

use flate2::{Compression, write::ZlibEncoder};

use crate::{InventoryHeader, SphinxReference};

#[derive(Debug, PartialEq, Clone)]
pub enum WriteFormat {
    Plain,
    Zlib,
}

pub struct SphinxInventoryWriter {
    header: InventoryHeader,
    buffer: Vec<SphinxReference>,
}

impl SphinxInventoryWriter {
    pub fn from_header(header: InventoryHeader, capacity: usize) -> Self {
        Self {
            header,
            buffer: Vec::with_capacity(capacity),
        }
    }

    pub fn add_reference(&mut self, reference: SphinxReference) {
        self.buffer.push(reference);
    }

    pub fn finalize<W: Write>(
        mut self,
        writer: &mut W,
        format: &WriteFormat,
        minimize: bool,
    ) -> Result<(), std::io::Error> {
        let mut writer = BufWriter::new(writer);
        self.header.compression_method_description = match format {
            WriteFormat::Plain => "plain-text".to_string(),
            WriteFormat::Zlib => "zlib".to_string(),
        };
        writer.write_all(self.header.to_string().as_bytes())?;
        match format {
            WriteFormat::Plain => {
                if minimize {
                    for reference in self.buffer {
                        writeln!(writer, "{}", reference.fmt_minified())?;
                    }
                } else {
                    for reference in self.buffer {
                        writeln!(writer, "{}", reference.fmt_expanded())?;
                    }
                }
                Ok(())
            }
            WriteFormat::Zlib => {
                let mut zlib_writer = ZlibEncoder::new(writer, Compression::fast());
                if minimize {
                    for reference in self.buffer {
                        writeln!(zlib_writer, "{}", reference.fmt_minified())?;
                    }
                } else {
                    for reference in self.buffer {
                        writeln!(zlib_writer, "{}", reference.fmt_expanded())?;
                    }
                }
                zlib_writer.finish()?;
                Ok(())
            }
        }
    }
}

#[cfg(test)]
mod test {
    #![allow(clippy::unwrap_used)]
    use pretty_assertions::assert_eq;
    use std::io::Cursor;

    use crate::{
        InventoryHeader, SphinxInventoryReader, SphinxReference, SphinxType,
        error::SphinxInvError,
        priority::SphinxPriority,
        roles::PyRole,
        writers::{SphinxInventoryWriter, WriteFormat},
    };

    #[test]
    fn write_simple_plain_text_inventory_minified() -> Result<(), SphinxInvError> {
        let mut write_buffer = Vec::new();
        let expected = String::from(
            "# Sphinx inventory version 2
# Project: foo
# Version: 0.24.24
# The remainder of this file is compressed using plain-text.
str.join py:method 1 library/stdtypes.html#$ -
str.lower py:method 1 library/stdtypes.html#$ -
",
        );
        let header = InventoryHeader {
            project_name: "foo".to_string(),
            project_version: "0.24.24".to_string(),
            inventory_version: 2,
            compression_method_description: "zlib".to_string(),
        };

        let str_lower_ref = SphinxReference::new(
            "str.lower",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#$",
            "-",
        );

        let str_join_ref = SphinxReference::new(
            "str.join",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#$",
            "-",
        );

        let mut writer = SphinxInventoryWriter::from_header(header, 2);

        writer.add_reference(str_join_ref);
        writer.add_reference(str_lower_ref);

        let mut cursor = Cursor::new(&mut write_buffer);

        writer.finalize(&mut cursor, &WriteFormat::Plain, true)?;

        assert_eq!(String::from_utf8(write_buffer).unwrap(), expected);
        Ok(())
    }
    #[test]
    fn write_simple_plain_text_inventory_expanded() -> Result<(), SphinxInvError> {
        let mut write_buffer = Vec::new();
        let expected = String::from(
            "# Sphinx inventory version 2
# Project: foo
# Version: 0.24.24
# The remainder of this file is compressed using plain-text.
str.join py:method 1 library/stdtypes.html#str.join str.join
str.lower py:method 1 library/stdtypes.html#str.lower str.lower
",
        );
        let header = InventoryHeader {
            project_name: "foo".to_string(),
            project_version: "0.24.24".to_string(),
            inventory_version: 2,
            compression_method_description: "zlib".to_string(),
        };

        let str_lower_ref = SphinxReference::new(
            "str.lower",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#str.lower",
            "str.lower",
        );

        let str_join_ref = SphinxReference::new(
            "str.join",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#str.join",
            "-",
        );

        let mut writer = SphinxInventoryWriter::from_header(header, 2);

        writer.add_reference(str_join_ref);
        writer.add_reference(str_lower_ref);

        let mut cursor = Cursor::new(&mut write_buffer);

        writer.finalize(&mut cursor, &WriteFormat::Plain, false)?;

        assert_eq!(String::from_utf8(write_buffer).unwrap(), expected);
        Ok(())
    }

    #[test]
    fn write_read_round_trip() -> Result<(), SphinxInvError> {
        let buffer = Vec::new();
        let mut cursor = Cursor::new(buffer);
        let header = InventoryHeader {
            project_name: "foo".to_string(),
            project_version: "0.24.24".to_string(),
            inventory_version: 2,
            compression_method_description: "plain-text".to_string(),
        };

        let str_lower_ref = SphinxReference::new(
            "str.lower",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#str.lower",
            "str.lower",
        );

        let str_join_ref = SphinxReference::new(
            "str.join",
            SphinxType::Python(PyRole::Method),
            SphinxPriority::Standard,
            "library/stdtypes.html#str.join",
            "-",
        );
        let mut writer = SphinxInventoryWriter::from_header(header.clone(), 2);

        writer.add_reference(str_join_ref.clone());
        writer.add_reference(str_lower_ref.clone());
        writer.finalize(&mut cursor, &WriteFormat::Plain, true)?;

        cursor.set_position(0);

        let mut reader = SphinxInventoryReader::from_reader(cursor)?;

        assert_eq!(reader.header(), &header);

        assert_eq!(reader.next().unwrap()?, str_join_ref);

        assert_eq!(reader.next().unwrap()?, str_lower_ref);

        Ok(())
    }
}