Tuist 모듈 자동화 CLI 자동화 만들기
tuisttool.swift 만든 썰 — Tuist 명령어 치다가 손가락 아파서 만듦
이 글을 쓰게 된 계기
안녕하세요! iOS 운영진 서원지입니다 ㅋㅋㅋ
Tuist 쓰다 보면 이런 거 계속 치잖아요:
tuist generate
tuist fetch
tuist clean
tuist generate
하루에 몇 번을 치는지 모르겠어요… 손가락 아파 죽겠음 �
그래서 그냥 CLI 도구를 만들어버렸습니다!
만들고 싶었던 기능들
tuist generate, fetch, clean 등 한 방에 실행
새 모듈 만들 때 의존성 선택지 자동으로 보여주기
Modules.swift, SPM.swift 파싱해서 뭐 있는지 알아서 찾기
도메인 모듈이면 Interface 폴더도 자동 생성
이거 다 구현했어요! ㅋㅋㅋ
명령어 정리
./tuisttool.swift generate # tuist generate
./tuisttool.swift fetch # tuist fetch
./tuisttool.swift build # clean + fetch + generate (한 방에!)
./tuisttool.swift clean # tuist clean
./tuisttool.swift reset # DerivedData + 캐시 싹 지우고 generate
./tuisttool.swift moduleinit # 새 모듈 만들기 + 의존성 자동 삽입
build 이거 진짜 편해요. 세 개 따로 안 쳐도 됨! �
핵심 구현 포인트
1. 쉘 명령 실행하는 함수
func run(_ command: String, arguments: [String] = []) -> Int32
func runCapture(_ command: String, arguments: [String] = []) throws -> String
run(): 그냥 실행만 하면 될 때
runCapture(): 결과 값 받아야 할 때
이거 두 개만 있으면 웬만한 건 다 됨!
2. 모듈 이름이랑 의존성 입력받기
let moduleInput = prompt("모듈 이름 입력")
let moduleName = prompt("생성할 이름 입력")
의존성은 두 가지 방식으로 선택 가능하게 했어요:
SPM: Extension+TargetDependencySPM.swift 파싱해서 목록 보여줌
내부 모듈: Modules.swift에서 enum case 파싱해서 보여줌
직접 타이핑 안 해도 됨! 선택만 하면 됨! �
3. Tuist scaffold 실행
let result = run("tuist", arguments: [
"scaffold", "Module",
"--layer", layer,
"--name", moduleName,
"--author", author,
"--current-date", currentDate
])
모듈 타입(Presentation, Shared, Core/Domain)에 따라 layer 자동 지정!
4. Project.swift에 의존성 자동 삽입
이게 제일 귀찮았던 부분인데요:
if var content = try? String(contentsOfFile: projectFile),
let range = content.range(of: "dependencies: [") {
...
content.insert(contentsOf: " .SPM.alerter", at: insertIndex)
}
모듈 만들고 나서 Project.swift 열어서 의존성 추가하는 거...
이제 자동으로 넣어줌! ㅋㅋㅋ
5. 도메인 모듈이면 Interface 폴더도 자동 생성
도메인 모듈은 Interface 분리하잖아요?
그것도 자동으로 만들어줍니다:
Projects/Core/Domain/MyModule/Interface/Sources/Base.swift
템플릿까지 같이 생성! 손 안 대도 됨!
생성되는 구조
Projects/
└── Core/
└── Domain/
└── MyFeature/
├── Interface/
│ └── Sources/
│ └── Base.swift
└── Sources/
깔끔하죠? ㅋㅋㅋ
삽질 포인트
파일 파싱할 때 주의
Modules.swift 파싱할 때 정규식 잘못 쓰면 이상한 거 잡혀요.
enum case만 정확히 잡으려고 꽤 고생했음 ㅠㅠ
경로 처리
상대 경로 / 절대 경로 헷갈리면 파일 못 찾음.
FileManager.default.currentDirectoryPath 잘 활용하세요!
마무리
모듈 자주 만드는 분들한테 강추예요!
반복 작업 도구화하면 생산성 확 올라감!
Tuist가 구조화 잘 되어 있어서, 거기에 CLI 도구 얹으면 시너지 대박이에요.
팀원들이랑 같이 쓰면 더 좋고요
저도 계속 기능 추가할 예정입니다!
다음 글 예고: Tuist Plugin 만들기 다뤄볼 예정입니다!
작성자: iOS 운영진 서원지
GitHub: https://github.com/Roy-wonji