unityflow 0.3.4__py3-none-any.whl

unityflow/data/__init__.py

@@ -0,0 +1 @@
+# Package data directory for unityflow

unityflow/data/class_ids.json

@@ -0,0 +1,336 @@
+{
+  "0": "Object",
+  "1": "GameObject",
+  "2": "Component",
+  "3": "LevelGameManager",
+  "4": "Transform",
+  "5": "TimeManager",
+  "6": "GlobalGameManager",
+  "8": "Behaviour",
+  "9": "GameManager",
+  "11": "AudioManager",
+  "13": "InputManager",
+  "18": "EditorExtension",
+  "19": "Physics2DSettings",
+  "20": "Camera",
+  "21": "Material",
+  "23": "MeshRenderer",
+  "25": "Renderer",
+  "27": "Texture",
+  "28": "Texture2D",
+  "29": "OcclusionCullingSettings",
+  "30": "GraphicsSettings",
+  "33": "MeshFilter",
+  "41": "OcclusionPortal",
+  "43": "Mesh",
+  "45": "Skybox",
+  "47": "QualitySettings",
+  "48": "Shader",
+  "49": "TextAsset",
+  "50": "Rigidbody2D",
+  "53": "Collider2D",
+  "54": "Rigidbody",
+  "55": "PhysicsManager",
+  "56": "Collider",
+  "57": "Joint",
+  "58": "CircleCollider2D",
+  "59": "HingeJoint",
+  "60": "PolygonCollider2D",
+  "61": "BoxCollider2D",
+  "62": "PhysicsMaterial2D",
+  "64": "MeshCollider",
+  "65": "BoxCollider",
+  "66": "CompositeCollider2D",
+  "68": "EdgeCollider2D",
+  "70": "CapsuleCollider2D",
+  "72": "ComputeShader",
+  "74": "AnimationClip",
+  "75": "ConstantForce",
+  "78": "TagManager",
+  "81": "AudioListener",
+  "82": "AudioSource",
+  "83": "AudioClip",
+  "84": "RenderTexture",
+  "86": "CustomRenderTexture",
+  "89": "Cubemap",
+  "90": "Avatar",
+  "91": "AnimatorController",
+  "93": "RuntimeAnimatorController",
+  "94": "ShaderNameRegistry",
+  "95": "Animator",
+  "96": "TrailRenderer",
+  "98": "DelayedCallManager",
+  "102": "TextMesh",
+  "104": "RenderSettings",
+  "108": "Light",
+  "109": "ShaderInclude",
+  "110": "BaseAnimationTrack",
+  "111": "Animation",
+  "114": "MonoBehaviour",
+  "115": "MonoScript",
+  "116": "MonoManager",
+  "117": "Texture3D",
+  "118": "NewAnimationTrack",
+  "119": "Projector",
+  "120": "LineRenderer",
+  "121": "Flare",
+  "122": "Halo",
+  "123": "LensFlare",
+  "124": "FlareLayer",
+  "126": "NavMeshProjectSettings",
+  "128": "Font",
+  "129": "PlayerSettings",
+  "130": "NamedObject",
+  "134": "PhysicsMaterial",
+  "135": "SphereCollider",
+  "136": "CapsuleCollider",
+  "137": "SkinnedMeshRenderer",
+  "138": "FixedJoint",
+  "141": "BuildSettings",
+  "142": "AssetBundle",
+  "143": "CharacterController",
+  "144": "CharacterJoint",
+  "145": "SpringJoint",
+  "146": "WheelCollider",
+  "147": "ResourceManager",
+  "150": "PreloadData",
+  "152": "MovieTexture",
+  "153": "ConfigurableJoint",
+  "154": "TerrainCollider",
+  "156": "TerrainData",
+  "157": "LightmapSettings",
+  "158": "WebCamTexture",
+  "159": "EditorSettings",
+  "162": "EditorUserSettings",
+  "164": "AudioReverbFilter",
+  "165": "AudioHighPassFilter",
+  "166": "AudioChorusFilter",
+  "167": "AudioReverbZone",
+  "168": "AudioEchoFilter",
+  "169": "AudioLowPassFilter",
+  "170": "AudioDistortionFilter",
+  "171": "SparseTexture",
+  "180": "AudioBehaviour",
+  "181": "AudioFilter",
+  "182": "WindZone",
+  "183": "Cloth",
+  "184": "SubstanceArchive",
+  "185": "ProceduralMaterial",
+  "186": "ProceduralTexture",
+  "187": "Texture2DArray",
+  "188": "CubemapArray",
+  "191": "OffMeshLink",
+  "192": "OcclusionArea",
+  "193": "Tree",
+  "195": "NavMeshAgent",
+  "196": "NavMeshSettings",
+  "198": "ParticleSystem",
+  "199": "ParticleSystemRenderer",
+  "200": "ShaderVariantCollection",
+  "205": "LODGroup",
+  "206": "BlendTree",
+  "207": "Motion",
+  "208": "NavMeshObstacle",
+  "210": "SortingGroup",
+  "212": "SpriteRenderer",
+  "213": "Sprite",
+  "214": "CachedSpriteAtlas",
+  "215": "ReflectionProbe",
+  "218": "Terrain",
+  "220": "LightProbeGroup",
+  "221": "AnimatorOverrideController",
+  "222": "CanvasRenderer",
+  "223": "Canvas",
+  "224": "RectTransform",
+  "225": "CanvasGroup",
+  "226": "BillboardAsset",
+  "227": "BillboardRenderer",
+  "228": "SpeedTreeWindAsset",
+  "229": "AnchoredJoint2D",
+  "230": "Joint2D",
+  "231": "SpringJoint2D",
+  "232": "DistanceJoint2D",
+  "233": "HingeJoint2D",
+  "234": "SliderJoint2D",
+  "235": "WheelJoint2D",
+  "236": "ClusterInputManager",
+  "237": "BaseVideoTexture",
+  "238": "NavMeshData",
+  "240": "AudioMixer",
+  "241": "AudioMixerController",
+  "243": "AudioMixerGroupController",
+  "244": "AudioMixerEffectController",
+  "245": "AudioMixerSnapshotController",
+  "246": "PhysicsUpdateBehaviour2D",
+  "247": "ConstantForce2D",
+  "248": "Effector2D",
+  "249": "AreaEffector2D",
+  "250": "PointEffector2D",
+  "251": "PlatformEffector2D",
+  "252": "SurfaceEffector2D",
+  "253": "BuoyancyEffector2D",
+  "254": "RelativeJoint2D",
+  "255": "FixedJoint2D",
+  "256": "FrictionJoint2D",
+  "257": "TargetJoint2D",
+  "258": "LightProbes",
+  "259": "LightProbeProxyVolume",
+  "271": "SampleClip",
+  "272": "AudioMixerSnapshot",
+  "273": "AudioMixerGroup",
+  "290": "AssetBundleManifest",
+  "300": "RuntimeInitializeOnLoadManager",
+  "310": "UnityConnectSettings",
+  "319": "AvatarMask",
+  "320": "PlayableDirector",
+  "328": "VideoPlayer",
+  "329": "VideoClip",
+  "330": "ParticleSystemForceField",
+  "331": "SpriteMask",
+  "363": "OcclusionCullingData",
+  "900": "MarshallingTestObject",
+  "1001": "PrefabInstance",
+  "1002": "EditorExtensionImpl",
+  "1003": "AssetImporter",
+  "1005": "Mesh3DSImporter",
+  "1006": "TextureImporter",
+  "1007": "ShaderImporter",
+  "1008": "ComputeShaderImporter",
+  "1020": "AudioImporter",
+  "1026": "HierarchyState",
+  "1028": "AssetMetaData",
+  "1029": "DefaultAsset",
+  "1030": "DefaultImporter",
+  "1031": "TextScriptImporter",
+  "1032": "SceneAsset",
+  "1034": "NativeFormatImporter",
+  "1035": "MonoImporter",
+  "1038": "LibraryAssetImporter",
+  "1040": "ModelImporter",
+  "1041": "FBXImporter",
+  "1042": "TrueTypeFontImporter",
+  "1045": "EditorBuildSettings",
+  "1048": "InspectorExpandedState",
+  "1049": "AnnotationManager",
+  "1050": "PluginImporter",
+  "1051": "EditorUserBuildSettings",
+  "1055": "IHVImageFormatImporter",
+  "1101": "AnimatorStateTransition",
+  "1102": "AnimatorState",
+  "1105": "HumanTemplate",
+  "1107": "AnimatorStateMachine",
+  "1108": "PreviewAnimationClip",
+  "1109": "AnimatorTransition",
+  "1110": "SpeedTreeImporter",
+  "1111": "AnimatorTransitionBase",
+  "1112": "SubstanceImporter",
+  "1113": "LightmapParameters",
+  "1120": "LightingDataAsset",
+  "1124": "SketchUpImporter",
+  "1125": "BuildReport",
+  "1126": "PackedAssets",
+  "1127": "VideoClipImporter",
+  "100000": "int",
+  "100001": "bool",
+  "100002": "float",
+  "100003": "MonoObject",
+  "100004": "Collision",
+  "100005": "Vector3f",
+  "100006": "RootMotionData",
+  "100007": "Collision2D",
+  "100008": "AudioMixerLiveUpdateFloat",
+  "100009": "AudioMixerLiveUpdateBool",
+  "100010": "Polygon2D",
+  "100011": "void",
+  "19719996": "TilemapCollider2D",
+  "41386430": "ImportLog",
+  "55640938": "GraphicsStateCollection",
+  "73398921": "VFXRenderer",
+  "156049354": "Grid",
+  "156483287": "ScenesUsingAssets",
+  "171741748": "ArticulationBody",
+  "181963792": "Preset",
+  "285090594": "IConstraint",
+  "294290339": "AssemblyDefinitionReferenceImporter",
+  "355983997": "AudioResource",
+  "369655926": "AssetImportInProgressProxy",
+  "382020655": "PluginBuildInfo",
+  "387306366": "MemorySettings",
+  "403037116": "BuildMetaDataImporter",
+  "403037117": "BuildInstructionImporter",
+  "426301858": "EditorProjectAccess",
+  "468431735": "PrefabImporter",
+  "483693784": "TilemapRenderer",
+  "612988286": "SpriteAtlasAsset",
+  "638013454": "SpriteAtlasDatabase",
+  "641289076": "AudioBuildInfo",
+  "644342135": "CachedSpriteAtlasRuntimeData",
+  "655991488": "MultiplayerManager",
+  "662584278": "AssemblyDefinitionReferenceAsset",
+  "668709126": "BuiltAssetBundleInfoSet",
+  "687078895": "SpriteAtlas",
+  "702665669": "DifferentMarshallingTestObject",
+  "747330370": "RayTracingShaderImporter",
+  "780535461": "BuildArchiveImporter",
+  "815301076": "PreviewImporter",
+  "825902497": "RayTracingShader",
+  "850595691": "LightingSettings",
+  "877146078": "PlatformModuleSetup",
+  "890905787": "VersionControlSettings",
+  "893571522": "CustomCollider2D",
+  "895512359": "AimConstraint",
+  "937362698": "VFXManager",
+  "947337230": "RoslynAnalyzerConfigAsset",
+  "954905827": "RuleSetFileAsset",
+  "994735392": "VisualEffectSubgraph",
+  "994735403": "VisualEffectSubgraphOperator",
+  "994735404": "VisualEffectSubgraphBlock",
+  "1001480554": "Prefab",
+  "1027052791": "LocalizationImporter",
+  "1114811875": "ReferencesArtifactGenerator",
+  "1152215463": "AssemblyDefinitionAsset",
+  "1154873562": "SceneVisibilityState",
+  "1183024399": "LookAtConstraint",
+  "1210832254": "SpriteAtlasImporter",
+  "1223240404": "MultiArtifactTestImporter",
+  "1233149941": "AudioContainerElement",
+  "1268269756": "GameObjectRecorder",
+  "1307931743": "AudioRandomContainer",
+  "1325145578": "LightingDataAssetParent",
+  "1386491679": "PresetManager",
+  "1403656975": "StreamingManager",
+  "1480428607": "LowerResBlitTexture",
+  "1521398425": "VideoBuildInfo",
+  "1541671625": "C4DImporter",
+  "1542919678": "StreamingController",
+  "1557264870": "ShaderContainer",
+  "1597193336": "RoslynAdditionalFileAsset",
+  "1642787288": "RoslynAdditionalFileImporter",
+  "1652712579": "MultiplayerRolesData",
+  "1660057539": "SceneRoots",
+  "1731078267": "BrokenPrefabAsset",
+  "1736697216": "AndroidAssetPackImporter",
+  "1740304944": "VulkanDeviceFilterLists",
+  "1742807556": "GridLayout",
+  "1766753193": "AssemblyDefinitionImporter",
+  "1773428102": "ParentConstraint",
+  "1777034230": "RuleSetFileImporter",
+  "1818360608": "PositionConstraint",
+  "1818360609": "RotationConstraint",
+  "1818360610": "ScaleConstraint",
+  "1839735485": "Tilemap",
+  "1896753125": "PackageManifest",
+  "1896753126": "PackageManifestImporter",
+  "1903396204": "RoslynAnalyzerConfigImporter",
+  "1931382933": "UIRenderer",
+  "1953259897": "TerrainLayer",
+  "1971053207": "SpriteShapeRenderer",
+  "2058629509": "VisualEffectAsset",
+  "2058629510": "VisualEffectImporter",
+  "2058629511": "VisualEffectResource",
+  "2059678085": "VisualEffectObject",
+  "2083052967": "VisualEffect",
+  "2083778819": "LocalizationAsset",
+  "2089858483": "ScriptedImporter",
+  "2103361453": "ShaderIncludeImporter"
+}

unityflow/diff.py

@@ -0,0 +1,234 @@
+"""Unity Prefab Diff Utilities.
+
+Provides meaningful diff output by normalizing files before comparison,
+eliminating noise from Unity's non-deterministic serialization.
+"""
+
+from __future__ import annotations
+
+import difflib
+from dataclasses import dataclass
+from enum import Enum
+from pathlib import Path
+
+from unityflow.normalizer import UnityPrefabNormalizer
+
+
+class DiffFormat(Enum):
+    """Output format for diff."""
+
+    UNIFIED = "unified"
+    CONTEXT = "context"
+    SIDE_BY_SIDE = "side-by-side"
+    SUMMARY = "summary"
+
+
+@dataclass
+class DiffResult:
+    """Result of a diff operation."""
+
+    old_path: str
+    new_path: str
+    old_content: str
+    new_content: str
+    has_changes: bool
+    diff_lines: list[str]
+
+    def __str__(self) -> str:
+        return "\n".join(self.diff_lines)
+
+    @property
+    def additions(self) -> int:
+        """Count of added lines."""
+        return sum(1 for line in self.diff_lines if line.startswith("+") and not line.startswith("+++"))
+
+    @property
+    def deletions(self) -> int:
+        """Count of deleted lines."""
+        return sum(1 for line in self.diff_lines if line.startswith("-") and not line.startswith("---"))
+
+
+class PrefabDiff:
+    """Diff utility for Unity prefab files."""
+
+    def __init__(
+        self,
+        normalize: bool = True,
+        context_lines: int = 3,
+        format: DiffFormat = DiffFormat.UNIFIED,
+    ):
+        """Initialize the diff utility.
+
+        Args:
+            normalize: Whether to normalize files before diffing
+            context_lines: Number of context lines to show
+            format: Output format
+        """
+        self.normalize = normalize
+        self.context_lines = context_lines
+        self.format = format
+        self._normalizer = UnityPrefabNormalizer() if normalize else None
+
+    def diff_files(
+        self,
+        old_path: str | Path,
+        new_path: str | Path,
+    ) -> DiffResult:
+        """Diff two Unity YAML files.
+
+        Args:
+            old_path: Path to the old/original file
+            new_path: Path to the new/modified file
+
+        Returns:
+            DiffResult containing the diff output
+        """
+        old_path = Path(old_path)
+        new_path = Path(new_path)
+
+        # Read and optionally normalize
+        if self.normalize and self._normalizer:
+            old_content = self._normalizer.normalize_file(old_path)
+            new_content = self._normalizer.normalize_file(new_path)
+        else:
+            old_content = old_path.read_text(encoding="utf-8")
+            new_content = new_path.read_text(encoding="utf-8")
+
+        return self.diff_content(
+            old_content,
+            new_content,
+            old_label=str(old_path),
+            new_label=str(new_path),
+        )
+
+    def diff_content(
+        self,
+        old_content: str,
+        new_content: str,
+        old_label: str = "old",
+        new_label: str = "new",
+    ) -> DiffResult:
+        """Diff two content strings.
+
+        Args:
+            old_content: The old/original content
+            new_content: The new/modified content
+            old_label: Label for the old content
+            new_label: Label for the new content
+
+        Returns:
+            DiffResult containing the diff output
+        """
+        old_lines = old_content.splitlines(keepends=True)
+        new_lines = new_content.splitlines(keepends=True)
+
+        has_changes = old_content != new_content
+
+        if self.format == DiffFormat.UNIFIED:
+            diff_lines = list(
+                difflib.unified_diff(
+                    old_lines,
+                    new_lines,
+                    fromfile=old_label,
+                    tofile=new_label,
+                    n=self.context_lines,
+                )
+            )
+        elif self.format == DiffFormat.CONTEXT:
+            diff_lines = list(
+                difflib.context_diff(
+                    old_lines,
+                    new_lines,
+                    fromfile=old_label,
+                    tofile=new_label,
+                    n=self.context_lines,
+                )
+            )
+        elif self.format == DiffFormat.SUMMARY:
+            diff_lines = self._generate_summary(old_lines, new_lines, old_label, new_label)
+        else:
+            diff_lines = list(
+                difflib.unified_diff(
+                    old_lines,
+                    new_lines,
+                    fromfile=old_label,
+                    tofile=new_label,
+                    n=self.context_lines,
+                )
+            )
+
+        # Strip trailing newlines from diff lines for cleaner output
+        diff_lines = [line.rstrip("\n") for line in diff_lines]
+
+        return DiffResult(
+            old_path=old_label,
+            new_path=new_label,
+            old_content=old_content,
+            new_content=new_content,
+            has_changes=has_changes,
+            diff_lines=diff_lines,
+        )
+
+    def _generate_summary(
+        self,
+        old_lines: list[str],
+        new_lines: list[str],
+        old_label: str,
+        new_label: str,
+    ) -> list[str]:
+        """Generate a summary of changes."""
+        matcher = difflib.SequenceMatcher(None, old_lines, new_lines)
+        opcodes = matcher.get_opcodes()
+
+        summary = [f"Comparing {old_label} -> {new_label}", ""]
+
+        additions = 0
+        deletions = 0
+        changes = 0
+
+        for tag, i1, i2, j1, j2 in opcodes:
+            if tag == "insert":
+                additions += j2 - j1
+            elif tag == "delete":
+                deletions += i2 - i1
+            elif tag == "replace":
+                changes += max(i2 - i1, j2 - j1)
+
+        summary.append(f"  Lines added: {additions}")
+        summary.append(f"  Lines deleted: {deletions}")
+        summary.append(f"  Lines changed: {changes}")
+
+        if additions == 0 and deletions == 0 and changes == 0:
+            summary.append("")
+            summary.append("No changes detected.")
+        else:
+            summary.append("")
+            summary.append("Changed sections:")
+            for tag, i1, i2, j1, j2 in opcodes:
+                if tag != "equal":
+                    summary.append(f"  - {tag}: lines {i1+1}-{i2} -> {j1+1}-{j2}")
+
+        return summary
+
+
+def diff_prefabs(
+    old_path: str | Path,
+    new_path: str | Path,
+    normalize: bool = True,
+    format: DiffFormat = DiffFormat.UNIFIED,
+    context_lines: int = 3,
+) -> DiffResult:
+    """Convenience function to diff two prefab files.
+
+    Args:
+        old_path: Path to the old file
+        new_path: Path to the new file
+        normalize: Whether to normalize before diffing
+        format: Output format
+        context_lines: Number of context lines
+
+    Returns:
+        DiffResult containing the diff
+    """
+    differ = PrefabDiff(normalize=normalize, format=format, context_lines=context_lines)
+    return differ.diff_files(old_path, new_path)