unityflow 0.3.4__py3-none-any.whl

unityflow-0.3.4.dist-info/METADATA

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: unityflow
+Version: 0.3.4
+Summary: Unity workflow automation - edit, diff, and merge prefabs, scenes, and assets without the Unity Editor
+Author: unityflow contributors
+License: MIT
+Project-URL: Homepage, https://github.com/TrueCyan/unityflow
+Project-URL: Repository, https://github.com/TrueCyan/unityflow
+Project-URL: Issues, https://github.com/TrueCyan/unityflow/issues
+Keywords: unity,prefab,scene,asset,yaml,llm,workflow,automation,git
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: unityparser>=4.0.0
+Requires-Dist: rapidyaml>=0.10.0
+Requires-Dist: click>=8.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: unityflow[dev]; extra == "all"
+Dynamic: license-file
+
+# unityflow
+
+Unity 워크플로우 자동화 도구입니다. Unity 에디터 없이 프리팹, 씬, 에셋을 편집하고, diff/merge하고, LLM과 통합할 수 있습니다.
+
+## 주요 기능
+
+- **정규화**: Unity YAML 파일을 결정적 형식으로 변환하여 불필요한 diff 제거
+- **검증**: 참조 유효성, 순환 참조, 중복 fileID 검사
+- **비교/병합**: 정규화된 diff 및 3-way 병합 지원
+- **에셋 추적**: 의존성 분석 및 역참조 검색
+- **Git 통합**: textconv, merge 드라이버, pre-commit 훅 지원
+
+## 설치
+
+### PyPI에서 설치 (권장)
+
+```bash
+pip install unityflow
+```
+
+### GitHub에서 설치
+
+```bash
+pip install git+https://github.com/TrueCyan/unityflow.git
+```
+
+### 소스에서 설치
+
+```bash
+git clone https://github.com/TrueCyan/unityflow
+cd unityflow
+pip install .
+```
+
+### 개발 환경 설치
+
+```bash
+git clone https://github.com/TrueCyan/unityflow
+cd unityflow
+pip install -e ".[dev]"
+```
+
+## 요구 사항
+
+- Python 3.12 이상
+- 의존성:
+  - `unityparser>=4.0.0`
+  - `rapidyaml>=0.10.0`
+  - `click>=8.0.0`
+
+## 빠른 시작
+
+### 파일 정규화
+
+```bash
+# 단일 파일 정규화
+unityflow normalize Player.prefab
+unityflow normalize MainScene.unity
+unityflow normalize GameConfig.asset
+
+# 여러 파일 정규화
+unityflow normalize *.prefab *.unity *.asset
+
+# 병렬 처리 (4 워커)
+unityflow normalize Assets/**/*.prefab --parallel 4 --progress
+
+# Git에서 변경된 파일만 정규화
+unityflow normalize --changed-only
+
+# 스테이징된 파일만 정규화
+unityflow normalize --changed-only --staged-only
+```
+
+### 파일 검증
+
+```bash
+# 단일 파일 검증
+unityflow validate Player.prefab
+unityflow validate MainScene.unity
+
+# 엄격 모드 (경고도 오류로 처리)
+unityflow validate Player.prefab --strict
+```
+
+### 파일 비교
+
+```bash
+# 두 파일 비교
+unityflow diff old.prefab new.prefab
+unityflow diff Scene_v1.unity Scene_v2.unity
+
+# 정규화 없이 비교
+unityflow diff old.prefab new.prefab --no-normalize
+```
+
+### 에셋 의존성 분석
+
+```bash
+# 모든 의존성 표시
+unityflow deps Player.prefab
+
+# 바이너리 에셋만 (텍스처, 메시 등)
+unityflow deps Player.prefab --binary-only
+
+# 특정 에셋을 참조하는 파일 찾기
+unityflow find-refs Textures/player.png
+```
+
+## Git 통합 설정
+
+Unity 프로젝트 루트에서 단일 명령어로 Git 통합을 설정할 수 있습니다:
+
+```bash
+# 기본 설정 (diff/merge 드라이버 + .gitattributes)
+unityflow setup
+
+# pre-commit 훅도 함께 설치
+unityflow setup --with-hooks
+
+# 글로벌 설정 (모든 저장소에 적용)
+unityflow setup --global
+```
+
+이 명령어는 다음을 자동으로 수행합니다:
+- Git diff 드라이버 설정 (정규화된 diff 출력)
+- Git merge 드라이버 설정 (Unity 파일 3-way 병합)
+- `.gitattributes` 파일 생성/업데이트
+
+### 수동 설정 (선택사항)
+
+수동으로 설정하려면 `.gitconfig`에 추가:
+```ini
+[diff "unity"]
+    textconv = unityflow git-textconv
+
+[merge "unity"]
+    name = Unity YAML Merge
+    driver = unityflow merge %O %A %B -o %A --path %P
+```
+
+`.gitattributes`에 추가:
+```
+*.prefab diff=unity merge=unity text eol=lf
+*.unity diff=unity merge=unity text eol=lf
+*.asset diff=unity merge=unity text eol=lf
+```
+
+## Python API 사용법
+
+```python
+from unityflow import (
+    UnityYAMLDocument,
+    UnityPrefabNormalizer,
+    analyze_dependencies,
+    get_changed_files,
+)
+
+# Unity YAML 파일 로드 (.prefab, .unity, .asset)
+doc = UnityYAMLDocument.load("Player.prefab")
+doc = UnityYAMLDocument.load("MainScene.unity")
+doc = UnityYAMLDocument.load("GameConfig.asset")
+
+# 정규화
+normalizer = UnityPrefabNormalizer()
+content = normalizer.normalize_file("Player.prefab")
+
+# 의존성 분석
+from pathlib import Path
+report = analyze_dependencies([Path("Player.prefab")])
+for dep in report.get_binary_dependencies():
+    print(f"{dep.path} [{dep.asset_type}]")
+
+# Git 변경 파일 조회
+changed = get_changed_files(staged_only=True)
+```
+
+### Unity 파일 프로그래매틱 생성
+
+```python
+from unityflow.parser import (
+    UnityYAMLDocument,
+    create_game_object,
+    create_transform,
+    create_rect_transform,
+)
+
+# 새 문서 생성
+doc = UnityYAMLDocument()
+
+# 고유 fileID 생성
+go_id = doc.generate_unique_file_id()
+transform_id = doc.generate_unique_file_id()
+
+# GameObject 생성
+go = create_game_object("MyObject", file_id=go_id, components=[transform_id])
+
+# Transform 생성
+transform = create_transform(
+    game_object_id=go_id,
+    file_id=transform_id,
+    position={"x": 0, "y": 5, "z": 0},
+)
+
+# 문서에 추가 및 저장
+doc.add_object(go)
+doc.add_object(transform)
+doc.save("MyObject.prefab")  # 또는 .unity, .asset
+```
+
+## 지원 파일 형식
+
+| 카테고리 | 확장자 |
+|---------|--------|
+| Core | `.prefab`, `.unity`, `.asset` |
+| Animation | `.anim`, `.controller`, `.overrideController`, `.playable`, `.mask`, `.signal` |
+| Rendering | `.mat`, `.renderTexture`, `.flare`, `.shadervariants`, `.spriteatlas`, `.cubemap` |
+| Physics | `.physicMaterial`, `.physicsMaterial2D` |
+| Terrain | `.terrainlayer`, `.brush` |
+| Audio | `.mixer` |
+| UI/Editor | `.guiskin`, `.fontsettings`, `.preset`, `.giparams` |
+
+## CLI 명령어 요약
+
+```bash
+unityflow setup       # Git 통합 설정
+unityflow normalize   # Unity YAML 파일 정규화
+unityflow validate    # 구조적 무결성 검증
+unityflow diff        # 두 파일 비교
+unityflow merge       # 3-way 병합
+unityflow query       # 경로 기반 데이터 조회
+unityflow set         # 경로 기반 값 설정
+unityflow deps        # 에셋 의존성 분석
+unityflow find-refs   # 역참조 검색
+unityflow stats       # 파일 통계 조회
+```
+
+전체 옵션은 `unityflow <command> --help`로 확인하세요.
+
+## 향후 계획
+
+- **프로젝트 전체 통계**: `unityflow stats --recursive Assets/`
+
+## 개발
+
+```bash
+# 개발 환경 설치
+pip install -e ".[dev]"
+
+# 테스트 실행
+pytest tests/
+
+# 코드 포맷팅
+black src/ tests/
+ruff check src/ tests/
+```
+
+아키텍처와 API 상세 문서는 [DEVELOPMENT.md](DEVELOPMENT.md)를 참조하세요.
+
+## 라이선스
+
+MIT License

unityflow-0.3.4.dist-info/RECORD

@@ -0,0 +1,25 @@
+unityflow/__init__.py,sha256=5bMpxrTw3bjkXeQBv9WUfh86wJ0kQQdZ4bcD1zsDf4Q,4148
+unityflow/asset_resolver.py,sha256=TObMXLRxwi4S8ovMnOL3e8HirzhFKVjw_snyHYqsbOs,19520
+unityflow/asset_tracker.py,sha256=NwyKbivaOTDeLuKcPW-EEwiDtL1_vkpRhhEmel9JweQ,56916
+unityflow/cli.py,sha256=BxmEXekxo0plhw4djA-p3vfoLpnSD0yyxyaYbGdw994,79525
+unityflow/diff.py,sha256=iAbKSZu71zyDT97NAUksfRk0RziWTRfEYtT0Iv3vzuk,6889
+unityflow/fast_parser.py,sha256=7FrOctrr9p0uqAZo-wYlsr6XjYXHYcJPesH5l-OTc8s,24067
+unityflow/formats.py,sha256=IpPkGYI2euQvbybV32VAvCvkt0uThNLv_7zqyeNWkEQ,54999
+unityflow/git_utils.py,sha256=ZlSMvChHm03tu-mgfu-CCwWM_70Ng-y95_KRctMzJ6I,8254
+unityflow/hierarchy.py,sha256=tUU9PGHoZiko4IGnhhtynk9Cn2kkUfE4DVI5gc4VStg,65466
+unityflow/merge.py,sha256=NxFxGWkyghW-E79M2pfW3Jene9QvqEUTQgXmPBnkh4o,6935
+unityflow/meta_generator.py,sha256=8YI8ixlzFbGlGLztpg3WHPz-A6aQyB4PKKUf_p41nf4,38173
+unityflow/normalizer.py,sha256=uFu7IRN_sXjw9TqX5BeSZFdoT8KGAT9EAis2ql0kX0U,18788
+unityflow/parser.py,sha256=57PLBIGYR0KV84shms6jpoBE8_iGDchBM6K3wD6Ub_4,21899
+unityflow/query.py,sha256=ogrSN_lHMZtumTkembbdt3dkyEZBGgXS_VPZpj_Ho_w,11546
+unityflow/script_parser.py,sha256=D9wCNjKOe5FCXkcRSRr8dR-AEEIv5yy9PzGlleWwDtk,22836
+unityflow/sprite.py,sha256=07K5Yyg7OP1tfEgLtF4BYdQyFhXN57i2haoyGqc0Wr8,11683
+unityflow/validator.py,sha256=2yOrHjdzexfmKIbNA34ziLAJ8IqrtzFD7TjZ9zF7IF0,27851
+unityflow/data/__init__.py,sha256=JatxIRoa7IpAQSLsCvMjuqCVJwekAih9LTWjRaoTHls,39
+unityflow/data/class_ids.json,sha256=3FHcqdZSzgyBnk-gkxA2gxSyR8Tz0BqHYvvgFZ5QWRU,9957
+unityflow-0.3.4.dist-info/licenses/LICENSE,sha256=ZHwUWPN3UIQ-JQz8enB9tdVBzShrsslteKxyfpl0GR4,1065
+unityflow-0.3.4.dist-info/METADATA,sha256=8WjJh-xBfC6e4V6j6wiF3nkMpUyTUDMsRpzv_N6B1nc,7452
+unityflow-0.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+unityflow-0.3.4.dist-info/entry_points.txt,sha256=zqRjzMbaiiSRMJ7TADy8RVKZsUeHbI09z3s8p6icCNE,49
+unityflow-0.3.4.dist-info/top_level.txt,sha256=SsUHJNh4BYZVDpJ-Z30AiZ3HK2pfhd_hq-g1kA_geOg,10
+unityflow-0.3.4.dist-info/RECORD,,

unityflow-0.3.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

unityflow-0.3.4.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+unityflow = unityflow.cli:main

unityflow-0.3.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TrueCyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

unityflow-0.3.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+unityflow