Here is the bad news: the new developer you hired has written some terrible, atrocious code. No one can understand what it does.
The good news: at least there are unit tests to prove the code is working.
You job is to refactor the code and make it readable, while keeping the code in working order (pass all tests).
- Clone this repository
git clone https://github.com/CodelyTV/finder-refactoring-kata-csharp - Install dotnet sdk 2.2 and ASP.NET Core Runtime (https://dotnet.microsoft.com/download/dotnet-core/2.2)
- Build the project directory using
dotnet build - Run the tests with
dotnet test. - Start refactoring!
The primary goal is to refactor the code in Finder.cs - as it stands the code is incomprehensible.
- Start with simple rename refactors so you can better understand the abstractions you are working with. Rename any class or any variable.
- Move on to extract methods and making the code more modular.
- See if you can also eliminate pattern matchings and multiple exit points from methods.
Anything is fair game, create new classes, new methods, and rename tests. The only restriction is that the existing tests have to keep working. Lean on the tests and run them after every small change to make sure you are on the right path.
You can stop when you feel the code is good enough, something you can come back to in 6 months and understand.
- Refactoring.guru Code Smells catalog
- Refactoring.guru Refactorings catalog
- SourceMaking Refactorings catalog
- Martin Fowler Refactorings catalog
- CodelyTV Refactoring videos (Spanish)
You can also find the kata in different programming languages in isolated repositories just ready to clone and enjoy:
This kata is a CSharp port of the original Incomprehensible Finder Refactoring Kata created by K. Scott Allen.
Port developed by CodelyTV and contributors 😊