Tirsvad-Udemy-100-days-of-code/026-nato-alphabet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

MIL-003 Documentation and publication #23

Merged
Tirsvad merged 3 commits from mil-003-documentation-and-publication into main 2026-10-13 10:49:04 +02:00
Conversation 0 Commits 3 Files Changed 21
+703 -5
18 changed files with 703 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit d932c7fa4f - Show all commits
Doxyfile
+3 -3
View File
@@ -130,10 +130,10 @@ WARN_LOGFILE =
#---------------------------------------------------------------------------
# Configuration options related to the input files
#---------------------------------------------------------------------------
INPUT = src README.md
INPUT = src
INPUT_ENCODING = UTF-8
INPUT_FILE_ENCODING =
FILE_PATTERNS = *.py *.md
FILE_PATTERNS = *.py
RECURSIVE = YES
EXCLUDE =
EXCLUDE_SYMLINKS = NO
@@ -147,7 +147,7 @@ INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = NO
FILTER_SOURCE_PATTERNS =
USE_MDFILE_AS_MAINPAGE = README.md
USE_MDFILE_AS_MAINPAGE =
IMPLICIT_DIR_DOCS = YES
FORTRAN_COMMENT_AFTER = 72
#---------------------------------------------------------------------------
README.md
+205 -1
View File
@@ -1,2 +1,206 @@
# 026-nato-alphabet
# 🚀 NATO alphabet
A console tool that spells a word with the NATO phonetic alphabet, the Day 26 assignment of Udemy's "100 Days of Code: The Complete Python Pro Bootcamp". It is written for fellow course participants and GitHub visitors who want a readable, tested, runnable solution that uses list and dictionary comprehensions and has no runtime dependencies.
![The tool spelling the word Hello][screenshot-spell]
## 📚 Table of Contents
- [Overview](#-overview)
- [Requirements](#-requirements)
- [Setup](#-setup)
- [Run](#-run)
- [Tests](#-tests)
- [Continuous integration](#-continuous-integration)
- [Build the source documentation](#-build-the-source-documentation)
- [Project layout](#-project-layout)
- [License](#-license)
- [Links](#-links)
- [Appendix: Project documents](#-appendix-project-documents)
## 🧭 Overview
You type a word, the program prints the NATO code word of each letter. A character that is not a letter makes it ask again.
```text
Enter a word: Hello
Phonetic code words:
Hotel
Echo
Lima
Lima
Oscar
```
How it works, in the course's terms:
- `load_nato_dict` reads the supplied CSV file and builds the letter-to-code-word dictionary with a **dictionary comprehension**.
- `generate_phonetic` turns a word into its code words with a **list comprehension**.
- The standard library `csv` module replaces Pandas, so the project has no runtime dependencies (see the architecture decision record [ADR-0001][ADR-0001]).
The wiki explains installation, usage and development in English, Danish and Bahasa Malaysia: [wiki][wiki].
## 📋 Requirements
- Python 3.13 or newer, with the `venv` module.
- Git, to clone the repository.
- Optional: [Doxygen](https://www.doxygen.nl/) to build the source documentation.
The program itself needs no packages. The development tools (pytest, ruff, mypy, import-linter) are installed by the `dev` extra.
## 🛠️ Setup
Clone the repository, then create a local virtual environment named `.venv` in its root, upgrade pip and install the project in editable mode with its development tools.
### Windows PowerShell
```powershell
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
If PowerShell refuses to run the activation script, allow it for this window only with `Set-ExecutionPolicy -Scope Process RemoteSigned`.
### Linux Debian
```bash
sudo apt install git python3 python3-venv
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
Debian 13 (trixie) ships Python 3.13. On an older release install Python 3.13 first (for example with `pyenv`).
### MacOS
```bash
brew install python@3.13 git
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
## ▶️ Run
With the virtual environment active:
```bash
python -m nato_alphabet
```
or, as the installed command:
```bash
nato-alphabet
```
An invalid character asks for the word again:
![A word with a digit is rejected, then a valid word is spelled][screenshot-retry]
## 🧪 Tests
Run the tests with the virtual environment active:
```bash
python -m pytest
```
The same checks that CI runs:
```bash
python -m ruff check .
python -m mypy
lint-imports
```
## 🔄 Continuous integration
The workflow [`.gitea/workflows/ci.yml`](.gitea/workflows/ci.yml) runs on every push to `main` or a `mil-*` branch and on every pull request that touches source, tests or configuration. It sets up Python 3.13, creates a virtual environment, installs the project with the `dev` extra, and runs ruff, mypy and pytest.
## 📖 Build the source documentation
The source is documented with Doxygen comments. From the repository root:
```bash
doxygen Doxyfile
```
Open `build/html/index.html` in a browser. The `build/` folder is ignored by git.
## 🗂️ Project layout
```text
src/nato_alphabet/
constants.py every literal of the program
main.py composition root and entry point
__main__.py python -m nato_alphabet
domain/ the spelling rule (no input or output)
application/ the use case and its ports
adapters/ CSV reader and console
data/ nato_phonetic_alphabet.csv
tests/ pytest tests, mirroring src/
docs/ project documents (see the appendix)
wiki/ wiki pages in en, da and ms
.gitea/workflows/ CI workflow
pyproject.toml project configuration
Doxyfile Doxygen configuration
```
## 📄 License
GNU Affero General Public License v3.0 or later. See [LICENSE](LICENSE).
## 🔗 Links
- [Repository][repository]
- [Documentation][documentation]
- [Issue tracker][issues]
## 📎 Appendix: Project documents
The documents a newcomer needs, in reading order.
| Document | What it tells you |
| --- | --- |
| [AGENTS.md][agents] | The rules AI agents follow in this repository |
| [Business Case][BC-001] | Why the project exists, its scope and success criteria |
| [Stakeholder Analysis][SA-001] | Who is involved; the stakeholder IDs used for owners and reviewers |
| [Project Plan][PP-001] | The gateways and their schedule |
| [Milestones][milestones] | One document per gateway: Go/No-Go criteria and tasks |
| [Architecture decisions][adr] | Why the data is read with the standard library and which analysis documents were skipped |
| [Artifact registry][registry] | Where each artifact type lives, the next version, the PO language and domain |
| [Traceability matrix][TM-001] | How the artifacts link and when each was last reviewed |
| [Framework README][framework-readme] | The framework this project uses |
| [Framework changelog][framework-changelog] | What changed in each framework release |
---
[repository]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet
[documentation]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/wiki
[wiki]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/wiki
[issues]: https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/issues
[screenshot-spell]: ./docs/images/spell-word.png
[screenshot-retry]: ./docs/images/retry-invalid.png
[agents]: ./AGENTS.md
[BC-001]: ./docs/business-case.md
[SA-001]: ./docs/stakeholder-analysis.md
[PP-001]: ./docs/project-plan.md
[milestones]: ./docs/milestones/
[adr]: ./docs/adr/
[ADR-0001]: ./docs/adr/adr-0001-read-nato-data-with-csv-module.md
[registry]: ./docs/artifact-registry.md
[TM-001]: ./docs/sqa/traceability-matrix.md
[framework-readme]: ./framework/README.md
[framework-changelog]: ./framework/CHANGELOG.md
docs/images/retry-invalid.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

docs/images/spell-word.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 16 KiB

src/nato_alphabet/__init__.py
+9 -1
View File
@@ -1 +1,9 @@
"""@brief Console tool that spells a word with the NATO phonetic alphabet."""
"""@brief Console tool that spells a word with the NATO phonetic alphabet.
@mainpage NATO alphabet
The Day 26 assignment of "100 Days of Code: The Complete Python Pro Bootcamp".
`load_nato_dict` builds the letter-to-code-word dictionary with a dictionary
comprehension and `generate_phonetic` spells a word with a list comprehension.
Run it with `python -m nato_alphabet`.
"""
wiki/Development-da.md
+43
View File
@@ -0,0 +1,43 @@
# Udvikling
🌐 [English](Development) · **Dansk** · [Bahasa Melayu](Development-ms)
Sæt projektet op først ([Installation](Install-da)). Udvidelsen `dev` installerer pytest, ruff, mypy og import-linter.
## Kør testene
```bash
python -m pytest
```
## Kør de kontroller, CI kører
```bash
python -m ruff check .
python -m mypy
lint-imports
```
## Byg kildedokumentationen
```bash
doxygen Doxyfile
```
Åbn `build/html/index.html`. Installér Doxygen fra [doxygen.nl](https://www.doxygen.nl/) eller din pakkehåndtering.
## Kodens opbygning
| Mappe | Indhold |
| --- | --- |
| `src/nato_alphabet/domain/` | Staveregelen, uden input og output |
| `src/nato_alphabet/application/` | Use casen og dens porte |
| `src/nato_alphabet/adapters/` | CSV-læseren og konsollen |
| `src/nato_alphabet/constants.py` | Alle programmets konstanter |
| `tests/` | pytest-tests, som spejler `src/` |
Afhængigheder peger indad: adapters kender applikationen, applikationen kender domænet. import-linter håndhæver det.
## Pull requests
Én gren og én pull request pr. milepæl; CI skal være grøn. Projektet følger SQA- og QC-frameworket i `framework/`; se `docs/` for planen og review-optegnelserne.
wiki/Development-ms.md
+43
View File
@@ -0,0 +1,43 @@
# Pembangunan
🌐 [English](Development) · [Dansk](Development-da) · **Bahasa Melayu**
Sediakan projek dahulu ([Pemasangan](Install-ms)). Pilihan tambahan `dev` memasang pytest, ruff, mypy dan import-linter.
## Jalankan ujian
```bash
python -m pytest
```
## Jalankan semakan yang dijalankan oleh CI
```bash
python -m ruff check .
python -m mypy
lint-imports
```
## Bina dokumentasi sumber
```bash
doxygen Doxyfile
```
Buka `build/html/index.html`. Pasang Doxygen dari [doxygen.nl](https://www.doxygen.nl/) atau pengurus pakej anda.
## Susun atur kod
| Folder | Kandungan |
| --- | --- |
| `src/nato_alphabet/domain/` | Peraturan ejaan, tanpa input dan output |
| `src/nato_alphabet/application/` | Kes guna dan portnya |
| `src/nato_alphabet/adapters/` | Pembaca CSV dan konsol |
| `src/nato_alphabet/constants.py` | Semua pemalar program |
| `tests/` | Ujian pytest, mencerminkan `src/` |
Kebergantungan menghala ke dalam: adapter mengenali aplikasi, aplikasi mengenali domain. import-linter menguatkuasakannya.
## Pull request
Satu cabang dan satu pull request bagi setiap milestone; CI mesti hijau. Projek ini mengikut rangka kerja SQA dan QC dalam `framework/`; lihat `docs/` untuk pelan dan rekod semakan.
wiki/Development.md
+43
View File
@@ -0,0 +1,43 @@
# Development
🌐 **English** · [Dansk](Development-da) · [Bahasa Melayu](Development-ms)
Set up the project first ([Install](Install)). The `dev` extra installs pytest, ruff, mypy and import-linter.
## Run the tests
```bash
python -m pytest
```
## Run the checks that CI runs
```bash
python -m ruff check .
python -m mypy
lint-imports
```
## Build the source documentation
```bash
doxygen Doxyfile
```
Open `build/html/index.html`. Install Doxygen from [doxygen.nl](https://www.doxygen.nl/) or your package manager.
## Code layout
| Folder | Content |
| --- | --- |
| `src/nato_alphabet/domain/` | The spelling rule, with no input or output |
| `src/nato_alphabet/application/` | The use case and its ports |
| `src/nato_alphabet/adapters/` | The CSV reader and the console |
| `src/nato_alphabet/constants.py` | Every literal of the program |
| `tests/` | pytest tests, mirroring `src/` |
Dependencies point inward: adapters know the application, the application knows the domain. import-linter enforces it.
## Pull requests
One branch and one pull request per milestone; CI must be green. The project follows the SQA and QC framework in `framework/`; see `docs/` for the plan and the review records.
wiki/Home-da.md
+23
View File
@@ -0,0 +1,23 @@
# NATO-alfabet
🌐 [English](Home) · **Dansk** · [Bahasa Melayu](Home-ms)
Et konsolprogram, der staver et ord med det fonetiske NATO-alfabet. Det er opgaven fra dag 26 i Udemys "100 Days of Code: The Complete Python Pro Bootcamp" og viser list comprehensions og dictionary comprehensions. Det kræver Python 3.13 eller nyere og har ingen runtime-afhængigheder.
![Programmet staver ordet Hello](images/spell-word.png)
| Side | Læs den, når du vil |
| --- | --- |
| [Installation](Install-da) | Oprette et lokalt `.venv` og installere projektet på Windows, Linux eller macOS |
| [Brug](Usage-da) | Køre programmet og læse dets output |
| [Udvikling](Development-da) | Køre testene og kontrollerne og bygge kildedokumentationen |
## Hvem det er til
- **Kursister**, der vil have en læsbar løsning med opgavens funktionsnavne (`load_nato_dict`, `generate_phonetic`) at sammenligne med deres egen.
- **GitHub-besøgende**, der vil se et lille, testet Python-projekt uden runtime-afhængigheder.
## Links
- [Repository](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet)
- [Fejl og ønsker](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/issues)
wiki/Home-ms.md
+23
View File
@@ -0,0 +1,23 @@
# Abjad NATO
🌐 [English](Home) · [Dansk](Home-da) · **Bahasa Melayu**
Alat konsol yang mengeja satu perkataan dengan abjad fonetik NATO. Ia ialah tugasan hari ke-26 dalam "100 Days of Code: The Complete Python Pro Bootcamp" di Udemy dan menunjukkan list comprehension serta dictionary comprehension. Ia memerlukan Python 3.13 atau lebih baharu dan tidak mempunyai kebergantungan masa jalan.
![Alat mengeja perkataan Hello](images/spell-word.png)
| Halaman | Baca apabila anda mahu |
| --- | --- |
| [Pemasangan](Install-ms) | Mencipta `.venv` setempat dan memasang projek di Windows, Linux atau macOS |
| [Penggunaan](Usage-ms) | Menjalankan program dan membaca outputnya |
| [Pembangunan](Development-ms) | Menjalankan ujian dan semakan serta membina dokumentasi sumber |
## Untuk siapa
- **Peserta kursus** yang mahukan penyelesaian yang mudah dibaca dengan nama fungsi tugasan (`load_nato_dict`, `generate_phonetic`) untuk dibandingkan dengan penyelesaian sendiri.
- **Pelawat GitHub** yang mahukan projek Python kecil yang diuji tanpa kebergantungan masa jalan.
## Pautan
- [Repositori](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet)
- [Penjejak isu](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/issues)
wiki/Home.md
+23
View File
@@ -0,0 +1,23 @@
# NATO alphabet
🌐 **English** · [Dansk](Home-da) · [Bahasa Melayu](Home-ms)
A console tool that spells a word with the NATO phonetic alphabet. It is the Day 26 assignment of Udemy's "100 Days of Code: The Complete Python Pro Bootcamp" and shows list and dictionary comprehensions. It needs Python 3.13 or newer and has no runtime dependencies.
![The tool spelling the word Hello](images/spell-word.png)
| Page | Read it when you want to |
| --- | --- |
| [Install](Install) | Create a local `.venv` and install the project on Windows, Linux or macOS |
| [Usage](Usage) | Run the program and read its output |
| [Development](Development) | Run the tests, the checks and build the source documentation |
## Who it is for
- **Course participants** who want a readable solution with the assignment's function names (`load_nato_dict`, `generate_phonetic`) to compare with their own.
- **GitHub viewers** who want a small, tested Python project with no runtime dependencies.
## Links
- [Repository](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet)
- [Issue tracker](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet/issues)
wiki/Install-da.md
+57
View File
@@ -0,0 +1,57 @@
# Installation
🌐 [English](Install) · **Dansk** · [Bahasa Melayu](Install-ms)
## Det skal du bruge
- Python 3.13 eller nyere med modulet `venv`
- Git
## Trin
Alle systemer gør de samme fire ting: klon repository'et, opret et virtuelt miljø kaldet `.venv`, opgradér pip og installér projektet.
### Windows PowerShell
```powershell
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
Hvis PowerShell afviser aktiveringsscriptet, så kør først `Set-ExecutionPolicy -Scope Process RemoteSigned`. Det gælder kun for det vindue.
### Linux Debian
```bash
sudo apt install git python3 python3-venv
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
### macOS
```bash
brew install python@3.13 git
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
## Tjek at det virker
```bash
python -m nato_alphabet
```
Skriv et ord. Du skal se dets kodeord. Næste side: [Brug](Usage-da).
wiki/Install-ms.md
+57
View File
@@ -0,0 +1,57 @@
# Pemasangan
🌐 [English](Install) · [Dansk](Install-da) · **Bahasa Melayu**
## Apa yang diperlukan
- Python 3.13 atau lebih baharu dengan modul `venv`
- Git
## Langkah
Semua sistem melakukan empat perkara yang sama: klon repositori, cipta persekitaran maya bernama `.venv`, naik taraf pip dan pasang projek.
### Windows PowerShell
```powershell
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
Jika PowerShell enggan menjalankan skrip pengaktifan, jalankan `Set-ExecutionPolicy -Scope Process RemoteSigned` dahulu. Ia hanya terpakai pada tetingkap itu.
### Linux Debian
```bash
sudo apt install git python3 python3-venv
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
### macOS
```bash
brew install python@3.13 git
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
## Semak ia berfungsi
```bash
python -m nato_alphabet
```
Masukkan satu perkataan. Anda akan melihat kata kodnya. Seterusnya: [Penggunaan](Usage-ms).
wiki/Install.md
+57
View File
@@ -0,0 +1,57 @@
# Install
🌐 **English** · [Dansk](Install-da) · [Bahasa Melayu](Install-ms)
## What you need
- Python 3.13 or newer with the `venv` module
- Git
## Steps
Every system does the same four things: clone the repository, create a virtual environment called `.venv`, upgrade pip, install the project.
### Windows PowerShell
```powershell
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
py -3.13 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
If PowerShell refuses to run the activation script, run `Set-ExecutionPolicy -Scope Process RemoteSigned` first. It only applies to that window.
### Linux Debian
```bash
sudo apt install git python3 python3-venv
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
### macOS
```bash
brew install python@3.13 git
git clone https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet.git
cd 026-nato-alphabet
python3.13 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"
```
## Check that it works
```bash
python -m nato_alphabet
```
Enter a word. You should see its code words. Next: [Usage](Usage).
wiki/Usage-da.md
+31
View File
@@ -0,0 +1,31 @@
# Brug
🌐 [English](Usage) · **Dansk** · [Bahasa Melayu](Usage-ms)
Aktivér det virtuelle miljø (se [Installation](Install-da)), og start programmet:
```bash
python -m nato_alphabet
```
Den installerede kommando gør det samme:
```bash
nato-alphabet
```
## Stav et ord
Programmet spørger efter et ord og skriver NATO-kodeordet for hvert bogstav i rækkefølge. Store og små bogstaver giver samme resultat.
![Programmet staver ordet Hello](images/spell-word.png)
## Ugyldigt input
Et ciffer, et mellemrum eller et tegn er ikke et bogstav. Programmet siger det og spørger igen.
![Et ord med et ciffer afvises, derefter staves et gyldigt ord](images/retry-invalid.png)
## Tryk Ctrl+C eller Ctrl+D
Afslutter du inputtet (Ctrl+D på Linux og macOS, Ctrl+Z og Enter på Windows) eller trykker Ctrl+C, lukker programmet stille.
wiki/Usage-ms.md
+31
View File
@@ -0,0 +1,31 @@
# Penggunaan
🌐 [English](Usage) · [Dansk](Usage-da) · **Bahasa Melayu**
Aktifkan persekitaran maya (lihat [Pemasangan](Install-ms)), kemudian mulakan program:
```bash
python -m nato_alphabet
```
Arahan yang dipasang melakukan perkara yang sama:
```bash
nato-alphabet
```
## Eja satu perkataan
Program meminta satu perkataan dan mencetak kata kod NATO bagi setiap huruf mengikut urutan. Huruf besar dan huruf kecil memberi keputusan yang sama.
![Alat mengeja perkataan Hello](images/spell-word.png)
## Input tidak sah
Angka, ruang atau tanda baca bukan huruf. Program memberitahu perkara itu dan bertanya semula.
![Perkataan dengan angka ditolak, kemudian perkataan yang sah dieja](images/retry-invalid.png)
## Tekan Ctrl+C atau Ctrl+D
Menamatkan input (Ctrl+D di Linux dan macOS, Ctrl+Z kemudian Enter di Windows) atau menekan Ctrl+C menutup program dengan senyap.
wiki/Usage.md
+31
View File
@@ -0,0 +1,31 @@
# Usage
🌐 **English** · [Dansk](Usage-da) · [Bahasa Melayu](Usage-ms)
Activate the virtual environment (see [Install](Install)), then start the program:
```bash
python -m nato_alphabet
```
The installed command does the same:
```bash
nato-alphabet
```
## Spell a word
The program asks for a word and prints the NATO code word of each letter, in order. Upper and lower case give the same result.
![The tool spelling the word Hello](images/spell-word.png)
## Invalid input
A digit, a space or a punctuation mark is not a letter. The program says so and asks again.
![A word with a digit is rejected, then a valid word is spelled](images/retry-invalid.png)
## Press Ctrl+C or Ctrl+D
Ending the input (Ctrl+D on Linux and macOS, Ctrl+Z then Enter on Windows) or pressing Ctrl+C closes the program quietly.
wiki/_Sidebar.md
+24
View File
@@ -0,0 +1,24 @@
**NATO alphabet**
- [Home](Home)
- [Install](Install)
- [Usage](Usage)
- [Development](Development)
**Dansk**
- [Hjem](Home-da)
- [Installation](Install-da)
- [Brug](Usage-da)
- [Udvikling](Development-da)
**Bahasa Melayu**
- [Utama](Home-ms)
- [Pemasangan](Install-ms)
- [Penggunaan](Usage-ms)
- [Pembangunan](Development-ms)
**Links**
- [Repository](https://git.tirsystem.com/Tirsvad-Udemy-100-days-of-code/026-nato-alphabet)