GitHub 오픈소스 탐험

Swift는 현대 애플 생태계에서 가장 인기 있는 프로그래밍 언어 중 하나이며, 그만큼 코드의 가독성과 일관성을 유지하는 것이 매우 중요합니다. 하지만 개발자들은 종종 코드 스타일에 대한 고민에 빠지곤 합니다. 이럴 때 유용한 도구가 바로 SwiftForma입니다. SwiftForma는 커맨드라인 도구이자 Xcode 확장으로, Swift 코드를 자동으로 포맷팅해주는 기능을 제공합니다. 이번 블로그 글에서는 SwiftForma의 주요 기능, 설치 방법, 사용법을 알아보겠습니다.

SwiftForma의 주요 기능과 특징

SwiftForma는 다음과 같은 주요 기능을 제공합니다:

자동 코드 포맷팅: Swift 코드의 스타일을 일관되게 유지해줍니다. 이를 통해 코드 리뷰 과정에서 발생할 수 있는 불필요한 논쟁을 줄일 수 있습니다.
Xcode 통합: Xcode의 확장으로 설치하면, Xcode 내에서 바로 사용할 수 있어 개발 흐름을 끊지 않고도 코드 포맷팅이 가능합니다.
커스터마이징 가능성: 필요에 따라 포맷팅 규칙을 커스터마이즈할 수 있어, 팀의 코드 스타일에 맞게 설정할 수 있습니다.
커맨드라인 도구: 명령어를 통해 손쉽게 여러 파일을 한 번에 포맷팅할 수 있어, 대규모 프로젝트에서도 효율적으로 사용할 수 있습니다.

설치 방법

SwiftForma를 설치하는 방법은 매우 간단합니다. 커맨드라인에서 다음 명령어를 입력하면 됩니다.

brew install nicklockwood/formulae/swiftformat

위 명령어는 Homebrew를 통해 SwiftForma를 설치합니다. Homebrew가 설치되어 있지 않다면, Homebrew 공식 웹사이트에서 설치 방법을 확인하세요.

SwiftForma 기본 사용법

SwiftForma를 설치한 후, 다음과 같이 기본적인 포맷팅을 사용할 수 있습니다.

커맨드라인에서 사용하기

swiftformat <파일 또는 디렉토리 경로>

예를 들어, 현재 디렉토리의 모든 Swift 파일을 포맷팅하고 싶다면 다음 명령어를 입력합니다:

swiftformat .

Xcode에서 사용하기

Xcode에서 SwiftForma를 사용하려면, Xcode를 열고 Preferences > Extensions에서 SwiftForma를 활성화합니다. 이후, 포맷팅하고 싶은 코드를 선택한 다음, Editor > Format 메뉴를 선택하면 됩니다.

실무에서의 활용 시나리오

팀 프로젝트에서 여러 개발자가 동시에 작업할 경우, 코드 스타일에 대한 합의가 어려워질 수 있습니다. 이때 SwiftForma를 사용하면 각 개발자가 작성한 코드가 통일된 스타일로 자동 포맷팅되어, 코드 리뷰 과정이 한층 수월해집니다. 또한, CI/CD 파이프라인에 통합하여, 코드가 메인 브랜치에 머지되기 전에 자동으로 포맷팅되도록 설정할 수도 있습니다. 이러한 자동화는 개발자들의 시간을 절약하고, 코드 품질을 높이는 데 큰 도움이 됩니다.

비슷한 도구와 비교

SwiftForma와 비슷한 도구로는 SwiftLint와 SwiftFormat가 있습니다.

SwiftLint: 코드 스타일을 검사하고, 규칙을 위반한 부분을 경고합니다. 하지만, 코드 수정은 수동으로 해야 하므로 포맷팅과는 다른 목적을 가지고 있습니다.
SwiftFormat: SwiftForma와 비슷하지만, 최근 SwiftForma가 더 적극적으로 업데이트되고 있어 대체 도구로 주목받고 있습니다.

Swift 코드 포맷팅을 쉽게! SwiftForma로 시작해보세요