phonetic-nato 0.2.0

A beautiful CLI for the NATO phonetic alphabet built with Python, Click, and Rich

nato-phonetic-alphabet

Printable / Remixable Nato Phonetic Alphabet page with a beautiful command-line interface.

Project page is hosted at https://trtmn.io/nato-phonetic-alphabet

Command Line Interface

A beautiful and easy-to-use CLI built with Python 3.11, Click, and Rich for displaying and working with the NATO phonetic alphabet.

Features

• 🎨 Beautiful Output: Rich terminal formatting with colors and styling
• 🔍 Search & Lookup: Find phonetic equivalents for letters and words
• 📝 Interactive Mode: Spell out words interactively
• 🖨️ Printable Output: Generate formatted output for printing
• 🚀 Fast & Lightweight: Built with modern Python libraries

Installation

Prerequisites

• Python 3.11 or higher
• pip (Python package installer)

Setup

1. Clone the repository:

   git clone https://codeberg.org/trtmn/nato-phonetic-alphabet.git
   cd nato-phonetic-alphabet
   

2. Create and activate virtual environment:

   python3.11 -m venv .venv
   source .venv/bin/activate  # On macOS/Linux
   # or
   .venv\Scripts\activate     # On Windows
   

3. Install dependencies:

   pip install -r requirements.txt
   

4. Install the CLI:

   pip install -e .
   

Usage

Basic Commands

Display the full NATO phonetic alphabet:

phonetic

Look up a specific letter:

phonetic lookup A

Spell out a word:

phonetic spell "HELLO"

Interactive spelling mode:

phonetic interactive

Generate printable output:

phonetic print --output nato-alphabet.txt

Command Options

phonetic --help

Available commands:

• lookup <letter> - Find phonetic equivalent for a single letter
• spell <word> - Spell out a word using NATO phonetic alphabet
• interactive - Enter interactive mode for spelling words
• print - Generate formatted output for printing
• list - Display the complete NATO phonetic alphabet

Examples

# Look up a letter
phonetic lookup X
# Output: X - X-ray

# Spell a word
phonetic spell "WORLD"
# Output: W - Whiskey, O - Oscar, R - Romeo, L - Lima, D - Delta

# Interactive mode
phonetic interactive
# Enter words to spell them out interactively

Development

Project Structure

nato-phonetic-alphabet/
├── .venv/                 # Virtual environment
├── src/                   # Source code
│   └── nato_phonetic/     # Main package
├── tests/                 # Test files
├── requirements.txt       # Python dependencies
├── pyproject.toml         # Project configuration
└── README.md             # This file

Running Tests

pytest tests/

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Submit a pull request

Dependencies

• Click: Command-line interface creation kit
• Rich: Rich text and beautiful formatting in the terminal
• Python 3.11+: Modern Python features and performance

License

This project is open source. See the LICENSE file for details.