pyflashkit 1.0.0__py3-none-any.whl

flashkit/__init__.py

@@ -0,0 +1,54 @@
+"""
+flashkit — SWF/ABC toolkit for parsing, analyzing, and manipulating Flash files.
+
+A Python library for working with Adobe Flash SWF containers and AVM2
+bytecode. Provides low-level binary parsing with round-trip fidelity,
+a rich resolved class model, and analysis tools for inheritance graphs,
+call graphs, cross-references, and string search.
+
+Packages:
+    swf: SWF container format (parse, build, tag types).
+    abc: AVM2 bytecode (parse, write, constants, data types).
+    info: Rich resolved model (ClassInfo, FieldInfo, MethodInfo).
+    workspace: Loaded binary workspace (SWF/SWZ resources).
+    analysis: Inheritance graph, call graph, references, strings.
+    search: Query engine for workspace content.
+
+Quick start::
+
+    from flashkit import parse_swf, parse_abc, serialize_abc
+
+    header, tags, version, length = parse_swf(swf_bytes)
+    abc = parse_abc(abc_bytes)
+    output = serialize_abc(abc)
+"""
+
+__version__ = "1.0.0"
+
+from .errors import (
+    FlashkitError, ParseError, SWFParseError,
+    ABCParseError, SerializeError, ResourceError,
+)
+from .swf.parser import parse_swf
+from .swf.builder import rebuild_swf, make_doabc2_tag
+from .abc.parser import parse_abc
+from .abc.writer import serialize_abc
+from .abc.types import AbcFile
+
+__all__ = [
+    "__version__",
+    # Errors
+    "FlashkitError",
+    "ParseError",
+    "SWFParseError",
+    "ABCParseError",
+    "SerializeError",
+    "ResourceError",
+    # Core API
+    "parse_swf",
+    "rebuild_swf",
+    "make_doabc2_tag",
+    "parse_abc",
+    "serialize_abc",
+    "AbcFile",
+]

flashkit/abc/__init__.py

@@ -0,0 +1,79 @@
+"""
+AVM2 bytecode parsing and serialization.
+
+This package handles the ABC (ActionScript Byte Code) format — the bytecode
+that runs on Adobe's AVM2 virtual machine inside Flash Player and Adobe AIR.
+
+Quick start::
+
+    from flashkit.abc import parse_abc, serialize_abc, AbcFile
+
+    abc = parse_abc(raw_bytes)
+    print(f"Classes: {len(abc.instances)}")
+    output = serialize_abc(abc)
+    assert output == raw_bytes  # round-trip fidelity
+"""
+
+from .types import (
+    AbcFile,
+    NamespaceInfo,
+    NsSetInfo,
+    MultinameInfo,
+    MethodInfo,
+    MetadataInfo,
+    TraitInfo,
+    InstanceInfo,
+    ClassInfo,
+    ScriptInfo,
+    ExceptionInfo,
+    MethodBodyInfo,
+)
+from .parser import (
+    parse_abc,
+    read_u30,
+    read_s32,
+    write_u30,
+    write_s32,
+    s24,
+    read_u8,
+    read_u16,
+    read_u32,
+    read_d64,
+)
+from .writer import serialize_abc
+from .disasm import Instruction, decode_instructions
+from .builder import AbcBuilder
+
+__all__ = [
+    # Types
+    "AbcFile",
+    "NamespaceInfo",
+    "NsSetInfo",
+    "MultinameInfo",
+    "MethodInfo",
+    "MetadataInfo",
+    "TraitInfo",
+    "InstanceInfo",
+    "ClassInfo",
+    "ScriptInfo",
+    "ExceptionInfo",
+    "MethodBodyInfo",
+    # Parser
+    "parse_abc",
+    "read_u30",
+    "read_s32",
+    "write_u30",
+    "write_s32",
+    "s24",
+    "read_u8",
+    "read_u16",
+    "read_u32",
+    "read_d64",
+    # Writer
+    "serialize_abc",
+    # Disassembler
+    "Instruction",
+    "decode_instructions",
+    # Builder
+    "AbcBuilder",
+]