pyjallib 0.1.10__py3-none-any.whl → 0.1.11__py3-none-any.whl

pyjallib/max/kneeBone.py

@@ -16,6 +16,8 @@ from .bone import Bone
 from .constraint import Constraint
 from .volumeBone import VolumeBone
 
+from .boneChain import BoneChain
+
 class KneeBone:
     """
     자동 무릎 본(AutoKnee) 관련 기능을 제공하는 클래스.
@@ -310,17 +312,19 @@ class KneeBone:
         result = self.volumeBone.create_bones(self.calf, self.thigh, inVolumeSize=5.0, inRotAxises=["Z", "Z"], inTransAxises=["PosY", "NegY"], inTransScales=transScales)
         
         filteringChar = self.name._get_filtering_char(inCalf.name)
-        calfName = self.name.get_name_part("RealName", inCalf.name+ filteringChar + "Vol")
+        calfName = self.name.get_RealName(inCalf.name)
+        calfName = calfName + filteringChar + "Vol"
         isLower = calfName[0].islower()
         replaceName = "Knee"
         if isLower:
             replaceName = replaceName.lower()
+            calfName = calfName.lower()
         
         for item in result["Bones"]:
-            item.name.replace(calfName, replaceName)
+            item.name = item.name.replace(calfName, replaceName)
         
-        result["rootBone"].name.replace(calfName, replaceName)
-        result["RotHelper"].name.replace(calfName, replaceName)
+        result["RootBone"].name = result["RootBone"].name.replace(calfName, replaceName)
+        result["RotHelper"].name = result["RotHelper"].name.replace(calfName, replaceName)
         
         # 결과 저장
         if result and "Bones" in result:
@@ -379,7 +383,7 @@ class KneeBone:
             
             liftTwistBone = self.bone.create_nub_bone(liftTwistBoneName, 2)
             liftTwistBone.name = self.name.remove_name_part("Nub", liftTwistBone.name)
-            liftTwistBone.name = self.name.replace_name_part("Index", liftTwistBone.name, self.name.get_name("Index", oriThighTwistBones.name))
+            liftTwistBone.name = self.name.replace_name_part("Index", liftTwistBone.name, self.name.get_name("Index", item.name))
             
             rt.setProperty(liftTwistBone, "transform", item.transform)
             liftTwistBone.parent = item
@@ -404,7 +408,7 @@ class KneeBone:
             
             liftTwistBone = self.bone.create_nub_bone(liftTwistBoneName, 2)
             liftTwistBone.name = self.name.remove_name_part("Nub", liftTwistBone.name)
-            liftTwistBone.name = self.name.replace_name_part("Index", liftTwistBone.name, self.name.get_name("Index", oriClafTwistBones.name))
+            liftTwistBone.name = self.name.replace_name_part("Index", liftTwistBone.name, self.name.get_name("Index", item.name))
             
             rt.setProperty(liftTwistBone, "transform", item.transform)
             liftTwistBone.parent = item
@@ -420,7 +424,7 @@ class KneeBone:
             self.calfTwistBones.append(liftTwistBone)
             self.calfTwistHelpers.append(liftTwistHelper)
             
-    def create_bone(self, inThigh, inCalf, inFoot, inLiftScale=0.05, inKneePopScale=1.0, inKneeBackScale=1.0):
+    def create_bone(self, inThigh, inCalf, inFoot, inLiftScale=0.05, inKneePopScale=0.1, inKneeBackScale=1.5):
         """
         자동 무릎 본 시스템의 모든 요소를 생성하는 주요 메서드입니다.
         
@@ -441,7 +445,7 @@ class KneeBone:
             inKneeBackScale: 무릎 뒤쪽 돌출 스케일 (1.0이 기본값)
             
         Returns:
-            bool: 자동 무릎 본 시스템 생성 성공 여부
+            BoneChain: 생성된 자동 무릎 본 체인 객체
         """
         if not rt.isValidNode(inThigh) or not rt.isValidNode(inCalf) or not rt.isValidNode(inFoot):
             return False
@@ -454,30 +458,61 @@ class KneeBone:
         self.create_middle_bone(inThigh, inCalf, inKneePopScale=inKneePopScale, inKneeBackScale=inKneeBackScale)
         self.create_twist_bones(inThigh, inCalf)
         
-        # 결과를 딕셔너리 형태로 준비
+        # 모든 생성된 본들 수집
+        all_bones = self.thighTwistBones + self.calfTwistBones + self.middleBones
+        all_helpers = [self.lookAtHleper, self.thighRotHelper, self.calfRotHelper, 
+                      self.thighRotRootHelper, self.calfRotRootHelper] + self.thighTwistHelpers + self.calfTwistHelpers
+        
+        # 결과를 BoneChain 형태로 준비
         result = {
-            "Thigh": inThigh,
-            "Calf": inCalf, 
-            "Foot": inFoot,
-            "LookAtHelper": self.lookAtHleper,
-            "ThighRotHelper": self.thighRotHelper,
-            "CalfRotHelper": self.calfRotHelper,
-            "ThighRotRootHelper": self.thighRotRootHelper,
-            "CalfRotRootHelper": self.calfRotRootHelper,
-            "ThighTwistBones": self.thighTwistBones,
-            "CalfTwistBones": self.calfTwistBones,
-            "ThighTwistHelpers": self.thighTwistHelpers,
-            "CalfTwistHelpers": self.calfTwistHelpers,
-            "MiddleBones": self.middleBones,
-            "LiftScale": inLiftScale,
-            "KneePopScale": inKneePopScale,
-            "KneeBackScale": inKneeBackScale
+            "Bones": all_bones,
+            "Helpers": all_helpers,
+            "SourceBones": [inThigh, inCalf, inFoot],
+            "Parameters": [inLiftScale, inKneePopScale, inKneeBackScale]
         }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return result
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 자동 무릎 본을 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 무릎 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): 자동 무릎 본 정보를 포함한 BoneChain 객체
+        
+        Returns:
+            BoneChain: 업데이트된 BoneChain 객체 또는 실패 시 None
+        """
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+            
+        # 기존 객체 삭제
+        inBoneChain.delete()
+            
+        # BoneChain에서 필요한 정보 추출
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        # 필수 소스 본 확인
+        if len(sourceBones) < 3 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]) or not rt.isValidNode(sourceBones[2]):
+            return None
+            
+        # 파라미터 가져오기 (또는 기본값 사용)
+        liftScale = parameters[0] if len(parameters) > 0 else 0.05
+        kneePopScale = parameters[1] if len(parameters) > 1 else 0.1
+        kneeBackScale = parameters[2] if len(parameters) > 2 else 1.5
+        
+        # 무릎 본 생성
+        inThigh = sourceBones[0]
+        inCalf = sourceBones[1]
+        inFoot = sourceBones[2]
+        
+        # 새로운 자동 무릎 본 생성
+        return self.create_bone(inThigh, inCalf, inFoot, liftScale, kneePopScale, kneeBackScale)
     
     def reset(self):
         """

pyjallib/max/macro/jal_macro_bone.py

@@ -273,7 +273,7 @@ def jal_bone_nub_create():
         for item in non_bone_array:
             jal.bone.create_nub_bone_on_obj(item)
     else:
-        jal.bone.create_nub_bone("Temp Nub", 2)
+        jal.bone.create_nub_bone("Temp", 2)
 
 # Register macroscripts
 macroScript_Category = "jalTools"

pyjallib/max/twistBone.py

@@ -19,6 +19,8 @@ from .constraint import Constraint
 from .bip import Bip
 from .bone import Bone
 
+from .boneChain import BoneChain
+
 
 class TwistBone:
     """
@@ -121,12 +123,7 @@ class TwistBone:
             twistNum (int, optional): 생성할 트위스트 뼈대의 개수. 기본값은 4입니다.
         
         Returns:
-            dict: 생성된 트위스트 뼈대 정보를 담고 있는 사전 객체입니다.
-                 "Bones": 생성된 뼈대 객체들의 배열
-                 "Type": "Upper" (상체 타입)
-                 "Limb": 부모 객체 참조
-                 "Child": 자식 객체 참조
-                 "TwistNum": 생성된 트위스트 뼈대 개수
+            BoneChain: 생성된 트위스트 뼈대 BoneChain 객체
         """
         limb = inObj
         distance = rt.distance(limb, inChild)
@@ -134,7 +131,6 @@ class TwistBone:
         inObjXAxisVec = inObj.objectTransform.row1
         distanceDir = 1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else -1.0
         offssetAmount = (distance / twistNum) * distanceDir
-        weightVal = 100.0 / (twistNum-1)
         
         boneChainArray = []
         
@@ -172,6 +168,8 @@ class TwistBone:
             lastBone.parent = limb
             self.anim.move_local(lastBone, offssetAmount*(twistNum-1), 0, 0)
             
+            weightVal = 100.0 / (twistNum-1)
+            
             if twistNum > 2:
                 for i in range(1, twistNum-1):
                     twistExtraBone = self.bone.create_nub_bone(boneName, 2)
@@ -197,25 +195,18 @@ class TwistBone:
             
             boneChainArray.append(lastBone)
         
-        # 결과를 멤버 변수에 저장
-        self.limb = inObj
-        self.child = inChild
-        self.twistNum = twistNum
-        self.bones = boneChainArray
-        self.twistType = "Upper"
-        
-        returnVal = {
+        # 결과를 BoneChain 형태로 준비
+        result = {
             "Bones": boneChainArray,
-            "Type": "Upper",
-            "Limb": inObj,
-            "Child": inChild,
-            "TwistNum": twistNum
+            "Helpers": [],
+            "SourceBones": [inObj, inChild],
+            "Parameters": [twistNum, "Upper"]
         }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return returnVal
+        return BoneChain.from_result(result)
 
     def create_lower_limb_bones(self, inObj, inChild, twistNum=4):
         """
@@ -231,12 +222,7 @@ class TwistBone:
             twistNum (int, optional): 생성할 트위스트 뼈대의 개수. 기본값은 4입니다.
         
         Returns:
-            dict: 생성된 트위스트 뼈대 정보를 담고 있는 사전 객체입니다.
-                 "Bones": 생성된 뼈대 객체들의 배열
-                 "Type": "Lower" (하체 타입)
-                 "Limb": 부모 객체 참조
-                 "Child": 자식 객체 참조
-                 "TwistNum": 생성된 트위스트 뼈대 개수
+            BoneChain: 생성된 트위스트 뼈대 BoneChain 객체
         """
         limb = inChild
         distance = rt.distance(inObj, inChild)
@@ -244,7 +230,6 @@ class TwistBone:
         inObjXAxisVec = inObj.objectTransform.row1
         distanceDir = 1.0 if rt.dot(inObjXAxisVec, facingDirVec) > 0 else -1.0
         offssetAmount = (distance / twistNum) * distanceDir
-        weightVal = 100.0 / (twistNum-1)
         
         boneChainArray = []
         
@@ -281,6 +266,8 @@ class TwistBone:
             lastBone.parent = inObj
             self.anim.move_local(lastBone, 0, 0, 0)
             
+            weightVal = 100.0 / (twistNum-1)
+            
             if twistNum > 2:
                 for i in range(1, twistNum-1):
                     twistExtraBone = self.bone.create_nub_bone(boneName, 2)
@@ -306,22 +293,54 @@ class TwistBone:
             
             boneChainArray.append(lastBone)
         
-        # 결과를 멤버 변수에 저장
-        self.limb = inObj
-        self.child = inChild
-        self.twistNum = twistNum
-        self.bones = boneChainArray
-        self.twistType = "Lower"
-        
-        returnVal = {
+        # 결과를 BoneChain 형태로 준비
+        result = {
             "Bones": boneChainArray,
-            "Type": "Lower",
-            "Limb": inObj,
-            "Child": inChild,
-            "TwistNum": twistNum
+            "Helpers": [],
+            "SourceBones": [inObj, inChild],
+            "Parameters": [twistNum, "Lower"]
         }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return returnVal
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 트위스트 본을 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 트위스트 본 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): 트위스트 본 정보를 포함한 BoneChain 객체
+        
+        Returns:
+            BoneChain: 업데이트된 BoneChain 객체 또는 실패 시 None
+        """
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+            
+        # 기존 객체 삭제
+        inBoneChain.delete()
+            
+        # BoneChain에서 필요한 정보 추출
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        # 필수 소스 본 확인
+        if len(sourceBones) < 2 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]):
+            return None
+            
+        # 파라미터 가져오기 (또는 기본값 사용)
+        twistNum = parameters[0] if len(parameters) > 0 else 4
+        twistType = parameters[1] if len(parameters) > 1 else "Upper"
+        
+        # 본 생성
+        inObj = sourceBones[0]
+        inChild = sourceBones[1]
+        
+        # 타입에 따라 적절한 방식으로 트위스트 본 생성
+        if twistType == "Upper":
+            return self.create_upper_limb_bones(inObj, inChild, twistNum)
+        else:
+            return self.create_lower_limb_bones(inObj, inChild, twistNum)

pyjallib/max/volumeBone.py

@@ -18,6 +18,8 @@ from .helper import Helper
 from .bone import Bone
 from .constraint import Constraint
 
+from .boneChain import BoneChain
+
 
 class VolumeBone:  # Updated class name to match the new file name
     """
@@ -69,8 +71,8 @@ class VolumeBone:  # Updated class name to match the new file name
             "\n"
             "q = localDeltaTm.rotation\n"
             "\n"
-            "eulerRot = (quatToEuler q order:6)\n"
-            "swizzledRot = (eulerAngles eulerRot.z eulerRot.y eulerRot.x)\n"
+            "eulerRot = (quatToEuler q order:5)\n"
+            "swizzledRot = (eulerAngles eulerRot.y eulerRot.z eulerRot.x)\n"
             "saturatedTwist = abs ((swizzledRot.x*axis.x + swizzledRot.y*axis.y + swizzledRot.z*axis.z)/180.0)\n"
             "\n"
             "trAxis * saturatedTwist * volumeSize * transScale\n"
@@ -213,7 +215,7 @@ class VolumeBone:  # Updated class name to match the new file name
             inTransScales: 변환 비율 리스트
         
         Returns:
-            dict: VolumeBoneChain 생성을 위한 결과 딕셔너리
+            BoneChain: 생성된 볼륨 본 체인 객체
         """
         if rt.isValidNode(inObj) == False or rt.isValidNode(inParent) == False:
             return None
@@ -242,32 +244,81 @@ class VolumeBone:  # Updated class name to match the new file name
             if rt.isValidNode(volBone):
                 bones.append(volBone)
         
-        # 클래스 변수에 결과 저장
-        self.rootBone = rootBone
-        self.limb = inObj
-        self.limbParent = inParent
-        self.bones = bones
-        self.rotAxises = inRotAxises.copy()
-        self.transAxises = inTransAxises.copy()
-        self.transScales = inTransScales.copy()
-        self.volumeSize = inVolumeSize
-        self.rotScale = inRotScale
-        
-        # VolumeBoneChain이 필요로 하는 형태의 결과 딕셔너리 생성
+        # 모든 생성된 본들 모음
+        all_bones = [rootBone] + bones
+        rotHelper = self.rotHelper
+        
+        # BoneChain에 필요한 형태의 결과 딕셔너리 생성
         result = {
-            "RootBone": rootBone,
-            "RotHelper": self.rotHelper,
-            "RotScale": inRotScale,
-            "Limb": inObj,
-            "LimbParent": inParent,
-            "Bones": bones,
-            "RotAxises": inRotAxises,
-            "TransAxises": inTransAxises,
-            "TransScales": inTransScales,
-            "VolumeSize": inVolumeSize
+            "Bones": all_bones,
+            "Helpers": [rotHelper],
+            "SourceBones": [inObj, inParent],
+            "Parameters": [inRotScale, inVolumeSize] + inRotAxises + inTransAxises + inTransScales
         }
         
         # 메소드 호출 후 데이터 초기화
         self.reset()
         
-        return result
+        return BoneChain.from_result(result)
+    
+    def create_bones_from_chain(self, inBoneChain: BoneChain):
+        """
+        기존 BoneChain 객체에서 볼륨 본을 생성합니다.
+        기존 설정을 복원하거나 저장된 데이터에서 볼륨 본 셋업을 재생성할 때 사용합니다.
+        
+        Args:
+            inBoneChain (BoneChain): 볼륨 본 정보를 포함한 BoneChain 객체
+        
+        Returns:
+            BoneChain: 업데이트된 BoneChain 객체 또는 실패 시 None
+        """
+        if not inBoneChain or inBoneChain.is_empty():
+            return None
+            
+        # 기존 객체 삭제
+        inBoneChain.delete()
+            
+        # BoneChain에서 필요한 정보 추출
+        sourceBones = inBoneChain.sourceBones
+        parameters = inBoneChain.parameters
+        
+        # 필수 소스 본 확인
+        if len(sourceBones) < 2 or not rt.isValidNode(sourceBones[0]) or not rt.isValidNode(sourceBones[1]):
+            return None
+        
+        # 최소 필요 파라미터 확인
+        if len(parameters) < 2:
+            return None
+            
+        # 파라미터 가져오기
+        inRotScale = parameters[0]
+        inVolumeSize = parameters[1]
+        
+        # 회전축, 변환축, 변환비율을 파라미터에서 추출
+        # 최소한 하나의 축 세트는 필요
+        param_count = len(parameters)
+        if param_count <= 2:
+            # 기본 값 사용
+            inRotAxises = ["Z"]
+            inTransAxises = ["PosY"]
+            inTransScales = [1.0]
+        else:
+            # 파라미터 중간을 3등분하여 각 목록 추출
+            axis_count = (param_count - 2) // 3
+            
+            inRotAxises = parameters[2:2+axis_count]
+            inTransAxises = parameters[2+axis_count:2+axis_count*2]
+            inTransScales = parameters[2+axis_count*2:2+axis_count*3]
+            
+            # 리스트 길이가 일치하지 않으면 기본값으로 보완
+            if len(inRotAxises) != len(inTransAxises) or len(inRotAxises) != len(inTransScales):
+                min_len = min(len(inRotAxises), len(inTransAxises), len(inTransScales))
+                inRotAxises = inRotAxises[:min_len] if min_len > 0 else ["Z"]
+                inTransAxises = inTransAxises[:min_len] if min_len > 0 else ["PosY"]
+                inTransScales = inTransScales[:min_len] if min_len > 0 else [1.0]
+            
+        # 새로운 볼륨 본 생성
+        inObj = sourceBones[0]
+        inParent = sourceBones[1]
+        
+        return self.create_bones(inObj, inParent, inRotScale, inVolumeSize, inRotAxises, inTransAxises, inTransScales)

pyjallib/naming.py

@@ -494,7 +494,7 @@ class Naming:
         for part in self._nameParts:
             partName = part.get_name()
             partType = part.get_type()
-            if partType != NamePartType.REALNAME:
+            if partType.value != NamePartType.REALNAME.value:
                 foundName = self.get_name(partName, inStr)
                 nonRealNameArray.append(foundName)
         

pyjallib/perforce.py

@@ -283,6 +283,36 @@ class Perforce:
             bool: 체크아웃 성공 시 True, 실패 시 False
         """
         return self._file_op("edit", file_path, change_list_number, "체크아웃")
+        
+    def checkout_files(self, file_paths: list, change_list_number: int) -> bool:
+        """여러 파일을 한 번에 체크아웃합니다.
+        
+        Args:
+            file_paths (list): 체크아웃할 파일 경로 리스트
+            change_list_number (int): 체인지 리스트 번호
+            
+        Returns:
+            bool: 모든 파일 체크아웃 성공 시 True, 하나라도 실패 시 False
+        """
+        if not file_paths:
+            logger.debug("체크아웃할 파일 목록이 비어있습니다.")
+            return True
+            
+        logger.info(f"체인지 리스트 {change_list_number}에 {len(file_paths)}개 파일 체크아웃 시도...")
+        
+        all_success = True
+        for file_path in file_paths:
+            success = self.checkout_file(file_path, change_list_number)
+            if not success:
+                all_success = False
+                logger.warning(f"파일 '{file_path}' 체크아웃 실패")
+                
+        if all_success:
+            logger.info(f"모든 파일({len(file_paths)}개)을 체인지 리스트 {change_list_number}에 성공적으로 체크아웃했습니다.")
+        else:
+            logger.warning(f"일부 파일을 체인지 리스트 {change_list_number}에 체크아웃하지 못했습니다.")
+            
+        return all_success
 
     def add_file(self, file_path: str, change_list_number: int) -> bool:
         """파일을 추가합니다.
@@ -295,6 +325,36 @@ class Perforce:
             bool: 추가 성공 시 True, 실패 시 False
         """
         return self._file_op("add", file_path, change_list_number, "추가")
+        
+    def add_files(self, file_paths: list, change_list_number: int) -> bool:
+        """여러 파일을 한 번에 추가합니다.
+        
+        Args:
+            file_paths (list): 추가할 파일 경로 리스트
+            change_list_number (int): 체인지 리스트 번호
+            
+        Returns:
+            bool: 모든 파일 추가 성공 시 True, 하나라도 실패 시 False
+        """
+        if not file_paths:
+            logger.debug("추가할 파일 목록이 비어있습니다.")
+            return True
+            
+        logger.info(f"체인지 리스트 {change_list_number}에 {len(file_paths)}개 파일 추가 시도...")
+        
+        all_success = True
+        for file_path in file_paths:
+            success = self.add_file(file_path, change_list_number)
+            if not success:
+                all_success = False
+                logger.warning(f"파일 '{file_path}' 추가 실패")
+                
+        if all_success:
+            logger.info(f"모든 파일({len(file_paths)}개)을 체인지 리스트 {change_list_number}에 성공적으로 추가했습니다.")
+        else:
+            logger.warning(f"일부 파일을 체인지 리스트 {change_list_number}에 추가하지 못했습니다.")
+            
+        return all_success
 
     def delete_file(self, file_path: str, change_list_number: int) -> bool:
         """파일을 삭제합니다.
@@ -307,6 +367,36 @@ class Perforce:
             bool: 삭제 성공 시 True, 실패 시 False
         """
         return self._file_op("delete", file_path, change_list_number, "삭제")
+        
+    def delete_files(self, file_paths: list, change_list_number: int) -> bool:
+        """여러 파일을 한 번에 삭제합니다.
+        
+        Args:
+            file_paths (list): 삭제할 파일 경로 리스트
+            change_list_number (int): 체인지 리스트 번호
+            
+        Returns:
+            bool: 모든 파일 삭제 성공 시 True, 하나라도 실패 시 False
+        """
+        if not file_paths:
+            logger.debug("삭제할 파일 목록이 비어있습니다.")
+            return True
+            
+        logger.info(f"체인지 리스트 {change_list_number}에서 {len(file_paths)}개 파일 삭제 시도...")
+        
+        all_success = True
+        for file_path in file_paths:
+            success = self.delete_file(file_path, change_list_number)
+            if not success:
+                all_success = False
+                logger.warning(f"파일 '{file_path}' 삭제 실패")
+                
+        if all_success:
+            logger.info(f"모든 파일({len(file_paths)}개)을 체인지 리스트 {change_list_number}에서 성공적으로 삭제했습니다.")
+        else:
+            logger.warning(f"일부 파일을 체인지 리스트 {change_list_number}에서 삭제하지 못했습니다.")
+            
+        return all_success
 
     def submit_change_list(self, change_list_number: int) -> bool:
         """체인지 리스트를 제출합니다.
@@ -393,6 +483,28 @@ class Perforce:
             self._handle_p4_exception(e, f"체인지 리스트 {change_list_number} 삭제")
             return False
 
+    def revert_file(self, file_path: str, change_list_number: int) -> bool:
+        """체인지 리스트에서 특정 파일을 되돌립니다.
+
+        Args:
+            file_path (str): 되돌릴 파일 경로
+            change_list_number (int): 체인지 리스트 번호
+
+        Returns:
+            bool: 되돌리기 성공 시 True, 실패 시 False
+        """
+        if not self._is_connected():
+            return False
+            
+        logger.info(f"파일 '{file_path}'을 체인지 리스트 {change_list_number}에서 되돌리기 시도...")
+        try:
+            self.p4.run_revert("-c", change_list_number, file_path)
+            logger.info(f"파일 '{file_path}'를 체인지 리스트 {change_list_number}에서 되돌리기 성공.")
+            return True
+        except P4Exception as e:
+            self._handle_p4_exception(e, f"파일 '{file_path}'를 체인지 리스트 {change_list_number}에서 되돌리기")
+            return False
+
     def revert_files(self, change_list_number: int, file_paths: list) -> bool:
         """체인지 리스트 내의 특정 파일들을 되돌립니다.
 
@@ -401,7 +513,7 @@ class Perforce:
             file_paths (list): 되돌릴 파일 경로 리스트
 
         Returns:
-            bool: 되돌리기 성공 시 True, 실패 시 False
+            bool: 모든 파일 되돌리기 성공 시 True, 하나라도 실패 시 False
         """
         if not self._is_connected():
             return False
@@ -410,14 +522,20 @@ class Perforce:
             return True
             
         logger.info(f"체인지 리스트 {change_list_number}에서 {len(file_paths)}개 파일 되돌리기 시도...")
-        try:
-            for file_path in file_paths:
-                self.p4.run_revert("-c", change_list_number, file_path)
-                logger.info(f"파일 '{file_path}'를 체인지 리스트 {change_list_number}에서 되돌리기 성공.")
-            return True
-        except P4Exception as e:
-            self._handle_p4_exception(e, f"체인지 리스트 {change_list_number}에서 파일 되돌리기")
-            return False
+        
+        all_success = True
+        for file_path in file_paths:
+            success = self.revert_file(file_path, change_list_number)
+            if not success:
+                all_success = False
+                logger.warning(f"파일 '{file_path}' 되돌리기 실패")
+                
+        if all_success:
+            logger.info(f"모든 파일({len(file_paths)}개)을 체인지 리스트 {change_list_number}에서 성공적으로 되돌렸습니다.")
+        else:
+            logger.warning(f"일부 파일을 체인지 리스트 {change_list_number}에서 되돌리지 못했습니다.")
+            
+        return all_success
 
     def check_update_required(self, file_paths: list) -> bool:
         """파일이나 폴더의 업데이트 필요 여부를 확인합니다.

{pyjallib-0.1.10.dist-info → pyjallib-0.1.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyjallib
-Version: 0.1.10
+Version: 0.1.11
 Summary: A utility library for 3D game character development pipelines.
 Author-email: Dongseok Kim <jalnagakds@gmail.com>
 Requires-Python: >=3.10