rot-converter 0.1.0__tar.gz

rot_converter-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2018 The Python Packaging Authority
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rot_converter-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: rot-converter
+Version: 0.1.0
+Summary: A library for the ROT cipher.
+Author-email: BasicSweater <ivanvotints@yandex.ru>
+License: MIT
+Project-URL: Homepage, https://github.com/BasicTShirt/rot-converter/blob/main/README.md
+Project-URL: Repository, https://github.com/BasicTShirt/rot-converter
+Keywords: rot,converter,beta
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# First Version: 0.1.0!
+
+---
+
+# ROT Converter
+
+A library for the ROT cipher.
+
+## Features
+
+- Encryption and decryption from ROT.
+- ROT bruteforce.
+- Error handling with clear messages.
+
+## Installation
+
+```bash
+pip install rot-converter
+```
+
+---
+
+## Usage
+
+- To import, use «from rot_converter import *» or «from rot_converter import m_rot, b_rot».
+- To use the library functions, use the command «m_rot(string: str, key: int)» or «b_rot(string: str)».
+
+### For example
+
+#### This program accepts a string (str) as input and outputs this string in the ROT.
+
+```python
+from rot import m_rot
+
+temp_str = input() # Input: tqv_eqpxgtvgt
+new_str = m_rot(temp_str, 2)
+
+print(new_str) # Output: rot_converter
+```
+## Requirements
+
+- Python 3.6 or higher.
+- No external dependencies (uses only standard library).
+
+---
+
+## Error Handling
+
+The library includes a comprehensive error handling system that validates inputs and provides clear, informative error messages.
+
+### Error Types
+| Error                            | Description                                                                          |
+|----------------------------------|--------------------------------------------------------------------------------------|
+| **You did not enter a string**   | The ROT_string parameter is missing or passed as an empty string ""                  |
+| **Key is not an integer**        | The ROT_key parameter cannot be a floating-point number, string, or any non-int type |
+| **You did not enter a key**      | The ROT_key parameter is required but missing (None) in manual mode                  |
+### Error Examples
+
+```python
+from rot import m_rot, b_rot
+
+# Missing string
+result = m_rot("", 24)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+
+
+# Missing key in manual mode
+result = m_rot("tqv_eqpxgtvgt", None)
+print(result)
+# Output:
+# ERROR! You did not enter a key
+
+
+# Key is a float number
+result = m_rot("tqv_eqpxgtvgt", 1.5)
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Key is a string
+result = m_rot("tqv_eqpxgtvgt", "key")
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Multiple errors (all displayed)
+result = m_rot("", 2.5)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+# 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                                                                          |
+###### **Made by the Hi Team.**

rot_converter-0.1.0/README.md

@@ -0,0 +1,104 @@
+# First Version: 0.1.0!
+
+---
+
+# ROT Converter
+
+A library for the ROT cipher.
+
+## Features
+
+- Encryption and decryption from ROT.
+- ROT bruteforce.
+- Error handling with clear messages.
+
+## Installation
+
+```bash
+pip install rot-converter
+```
+
+---
+
+## Usage
+
+- To import, use «from rot_converter import *» or «from rot_converter import m_rot, b_rot».
+- To use the library functions, use the command «m_rot(string: str, key: int)» or «b_rot(string: str)».
+
+### For example
+
+#### This program accepts a string (str) as input and outputs this string in the ROT.
+
+```python
+from rot import m_rot
+
+temp_str = input() # Input: tqv_eqpxgtvgt
+new_str = m_rot(temp_str, 2)
+
+print(new_str) # Output: rot_converter
+```
+## Requirements
+
+- Python 3.6 or higher.
+- No external dependencies (uses only standard library).
+
+---
+
+## Error Handling
+
+The library includes a comprehensive error handling system that validates inputs and provides clear, informative error messages.
+
+### Error Types
+| Error                            | Description                                                                          |
+|----------------------------------|--------------------------------------------------------------------------------------|
+| **You did not enter a string**   | The ROT_string parameter is missing or passed as an empty string ""                  |
+| **Key is not an integer**        | The ROT_key parameter cannot be a floating-point number, string, or any non-int type |
+| **You did not enter a key**      | The ROT_key parameter is required but missing (None) in manual mode                  |
+### Error Examples
+
+```python
+from rot import m_rot, b_rot
+
+# Missing string
+result = m_rot("", 24)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+
+
+# Missing key in manual mode
+result = m_rot("tqv_eqpxgtvgt", None)
+print(result)
+# Output:
+# ERROR! You did not enter a key
+
+
+# Key is a float number
+result = m_rot("tqv_eqpxgtvgt", 1.5)
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Key is a string
+result = m_rot("tqv_eqpxgtvgt", "key")
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Multiple errors (all displayed)
+result = m_rot("", 2.5)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+# 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                                                                          |
+###### **Made by the Hi Team.**

rot_converter-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rot-converter"
+version = "0.1.0"
+authors = [
+    {name = "BasicSweater", email = "ivanvotints@yandex.ru"},
+]
+description = "A library for the ROT cipher."
+readme = "README.md"
+requires-python = ">=3.6"
+license = {text = "MIT"}
+keywords = ["rot", "converter", "beta"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.6",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Homepage = "https://github.com/BasicTShirt/rot-converter/blob/main/README.md"
+Repository = "https://github.com/BasicTShirt/rot-converter"
+
+[tool.setuptools]
+packages = ["rot_converter"]

rot_converter-0.1.0/rot_converter/__init__.py

@@ -0,0 +1,15 @@
+"""
+Sys Converter - a library for converting numbers between different number systems.
+
+Main features:
+- Convert integers to any number system (2-36)
+- Convert fractional numbers with precision limit
+- Error handling and input validation
+"""
+
+__version__ = "0.1.0"
+__author__ = "BasicSweater"
+
+from .converter import m_rot, b_rot
+
+__all__ = ["m_rot", "b_rot"]

rot_converter-0.1.0/rot_converter/converter.py

@@ -0,0 +1,96 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -
+# version 0.1.0
+
+class ROT_Convertor_Class():
+	def __init__(self):
+		super().__init__()
+
+		self.alphabet = ['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']
+
+	def combine_error_handler(self, ROT_string, ROT_key):
+		self.error_state = None
+		self.error_message = None
+
+		self.errors = []
+
+		self.type_ROT_string = type(ROT_string)
+		self.type_ROT_key = type(ROT_key)
+
+		if ROT_string is None or ROT_string == "":
+			self.errors.append("ERROR! You did not enter a string")
+
+		if self.mode == "manual":
+			if ROT_key is None:
+				self.errors.append("ERROR! You did not enter a key")
+			else:
+				if self.type_ROT_key != int:
+					self.errors.append("ERROR! Type of the key is not a integer")
+
+		if self.errors:
+			self.error_state = False
+			self.error_message = "\n".join(self.errors) + "\n"
+		else:
+			self.error_state = True
+
+
+	def m_rot(self, ROT_string, ROT_key):
+		self.mode = "manual"
+		self.local_ROT_string = str(ROT_string)
+		self.local_ROT_key = ROT_key
+
+		self.combine_error_handler(ROT_string, ROT_key)
+
+		if self.error_state:
+			self.new_ROT_string = ""
+
+			for self.symbol in self.local_ROT_string:
+				if self.symbol.upper() in self.alphabet:
+					if self.symbol.islower():
+						self.new_ROT_string += chr((ord(self.symbol) - ord("a") - self.local_ROT_key) % 26 + ord("a"))
+					else:
+						self.new_ROT_string += chr((ord(self.symbol) - ord("A") - self.local_ROT_key) % 26 + ord("A"))
+				else:
+					self.new_ROT_string += self.symbol
+
+			return self.new_ROT_string
+		else:
+			return self.error_message
+
+	def b_rot(self, ROT_string):
+		self.mode = "bruteforce"
+		self.local_ROT_string = str(ROT_string)
+
+		self.combine_error_handler(ROT_string, None)
+
+		if self.error_state:
+			self.new_ROT_string = ""
+			self.bruteforce_list = []
+
+			for self.bruteforce_key in range(1, 26):
+				for self.symbol in self.local_ROT_string:
+					if self.symbol.upper() in self.alphabet:
+						if self.symbol.islower():
+							self.new_ROT_string += chr((ord(self.symbol) - ord("a") - self.bruteforce_key) % 26 + ord("a"))
+						else:
+							self.new_ROT_string += chr((ord(self.symbol) - ord("A") - self.bruteforce_key) % 26 + ord("A"))
+					else:
+						self.new_ROT_string += self.symbol
+				self.bruteforce_list.append(self.new_ROT_string)
+				self.new_ROT_string = ""
+			return self.bruteforce_list[::-1]
+		else:
+			return self.error_message
+
+M = ROT_Convertor_Class()
+
+def m_rot(s, n):
+	return M.m_rot(s, n)
+def b_rot(s):
+	return M.b_rot(s)
+
+if __name__ == '__main__':
+	m_rot(s, n)
+	b_rot(s)

rot_converter-0.1.0/rot_converter.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: rot-converter
+Version: 0.1.0
+Summary: A library for the ROT cipher.
+Author-email: BasicSweater <ivanvotints@yandex.ru>
+License: MIT
+Project-URL: Homepage, https://github.com/BasicTShirt/rot-converter/blob/main/README.md
+Project-URL: Repository, https://github.com/BasicTShirt/rot-converter
+Keywords: rot,converter,beta
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# First Version: 0.1.0!
+
+---
+
+# ROT Converter
+
+A library for the ROT cipher.
+
+## Features
+
+- Encryption and decryption from ROT.
+- ROT bruteforce.
+- Error handling with clear messages.
+
+## Installation
+
+```bash
+pip install rot-converter
+```
+
+---
+
+## Usage
+
+- To import, use «from rot_converter import *» or «from rot_converter import m_rot, b_rot».
+- To use the library functions, use the command «m_rot(string: str, key: int)» or «b_rot(string: str)».
+
+### For example
+
+#### This program accepts a string (str) as input and outputs this string in the ROT.
+
+```python
+from rot import m_rot
+
+temp_str = input() # Input: tqv_eqpxgtvgt
+new_str = m_rot(temp_str, 2)
+
+print(new_str) # Output: rot_converter
+```
+## Requirements
+
+- Python 3.6 or higher.
+- No external dependencies (uses only standard library).
+
+---
+
+## Error Handling
+
+The library includes a comprehensive error handling system that validates inputs and provides clear, informative error messages.
+
+### Error Types
+| Error                            | Description                                                                          |
+|----------------------------------|--------------------------------------------------------------------------------------|
+| **You did not enter a string**   | The ROT_string parameter is missing or passed as an empty string ""                  |
+| **Key is not an integer**        | The ROT_key parameter cannot be a floating-point number, string, or any non-int type |
+| **You did not enter a key**      | The ROT_key parameter is required but missing (None) in manual mode                  |
+### Error Examples
+
+```python
+from rot import m_rot, b_rot
+
+# Missing string
+result = m_rot("", 24)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+
+
+# Missing key in manual mode
+result = m_rot("tqv_eqpxgtvgt", None)
+print(result)
+# Output:
+# ERROR! You did not enter a key
+
+
+# Key is a float number
+result = m_rot("tqv_eqpxgtvgt", 1.5)
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Key is a string
+result = m_rot("tqv_eqpxgtvgt", "key")
+print(result)
+# Output:
+# ERROR! Type of the key is not a integer
+
+
+# Multiple errors (all displayed)
+result = m_rot("", 2.5)
+print(result)
+# Output:
+# ERROR! You did not enter a string
+# 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                                                                          |
+###### **Made by the Hi Team.**

rot_converter-0.1.0/rot_converter.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+rot_converter/__init__.py
+rot_converter/converter.py
+rot_converter.egg-info/PKG-INFO
+rot_converter.egg-info/SOURCES.txt
+rot_converter.egg-info/dependency_links.txt
+rot_converter.egg-info/top_level.txt
+tests/test_converter.py

rot_converter-0.1.0/rot_converter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rot_converter-0.1.0/rot_converter.egg-info/top_level.txt

@@ -0,0 +1 @@
+rot_converter

rot_converter-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rot_converter-0.1.0/tests/test_converter.py

@@ -0,0 +1,59 @@
+"""
+Tests for the rot module
+"""
+
+import unittest
+import sys
+import os
+
+# Добавляем родительскую директорию в путь, чтобы импортировать модуль rot
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), '..')))
+
+from rot import m_rot, b_rot
+
+
+class TestROTConverter(unittest.TestCase):
+    """Tests for the ROT cipher and bruteforce functions"""
+
+    def test_manual_rot_decryption(self):
+        """Test encryption/decryption with specific keys"""
+        # Сдвиг назад на 24 (эквивалентно сдвигу вперед на 2 для строки 'rot_converter')
+        self.assertEqual(m_rot("tqv_eqpxgtvgt", 24), "rot_converter")
+        # Сохранение регистра символов
+        self.assertEqual(m_rot("TQV_eqpxgtvgt", 24), "ROT_converter")
+        # Проверка полного цикла алфавита (сдвиг 26 возвращает ту же строку)
+        self.assertEqual(m_rot("Hello_World", 26), "Hello_World")
+
+    def test_bruteforce_rot(self):
+        """Test bruteforce decryption"""
+        results = b_rot("tqv")
+        # b_rot возвращает инвертированный список из 25 вариантов (от ключа 25 до 1)
+        self.assertIsInstance(results, list)
+        self.assertEqual(len(results), 25)
+        # Так как список перевернут ([::-1]), ключ 24 будет вторым с конца (индекс -2)
+        # tqv со сдвигом 24 -> rot
+        self.assertEqual(results[-2], "rot")
+
+    def test_error_handling(self):
+        """Test validation and error handling messages"""
+        self.assertIn("You did not enter a string", m_rot("", 24))
+        self.assertIn("You did not enter a key", m_rot("tqv_eqpxgtvgt", None))
+        self.assertIn("Type of the key is not a integer", m_rot("tqv_eqpxgtvgt", 1.5))
+        self.assertIn("Type of the key is not a integer", m_rot("tqv_eqpxgtvgt", "key"))
+
+    def test_multiple_errors(self):
+        """Test displaying multiple error messages at once"""
+        error_output = m_rot("", 1.5)
+        self.assertIn("You did not enter a string", error_output)
+        self.assertIn("Type of the key is not a integer", error_output)
+
+    def test_edge_cases(self):
+        """Test edge cases like numbers, spaces, and punctuation symbols"""
+        # Символы, которых нет в латинском алфавите, должны оставаться неизменными
+        self.assertEqual(m_rot("12345!@# ", 10), "12345!@# ")
+        # Сдвиг 0 не должен изменять строку
+        self.assertEqual(m_rot("NoChange", 0), "NoChange")
+
+
+if __name__ == '__main__':
+    unittest.main()