📡 Morsecode Handler

Easily encode and decode Morse code in Python 🐍.
This library is simple, lightweight, and includes both a Python API and a Command-Line Interface (CLI).

✅ Learn Morse code
✅ Encode secret messages
✅ Use it in scripts, projects, or just for fun

🚀 Installation

Install from PyPI:

pip install morsecode_handler

🛠️ Usage in Python

import morsecode_handler

# Encode text
encoded = morsecode_handler.encode("HELLO WORLD")
print(encoded)
# .... . .-.. .-.. --- / .-- --- .-. .-.. -..

# Decode Morse back to text
decoded = morsecode_handler.decode(".... . .-.. .-.. --- / .-- --- .-. .-.. -..")
print(decoded)
# HELLO WORLD

Lenient Mode (skip unknown characters)

import morsecode_handler

morsecode_handler.encode("HELLO 🙂", strict=False, unknown="?")
# .... . .-.. .-.. --- / ?

💻 Command Line Tool

Once installed, you also get the morsecode CLI:

# Encode
morsecode_handler encode "HELLO WORLD"
# .... . .-.. .-.. --- / .-- --- .-. .-.. -..

# Decode
morsecode_handler decode ".... . .-.. .-.. --- / .-- --- .-. .-.. -.."
# HELLO WORLD

# Lenient mode (replace unknown characters with '?')
morsecode_handler encode "HELLO 🙂" --lenient
# .... . .-.. .-.. --- / ?

🌍 Supported Languages

This library supports 41 languages across Latin, Cyrillic, Arabic, Hebrew, Greek, and Korean scripts.
We follow the ISO 639-1 standard for the two-letter language codes (e.g., EN for English, FR for French, RU for Russian).

⚡ Features

• 🔑 Encode and decode Morse code
• 🎯 Strict mode (raise errors) or Lenient mode (skip unknowns)
• 💻 CLI for quick terminal use
• 🌍 Multi-language support via JSON dictionary
• 🚀 High Performance: Features lazy-loaded data and @functools.lru_cache for maximum speed during bulk encoding/decoding.
• 📝 MIT licensed — free to use anywhere

🛠️ Development & Testing

We welcome contributions! To set up the development environment, clone the repo and install the dev dependencies:

git clone https://github.com/mricardo888/morsecode.git
cd morsecode-handler
pip install -e ".[dev]"

Run the pytest suite to ensure everything is working correctly:

pytest -v tests/

📜 License

Released under the MIT License. Created by Ricardo (mricardo888).