Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

1.2 KB
Raw Blame
/**
 * Final CPython bytecode magics for the minor versions whose 16-byte `.pyc`
 * header this reader can reconstruct. Other magics leave the PYZ opaque.
 * Each value is the four-byte little-endian magic, including the trailing CR LF.
 */
const PYTHON_BYTECODE_MAGICS: Readonly<Record<string, string>> = {
  "420d0d0a": "3.7",
  "550d0d0a": "3.8",
  "610d0d0a": "3.9",
  "6f0d0d0a": "3.10",
  a70d0d0a: "3.11",
  cb0d0d0a: "3.12",
  f30d0d0a: "3.13",
  "2b0e0d0a": "3.14",
};

/** Limitation recorded when a member's digest covers a derived `.pyc` header. */
export const RECONSTRUCTED_PYTHON_HEADER_LIMITATION =
  "Python bytecode header was reconstructed from the archive Python magic; this digest covers the derived file.";

/** Dotted Python version for a supported bytecode magic, when one is known. */
export const pythonVersionForMagic = (magic: Buffer): string | undefined =>
  PYTHON_BYTECODE_MAGICS[magic.toString("hex")];

/**
 * 16-byte `.pyc` header used since Python 3.7: magic, zero flags, zero
 * timestamp, and zero source size. The flags word selects the timestamp form.
 */
export const reconstructedPycHeader = (magic: Buffer): Buffer => {
  const header = Buffer.alloc(16);
  magic.copy(header, 0, 0, 4);
  return header;
};