🐶 WALWAL Code Convention

1️⃣ 코드 레이아웃

1. 들여쓰기 및 띄어쓰기

들여쓰기에는 탭(tab) 대신 2개의 space를 사용합니다.

콜론(:)을 쓸 때에는 콜론의 오른쪽에만 공백을 둡니다.
```
let names: [String: String]?
```
연산자 오버로딩 함수 정의에서는 연산자와 괄호 사이에 한 칸 띄어씁니다.
```
func ** (lhs: Int, rhs: Int)
```

2. 줄바꿈

파라미터 3개 이상일 때, 파라미터 기준으로 줄바꿈합니다.

let actionSheet = UIActionSheet(
  title: "정말 계정을 삭제하실 건가요?",
  delegate: self,
  cancelButtonTitle: "취소",
  destructiveButtonTitle: "삭제해주세요"
)

파라미터에 클로저가 2개 이상 존재하는 경우에는 무조건 내려쓰기합니다.

UIView.animate(
  withDuration: 0.25,
  animations: {
    // doSomething()
  },
  completion: { finished in
    // doSomething()
  }
)

함수를 작성할 땐, 첫 번째 파라미터가 줄바꿈 이후에 위치하도록 합니다.

func animationController(
  forPresented presented: UIViewController,
  presenting: UIViewController,
  source: UIViewController
) -> UIViewControllerAnimatedTransitioning? {
  // doSomething()
}

if let 구문이 길 경우에는 줄바꿈하고 한 칸 들여씁니다.

if let user = self.veryLongFunctionNameWhichReturnsOptionalUser(),
   let name = user.veryLongFunctionNameWhichReturnsOptionalName(),
  user.gender == .female {
  // ...
}

guard let 구문이 길 경우에는 줄바꿈하고 한 칸 들여씁니다. else는 단순 return 인 경우에는 한 줄로 쓰고 else 구문 안에 동작이 있는 경우 줄바꿈합니다. (예시 참고)

guard let user = self.veryLongFunctionNameWhichReturnsOptionalUser(),
      let name = user.veryLongFunctionNameWhichReturnsOptionalName(),
      user.gender == .female else { return }
      
guard let user = self.veryLongFunctionNameWhichReturnsOptionalUser(),
      let name = user.veryLongFunctionNameWhichReturnsOptionalName(),
      user.gender == .female else { 
	      // ...
	      return 
      }

return 전에 줄바꿈하지 않습니다.

3. 빈 줄

빈 줄에는 공백이 포함되지 않도록 합니다.
모든 파일은 빈 줄로 끝나도록 합니다.

MARK 구문 위와 아래에는 공백이 필요합니다.

// MARK: - Layout

override func layoutSubviews() {
  // doSomething()
}

// MARK: - Actions

override func menuButtonDidTap() {
  // doSomething()
}

4. 임포트

내장 프레임워크를 먼저 임포트하고, 빈 줄로 구분하여 서드파티 프레임워크를 임포트합니다.
```
import UIKit

import SwiftyColor
import SwiftyImage
import Then
import URLNavigator
```

2️⃣ 네이밍

1. 클래스와 구조체

클래스와 구조체의 이름에는 UpperCamelCase를 사용합니다.

✅ 좋은 예:

class SomeClass {
  // class definition goes here
} 

struct SomeStructure {
  // structure definition goes here
}

❌ 나쁜 예:

class someClass {
  // class definition goes here
}

struct someStructure {
  // structure definition goes here
}

2. 함수

함수 이름에는 lowerCamelCase를 사용합니다.
함수 이름 앞에는 되도록이면 get, make, set 을 붙이지 않습니다.
함수 이름은 return 값을 변수처럼 사용한다면, 명사로 사용해도 무관

✅ 좋은 예:
```
func name(for user: User) -> String?
```
❌ 나쁜 예:
```
func getName(for user: User) -> String?
```
Action 함수의 네이밍은 '주어 + 동사 + 목적어' 형태를 사용합니다.
- Tap(눌렀다 뗌)*은 UIControlEvents의 .touchUpInside에 대응하고, *Press(누름)*는 .touchDown에 대응합니다.
  1. 동사 과거형으로 (ex. *confirmButtonTapped*)
  2. *will~*은 특정 행위가 일어나기 직전
  3. bool형을 반환하는 함수는 *is~*
✅ 좋은 예:
```
func backButtonDidTap() {
  // ...
}
```
❌ 나쁜 예:
```
func back() {
  // ...
}

func pressBack() {
  // ...
}
```

3. 변수

변수 이름에는 lowerCamelCase를 사용합니다.

4. 상수

상수 이름에는 lowerCamelCase를 사용합니다.

✅ 좋은 예:

let maximumNumberOfLines = 3

❌ 나쁜 예:

let MaximumNumberOfLines = 3
let MAX_LINES = 3

5. 열거형

enum의 이름에는 UpperCamelCase를 사용합니다.
enum의 각 case에는 lowerCamelCase를 사용합니다.

case의 선언부는 라인별 1개의 case를 작정하고, case에 대한 처리가 동일한 경우에는 한 줄에 여러 case에 대한 경우를 처리

✅ 좋은 예:

enum Result {
  
  case signUp(body: String)
  case signIn
  
  var httpMethod: {
	switch self {
	case .signUp, .signIn:
	  return .POST
	}
  }
}

❌ 나쁜 예:

enum Result {
  case .Success
  case .Failure
}

enum result {
  case .Success
  case .Failure
}

6. 프로토콜

프로토콜의 이름에는 UpperCamelCase를 사용합니다.
구조체나 클래스에서 프로토콜을 채택할 때는 콜론과 빈칸을 넣어 구분하여 명시합니다.
extension을 통해 채택할 때도 동일하게 적용됩니다.

protocol의 suffix는 ~Protocol로 통일합니다.

✅ 좋은 예:

protocol SomeProtocol {
  // protocol definition goes here
}

struct SomeStructure: SomeProtocol, AnotherProtocol {
  // structure definition goes here
}

class SomeClass: SomeSuperclass, SomeProtocol, AnotherProtocol {
  // class definition goes here
}

extension UIViewController: SomeProtocol, AnotherProtocol {
  // doSomething()
}

7. 약어

약어로 시작하는 경우(prefix의 경우) 소문자로 표기하고, 그 외의 경우에는 항상 대문자로 표기합니다.

✅ 좋은 예:

let userID: Int?
let html: String?
let websiteURL: URL?
let urlString: String?

❌ 나쁜 예:

let userId: Int?
let HTML: String?
let websiteUrl: NSURL?
let URLString: String?

8. Delegate

Delegate 메서드는 프로토콜명으로 네임스페이스를 구분합니다.

ex) UserCellDelegate → 내부 함수의 prefix는 UserCell

✅ 좋은 예:

protocol UserCellDelegate {
  func userCellDidSetProfileImage(_ cell: UserCell)
  func userCell(_ cell: UserCell, didTapFollowButtonWith user: User)
}

❌ 나쁜 예:

protocol UserCellDelegate {
  func didSetProfileImage()
  func followPressed(user: User)

  // `UserCell`이라는 클래스가 존재할 경우 컴파일 에러 발생
  func UserCell(_ cell: UserCell, didTapFollowButtonWith user: User)
}

9. 클로저

파라미터와 리턴 타입이 없는 Closure 정의시에는 () -> Void를 사용합니다.

✅ 좋은 예:
```
let completionBlock: (() -> Void)?
```
❌ 나쁜 예:
```
let completionBlock: (() -> ())?let completionBlock: ((Void) -> (Void))?
```
Closure 정의시 파라미터에는 괄호를 사용하지 않습니다. Rx 내부 클로저에서도 적용됩니다.

✅ 좋은 예:
```
{ operation, responseObject in
  // doSomething()
}
```
❌ 나쁜 예:
```
{ (operation, responseObject) in
  // doSomething()
}
```

Closure 정의시 가능한 경우 타입 정의를 생략합니다.

✅ 좋은 예:

...,
completion: { finished in
  // doSomething()
}

❌ 나쁜 예:

...,
completion: { (finished: Bool) -> Void in
  // doSomething()
}

Closure 호출시 또다른 유일한 Closure를 마지막 파라미터로 받는 경우, 파라미터 이름을 생략합니다.

✅ 좋은 예:
```
UIView.animate(withDuration: 0.5) {
  // doSomething()
}
```
❌ 나쁜 예:
```
UIView.animate(withDuration: 0.5, animations: { () -> Void in
  // doSomething()
})
```

3️⃣ 클래스와 구조체

구조체를 생성할 때에는 Swift 구조체 생성자를 사용합니다.

✅ 좋은 예:

let frame = CGRect(x: 0, y: 0, width: 100, height: 100)

❌ 나쁜 예:

let frame = CGRectMake(0, 0, 100, 100)

1. 타입

Array<T>와 Dictionary<T: U> 보다는 [T], [T: U]를 사용합니다.

✅ 좋은 예:

var messages: [String]?
var names: [Int: String]?

❌ 나쁜 예:

var messages: Array<String>?
var names: Dictionary<Int, String>?

2. 주석

///를 사용해서 문서화에 사용되는 주석을 남깁니다.

/// 사용자 프로필을 그려주는 뷰
class ProfileView: UIView {

  /// 사용자 닉네임을 그려주는 라벨
  var nameLabel: UILabel!
}

// MARK: 를 사용해서 연관된 코드를 구분짓습니다.
Objective-C에서 제공하는 #pragma mark와 같은 기능으로, 연관된 코드와 그렇지 않은 코드를 구분할 때 사용합니다.

// MARK: - Init

override init(frame: CGRect) {
  // doSomething()
}

deinit {
  // doSomething()
}

// MARK: - Layout

override func layoutSubviews() {
  // doSomething()
}

// MARK: - Actions

override func menuButtonDidTap() {
  // doSomething()
}

4️⃣ 프로그래밍 권장사항

가능하다면 변수를 정의할 때 함께 초기화하도록 합니다. Then을 사용하면 초기화와 함께 속성을 지정할 수 있습니다.
```
let label = UILabel().then {
  $0.textAlignment = .center
  $0.textColor = .black
  $0.text = "Hello, World!"
}
```

상수를 정의할 때에는 enum를 만들어 비슷한 상수끼리 모아둡니다. 재사용성과 유지보수 측면에서 큰 향상을 가져옵니다. struct 대신 enum을 사용하는 이유는, 생성자가 제공되지 않는 자료형을 사용하기 위해서입니다. CGFloatLiteral과 SwiftyColor를 사용해서 코드를 단순화시킵니다.

final class ProfileViewController: UIViewController {

  private enum Metric {
    static let profileImageViewLeft = 10.f
    static let profileImageViewRight = 10.f
    static let nameLabelTopBottom = 8.f
    static let bioLabelTop = 6.f
  }

  private enum Font {
    static let nameLabel = UIFont.boldSystemFont(ofSize: 14)
    static let bioLabel = UIFont.boldSystemFont(ofSize: 12)
  }

  private enum Color {
    static let nameLabelText = 0x000000.color
    static let bioLabelText = 0x333333.color ~ 70%
  }

}

이렇게 선언된 상수들은 다음과 같이 사용될 수 있습니다.

self.profileImageView.frame.origin.x = Metric.profileImageViewLeft
self.nameLabel.font = Font.nameLabel
self.nameLabel.textColor = Color.nameLabelText

더이상 상속이 발생하지 않는 클래스는 항상 final 키워드로 선언합니다.
프로토콜을 적용할 때에는 extension을 만들어서 관련된 메서드를 모아둡니다.

private method는 extension으로 분리합니다.

✅ 좋은 예:

final class MyViewController: UIViewController {
  // ...
}

// MARK: - UITableViewDataSource

extension MyViewController: UITableViewDataSource {
  // ...
}

// MARK: - UITableViewDelegate

extension MyViewController: UITableViewDelegate {
  // ...
}

// MARK: - Private Method

extension MyViewController {
  private func goHome() {
	/// do something
  }
}

❌ 나쁜 예:

final class MyViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
  // ...
}

5️⃣ Rx 컨벤션

1. RxCocoa 에서의 체이닝

구문의 첫번째 Operator 기준으로 줄을 바꿉니다.

comfirmButton.rx.tap
  .map{ }
  .bind()
  .disposed(by: disposeBag)

buttonTapped
  .map { Reactor.Action.tapped }
  .bind(to: reactor.action)
  .disposed(by: disposeBag)	

reactor.state
  .map { $0.id }	
  .disposed(by: disposeBag)
	
input.settingButtonTapped
  .withUnretained(self)
  .subscribe(onNext: { owner, _ in
    owner.coordinator?.destination.accept(.myPage)
  })
  .disposed(by: disposeBag)

2. withUnretained()

.withUnretained(self)는 drive에 사용할 수 없습니다.
따라서.drive(with: self), .subscribe(with: self)을 사용하도록 합니다.

self를 지칭하는 변수는 owner로 작성합니다.

✅ 좋은 예:

reactor.state
  .map { $0.logoutSuccess }
  .filter { $0 }
  .asDriver(onErrorJustReturn: false)
  .drive(with: self) { owner, _ in
  
  }
  .disposed(by: disposeBag)

3. Rx Extension

// Case 1
extension Reactive where Base: CustomButton {
  public var tap: ControlEvent<Void> {
    let source: Observable<Void> = self.base.rx.tapGesture()
      .when(.recognized)
      .map { _ in () }
    	return ControlEvent(events: source)
    }
  }
    
 // Case 2
extension Reactive where Base: UIView {
  public var tapped() -> ControlEvent<Void> {
    let source = self.base.rx.tapGesture().when(.recognized).map { _ in }
      return ControlEvent(events: source)
    }
  }

StyleShare 가이드를 참고하여 작성하였습니다. 🔗StyleShare Guide

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🐶 WALWAL Code Convention

1️⃣ 코드 레이아웃

1. 들여쓰기 및 띄어쓰기

2. 줄바꿈

3. 빈 줄

4. 임포트

2️⃣ 네이밍

1. 클래스와 구조체

2. 함수

3. 변수

4. 상수

5. 열거형

6. 프로토콜

7. 약어

8. Delegate

9. 클로저

3️⃣ 클래스와 구조체

1. 타입

2. 주석

4️⃣ 프로그래밍 권장사항

5️⃣ Rx 컨벤션

1. RxCocoa 에서의 체이닝

2. withUnretained()

3. Rx Extension

Clone this wiki locally