SabreTools.IO 1.9.0

SabreTools.IO

This library compries of I/O functionality used by other SabreTools projects.

Find the link to the Nuget package here.

Namespaces

Below are a list of the included namespaces and their overall utility.

SabreTools.IO

Generic helper classes that involve custom functionality and utility.

SabreTools.IO.Compression

Various compression implementations that are used across multiple projects. Most of the implementations are be ports of existing C and C++ code.

Supported Compressions

Note: If something is marked with a * it means that it need testing.

External Libraries

SabreTools.IO.Encryption

Various encryption implementations that are used across multiple projects. Most of the implementations are be ports of existing C and C++ code.

Supported Encryption Schemes

SabreTools.IO.Extensions

Extensions for BinaryReader, byte[], and Stream to help with reading and writing various data types. Some data types are locked behind .NET version support.

This namespace also contains other various extensions that help with common functionality and safe access.

SabreTools.IO.Interfaces

Common interfaces used mainly internal to the library.

SabreTools.IO.Logging

Logic for a logging system, including writing to console and textfile outputs. There are 4 possible log levels for logging statements to be invoked with. There is also a stopwatch implementation included for logging statements with automatic timespan tracking.

SabreTools.IO.Matching

Classes designed to make matching contents and paths easier. These classes allow for both grouped and single matching as well as post-processing of matched information.

SabreTools.IO.Readers and SabreTools.IO.Writers

Reading and writing support for the following file types:

• ClrMamePro-derived Metadata files
• Standard and non-standard INI files
• Separated-Value files (e.g. CSV, SSV, TSV)

For a generic INI implementation, see SabreTools.IO.IniFile.

SabreTools.IO.Streams

Custom Stream implementations that are required for specialized use:

• BufferedStream: A format that is not a true stream implementation used for buffered, single-byte reads
• ReadOnlyBitStream: A readonly stream implementation allowing bitwise reading
• ReadOnlyCompositeStream: A readonly stream implementation that wraps multiple source streams in a set order
• ViewStream: A readonly stream implementation representing a view into source data

SabreTools.IO.Transform

File and stream implementations of common data transformations:

• Combine using either ordered concatenation or interleaving
• Split by even/odd chunks or based on block size
• Convert data either by bit-swapping, byte-swapping, word-swapping, or word/byte-swapping

SabreTools.Numerics

Custom numeric types and related functionality.

Supported Numeric Types

Both-endian or bi-endian numbers are represented by a little-endian value followed by a big-endian value, where both values are the same number.

SabreTools.Text.Compare

Classes focused on string comparison by natural sorting. For example, "5" would be sorted before "100".

Releases

For the most recent stable build, download the latest release here: Releases Page

For the latest WIP build here: Rolling Release