pymorsed 0.1.0

Encode, decode, generate, and analyze Morse code audio signals in Python.

pymorsed

A Python library for encoding, decoding, generating, and analyzing Morse code audio signals.

Features

• Convert text to Morse code

• Convert Morse code to text

• Multi-language support

  • English
  • Russian

• Generate Morse code audio signals

• Decode Morse code from WAV audio files

• Visualize Morse code waveforms

• JSON-based language mappings

• Fully tested with automated CI pipeline

Documentation

Full documentation is available at : https://shauryaprakashverma.github.io/pymorsed/

Installation

pip install pymorsed

---

Quick Start

Encode Text

from pymorsed import encode

morse = encode("HELLO WORLD")
print(morse)

Output:

.... . .-.. .-.. --- / .-- --- .-. .-.. -..

---

Decode Morse Code

from pymorsed import decode

text = decode(".... . .-.. .-.. --- / .-- --- .-. .-.. -..")
print(text)

Output:

HELLO WORLD

---

Generate Morse Audio

from pymorsed import encode
from pymorsed.audio_encoder import morse_to_audio

morse = encode("SOS")
audio = morse_to_audio(morse)

---

Save Audio to File

from pymorsed.audio_encoder import (
    morse_to_audio,
    save_audio
)

audio = morse_to_audio("... --- ...")

save_audio(
    audio,
    "sos.wav",
    44100
)

---

Decode Audio File

from pymorsed.audio_decoder import decode_from_file

text = decode_from_file("sos.wav")

print(text)

Output:

SOS

---

Morse Code Conventions

pymorsed follows standard Morse code formatting:

Symbol	Meaning
.	Dot
-	Dash
Space ( )	Letter separator
/	Word separator

Example:

HELLO WORLD

becomes:

.... . .-.. .-.. --- / .-- --- .-. .-.. -..

---

Supported Languages

Language	Code
English	english
Russian	russian

Additional language mappings may be added in future releases.

---

Example Imports

Root Package Imports

from pymorsed import encode
from pymorsed import decode

Module Imports

from pymorsed.encoder import encode
from pymorsed.decoder import decode

from pymorsed.audio_encoder import (
    morse_to_audio,
    play_audio,
    save_audio,
    plot_waveform
)

from pymorsed.audio_decoder import decode_from_file

Development

Clone the repository:

git clone https://github.com/ShauryaPrakashVerma/pymorsed.git
cd pymorsed

Install dependencies:

pip install -e .

Run tests:

pytest

Run tests with coverage:

pytest --cov=pymorsed

License

This project is licensed under the MIT License.

See the LICENSE file for details.