Expose some parsing components

Author: trumank

uesave/src/context.rs

@@ -82,7 +82,7 @@ impl Scope {
 }
 
 #[derive(Debug)]
-pub(crate) struct SaveGameArchive<S> {
+pub struct SaveGameArchive<S> {
     pub(crate) stream: S,
     pub(crate) version: Option<Header>,
     pub(crate) types: Rc<Types>,
@@ -111,27 +111,33 @@ impl<W: Write + Seek> Write for SaveGameArchive<W> {
 }
 
 impl<S> SaveGameArchive<S> {
-    pub(crate) fn run<F, T>(stream: S, f: F) -> T
-    where
-        F: FnOnce(&mut SaveGameArchive<S>) -> T,
-    {
-        f(&mut SaveGameArchive {
+    /// Construct a new archive around `stream`. The version (Header) must be set
+    /// via [`set_version`](Self::set_version) before reading any property data,
+    /// since property serialization depends on engine/package versions.
+    pub fn new(stream: S) -> Self {
+        SaveGameArchive {
             stream,
             version: None,
             types: Rc::new(Types::new()),
             scope: Scope::root(),
             log: false,
             error_to_raw: false,
             schemas: Rc::new(RefCell::new(PropertySchemas::new())),
-        })
+        }
+    }
+    pub(crate) fn run<F, T>(stream: S, f: F) -> T
+    where
+        F: FnOnce(&mut SaveGameArchive<S>) -> T,
+    {
+        f(&mut SaveGameArchive::new(stream))
     }
     fn path(&self) -> String {
         self.scope.path()
     }
     fn get_type(&self) -> Option<&StructType> {
         self.types.types.get(&self.path())
     }
-    pub(crate) fn set_version(&mut self, version: Header) {
+    pub fn set_version(&mut self, version: Header) {
         self.version = Some(version);
     }
     pub(crate) fn version(&self) -> &Header {

uesave/src/lib.rs

@@ -36,11 +36,10 @@ mod serialization;
 mod tests;
 
 pub use archive::{ArchiveReader, ArchiveType, ArchiveWriter, SaveGameArchiveType};
-pub use context::{PropertySchemas, Scope, Types};
+pub use context::{PropertySchemas, SaveGameArchive, Scope, Types};
 pub use error::{Error, ParseError};
 
 use byteorder::{ReadBytesExt, WriteBytesExt, LE};
-use context::SaveGameArchive;
 use std::{
     borrow::Cow,
     cell::RefCell,
@@ -4473,8 +4472,8 @@ impl CustomFormatData {
 
 #[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
 pub struct PackageVersion {
-    ue4: u32,
-    ue5: Option<u32>,
+    pub ue4: u32,
+    pub ue5: Option<u32>,
 }
 
 pub trait VersionInfo {