CustomCrypto (version 0.0.1)
index
customcrypto.py

This file implements tools to build your custom cipher.
 
>>> CustomCrypto(xor).dynamic_key_1(b'00', [ord('0')])
[0, 48]
>>> CustomCrypto(xor).reverse_dynamic_key_1([0, 48], [ord('0')])
[48, 48]
>>> CustomCrypto(viginere, string.ascii_uppercase, alphabet_length=26).dynamic_key_2('ACCA', ('C', 'A'))
['C', 'C', 'C', 'C']
>>> CustomCrypto(decipher_viginere, string.ascii_uppercase, alphabet_length=26).dynamic_key_2('CCCC', ('C', 'A'))
['A', 'C', 'C', 'A']
>>> CustomCrypto(None).shuffle('ABCDEFGH', 4)
['A', 'E', 'B', 'F', 'C', 'G', 'D', 'H']
>>> CustomCrypto(None).unshuffle('AEBFCGDH', 4)
['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H']
>>> CustomCrypto(None).reverse('ABCD')
['D', 'C', 'B', 'A']
>>> lines = CustomCrypto(None).group('0' * 40, '0')
>>> lines = "\n".join(" ".join("".join(chars) for chars in words) for words in lines)
>>> print(lines)
30303030 30303030 30303030 30303030 30303030
30303030 30303030 30303030 30303030 30303030
>>> CustomCrypto(None).shift(b'\xff\x00\xf0\xa5\xaa')
b'\xff\x00\x0fZ\xaa'
 
~# python3 -m doctest -v CustomCrypto.py

 
Modules
       
operator
string
sys

 
Classes
       
builtins.object
CustomCrypto

 
class CustomCrypto(builtins.object)
    CustomCrypto(crypt: collections.abc.Callable, *args, **kwargs)
 
This class implements tools to build custom crypto.
 
>>> CustomCrypto(viginere, string.ascii_uppercase, alphabet_length=26).dynamic_key_1('AC', ('C',))
['C', 'E']
 
  Methods defined here:
__init__(self, crypt: collections.abc.Callable, *args, **kwargs)
Initialize self.  See help(type(self)) for accurate signature.
dynamic_key_1(self, data: collections.abc.Iterable, key: collections.abc.Iterable, *args, **kwargs) -> List[Any]
This function crypt data with the key and precedent character/block.
 
>>> CustomCrypto(xor).dynamic_key_1(b'00', [ord('0')])
[0, 48]
>>> CustomCrypto(viginere).dynamic_key_1('AC', ('C',), string.ascii_uppercase, alphabet_length=26)
['C', 'E']
dynamic_key_2(self, data: collections.abc.Iterable, key: collections.abc.Iterable, *args, **kwargs) -> List[Any]
This function crypt data with .
 
>>> CustomCrypto(xor).dynamic_key_2(b'0110', [ord('0'), ord('1')])
[0, 0, 0, 0]
>>> CustomCrypto(viginere, string.ascii_uppercase, alphabet_length=26).dynamic_key_2('ACCA', ('C', 'A'))
['C', 'C', 'C', 'C']
group(self, data: collections.abc.Iterable, alphabet: collections.abc.Iterable, hexa: bool = True, lines_size: int = 5, word_size: int = 4) -> List[List[Any]]
This function format elements in data.
 
data: should be bytes or str (can be Iterable[Any])
alphabet: should be bytes or str (can be Iterable[Any])
hexa: should be boolean (True only with data and alphabet as bytes or str)
 
>>> lines = CustomCrypto(None).group('0' * 40, '0')
>>> lines = "\n".join(" ".join("".join(chars) for chars in words) for words in lines)
>>> print(lines)
30303030 30303030 30303030 30303030 30303030
30303030 30303030 30303030 30303030 30303030
>>> lines = CustomCrypto(None).group(b'0' * 40, b'0', hexa=False)
>>> lines = "\n".join(" ".join("".join(chars) for chars in words) for words in lines)
>>> print(lines)
0000 0000 0000 0000 0000
0000 0000 0000 0000 0000
reverse(self, data: collections.abc.Iterable) -> List[Any]
This function reverse data.
 
>>> CustomCrypto(None).reverse('ABCD')
['D', 'C', 'B', 'A']
>>> c = CustomCrypto(None); c.reverse(c.reverse('ABCD'))
['A', 'B', 'C', 'D']
reverse_dynamic_key_1(self, data: collections.abc.Iterable, key: collections.abc.Iterable, *args, **kwargs) -> List[Any]
This function decrypt data with the key and precedent character/block.
 
>>> c = CustomCrypto(xor)
>>> key = [ord('0')]
>>> c.reverse_dynamic_key_1(c.dynamic_key_1(b'00', key), key)
[48, 48]
>>> c = CustomCrypto(viginere)
>>> d = c.dynamic_key_1('AC', ('C',), string.ascii_uppercase, alphabet_length=26)
>>> c = CustomCrypto(decipher_viginere)
>>> c.reverse_dynamic_key_1(d, ('C',), string.ascii_uppercase, alphabet_length=26)
['A', 'C']
shift(self, data: bytes, shifter: int = 4, decode: bool = False) -> bytes
This function shift bits.
 
>>> CustomCrypto(None).shift(b'\xff\x00\xf0\xa5\xaa')
b'\xff\x00\x0fZ\xaa'
>>> CustomCrypto(None).shift(b'\xff\x00\x0fZ\xaa', decode=True)
b'\xff\x00\xf0\xa5\xaa'
>>> CustomCrypto(None).shift(b'', shifter=8)
Traceback (most recent call last):
    ...
ValueError: 'shifter' should be smaller than 8.
>>> CustomCrypto(None).shift(b'', shifter=9)
Traceback (most recent call last):
    ...
ValueError: 'shifter' should be smaller than 8.
shuffle(self, data: collections.abc.Iterable, number: int = 2) -> List[Any]
This function shuffle data in <number> sections.
 
>>> CustomCrypto(None).shuffle('ABCD')
['A', 'C', 'B', 'D']
>>> CustomCrypto(None).shuffle('ABCDEFGH', 4)
['A', 'E', 'B', 'F', 'C', 'G', 'D', 'H']
unshuffle(self, data: collections.abc.Iterable, number: int = 2) -> List[Any]
This function shuffle data in <number> sections.
 
>>> CustomCrypto(None).unshuffle('ACBD')
['A', 'B', 'C', 'D']
>>> c = CustomCrypto(None); c.unshuffle(c.shuffle('ABCDEFGH', 4), 4)
['A', 'B', 'C', 'D', 'E', 'F', 'G', 'H']

Data descriptors defined here:
__dict__
dictionary for instance variables (if defined)
__weakref__
list of weak references to the object (if defined)

 
Functions
       
decipher_monoalphabetique(data: collections.abc.Iterable, key: Union[Dict[Any, Any], collections.abc.Iterable[Tuple[Any, Any]], Tuple[collections.abc.Iterable[Any, Any]]]) -> List[Any]
This function implement monoalphabetique cipher.
 
key as dict:
    - key: should contains any element of data
 
key as tuples:
    - key[x][0] should contains any element of data
 
key as tuple:
    - key[0] should contains any element of data
 
>>> decipher_monoalphabetique("B", {"A": "B"})
['A']
>>> decipher_monoalphabetique("B", [("A","B")])
['A']
>>> decipher_monoalphabetique("B", ("A","B"))
['A']
>>> decipher_monoalphabetique("B", 10)
Traceback (most recent call last):
    ...
TypeError: 'key' should be a Dict[Any, Any], a Tuple[Iterable[Any, Any]] or Iterable[Tuple[Any, Any]].
decipher_viginere(char_data: Union[str, bytes], char_key: Union[str, bytes], alphabet: Union[str, bytes] = ['\x00', '\x01', '\x02', '\x03', '\x04', '\x05', '\x06', '\x07', '\x08', '\t', '\n', '\x0b', '\x0c', '\r', '\x0e', '\x0f', '\x10', '\x11', '\x12', '\x13', '\x14', '\x15', '\x16', '\x17', '\x18', '\x19', '\x1a', '\x1b', '\x1c', '\x1d', '\x1e', '\x1f', ' ', '!', '"', '#', '$', '%', '&', "'", '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~', '\x7f', '\x80', '\x81', '\x82', '\x83', '\x84', '\x85', '\x86', '\x87', '\x88', '\x89', '\x8a', '\x8b', '\x8c', '\x8d', '\x8e', '\x8f', '\x90', '\x91', '\x92', '\x93', '\x94', '\x95', '\x96', '\x97', '\x98', '\x99', '\x9a', '\x9b', '\x9c', '\x9d', '\x9e', '\x9f', '\xa0', '¡', '¢', '£', '¤', '¥', '¦', '§', '¨', '©', 'ª', '«', '¬', '\xad', '®', '¯', '°', '±', '²', '³', '´', 'µ', '¶', '·', '¸', '¹', 'º', '»', '¼', '½', '¾', '¿', 'À', 'Á', 'Â', 'Ã', 'Ä', 'Å', 'Æ', 'Ç', 'È', 'É', 'Ê', 'Ë', 'Ì', 'Í', 'Î', 'Ï', 'Ð', 'Ñ', 'Ò', 'Ó', 'Ô', 'Õ', 'Ö', '×', 'Ø', 'Ù', 'Ú', 'Û', 'Ü', 'Ý', 'Þ', 'ß', 'à', 'á', 'â', 'ã', 'ä', 'å', 'æ', 'ç', 'è', 'é', 'ê', 'ë', 'ì', 'í', 'î', 'ï', 'ð', 'ñ', 'ò', 'ó', 'ô', 'õ', 'ö', '÷', 'ø', 'ù', 'ú', 'û', 'ü', 'ý', 'þ', 'ÿ'], *, alphabet_length: int = None) -> Union[str, int]
This function implement VIGINERE cipher.
 
char_data: should be a str or bytes of length 1
char_key:  should be a str or bytes of length 1
alphabet: should contains char_data and char_key
alphabet_length: should be the alphabet length
 
>>> decipher_viginere('C', 'C', string.ascii_uppercase)
'A'
>>> decipher_viginere(b'C', b'C', string.ascii_uppercase.encode('ascii'))
65
monoalphabetique(data: collections.abc.Iterable, key: Union[Dict[Any, Any], collections.abc.Iterable[Tuple[Any, Any]], Tuple[collections.abc.Iterable[Any, Any]]]) -> List[Any]
This function implement monoalphabetique cipher.
 
key as dict:
    - key: should contains any element of data
 
key as tuples:
    - key[x][0] should contains any element of data
 
key as tuple:
    - key[0] should contains any element of data
 
>>> monoalphabetique("A", {"A": "B"})
['B']
>>> monoalphabetique("A", [("A","B")])
['B']
>>> monoalphabetique("A", ("A","B"))
['B']
>>> monoalphabetique("A", 10)
Traceback (most recent call last):
    ...
TypeError: 'key' should be a Dict[Any, Any], a Tuple[Iterable[Any, Any]] or Iterable[Tuple[Any, Any]].
viginere(char_data: Union[str, bytes], char_key: Union[str, bytes], alphabet: Union[str, bytes] = ['\x00', '\x01', '\x02', '\x03', '\x04', '\x05', '\x06', '\x07', '\x08', '\t', '\n', '\x0b', '\x0c', '\r', '\x0e', '\x0f', '\x10', '\x11', '\x12', '\x13', '\x14', '\x15', '\x16', '\x17', '\x18', '\x19', '\x1a', '\x1b', '\x1c', '\x1d', '\x1e', '\x1f', ' ', '!', '"', '#', '$', '%', '&', "'", '(', ')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', ':', ';', '<', '=', '>', '?', '@', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', '[', '\\', ']', '^', '_', '`', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~', '\x7f', '\x80', '\x81', '\x82', '\x83', '\x84', '\x85', '\x86', '\x87', '\x88', '\x89', '\x8a', '\x8b', '\x8c', '\x8d', '\x8e', '\x8f', '\x90', '\x91', '\x92', '\x93', '\x94', '\x95', '\x96', '\x97', '\x98', '\x99', '\x9a', '\x9b', '\x9c', '\x9d', '\x9e', '\x9f', '\xa0', '¡', '¢', '£', '¤', '¥', '¦', '§', '¨', '©', 'ª', '«', '¬', '\xad', '®', '¯', '°', '±', '²', '³', '´', 'µ', '¶', '·', '¸', '¹', 'º', '»', '¼', '½', '¾', '¿', 'À', 'Á', 'Â', 'Ã', 'Ä', 'Å', 'Æ', 'Ç', 'È', 'É', 'Ê', 'Ë', 'Ì', 'Í', 'Î', 'Ï', 'Ð', 'Ñ', 'Ò', 'Ó', 'Ô', 'Õ', 'Ö', '×', 'Ø', 'Ù', 'Ú', 'Û', 'Ü', 'Ý', 'Þ', 'ß', 'à', 'á', 'â', 'ã', 'ä', 'å', 'æ', 'ç', 'è', 'é', 'ê', 'ë', 'ì', 'í', 'î', 'ï', 'ð', 'ñ', 'ò', 'ó', 'ô', 'õ', 'ö', '÷', 'ø', 'ù', 'ú', 'û', 'ü', 'ý', 'þ', 'ÿ'], *, alphabet_length: int = None) -> Union[str, int]
This function implement VIGINERE cipher.
 
char_data: should be a str or bytes of length 1
char_key:  should be a str or bytes of length 1
alphabet: should contains char_data and char_key
alphabet_length: should be the alphabet length
 
>>> viginere('A', 'C', string.ascii_uppercase)
'C'
>>> viginere(b'A', b'C', string.ascii_uppercase.encode('ascii'))
67
xor(a, b, /)
Same as a ^ b.

 
Data
        __all__ = ['CustomCrypto', 'xor', 'viginere', 'decipher_viginere', 'monoalphabetique', 'decipher_monoalphabetique']
__author_email__ = 'mauricelambert434@gmail.com'
__copyright__ = '\nCustomCrypto Copyright (C) 2021 Maurice Lambe...ome to redistribute it\nunder certain conditions.\n'
__description__ = '\nThis package implements tools to build your custom cipher.\n'
__license__ = 'GPL-3.0 License'
__maintainer__ = 'Maurice Lambert'
__maintainer_email__ = 'mauricelambert434@gmail.com'
__url__ = 'https://github.com/mauricelambert/CustomCrypto'

 
Author
        Maurice Lambert