Agile Swift

Godfrey Nolan

RIIS LLC

Agenda

Agile Testing Benefits

Catch more mistakes
Confidently make more changes
Built in regression testing
Extend the life of your codebase
Better predicability & reliability

Agile Swift

Swift Unit Test - XCTest

Unit Testing Assertions

Unit Testing Code Coverage

$ brew install ruby

$ gem install slather

$ slather coverage --html --scheme XcodeSchemeName path/to/project.xcodeproj

$ slather coverage --html --scheme Calculator Calculator/Calculator.xcodeproj

API Testing - Postman

API Testing - Newman

Swift GUI Testing - XCUI

Swift GUI Testing

Putting It All Together

1. Download the Jenkins Mac OS X native package from http://jenkins-ci.org.
2. Double click the .pkg file to install Jenkins.
3. Once done, your browser will open to http://localhost:8080 where Jenkins lives.
4. Make the Jenkins user an admin:  
    sudo dseditgroup -o edit -a jenkins -t user admin
5. Add the Jenkins user to the developer group: 
    sudo dscl . append /Groups/_developer GroupMembership jenkins
6. Make the Jenkins user automatically login when the computer is restarted
7. unload Jenkins as a Daemon: 
    sudo launchctl unload /Library/LaunchDaemons/org.jenkins-ci.plist
8. move the .plist file, which defines how Jenkins will run, to the LaunchAgents folder: 
    sudo mv /Library/LaunchDaemons/org.jenkins-ci.plist /Library/LaunchAgents/
9. Edit the plist file:
    sudo vim /Library/LaunchAgents/org.jenkins-ci.plist 
    /* Remove the following lines */
    <key>SessionCreate</key
    <true />
10. reload the Launch Agent to restart Jenkins:
    sudo launchctl load /Library/LaunchAgents/org.jenkins-ci.plist

FIRST Principles

F(ast)
I(solated)
R(epeatable)
S(elf-verifying)
T(imely) i.e. TDD not TAD

FIRST Principles - Fast

FIRST Principles - Isolated

 when(methodIsCalled).thenReturn(aValue);

// Cuckoo

stub(mock) { stub in
  when(stub.readWriteProperty.get).thenReturn(10)
}


1. Click on the project folder then choose Test Target ➤ Build Phases.

2. Click + and choose New Run Script Phase.

3. Add Listing to the Run Script section, making sure to modify the 
input files that you want to mock.

4. Build the project.

5. Run the tests.

6. Drag and drop GeneratedMocks.swift into the test section.

7. Uncomment out your mocked tests

8. Run the mocked tests.

Isolated - Cuckoo

# Define output file; change "${PROJECT_NAME}Tests" to your test's 
root source folder, if it's not the default name

OUTPUT_FILE="./${PROJECT_NAME}Tests/GeneratedMocks.swift"
echo "Generated Mocks File = ${OUTPUT_FILE}"

# Define input directory; change "${PROJECT_NAME}" to your project's root
source folder, if it's not the default name
INPUT_DIR="./${PROJECT_NAME}"
echo "Mocks Input Directory = ${INPUT_DIR}"

# Generate mock files; include as many input files as you'd like to create mocks for
${PODS_ROOT}/Cuckoo/run generate --testable "${PROJECT_NAME}" \
--output "${OUTPUT_FILE}" \
"${INPUT_DIR}/FileName1.swift" \
"${INPUT_DIR}/FileName2.swift" \
"${INPUT_DIR}/FileName3.swift"
# ... and so forth

Isolated - Cuckoo

FIRST Principle - Repeatable

FIRST Prin - Self-Verifying

FIRST Principles - Timely

Sample App

Sample App - Unit Test

    func testParseRoutes() {
        let mock = MockJSONfetcher()
        
        stub(mock) { mock in
            when(mock.callApi(url: any(), completion: anyClosure())).then { url, closure in
                closure(self.testRouteJson)
            }
        }
        
        mock.callApi(url: url) { data in
            XCTAssertEqual(data, self.testRouteJson)
            let parser = customJSONparser(companyIndex: 1)
            let route = Route(name: "FORT ST-EUREKA RD", 
                    direction1: "Northbound", 
                        direction2: "Southbound", id: 1, routeId: "125")
            XCTAssertEqual(parser.getRoutes(fromJSONString: data), [route])
        }
    }

xcodebuild test -workspace ETAMock.xcworkspace -scheme ETAMock 
-destination 'platform=iOS Simulator, name=iPhone 7 Plus'
-only-testing:ETAMockTests

Sample App - Unit Test

# Define output file; change "${PROJECT_NAME}Tests" to your test's root source folder, if it's not the default name
OUTPUT_FILE="./${PROJECT_NAME}Tests/GeneratedMocks.swift"
echo "Generated Mocks File = ${OUTPUT_FILE}"

# Define input directory; change "${PROJECT_NAME}" to your project's root source folder, if it's not the default name
INPUT_DIR="./${PROJECT_NAME}"
echo "Mocks Input Directory = ${INPUT_DIR}"

# Generate mock files; include as many input files as you'd like to create mocks for
${PODS_ROOT}/Cuckoo/run generate --testable "${PROJECT_NAME}" \
--output "${OUTPUT_FILE}" \
"${INPUT_DIR}/JSONFetcher.swift"

# ... and so forth

# After running once, locate `GeneratedMocks.swift` and drag it into your Xcode test target group

Sample App - API Test

newman run ETAJson.postman_collection

Sample App - API Test

Sample App - GUI Test

    func testExample() {
        let app = XCUIApplication()
        let tablesQuery = app.tables
        tablesQuery.staticTexts["Smart"].tap()
        tablesQuery.staticTexts["SOUTHSHORE"].tap()
        app.buttons["Southbound"].tap()
        XCTAssert(tablesQuery.staticTexts["JEFFERSON + SOUTHFIELD"].exists)
        
        
        app.navigationBars["ETAMock.StopsView"].children(matching: .button)
                        .matching(identifier: "Back").element(boundBy: 0).tap()
        tablesQuery.staticTexts["MICHIGAN AVENUE LOCAL"].tap()
        app.buttons["Westbound"].tap()
        XCTAssert(tablesQuery.staticTexts["MICHIGAN + CASS"].exists)
    }

xcodebuild test -workspace ETAMock.xcworkspace -scheme ETAMock 
-destination 'platform=iOS Simulator, name=iPhone 7 Plus'
-only-testing:ETAMockUITests

Sample App - Jenkins

Slather - Jenkins

# .slather.yml
input_format: profdata
coverage_service: cobertura_xml
output_directory: slather-report
scheme: ETAMock
workspace: ETAMock.xcworkspace
xcodeproj: ETAMock.xcodeproj