/Racing-Car-Katas

The starting code for several code katas on a racing car theme

Primary LanguageJavaScriptMIT LicenseMIT

Racing Car Katas

In this repository you'll find starting code for five distinct problems. They could be code you inherited from a legacy code-base. Now you want to write unit tests for them, and that is harder than it needs to be. All of the code snippets fail to follow one or more of the SOLID principles.

For each exercise, you should identify which SOLID principles are not being followed by the code. There is only one class you are interested in writing tests for right now. As a first step, try to get some kind of test in place before you change the class at all. If the tests are hard to write, is that because of the problems with SOLID principles?

When you have some kind of test to lean on, refactor the code and make it testable. Take care when refactoring not to alter the functionality, or change interfaces which other client code may rely on. (Imagine there is client code in another repository that you can't see right now). Add more tests to cover the functionality of the particular class you've been asked to get under test.

Apply the unit testing style and framework you are most comfortable with. You can choose to use stubs or mocks or none at all. If you do, you are free to use the mocking tool that you prefer.

  1. PressureMonitoringSystem exercise: Father Christmas' workshop uses a hydraulic system to move presents around the workshop. Write the unit tests for the Alarm class. The Alarm class is designed to monitor pressure and set an alarm if the pressure falls outside of the expected range. The Sensor class provided for the exercise fakes the behaviour of a real sensor, providing random but realistic values.

  2. UnicodeFileToHtmlTextConverter exercise: Father Christmas's elves generate reports in unicode files. Father Christmas needs to be able to check them while he's out on deliveries so needs them to be converted to html. Write the unit tests for the UnicodeFileToHtmlTextConverter class. The UnicodeFileToHtmlTextConverter class is designed to reformat a plain text file for display in a browser. For the Python and Java versions, there is an additional class "HtmlPagesConverter" which is slightly harder to get under test. It not only converts text in a file to html, it also supports pagination. It's meant as a follow up exercise.

  3. TicketDispenser exercise: The TicketDispenser class is designed to be used to manage a queuing system in the workshop shop. Write unit tests for the TicketDispenser. There may be more than one ticket dispenser but the same ticket should not be issued to two different customers.

  4. TelemetrySystem exercise: Father Christmas is upgrading his workshop to use IoT devices to track the health of machinery. Write the unit tests for the TelemetryDiagnosticControls class. The responsibility of the TelemetryDiagnosticControls class is to establish a connection to the telemetry server (through the TelemetryClient), send a diagnostic request and successfully receive the response that contains the diagnostic info. The TelemetryClient class provided for the exercise fakes the behavior of the real TelemetryClient class, and can respond with either the diagnostic information or a random sequence. The real TelemetryClient class would connect and communicate with the telemetry server via tcp/ip.

Get going quickly with Cyber-Dojo

You can quickly and easily get going with these problems using the cyber-dojo tool. Click on the relevant link below to create a new cyber-dojo practice id with the problem set up ready for your dojo.

  1. ressureMonitoringSystem in C#, Java, C++
  2. UnicodeFileToHtmlTextConverter in C#, Java, C++
  3. Ticket Dispenser C++
  4. Telemetry Diagnostic Controls C++
  5. Leaderboard C++

TDD with Mock Objects: Design Principles and Emerging Properties

This was originally a fork of Luca Minudel's repo. He was using it for a study of TDD and Design principles. I am using it as a repository for storing exercises useful for people wishing to improve their skills with TDD and SOLID principles. Please look at my blog post "SOLID principles and TDD" for background reading, or my book "The Coding Dojo Handbook".