Added new codec: ordinals

README.md

@@ -25,6 +25,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
+`ordinals` | Ordinals <-> text | dummy character ordinals conversion
 `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

codext/others/ordinals.py

@@ -0,0 +1,16 @@
+# -*- coding: UTF-8 -*-
+"""Ordinals Codec - ordinals 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 = {chr(i): str(i) for i in range(256)}
+
+
+add_map("ordinals", ENCMAP, sep=" ", pattern=r"^ordinals?$")

docs/encodings.md

@@ -153,6 +153,23 @@ At this time, only Nokia 3310 keystrokes is supported.
 
 -----
 
+### Ordinals
+
+This simple codec converts characters into their ordinals.
+
+**Codec** | **Conversions** | **Aliases** | **Comment**
+:---: | :---: | --- | ---
+`ordinals` | Ordinals <-> text | `ordinal` | 
+
+```python
+>>> codext.encode("this is a test", "ordinal")
+'116 104 105 115 32 105 115 32 97 32 116 101 115 116'
+>>> codext.decode("116 104 105 115 32 105 115 32 97 32 116 101 115 116", "ordinals")
+'this is a test'
+```
+
+-----
+
 ### Radio Alphabet
 
 This is also known as the [NATO phonetic alphabet](https://en.wikipedia.org/wiki/NATO_phonetic_alphabet).