ra2mix 0.0.8

ra2mix is a python library for working with Red Alert 2 / Yuri's Revenge *.mix files

ra2mix

A python library for working with Red Alert 2 / Yuri's Revenge *.mix files

Table of Contents

• Installation
• Usage
  • Reading a *.mix file
  • Creating a *.mix file

Installation

pip install ra2mix

Usage

Import the package

import ra2mix

Reading a *.mix file

The ra2mix.read function will take a *.mix filepath and return a dict[str, bytes] object. The keys are filenames and the values are file data as bytes.

import ra2mix
mix_filepath = "path/to/mixfile.mix"

filemap = ra2mix.read(mix_filepath)
print(f"filenames: {list(filemap.keys())}")

extract_folder = "extract/to/folder"

for filename, file_data in filemap.items():
    print(f"Creating {filename}")
    with open(os.path.join(extract_folder, filename), "wb") as fp:
        fp.write(file_data)

---

Creating a *.mix file

The ra2mix.write supports three methods for specifying files to include in a new *.mix file: - filemap: A dict[str, bytes] object consisting of filenames and file data - folder_path: A path to a folder; all files in the folder are added to the mix - filepaths: A list[str] containing exact filepaths to include in the mix

import ra2mix
mix_filepath = "path/to/mixfile.mix"

target_folder = "read/from/folder"

mix_data = ra2mix.write(mix_filepath, folder_path=target_folder)

# Optionally do something with mix_data if you want; file is already written to
# `mix_filepath`