Pull to refresh

BDD тестирование в Swift с помощью Sleipnir

Reading time4 min
Views10K
Original author: Artur Termenji

Objective-C разработчики могут пользоваться различными фреймворками для BDD тестирования своего кода.
Некоторые из них:


С появлением языка программирования Swift мы решили реализовать фреймворк для тестирования в стиле BDD на чистом Swift, без привязки к Objective-C.
После пары недель имлементации мы выпустили первую публичную версию фреймворка Sleipnir.

Sleipnir был вдохновлен фреймворком Cedar и позволяет писать BDD тесты в таком стиле:

class SampleSpec : SleipnirSpec {
    var spec : () = describe("Horse") {
        context("usual") {
            it("is not awesome") {
                let usualHorse = UsualHorse()
                expect(usualHorse.legsCount).to(equal(4))
                expect(usualHorse.isAwesome()).to(beFalse())
            }
        }
        
        context("Sleipnir") {
            it("is awesome") {
                let sleipnirHorse = Sleipnir()
                expect(sleipnirHorse.legsCount).to(equal(8))
                expect(sleipnirHorse.isAwesome()).to(beTrue())
            }
        }
    }
}

Основные принципы Sleipnir


  • Sleipnir не зависит от NSObject, это BDD фреймворк на чистом Swift
  • Sleipnir не использует XCTest
  • Sleipnir выводит результаты тестов в командную строку в удобном виде и позволяет расширять или дополнять вывод результатов
  • Другие возможности, такие как рандомное исполнение тестов, фокусированные/исключаемые группы тестов

Мы также нашли некоторые альтернативные фреймворки для BDD тестирования на Swift, например Quick.
Выбор между ними — вопрос личных предпочтений разработчика.

Пример использования


Определим два класса — Book и Library и напишем для них тесты.
Класс Book содержит информацию об авторе и названии книги:
class Book {    
    var title: String
    var author: String
    
    init(title: String, author: String) {
        self.title = title
        self.author = author
    }   
}

Класс Library — простая коллекция книг:
class Library {  
    var books: Book[]
    
    init() {
        self.books = Book[]()
    }
    
    func addBook(book: Book) {
        books.append(book)
    }
    
    func removeLastBook() {
        books.removeLast()
    }
    
    func clear() {
        books.removeAll()
    }
    
    func size() -> Int {
        return books.count
    }
    
    func hasBooks() -> Bool {
        return size() > 0
    }
    
    func filterBy(#author: String) -> Book[] {
        return books.filter { $0.author == author }
    }
    
    func filterBy(#title: String) -> Book[] {
        return books.filter { !$0.title.rangeOfString(title).isEmpty }
    }
}

Для начала протестируем корректность инициализации класса Book:
class LibrarySpec : SleipnirSpec {
    
    var book : () = context("Book") {
        
        var swiftBook: Book?
        beforeAll {
            swiftBook = Book(title: "Introduction to Swift", author: "Apple Inc.")
        }
        
        it("has title") {
            expect(swiftBook!.title).to(equal("Introduction to Swift"))
        }
       
        it("has author") {
            expect(swiftBook!.author).to(equal("Apple Inc."))
        }
    }
}

Мы создали класс LibrarySpec, который наследуется от класса SleipnirSpec. Он содержит в себе основной context и определяет два exampla, которые проверяют свойства созданного объекта класса Book.

Объект класса Book создается в блоке beforeAll{ }.
Sleipnir поддерживает несколько блоков инициализации и деинициализации тестов: beforeAll, afterAll, beforeEach и afterEach.

Результат вызова всех examplов (describe или context) верхнего уровня в тесте должен быть присвоен переменной для корректного инстанциирования:
var book : () = context("Book") {  }

Теперь протестируем поведение класса Library:
class LibrarySpec : SleipnirSpec {
    
    ...

    var library : () = context("Library") {
        
        var swiftLibrary: Library?
        beforeAll {
            swiftLibrary = Library()
        }
        
        afterAll {
            swiftLibrary = nil
        }
        
        describe("empty") {
            it("has no books") {
                expect(swiftLibrary!.hasBooks()).to(beFalse())
            }
        }
        
        describe("with books") {
            
            beforeEach {
                swiftLibrary!.addBook(Book(title: "Introduction to Swift", author: "Apple Inc."))
                swiftLibrary!.addBook(Book(title: "Using Swift with Cocoa", author: "Apple Inc."))
                swiftLibrary!.addBook(Book(title: "Swift tutorials", author: "John Doe"))
                swiftLibrary!.addBook(Book(title: "Programming iOS with Swift", author: "Vladimir Swiftin"))
            }
            
            afterEach {
                swiftLibrary!.clear()
            }
            
            it("is not empty") {
                expect(swiftLibrary!.hasBooks()).to(beTrue())
            }
            
            it("has correct number of books") {
                expect(swiftLibrary!.size()).to(equal(4))
                swiftLibrary!.removeLastBook()
                expect(swiftLibrary!.size()).to(equal(3))
            }
            
            describe("filters books") {
                it("by author") {
                    expect(swiftLibrary!.filterBy(author: "Apple Inc.").count).to(equal(2))
                }
                
                it("by title") {
                    expect(swiftLibrary!.filterBy(title: "tutorials").count).to(equal(1))
                }
            }
        }
    }
}

Запуск этих тестов выведет в командную строку следующую информацию:
Running With Random Seed: 657464010

.......


Finished in 0.0091 seconds

7 examples, 0 failures

В случае упавшего теста выведется детальная информация об ошибке, включая файл и номер строки:
Running With Random Seed: 2027508247

..F....

FAILURE Library with books has correct number of books:
/Users/atermenji/Coding/objc/Sleipnir/Sample/LibrarySpec.swift:64 Expected 3 to equal [2]


Finished in 0.0043 seconds

7 examples, 1 failures

Мы протестировали поведение класса Library используя простые expectaionы и matcherы.
На данный момент Sleipnir поддерживает только три типа matcherов: equal, beTrue и beFalse, однако вскоре будут добавлены новые.

Планы на будущее


Так как это первый публичный релиз, многие возможности еще не реализованы. У нас есть план имплементации на ближайшее будущее, который включает:
  • Механизм распространения фреймворка
  • Поддержка pending examples
  • Реализация фокусируемых/исключаемых групп тестов
  • Шаблоны XCode
  • Поддержка shared examples
  • Поддержка синтаксиса should (some_value should equal(some_another_value))
  • Вики документация
  • Тестирование Sleipnirа с помощью Sleipnirа
  • Дополнительные matcherы, среди которых:
    • beNil
    • beGreaterThan, beLessThan, beInRangeOf
    • асинхронные matcherы (will, willNot, after)
    • matcherы для коллекций и строк (contains, haveCount, beginWith, endWith, и т.д.)


Оставляйте багрепорты и фидбек на гитхабе или в комментах и следите за обновлениями!
Tags:
Hubs:
Total votes 23: ↑18 and ↓5+13
Comments4

Articles