Skip to content

TODO API Client Kata for iOS Developers. The main goal is to practice integration testing using Nocilla and Nimble.

License

Notifications You must be signed in to change notification settings

nasli/KataTODOApiClientIOS

 
 

Repository files navigation

Karumi logo KataTODOApiClient for iOS. Build Status

  • We are here to practice integration testing using HTTP stubbing.
  • We are going to use Nocilla to simulate a HTTP server.
  • We are going to use Nimble to perform assertions.
  • We are going to practice pair programming.

Getting started

This repository contains an API client to interact with a remote service we can use to implement a TODO application.

This APIClient is based on one class with name TODOAPIClient containing some methos to interact with the API. Using this class we can get all the tasks we have created before, get a task using the task id, add a new task, update a task or delete an already created task.

The API client has been implemented using a networking framework named BothamNetworking. Review the project documentation if needed.

Tasks

Your task as iOS Developer is to write all the integration tests needed to check if the API Client is working as it should.

This repository is ready to build the application, pass the checkstyle and your tests in Travis-CI environments.

Our recommendation for this exercise is:

  • Before starting

    1. Fork this repository.
    2. Checkout kata-todo-api-client branch.
    3. Execute the repository playground and make yourself familiar with the code.
    4. Execute TODOAPIClientTests and watch the only test it contains pass.
  • To help you get started, these are some tests already written at TODOAPIClientTests class. Review it carefully before to start writing your own tests. Here you have the description of some tests you can write to start working on this Kata:

    1. Test that the Accept and ContentType headers are sent.
    2. Test that the list of TaskDTO instances obtained invoking the method getAllTasks contains the expected values.
    3. Test that if there is no connection the error returned by any method call is TODOAPIClientError.NetworkError.
    4. Test that adding a task the body sent to the server is the correct one.

Considerations

  • If you get stuck, master branch contains all the tests already solved.

  • You will find some utilities to help you test the APIClient easily in: KataTODOAPIClientTests/Extensions/NSError and KataTODOAPIClientTests/Extensions/NocillaTestCase.

Extra Tasks

If you've covered all the application functionality using integration tests you can continue with some extra tasks:

  • Replace some integration tests we have created with unit tests. A starting point could be the mapErrorToTODOAPIClientError function or the DefaultHeadersInterceptor class.
  • Create your own API client to consume one of the services described in this web: http://jsonplaceholder.typicode.com/

Documentation

There are some links which can be useful to finish these tasks:

#License

Copyright 2016 Karumi

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

TODO API Client Kata for iOS Developers. The main goal is to practice integration testing using Nocilla and Nimble.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Swift 93.3%
  • Objective-C 5.1%
  • Ruby 1.6%