Added new codec: radio

README.md

@@ -23,6 +23,7 @@ This library extends the native `codecs` library and provides some new encodings
 `markdown` | markdown --> HTML | unidirectional
 `morse` | morse <-> text | uses whitespace as a separator
 `nokia3310` | Nokia 3310 keystrokes <-> text | uses "`-`" as a separator for encoding, "`-`" or "`_`" or whitespace for decoding
+`radio` | Radio <-> text | aka NATO or radio phonetic alphabet
 `rot-N` | ROT(N) <-> text | aka Caesar cipher (N belongs to [1,25])
 `url` | URL <-> text | aka URL encoding
 `xor-N` | XOR(N) <-> text | XOR with a single byte (N belongs to [1,255])

codext/languages/__init__.py

@@ -1,3 +1,4 @@
 # -*- coding: UTF-8 -*-
 from .braille import *
 from .morse import *
+from .radio import *

codext/languages/radio.py

@@ -0,0 +1,22 @@
+# -*- coding: UTF-8 -*-
+"""Radio Codec - NATO/Military phonetic alphabet content encoding.
+
+This codec:
+- en/decodes strings from str to str
+- en/decodes strings from bytes to bytes
+- decodes file content to str (read)
+- encodes file content from str to bytes (write)
+"""
+from ..__common__ import *
+
+
+ENCMAP = {
+    'A': "Alpha", 'B': "Bravo", 'C': "Charlie", 'D': "Delta", 'E': "Echo", 'F': "Foxtrot", 'G': "Golf", 'H': "Hotel",
+    'I': "India", 'J': "Juliett", 'K': "Kilo", 'L': "Lima", 'M': "Mike", 'N': "November", 'O': "Oscar", 'P': "Papa",
+    'Q': "Quebec", 'R': "Romeo", 'S': "Sierra", 'T': "Tango", 'U': "Uniform", 'V': "Victor", 'W': "Whiskey",
+    'X': "X-ray", 'Y': "Yankee", 'Z': "Zulu", ' ': "/",
+}
+
+
+add_map("radio", ENCMAP, sep=" ", ignore_case="both",
+        pattern=r"^(?:military|nato|radio)(?:[-_]phonetic)?[-_]alphabet?$")

docs/encodings.md

@@ -172,6 +172,23 @@ At this time, only Nokia 3310 keystrokes is supported.
 
 -----
 
+### Radio Alphabet
+
+This is also known as the [NATO phonetic alphabet](https://en.wikipedia.org/wiki/NATO_phonetic_alphabet).
+
+**Codec** | **Conversions** | **Aliases** | **Comment**
+:---: | :---: | --- | ---
+`radio` | Radio <-> text | `military_alphabet`, `nato-phonetic-alphabet`, `radio-alphabet` | 
+
+```python
+>>> codext.encode("foobar", "nato_phonetic_alphabet")
+'Foxtrot Oscar Oscar Bravo Alpha Romeo'
+>>> codext.decode("Foxtrot Oscar Oscar Bravo Alpha Romeo", "radio-alphabet")
+'FOOBAR'
+```
+
+-----
+
 ### ROT N
 
 This is a dynamic encoding, that is, it can be called with an integer to define the ROT offset. Encoding will apply a positive offset, decoding will apply a negative one.