Core Module (krenamer.core)

KRenamer Core Engine - Korean File processing and renaming logic

class krenamer.core.RenameEngine

기반 클래스: object

한국어 파일 이름 변경 엔진

KRenamer의 핵심 파일 처리 엔진으로, 다양한 조건과 패턴을 사용하여 파일명을 일괄 변경하는 기능을 제공합니다.

주요 기능:

• 접두사/접미사 추가

• 순차 번호 매기기

• 찾기/바꾸기

• 정규식 패턴 매칭

• 조건부 필터링 (크기, 날짜, 확장자)

• 대소문자 변환 및 특수문자 처리

files

처리할 파일 경로 목록

Type:

list

method

기본 이름 변경 방식 (‘prefix’, ‘suffix’, ‘number’, ‘replace’)

Type:

str

use_regex

정규식 사용 여부

Type:

bool

use_size_condition

파일 크기 조건 사용 여부

Type:

bool

use_date_condition

날짜 조건 사용 여부

Type:

bool

use_ext_condition

확장자 조건 사용 여부

Type:

bool

예제

>>> engine = RenameEngine()
>>> engine.add_files(['photo1.jpg', 'photo2.jpg'])
>>> engine.set_basic_rename_options('prefix', text='vacation_')
>>> plan = engine.generate_rename_plan()
>>> success_count, errors = engine.execute_rename(plan)

__init__()

add_files(file_paths)

파일 목록에 파일들을 추가합니다.

매개변수:

file_paths (list or str) – 추가할 파일 경로들 (문자열 또는 리스트)

반환:

실제로 추가된 파일 개수

반환 형식:

int

참고

• 중복 파일은 추가되지 않습니다

• 존재하지 않는 파일은 무시됩니다

• 폴더의 경우 내부 파일들이 재귀적으로 추가됩니다

remove_files_by_indices(indices)

지정된 인덱스의 파일들을 목록에서 제거합니다.

매개변수:

indices (list) – 제거할 파일들의 인덱스 리스트

참고

인덱스는 역순으로 정렬되어 처리됩니다.

clear_files()

파일 목록을 모두 비웁니다.

matches_conditions(file_path)

파일이 설정된 모든 조건을 만족하는지 확인합니다.

매개변수:

file_path (str) – 검사할 파일 경로

반환:

모든 조건을 만족하면 True, 하나라도 만족하지 않으면 False

반환 형식:

bool

참고

다음 조건들을 검사합니다:

• 파일 크기 조건 (use_size_condition이 True인 경우)

• 수정 날짜 조건 (use_date_condition이 True인 경우)

• 확장자 조건 (use_ext_condition이 True인 경우)

apply_transformations(name)

파일명에 변환 규칙 적용

generate_new_name(file_path, index)

단일 파일의 새 이름 생성

generate_rename_plan()

이름 변경 계획 생성

execute_rename()

이름 변경 실행