Be Careful! This Is A Beta Test Some Functions May Not Work Stably.

Last Big Update: 3.0.0b1

- Added Smart ROT Mode

ROT Converter

A library for the ROT cipher with multi-language support.

Features

• Encryption and decryption with ROT for 20 languages.
• ROT bruteforce for all supported alphabets.
• CLI Mode.
• Custom Alphabets For The ROT.
• Error handling with clear messages.
• Smart ROT mode based on frequency analysis

Installation

pip install rot-converter

Usage

Import the functions:

from rot_converter import m_rot, b_rot

Manual ROT — m_rot(string: str, key: int, language: str)

Shifts each letter in the string by the given key within the specified alphabet.

from rot_converter import m_rot

temp_str = "tqv_eqpxgtvgt"
new_str = m_rot(temp_str, -2, "en")

print(new_str)  # Output: rot_converter

Bruteforce ROT — b_rot(string: str, language: str)

Returns a list of all possible ROT shifts for the given string.

from rot_converter import b_rot

temp_str = "bcd"
results = b_rot(temp_str, "en")

print(results[24])  # Output: zab
print(results[25])  # Output: abc

Custom Alphabet — m_rot(string: str, key: int, custom_alphabet: str)

Use your own alphabet for encryption/decryption.

from rot_converter import m_rot

# Base-36 alphabet
alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"
result = m_rot("HELLO", 5, alphabet)
print(result)

Smart ROT Mode - smart_rot(string: str, language: str) - This Feature Is In Beta Development.

CLI Usage

After installation, the rot-converter command is available in your terminal.

Commands

Options

Examples

# Encrypt
rot-converter encrypt "hello" --key 3 --lang en
# Output: khoor

# Decrypt
rot-converter decrypt "khoor" --key 3 --lang en
# Output: hello

# Bruteforce
rot-converter brute "bcd" --lang en
# Output:
#  Shift | Text
# ----------------------------------------
#      0 | bcd
#      1 | cde
#     ...
#     25 | abc

Supported Languages

Requirements

• Python 3.10 or higher.
• No external dependencies (uses only standard library).

Error Handling

The library validates all inputs and raises ValueError with descriptive messages.

Error Types

Error Examples

from rot_converter import m_rot, b_rot

# Missing string
m_rot("", 2, "en")
# ValueError: ERROR! You did not enter a string

# Missing language or custom alphabet
m_rot("abc", 2, "")
# ValueError: ERROR! You did not enter a language or a custom alphabet

# Missing key
m_rot("abc", None, "en")
# ValueError: ERROR! You did not enter a key

# Key is a float
m_rot("abc", 1.5, "en")
# ValueError: ERROR! Type of the key is not a integer

# Unsupported language for the smart mode
smart_rot("Hello", "xx")
# ValueError: ERROR! Language for the smart mode is not support

# Multiple errors
m_rot("", 2.5, "")
# ValueError: ERROR! You did not enter a string
# ERROR! You did not enter a language or a custom alphabet
# ERROR! Type of the key is not a integer

Changelog

Made by the Hi Team.