Skip to content

chore: complete repository baseline #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
megabyde merged 1 commit into from
Aug 13, 2026
Merged

chore: complete repository baseline #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/CODEOWNERS
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
* @Coding-Cuddles/kata-maintainers
/.github/CODEOWNERS @Coding-Cuddles/kata-maintainers
28 changes: 13 additions & 15 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,9 @@
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Replit](https://img.shields.io/badge/Try%20with%20Replit-black?logo=replit)](https://replit.com/new/github/Coding-Cuddles/roman-numerals-cpp-kata)

Implement conversions between Arabic numerals and Roman numerals in C++17 with
GoogleTest. Setup is complete when the existing starter test passes.

## Overview

This kata complements [Clean Code: Advanced TDD, Ep. 19](https://cleancoders.com/episode/clean-code-episode-19-p1).
Expand All @@ -14,9 +17,8 @@ test-driven development.

## Instructions

Roman numerals are a numeral system that was used by ancient Rome. Numbers in
this system use letters from the Latin alphabet. Currently, it uses seven
symbols:
Roman numerals are a numeral system used in ancient Rome. Numbers in this
system use seven letters from the Latin alphabet:

| Symbol | Value |
|:-------|-------|
Expand All @@ -28,30 +30,29 @@ symbols:
| D | 500 |
| M | 1000 |

Instead of writing the same letter four times, a rule for subtraction is used:
the letter is written once, then the next largest Roman numeral is written.
Instead of writing the same letter four times, a subtraction rule is used: the
letter is written once, followed by the next larger Roman numeral.
For example, 4 is not written as IIII, but instead as IV, because IV is V (5)
minus I (1).

In general, the values for 5, 50, and 500 are not subtracted.

### Exercise 1

The task at hand entails crafting a function `to_roman(number: int) -> str` to
convert regular Arabic numbers into Roman numerals, such as:
Implement `std::string to_roman(int number)` to convert Arabic numerals into
Roman numerals, such as:

* 4 → IV
* 7 → VII
* 9 → IX

The lowest number you can write in Roman Numerals is number I (1). And the
largest numeral is MMMCMXCIX (3999).
The smallest supported number is 1 (`I`), and the largest is 3999
(`MMMCMXCIX`).

### Exercise 2

In this phase, the objective is to develop a function `from_roman(number: str)
-> int` that performs the reverse conversion, transforming Roman numerals into
their corresponding Arabic digits.
Implement `int from_roman(const std::string& number)` to perform the reverse
conversion from Roman numerals to Arabic numerals.

## Guiding principles

Expand All @@ -64,9 +65,6 @@ their corresponding Arabic digits.
* If you do know an algorithm, evaluate if it can be implemented using strict
TDD principles.

This is a C++17 kata using GoogleTest. Setup is complete when CTest reports
`100% tests passed`.

## Prerequisites

Required:
Expand Down