Skip to main content

Last Big Update: 2.0.0

- Added Support for 20 Languages

- New Error Handler


ROT Converter

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

Features

  • Encryption and decryption with ROT for 21 languages.
  • ROT bruteforce for all supported alphabets.
  • Error handling with clear messages.

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

Supported Languages

Code Language Alphabet Length
en English 26
es Spanish 27
de German 29
fr French 26
it Italian 26
pt Portuguese 26
tr Turkish 29
sv Swedish 29
no Norwegian 29
fi Finnish 29
nl Dutch 26
da Danish 29
ru Russian 33
bg Bulgarian 30
sr Serbian 30
mk Macedonian 31
be Belarusian 31
el Greek 24
he Hebrew 22
hy Armenian 38

Requirements

  • Python 3.6 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 Description
You did not enter a string The string parameter is missing or empty.
You did not enter a language The language parameter is missing or empty.
Type of the language is not a string The language parameter is not a str.
You entered a not supported language The language code is not in the supported list.
You did not enter a key The key parameter is missing (None) in manual mode.
Type of the key is not a integer The key parameter is not an int.

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
m_rot("abc", 2, "")
# ValueError: ERROR! You did not enter a language

# Unsupported language
m_rot("abc", 2, "xx")
# ValueError: ERROR! You entered a not supported language.
# Supported languages: en, es, de, fr, it, pt, tr, sv, no, fi, nl, da, ru, bg, sr, mk, be, el, he, hy

# 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

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

Changelog

Version Date Commit
0.1.0 07.08.2026 Beta: First Beta Version On PyPI
1.0.0 13.08.2026 Release: Just A Release
2.0.0 15.08.2026 Release: New Clean Code, Added Support for 21 Languages And New Error Handler
2.0.1 15.08.2026 Release: Improved Efficiency, Minor Bugs Fixed And a New GitHub Repository
2.0.2 15.08.2026 Release: Normalize Input Strings To NFC
Made by the Hi Team.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rot_converter-2.0.2.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rot_converter-2.0.2-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file rot_converter-2.0.2.tar.gz.

File metadata

  • Download URL: rot_converter-2.0.2.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for rot_converter-2.0.2.tar.gz
Algorithm Hash digest
SHA256 205a511b2dd965a8c4491dc4bb8b3c52627538838d89461606461f54e26bf337
MD5 87cb4f659c2dad1aeb9bdacb16f6a0bc
BLAKE2b-256 ad24bf67f4021d0870cb95b12ea8823a58df5563e5f9cd640d5989037d82c3bb

See more details on using hashes here.

File details

Details for the file rot_converter-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: rot_converter-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 5.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for rot_converter-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 c2392150d770f34a83c1635676d136cc1a26387a4ff36900a1746db50e59cc49
MD5 b57ce18cf47f56f361c16a51ad4dc8e8
BLAKE2b-256 427de0aa51311cff46c72b0dea76740b3eceb01904341ebb3518edf4a41ddc80

See more details on using hashes here.

Release history Release notifications | RSS feed

2.1.0

2 files

This release

2.0.2 This release

2 files

2.0.1

2 files

2.0.0

2 files

1.0.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page