Added codec: feron74

Author: dhondta

README.md

@@ -365,6 +365,7 @@ This category also contains `ascii85`, `adobe`, `[x]btoa`, `zeromq` with the `ba
 - [X] `enigma`: aka Enigma machine (Enigma I, M3 and M4, with reflector, rotors, rings, positions and plugboard)
 - [X] `esab46`: aka ESAB-46 (Base64 with a shuffled alphabet, from online JavaScript tools)
 - [X] `ezip64`: aka EZIP-64 (variant of ARMON-64 with smaller blocks)
+- [X] `feron74`: aka FERON-74 (Base64 with a shuffled alphabet, from online JavaScript tools)
 - [X] `foursquare`: aka Four-square Cipher (bigrams substituted with two keyed squares and two plain ones)
 - [X] `fractionated-morse`: aka Fractionated Morse Cipher (Morse code split into groups of three symbols, each replaced by a letter of a keyed alphabet)
 - [X] `gronsfeld`: aka Gronsfeld Cipher (variant of Vigenere Cipher with a numeric key)

docs/pages/enc/crypto.md

@@ -418,6 +418,23 @@ This toy cipher, a variant of [ARMON-64](#armon-64), comes from online JavaScrip
 
 -----
 
+### FERON-74
+
+This toy cipher comes from online JavaScript encryption tools. Like [ATOM-128](#atom-128), it is Base64 with a shuffled alphabet, whose 65th character (`4`) is used for padding, and the text is first escaped with JavaScript's `escape()`, then unescaped after decoding.
+
+**Codec** | **Conversions** | **Aliases** | **Comment**
+:---: | :---: | --- | ---
+`feron74` | text <-> FERON-74 ciphertext | `feron-74`, `feron_74` | 
+
+```python
+>>> codext.encode("this is a test", "feron74")
+'sbxMC161WbyZ/rSiNq61WcDyCnA4'
+>>> codext.decode("sbxMC161WbyZ/rSiNq61WcDyCnA4", "feron-74")
+'this is a test'
+```
+
+-----
+
 ### Four-square Cipher
 
 The Four-square cipher, invented by Felix Delastelle, substitutes pairs of letters using four squares arranged in a 2x2 matrix: the upper-left and lower-right ones hold the alphabet in order, while the upper-right and lower-left ones are filled with two keywords. The first letter of each pair is located in the upper-left square and the second one in the lower-right square ; they are replaced by the letters at the other corners of the rectangle they form (in the upper-right square, then in the lower-left one).

src/codext/crypto/__init__.py

@@ -16,6 +16,7 @@
 from .enigma import *
 from .esab46 import *
 from .ezip64 import *
+from .feron74 import *
 from .foursquare import *
 from .fractionatedmorse import *
 from .hill import *

src/codext/crypto/_jsbase64.py

@@ -1,5 +1,5 @@
 # -*- coding: UTF-8 -*-
-"""Base64 variants, shared by the toy ciphers of online JavaScript encryption tools (ATOM-128, ESAB-46).
+"""Base64 variants, shared by the toy ciphers of online JavaScript encryption tools (ATOM-128, ESAB-46, FERON-74).
 
 These ciphers are Base64 with a shuffled alphabet of 65 characters, whose last one is used for padding. As in the
  original JavaScript, the text is first escaped with JavaScript's escape() (e.g. " " becoming "%20" and "é" becoming

src/codext/crypto/feron74.py

@@ -0,0 +1,30 @@
+# -*- coding: UTF-8 -*-
+"""FERON-74 Codec - FERON-74 content encoding.
+
+FERON-74 is a toy cipher found on online JavaScript encryption tools. It is Base64 with a shuffled alphabet, whose 65th
+ character ("4") is used for padding. As in the original JavaScript, the text is first escaped with JavaScript's
+ escape() (e.g. " " becoming "%20" and "é" becoming "%E9"), and unescaped after decoding ; ciphertexts made without this
+ escaping (i.e. from the UTF-8 bytes of the text) are then decoded the same way.
+
+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)
+
+Reference: http://qbarbe.free.fr/crypto/eng_feron74c.php
+"""
+from ._jsbase64 import js_base64
+from ..__common__ import add
+
+
+__examples__ = {
+    'enc(feron74|feron-74|feron_74)': {'this is a test': "sbxMC161WbyZ/rSiNq61WcDyCnA4", 'test': "sbRZs744", '': ""},
+    'dec(feron74)': {'sbRZs744': "test", 'sbRZ s744': "test", 'sbRZs74': None, 'sbRZs74%': None},
+    'enc-dec(feron74)': ["this is a test", "Hello, World! 1234", "\xe9t\xe9 ☃ \U0001F600", "100% sure", "a"],
+}
+__guess__ = ["feron74"]
+
+
+add("feron74", *js_base64("feron74", "75XYTabcS/UVWdefADqr6RuvN8PBCsQtwx2KLyz+OM3Hk9ghi01ZFlmnjopE=GIJ4"),
+    r"^feron[-_]?74$", printables_rate=1., expansion_factor=(1.6, .3))