Skip to main content

Module extractor

Module extractor 

Source
Expand description

L9 extractor: tools/extractor.py:25-157, tools/extractor.py:165-319. Container entries are never deduplicated. Stable priority is implemented by sorting (priority, original ordinal), without allocating sort scratch. Tier C failures are retained in the report; failure to allocate the report itself ends the run. The caller supplies a confined filesystem sink; all names handed to it have passed paths::validate.

Modules§

paths
Naming from tools/extractor.py:25-78 and tools/extractor.py:81-157. Safety policy: validate before dropping directories; reject parent, NUL, absolute and backslash-bearing paths. Empty slash components are ignored.

Structs§

Failure
An export failure with its original typed cause and requested relative path.
Identity
Exported identities preserve UnityPy’s duplicates (a Sprite returns its texture).
Options
Options of extract_assets; loading is the caller’s Environment policy.
Report
Written
A completed write, including writes subsequently overwritten. Paths are relative.

Enums§

Error

Constants§

EXPORT_TYPES
Export dispatch order, including UnityPy’s observable insertion order.

Traits§

AssetFilter
Called first with metadata, then with the parsed object, as UnityPy does. A missing MonoBehaviour tree is passed as None on the second call too.
Sink
A sink must confine paths beneath its root and charge buffered output before fallible allocation. A successful call has finished writing.

Functions§

export_obj
Export one object, appending its name when requested. Recoverable failures are appended to report; report allocation failures return Err.
extract_assets
Extract a loaded Environment. Empty container mode stays empty: there is no implicit fallback to all objects. Later entries overwrite earlier ones.