KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

2023

★ 93 Open GitHub ↗

Advent of Craft 2023

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Advent Of Craft

[![Our Discord](https://img.shields.io/badge/Discord-7289DA?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/E5Z9s9UKTS)
[![Linkedin](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/company/advent-of-craft)

[![License](https://img.shields.io/github/license/advent-of-craft/2023.svg)](https://github.com/advent-of-craft/2023/blob/main/LICENSE)
[![Contributors](https://github.com/advent-of-craft/2023/actions/workflows/contributors.yml/badge.svg)](https://github.com/advent-of-craft/advent-of-craft/actions/workflows/contributors.yml)
[![CodeScene general](https://codescene.io/images/analyzed-by-codescene-badge.svg)](https://codescene.io/projects/47561)
[![CodeScene Code Health](https://codescene.io/projects/47561/status-badges/code-health)](https://codescene.io/projects/47561)

Christmas is here! 🎅

Your journey as a developer has probably taken many turns.

You probably had to troubleshoot and refactor a piece of code that you still have nightmares about.

You might have been stuck in a team when you never have time to improve your code base
because `"We have to deliver more features"`.

Heck, you probably still are.

We feel you, and in the spirit of Christmas, you deserve a gift.

We have the privilege this year to bring to you the Advent of Craft.
This is a journey into software craftsmanship.

Each day, `you will be taken in a small aspect of software craftsmanship`. Each day, you will
have `an exercise with a topic` to look at in a small bite approach and hopefully you will `learn something`.

From refactoring to testing to reviewing, all aspects are going to be explored.

> The objective of this journey is to learn new crafts and share with your peers, not to get lost in impossible
> algorithm exercises or to finish as fast as you can using chatGPT.

A repository is available and each day a topic will appear with a proposed solution for the day before.

We hope you enjoy the ride.
Happy Crafting!

![Advent Of Craft 2023](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/img/advent-of-craft.png)

## Join us on Discord

To facilitate the communication around challenges you can join us on `Discord` by simply
clicking [here](https://discord.gg/E5Z9s9UKTS).

![Discord Advent Of Craft](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/img/discord.png)

## Instructions

[Here are the instructions for the journey](docs/INSTRUCTIONS.md)

## Challenges - 2023

Here are the different challenges :

- [Day 1: Make your production code easier to understand.](docs/exercise/day01/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md)
- [Day 2: One level of indentation.](docs/exercise/day02/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md)
- [Day 3: One dot per line.](docs/exercise/day03/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md)
- [Day 4: Identify the behavior under test and rewrite the tests.](docs/exercise/day04/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 5: No "for" loop authorized.](docs/exercise/day05/challenge.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 6: Parameterize your tests.](docs/exercise/day06/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 7: Simplify the run method by extracting the right behavior.](docs/exercise/day07/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md)
- [Day 8: Using TDD rules, write a password validation program.](docs/exercise/day08/challenge.md) [![T.D.D](https://img.shields.io/badge/T.D.D-green)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/tdd.md)
- [Day 9: Fix the code.](docs/exercise/day09/challenge.md) [![Design](https://img.shields.io/badge/Design-yellow)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/design.md)
- [Day 10: Dot not use "if" statement.](docs/exercise/day10/challenge.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 11: Gather a dependency freshness metric.](docs/exercise/day11/challenge.md) [![Design](https://img.shields.io/badge/Design-yellow)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/design.md)
- [Day 12: Make your code open for extension.](docs/exercise/day12/challenge.md) [![Design](https://img.shields.io/badge/Design-yellow)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/design.md)
- [Day 13: Find a way to eliminate the irrelevant, and amplify the essentials of those tests.](docs/exercise/day13/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 14: Do not use exceptions anymore.](docs/exercise/day14/challenge.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 15: Put a code under tests.](docs/exercise/day15/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 16: Make this code immutable.](docs/exercise/day16/challenge.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 17: Design one test that has the impact of thousands.](docs/exercise/day17/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 18: Automatically detect Linguistic Anti-Patterns (LAP).](docs/exercise/day18/challenge.md) [![Design](https://img.shields.io/badge/Design-yellow)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/design.md)
- [Day 19: Loosing up dead weight.](docs/exercise/day19/challenge.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 20: No more exceptions in our domain.](docs/exercise/day20/challenge.md) [![Design](https://img.shields.io/badge/Design-yellow)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/design.md)
- [Day 21: Refactor the tests and production code to Output-Based tests.](docs/exercise/day21/challenge.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md)
- [Day 22: Design a diamond program using T.D.D and Property-Based Testing.](docs/exercise/day22/challenge.md) [![T.D.D](https://img.shields.io/badge/T.D.D-green)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/tdd.md)
- [Day 23: Refactor the code after putting it under test.](docs/exercise/day23/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md) [![T.D.D](https://img.shields.io/badge/T.D.D-green)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/tdd.md) [![Clean Testing](https://img.shields.io/badge/Clean%20Testing-orange)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/clean-testing.md) [![Functional Programming](https://img.shields.io/badge/Functional%20Programming-purple)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/functional-programming.md)
- [Day 24: Write the most complicated code you can.](docs/exercise/day24/challenge.md) [![Refactoring](https://img.shields.io/badge/Refactoring-blue)](https://raw.githubusercontent.com/advent-of-craft/2023/main/docs/learning-paths/refactoring.md)
- [Day 25: Share with the world what you have learned.](docs/exercise/day25/challenge.md)

### Solutions

A solution proposal will be published here every day during the `Advent Of Craft` containing `the code` and
a `step by step` guide.

- [Day 1: Make your production code easier to understand.](docs/exercise/day01/solution/step-by-step.md)
- [Day 2: One level of indentation.](docs/exercise/day02/solution/step-by-step.md)
- [Day 3: One dot per line.](docs/exercise/day03/solution/step-by-step.md)
- [Day 4: Identify the behavior under test and rewrite the tests.](docs/exercise/day04/solution/step-by-step.md)
- [Day 5: No "for" loop authorized.](docs/exercise/day05/solution/step-by-step.md)
- [Day 6: Parameterize your tests.](docs/exercise/day06/solution/step-by-step.md)
- [Day 7: Simplify the run method by extracting the right behavior.](docs/exercise/day07/solution/step-by-step.md)
- [Day 8: Using TDD rules, write a password validation program.](docs/exercise/day08/solution/step-by-step.md)
- [Day 9: Fix the code.](docs/exercise/day09/solution/step-by-step.md)
- [Day 10: Dot not use "if" statement.](docs/exercise/day10/solution/step-by-step.md)
- [Day 11: Gather a dependency freshness metric.](docs/exercise/day11/solution/step-by-step.md)
- [Day 12: Make your code open for extension.](docs/exercise/day12/solution/step-by-step.md)
- [Day 13: Find a way to eliminate the irrelevant, and amplify the essentials of those tests.](docs/exercise/day13/solution/step-by-step.md)
- [Day 14: Do not use exceptions anymore.](docs/exercise/day14/solution/step-by-step.md)
- [Day 15: Put a code under tests.](docs/exercise/day15/solution/step-by-step.md)
- [Day 16: Make this code immutable.](docs/exercise/day16/solution/step-by-step.md)
- [Day 17: Design one test that has the impact of thousands.](docs/exercise/day17/solution/step-by-step.md)
- [Day 18: Automatically detect Linguistic Anti-Patterns (LAP).](docs/exercise/day18/solution/step-by-step.md)
- [Day 19: Loosing up dead weight.](docs/exercise/day19/solution/step-by-step.md)
- [Day 20: No more exceptions in our domain.](docs/exercise/day20/solution/step-by-step.md)
- [Day 21: Refactor the tests and production code to Output-Based tests.](docs/exercise/day21/solution/step-by-step.md)
- [Day 22: Design a diamond program using T.D.D and Property-Based Testing.](docs/exercise/day22/solution/step-by-step.md)
- [Day 23: Refactor the code after putting it under test.](docs/exercise/day23/solution/step-by-step.md)
- [Day 24: Write the most complicated code you can.](docs/exercise/day24/solution/step-by-step.md)

## Learning paths 🚀

We have designed several `learning paths` based on the challenges that you can follow if you want to deep dive into a
given concept:

- [Refactoring 🚀](docs/learning-paths/refactoring.md)
- [Clean Testing 🧼](docs/learning-paths/clean-testing.md)
- [Test-Driven Development 🔴🟢🔵](docs/learning-paths/tdd.md)
- [Design 🏛](docs/learning-paths/design.md)
- [Functional Programming 🌋](docs/learning-paths/functional-programming.md)

## Available languages

Here are the libraries we use in the different days per supported language:

| Topic                  | java                                                             | C#                                                                                          | kotlin                                                                                               | typescript                               |
|------------------------|------------------------------------------------------------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|------------------------------------------|
| Test framework         | [junit](https://junit.org/junit5/)                               | [xUnit](https://xunit.net/)                                                                 | [Kotest](https://kotest.io/)                                                                         | [jest](https://jestjs.io/)               |
| Fluent assertions      | [assertJ](https://joel-costigliola.github.io/assertj/)           | [FluentAssertions](https://fluentassertions.com/)                                           | Native `kotest` assertions                                                                           | Native `jest` assertions                 |
| Mocking                | [mockito](https://site.mockito.org/)                             | [NSubstitute](https://nsubstitute.github.io/)                                               | [mockk](https://mockk.io/)                                                                           | Native `jest` mocking features           |
| Approval testing       | [approvalTests](https://github.com/approvals/approvaltests.java) | [Verify.xUnit](https://github.com/VerifyTests/Verify)                                       | [approvalTests](https://github.com/approvals/approvaltests.java)                                     | [approvals](http://approvaltests.com)    |
| Property-Based testing | [vavr-test](https://github.com/vavr-io/vavr-test)                | [FSCheck](https://fscheck.github.io/FsCheck/)                                               | [kotest-property](https://kotest.io/docs/proptest/property-based-testing.html)                       | [fast-check](https://fast-check.dev/)    |
| Fake data generator    | [instancio](https://www.instancio.org/)                          | [Bogus](https://github.com/bchavez/Bogus)                                                   | Not used                                                                                             | [fakerjs](https://fakerjs.dev/)          |
| Architecture tests     | [archunit](https://www.archunit.org/)                            | [TngTech.ArchUnitNET.xUnit](https://archunitnet.readthedocs.io/en/latest/)                  | [archunit](https://www.archunit.org/)                                                                | N/A                                      |
| Functional library     | [vavr](https://www.vavr.io/)                                     | [LanguageExt.Core](https://github.com/louthy/language-ext)                                  | [arrow-kt](https://arrow-kt.io/)                                                                     | [fp-ts](https://gcanti.github.io/fp-ts/) |
| Functional assertions  | [assertj-vavr](https://github.com/assertj/assertj-vavr)          | [FluentAssertions.LanguageExt](https://www.nuget.org/packages/FluentAssertions.LanguageExt) | [kotest-extensions-arrow](https://github.com/kotest/kotest-extensions-arrow#kotest-extensions-arrow) | Native `jest` assertions                 |

## Contributors

<table>
<tr>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/ythirion>
 <img src=https://avatars.githubusercontent.com/u/20967693?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Yoan Thirion/>
 
 Yoan Thirion
 </a>
 </td>
 <td align="center" style="word-wrap: break-word; width: 150.0; height: 150.0">
 <a href=https://github.com/yanncourtel>
 <img src=https://avatars.githubusercontent.com/u/75068587?v=4 width="100;" style="border-radius:50%;align-items:center;justify-content:center;overflow:hidden;padding-top:10px" alt=Yann Courtel/>
 
 Yann Courtel
 </a>
 </td>
</tr>
</table>

2023

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README