[iOS/Framework] Quick/Nimble이 뭘까? (feat. 사용법)

안녕하세요 Foma 💻  입니다!

 

테스트 주도 개발을 찾아보다가 우연히 많은 개발자분들이 Quick과 Nimble을 사용하고 있다는 것을

 

알게 되었습니다.

 

그래서 오늘은 Quick과 Nimble이 어떤 것이고 어떻게 사용하는지 알아보려고 합니다.

 

바로 시작할게요~

---

Quick

 

먼저 Quick은 아래와 같이 자신들을 소개하고 있습니다.

 

RSpec, Specta,Ginkgo에서 영감을 받은  Swift 및 Objective-C를 위한 행동 중심 개발 프레임워크입니다. 

 

즉 iOS 전용 BDD 프레임워크라는 것이죠.

 

정말 놀랍게도 한국어 버전으로 문서가 제공되어 있어 구체적으로 궁금하신 분들은 여기에서 읽어보시길 바랍니다.

 

GitHub - Quick/Quick: The Swift (and Objective-C) testing framework.

---

Nimble

 

Nimble은 아래와 같이 자신들을 소개합니다.

 

Cedar에서 영감을 받은 Swift 및 Objective-C 표현식의 예상 결과를 나타내주는 Matcher 프레임워크입니다.

 

즉, XCTest에서 Assertion을 더욱 편리하게 쓸 수 있도록 하는 프레임워크입니다.

 

Nimble은 Apple에서 제공하는 XCTest Assertion에서 단점을 극복하기 위해 만들어졌는데요.

 

1. 충분하지 않은 매크로 

 

XCTest Assertion에는 문자열에 특정 하위 문자열이 포함되거나 숫자가 다른 문자열보다 작거나 같다고 하는 방법이 없습니다.

 

2. 비동기 테스트 작성의 어려움

 

XCTest를 사용하면 많은 상용구 코드를 작성해야 합니다.

 

이 두가지 외에도 정말 많은 이점이 있는데 여기서 다 소개는 못드려서 아래에 링크를 남겨놓겠습니다.

 

GitHub - Quick/Nimble: A Matcher Framework for Swift and Objective-C

---

Example

 

Quick과 Nimble을 사용하는 예제로 영화 목록을 테이블뷰에 띄우는 간단한 프로젝트를 테스트 해보겠습니다.

---

Storyboard

 

뷰컨트롤러에 테이블뷰를 세팅해줍니다.

 

 

테이블뷰 스타일은 Right Detail로 해주시고 Identifier는 MovieTableViewCell로 해주세요.

 

---

Movie

 

영화 모델을 만들어줍니다.

 

struct Movie {
    var title: String
    var genre: Genre
    
    func genreString() -> String {
        switch genre {
        case .Action:
            return "Action"
        case .Animation:
            return "Animation"
        default:
            return "None"
        }
    }
}

---

Genre

 

영화 장르를 enum으로 나열해줍니다.

 

enum Genre: Int {
    case Animation
    case Action
    case None
}

---

MoviesDataHelper

 

영화 제목과 장르가 담겨있는 데이터를 미리 만들어놓습니다.

 

class MoviesDataHelper {
    static func getMovies() -> [Movie] {
        return [
            Movie(title: "The Emoji Movie", genre: .Animation),
            Movie(title: "Logan", genre: .Action),
            Movie(title: "Wonder Woman", genre: .Action),
            Movie(title: "Zootopia", genre: .Animation),
            Movie(title: "The Baby Boss", genre: .Animation),
            Movie(title: "Despicable Me 3", genre: .Animation),
            Movie(title: "Spiderman: Homecoming", genre: .Action),
            Movie(title: "Dunkirk", genre: .Animation)
        ]
    }
}

---

MovieViewController

 

MovieViewController에 테이블뷰를 연결해줍니다.

 

영화데이터를 받아오고 테이블뷰에 타이틀과 장르를 뿌려줍니다.

 

import UIKit

class MovieViewController: UIViewController {

    //MARK:- IBOutlets
    
    @IBOutlet weak var table: UITableView!
    
    //MARK:- Properties
    
    var movies:[Movie] {
        return MoviesDataHelper.getMovies()
    }
    
    //MARK:- Life Cycle
    
    override func viewDidLoad() {
        super.viewDidLoad()
       configure()
    }
    
    //MARK:- Helper Functions
    
    private func configure() {
        table.dataSource = self
    }
}

//MARK:- UITableViewDataSource

extension MovieViewController:UITableViewDataSource {
    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
        return movies.count
    }
    
    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = table.dequeueReusableCell(withIdentifier: "MovieTableViewCell")
        cell?.textLabel?.text = movies[indexPath.row].title
        cell?.detailTextLabel?.text = movies[indexPath.row].genreString()
        return cell!
    }
}

---

Pod

 

해당 프로젝트에 pod init을 해주신 뒤 두 프레임워크를 추가한 뒤 pod install 해주세요.

  pod 'Quick'
  pod 'Nimble'

---

MovieViewControllerSpec

 

프로젝트명Tests에 Unit Test Case Class를 만들어줍니다.

 

 

이름은 MovieViewControllerSpec으로 해줍니다.

 

 

Quick과 Nimble 그리고 해당 프로젝트를  import 해주세요.

 

import Quick
import Nimble
@testable import Quick_Nimble_Example

 

클래스를 QuickSpec으로 바꿔주세요.

 

class MovieViewControllerSpec: QuickSpec {

 

생선된 모든 메소드를 지우고  spec() 을 작성해줍니다.

 

이제 모든 테스트는 spec() 블록 안에 작성해주겠습니다.

 

override func spec() { ... }

 

먼저 describe는 BDD에서 Given을 의미합니다.

 

즉, 어떤 환경에 있는지를 정의해줍니다.

 

beforeEach 블록은 테스트가 실행되기 전에 미리 환경을 설정하는 것인데요.

 

MovieViewController를 instantiate 해주고 해당 뷰를 설정해줍니다. (viewDidLoad와 비슷합니다.)

 

context는 BDD에서 When을 의미합니다.

 

즉, 어떤 행위가 일어날 때를 정의해줍니다.

 

it은 BDD에서 Then을 의미합니다.

 

즉, 예상되는 결과를 정의해줍니다.

 

그리곤 Nimble의 assertion을 이용해서 테이블뷰의 Row의 갯수가 정확한지 테스트해줍니다.

 

 

 var subject: MovieViewController!
           
           describe("무비뷰컨트롤러에서") {
               beforeEach {
                subject = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "MovieViewController") as? MovieViewController
                   
                   _ = subject.view
               }
               
               context("뷰가 로드 될 때") {
                   it("8개 영화가 로드되어야 해") {
                       expect(subject.table.numberOfRows(inSection: 0)).to(equal(8))
                   }
               }

 

영화 데이터가 8개 이므로 테이블뷰는 Row가 8개 일 것입니다.

 

고로 테스트가 통과하는 것을 볼 수 있습니다.

 

 

또한 왼쪽 테스트 탭에서 정의해준 테스트가 정상적으로 통과했는지 볼 수 있습니다.

 

 

여기서 테스트를 한개 더 진행할건데요.

 

테이블뷰셀에 올바른 제목과 장르가 띄워지는지 테스트하겠습니다.

Given은 똑같이 무비 뷰컨트롤러에서 이고 When과 Then만 바꿔 보겠습니다.

 

When은 테이블뷰셀이 로드될 때로 context에 정의해줍니다.

 

beforeEach 블록에 테이블뷰 셀을 구현해줍니다.

 

it에 예상되는 결과를 정의해주고 Nimble의 assertion을 이용하여 예상되는 제목과 장르를 적어줍니다.

 

context("테이블뷰셀이 로드될 때") {
                   var cell: UITableViewCell!
                   
                   beforeEach {
                       cell = subject.tableView(subject.table, cellForRowAt: IndexPath(row: 0, section: 0))
                   }
                   
                   it("타이틀과 장르가 보여야 해") {
                       expect(cell.textLabel?.text).to(equal("The Emoji Movie"))
                       expect(cell.detailTextLabel?.text).to(equal("Animation"))
                   }
               }

 

 

이렇게 진행하면 테스트가 두개 다 통과하는 것을 볼 수 있습니다.

 

 

---

오늘은 이렇게 테스트 프레임워크인 Quick과 Nimble을 알아보았는데요.

 

이 Quick 덕에 BDD를 어떻게 테스트에 적용하는지 구체적으로 알 수 있게 되었고 Nimble을 통해서

 

더욱 편리한 assertion을 쓸 수 있었습니다.

 

혹시라도 궁금하신 점이나 틀린 부분이 있다면 언제든 댓글로 알려주세요!

---

Reference

 

Test Driven Development (TDD) in Swift with Quick and Nimble