pystringmath 1.0.0__py3-none-any.whl

pystringmath-1.0.0.dist-info/METADATA

@@ -0,0 +1,298 @@
+Metadata-Version: 2.4
+Name: pystringmath
+Version: 1.0.0
+Summary: Package for string maths
+Home-page: https://github.com/shTrueDDel/pystringmath/
+Author: shTrueDDel
+Author-email: xeosscript@gmail.com
+Project-URL: Documentation, https://github.com/shTrueDDel/pystringmath/blob/main/README.MD
+Keywords: math string mathstring crypto cryptography encoding decoding
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# String Arithmetic Library
+
+*This documentation was translated and compiled with the help of AI. Examples may contain minor errors that do not affect the understanding of how it works.*
+
+## Overview
+The library provides tools for performing arithmetic operations on strings by converting characters to their numeric codes (ASCII/Unicode) and back. It allows adding, subtracting, multiplying, and dividing strings with both numbers and other strings.
+
+---
+
+## Class `to`
+A helper class for converting strings to code arrays and back.
+
+### Methods
+
+#### `to.array(data)`
+Converts a string to an array of character numeric codes.
+
+**Parameters:**
+- `data` (str) - input string
+
+**Returns:**
+- list[int] - array of character codes
+
+**Exceptions:**
+- `TypeError` - if input data is not a string
+
+**Example:**
+```python
+>>> to.array('Hello')
+[72, 101, 108, 108, 111]
+```
+
+---
+
+#### `to.chars(data)`
+Converts an array of numeric codes back to a string.
+
+**Parameters:**
+- `data` (list[int]) - array of character codes
+
+**Returns:**
+- str - resulting string
+
+**Exceptions:**
+- `TypeError` - if input data is invalid
+
+**Example:**
+```python
+>>> to.chars([72, 101, 108, 108, 111])
+'Hello'
+```
+
+---
+
+## Class `nmath`
+Performs arithmetic operations on a string using a single number.
+
+### General Features
+- All methods accept a string and a number
+- Operations are applied to each character in the string
+- Result is returned as a string
+
+---
+
+#### `nmath.sum(data, plus)`
+Adds a number to each character in the string.
+
+**Parameters:**
+- `data` (str) - source string
+- `plus` (int) - number to add
+
+**Returns:**
+- str - new string
+
+**Example:**
+```python
+>>> nmath.sum('ABC', 1)
+'BCD'  # A(65)+1=66('B'), B(66)+1=67('C'), C(67)+1=68('D')
+```
+
+---
+
+#### `nmath.min(data, minus)`
+Subtracts a number from each character in the string.
+
+**Parameters:**
+- `data` (str) - source string
+- `minus` (int) - number to subtract
+
+**Returns:**
+- str - new string
+
+**Example:**
+```python
+>>> nmath.min('DEF', 1)
+'CDE'  # D(68)-1=67('C'), E(69)-1=68('D'), F(70)-1=69('E')
+```
+
+---
+
+#### `nmath.mul(data, multiplier)`
+Multiplies each character's code by a number.
+
+**Parameters:**
+- `data` (str) - source string
+- `multiplier` (int) - multiplier
+
+**Returns:**
+- str - new string
+
+**Example:**
+```python
+>>> nmath.mul('AB', 2)
+'ÆÊ'  # A(65)*2=130('Æ'), B(66)*2=132('Ê')
+```
+
+---
+
+#### `nmath.div(data, divisor)`
+Performs integer division of each character's code by a number.
+
+**Parameters:**
+- `data` (str) - source string
+- `divisor` (int) - divisor
+
+**Returns:**
+- str - new string
+
+**Exceptions:**
+- `ZeroDivisionError` - when attempting division by zero
+
+**Example:**
+```python
+>>> nmath.div('d', 2)
+'2'  # d(100)//2 = 50('2')
+```
+
+---
+
+## Class `armath`
+Performs element-wise arithmetic operations between two strings with cyclic repetition.
+
+### General Features
+- Accepts two strings
+- Operations are performed on corresponding character codes
+- If the second string is shorter, it's cyclically repeated (via `itertools.cycle`)
+- Result is returned as a string
+
+---
+
+#### `armath.sum(data, plus)`
+Element-wise addition of character codes from two strings.
+
+**Parameters:**
+- `data` (str) - first string
+- `plus` (str) - second string (addend)
+
+**Returns:**
+- str - resulting string
+
+**Example:**
+```python
+>>> armath.sum('ABC', '12')
+'rtt'  # A(65)+'1'(49)=114('r')
+       # B(66)+'2'(50)=116('t')
+       # C(67)+'1'(49)=116('t') - cyclic repetition of '12'
+```
+
+---
+
+#### `armath.min(data, subtrahend)`
+Element-wise subtraction of second string character codes from the first.
+
+**Parameters:**
+- `data` (str) - first string
+- `subtrahend` (str) - second string (subtrahend)
+
+**Returns:**
+- str - resulting string
+
+**Example:**
+```python
+>>> armath.min('ABC', '12')
+'\x10\x11\x12'  # A(65)-'1'(49)=16 (DLE character, non-printable)
+                # Results may be in non-printable range
+```
+
+---
+
+#### `armath.mul(data, multiplier)`
+Element-wise multiplication of character codes from two strings.
+
+**Parameters:**
+- `data` (str) - first string
+- `multiplier` (str) - second string (multipliers)
+
+**Returns:**
+- str - resulting string
+
+**Example:**
+```python
+>>> armath.mul('AB', '12')
+'1¡'  # A(65)*'1'(49)=3185 - may exceed ASCII range
+```
+
+---
+
+#### `armath.div(data, divisor)`
+Element-wise integer division of first string character codes by second string codes.
+
+**Parameters:**
+- `data` (str) - first string (dividend)
+- `divisor` (str) - second string (divisor)
+
+**Returns:**
+- str - resulting string
+
+**Exceptions:**
+- `ZeroDivisionError` - if the second string contains a character with code 0
+
+**Example:**
+```python
+>>> armath.div('abcd', '12')
+'\x00\x00\x00\x00'  # Results may be non-printable
+```
+
+---
+
+## Usage Examples
+
+### Basic Operations
+```python
+# Simple numeric operations
+text = "Hello"
+encoded = nmath.sum(text, 5)  # "Mjqqt" (shift by 5)
+decoded = nmath.min(encoded, 5)  # "Hello"
+
+# String operations
+result = armath.sum("Hello", "123")  # Element-wise addition with cyclic repetition of "123"
+```
+
+### Encryption/Decryption
+```python
+# Simple shift cipher
+def encrypt(text, key):
+    return nmath.sum(text, key)
+
+def decrypt(text, key):
+    return nmath.min(text, key)
+
+message = "Secret message"
+encrypted = encrypt(message, 10)
+decrypted = decrypt(encrypted, 10)
+print(decrypted)  # "Secret message"
+```
+
+### Variant Generation
+```python
+base = "Test"
+variants = [nmath.mul(base, i) for i in range(1, 6)]
+for i, variant in enumerate(variants, 1):
+    print(f"Variant {i}: {variant}")
+```
+
+---
+
+## Notes and Limitations
+
+1. **Encoding**: Works with Unicode characters, but results may be non-printable
+2. **Integer Division**: Uses `//`, so fractional results are truncated
+3. **Value Range**: Operation results may fall outside the printable character range

pystringmath-1.0.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+pystringmath-1.0.0.dist-info/licenses/LICENSE,sha256=G69gIr9H83u39ykihIDjWt1guZohcFi99ULUvafS23M,1058
+pystringmath-1.0.0.dist-info/METADATA,sha256=mBhMJGEjWeRRCTmluFyD4E_-3V8ZzFpOCwEuDgcTHKc,6916
+pystringmath-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+pystringmath-1.0.0.dist-info/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+pystringmath-1.0.0.dist-info/RECORD,,

pystringmath-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pystringmath-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) 2026 shTrueDDel
+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.

pystringmath-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+