ToolVerse 1.2.0__tar.gz

toolverse-1.2.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Mohammed Ayaz
+
+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.
+

toolverse-1.2.0/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: ToolVerse
+Version: 1.2.0
+Summary: A personal Python utility library
+Author: Mohammed Ayaz
+License: MIT License
+        
+        Copyright (c) 2026 Mohammed Ayaz
+        
+        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.
+        
+        
+Project-URL: Homepage, https://github.com/gaderjimrs-creator/MyPythonLibrary
+Project-URL: Repository, https://github.com/gaderjimrs-creator/MyPythonLibrary
+Project-URL: Issues, https://github.com/gaderjimrs-creator/MyPythonLibrary/issues
+Keywords: python,utilities,calculator,password-generator,string-tools,file-tools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: psutil
+Dynamic: license-file
+
+# ToolVerse
+
+A powerful Python utility library created by **Mohammed Ayaz**.
+This library provides ready-to-use tools for calculations, string operations, number utilities, password generation, file handling, date & time operations, random generators, student management, system utilities, and more.
+
+---
+
+## Features
+
+| Module           | Description                                     |
+| ---------------- | ----------------------------------------------- |
+| calculator       | Mathematical calculations and utility functions |
+| conversion_tools | Unit and measurement conversions                |
+| date_time_tools  | Date and time utilities                         |
+| file_tools       | File management operations                      |
+| number_tools     | Number-related utilities                        |
+| password_tools   | Password generation and security tools          |
+| random_tools     | Random values, strings, dates, and passwords    |
+| string_tools     | String manipulation utilities                   |
+| student_tools    | Student management and reporting system         |
+| system_tools     | System and OS information utilities             |
+
+---
+
+## Installation
+
+Install directly from GitHub:
+
+```bash
+pip install git+https://github.com/gaderjimrs-creator/MyPythonLibrary.git
+```
+
+Or clone the repository:
+
+```bash
+git clone https://github.com/gaderjimrs-creator/MyPythonLibrary.git
+
+cd MyPythonLibrary
+
+pip install .
+```
+
+---
+
+## Usage Examples
+
+### Calculator
+
+```python
+from ToolVerse.calculator import MyCalculator
+
+calc = MyCalculator()
+
+print(calc.add(10, 5))
+print(calc.sub(10, 5))
+print(calc.mul(10, 5))
+print(calc.div(10, 5))
+```
+
+### Password Generator
+
+```python
+from ToolVerse.password_tools import MyPasswordTools
+
+pwd = MyPasswordTools()
+
+print(pwd.generate_password())
+print(pwd.generate_strong_password())
+```
+
+### String Tools
+
+```python
+from ToolVerse.string_tools import MyStringTools
+
+s = MyStringTools()
+
+s.set_string("Hello World")
+
+print(s.reverse_string())
+print(s.to_uppercase())
+print(s.count_words())
+```
+
+---
+
+## Modules Included
+
+* calculator
+* conversion_tools
+* date_time_tools
+* file_tools
+* number_tools
+* password_tools
+* random_tools
+* string_tools
+* student_tools
+* system_tools
+
+---
+
+## Running Tests
+
+Run all tests using:
+
+```bash
+pytest
+```
+
+Expected result:
+
+```bash
+25 passed
+```
+
+---
+
+## Project Structure
+
+```text
+MyPythonLibrary/
+│
+├── src/
+│   └── MyPythonLibrary/
+│
+├── tests/
+│
+├── README.md
+├── LICENSE
+├── pyproject.toml
+├── pytest.ini
+└── setup.py
+```
+
+---
+
+## Continuous Integration
+
+GitHub Actions automatically runs all tests on every push and pull request.
+
+---
+
+## License
+
+This project is licensed under the terms of the LICENSE file included in this repository.
+
+---
+
+## Author
+
+**Mohammed Ayaz**
+
+GitHub:
+https://github.com/gaderjimrs-creator
+
+Python Developer | Open Source Enthusiast
+

toolverse-1.2.0/README.md

@@ -0,0 +1,157 @@
+# ToolVerse
+
+A powerful Python utility library created by **Mohammed Ayaz**.
+This library provides ready-to-use tools for calculations, string operations, number utilities, password generation, file handling, date & time operations, random generators, student management, system utilities, and more.
+
+---
+
+## Features
+
+| Module           | Description                                     |
+| ---------------- | ----------------------------------------------- |
+| calculator       | Mathematical calculations and utility functions |
+| conversion_tools | Unit and measurement conversions                |
+| date_time_tools  | Date and time utilities                         |
+| file_tools       | File management operations                      |
+| number_tools     | Number-related utilities                        |
+| password_tools   | Password generation and security tools          |
+| random_tools     | Random values, strings, dates, and passwords    |
+| string_tools     | String manipulation utilities                   |
+| student_tools    | Student management and reporting system         |
+| system_tools     | System and OS information utilities             |
+
+---
+
+## Installation
+
+Install directly from GitHub:
+
+```bash
+pip install git+https://github.com/gaderjimrs-creator/MyPythonLibrary.git
+```
+
+Or clone the repository:
+
+```bash
+git clone https://github.com/gaderjimrs-creator/MyPythonLibrary.git
+
+cd MyPythonLibrary
+
+pip install .
+```
+
+---
+
+## Usage Examples
+
+### Calculator
+
+```python
+from ToolVerse.calculator import MyCalculator
+
+calc = MyCalculator()
+
+print(calc.add(10, 5))
+print(calc.sub(10, 5))
+print(calc.mul(10, 5))
+print(calc.div(10, 5))
+```
+
+### Password Generator
+
+```python
+from ToolVerse.password_tools import MyPasswordTools
+
+pwd = MyPasswordTools()
+
+print(pwd.generate_password())
+print(pwd.generate_strong_password())
+```
+
+### String Tools
+
+```python
+from ToolVerse.string_tools import MyStringTools
+
+s = MyStringTools()
+
+s.set_string("Hello World")
+
+print(s.reverse_string())
+print(s.to_uppercase())
+print(s.count_words())
+```
+
+---
+
+## Modules Included
+
+* calculator
+* conversion_tools
+* date_time_tools
+* file_tools
+* number_tools
+* password_tools
+* random_tools
+* string_tools
+* student_tools
+* system_tools
+
+---
+
+## Running Tests
+
+Run all tests using:
+
+```bash
+pytest
+```
+
+Expected result:
+
+```bash
+25 passed
+```
+
+---
+
+## Project Structure
+
+```text
+MyPythonLibrary/
+│
+├── src/
+│   └── MyPythonLibrary/
+│
+├── tests/
+│
+├── README.md
+├── LICENSE
+├── pyproject.toml
+├── pytest.ini
+└── setup.py
+```
+
+---
+
+## Continuous Integration
+
+GitHub Actions automatically runs all tests on every push and pull request.
+
+---
+
+## License
+
+This project is licensed under the terms of the LICENSE file included in this repository.
+
+---
+
+## Author
+
+**Mohammed Ayaz**
+
+GitHub:
+https://github.com/gaderjimrs-creator
+
+Python Developer | Open Source Enthusiast
+

toolverse-1.2.0/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ToolVerse"
+version = "1.2.0"
+description = "A personal Python utility library"
+readme = "README.md"
+requires-python = ">=3.10"
+
+authors = [
+    { name = "Mohammed Ayaz" }
+]
+
+license = { file = "LICENSE" }
+
+keywords = [
+    "python",
+    "utilities",
+    "calculator",
+    "password-generator",
+    "string-tools",
+    "file-tools"
+]
+
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent"
+]
+
+dependencies = [
+    "psutil"
+]
+
+[project.urls]
+Homepage = "https://github.com/gaderjimrs-creator/MyPythonLibrary"
+Repository = "https://github.com/gaderjimrs-creator/MyPythonLibrary"
+Issues = "https://github.com/gaderjimrs-creator/MyPythonLibrary/issues"

toolverse-1.2.0/setup.cfg

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

toolverse-1.2.0/setup.py

@@ -0,0 +1,8 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="ToolVerse",
+    version="1.2.0",
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+)

toolverse-1.2.0/src/ToolVerse/__init__.py

@@ -0,0 +1,25 @@
+from .calculator import Calculator
+from .conversion_tools import ConversionTools
+from .date_time_tools import DateTimeTools
+from .file_tools import FileTools
+from .number_tools import NumberTools
+from .password_tools import PasswordTools
+from .random_tools import RandomTools
+from .string_tools import StringTools
+from .student_tools import StudentTools
+from .system_tools import SystemTools
+
+__version__ = "1.1.0"
+
+__all__ = [
+    "Calculator",
+    "ConversionTools",
+    "DateTimeTools",
+    "FileTools",
+    "NumberTools",
+    "PasswordTools",
+    "RandomTools",
+    "StringTools",
+    "StudentTools",
+    "SystemTools",
+]

toolverse-1.2.0/src/ToolVerse/calculator.py

@@ -0,0 +1,188 @@
+class Calculator:
+    def __init__(self):
+        self.a = 0
+        self.b = 0
+
+    def add(self, a, b):
+        self.a = a
+        self.b = b
+        result = self.a + self.b
+        return result
+        
+    def mul(self, a, b):
+        self.a = a
+        self.b = b
+        result = self.a * self.b
+        return result
+    
+    def div(self, a, b):
+        self.a = a
+        self.b = b
+        if self.b != 0:
+            result = self.a / self.b
+            return result
+        else:
+            return "Division by zero is not allowed"
+        
+    def sub(self, a, b):
+        self.a = a
+        self.b = b
+        result = self.a - self.b
+        return result
+    
+    def percentage(self, a, b):
+        self.a = a
+        self.b = b
+        if self.b != 0:
+            result = (self.a * self.b) / 100
+            return result
+        else:
+            return "Percentage by zero is not allowed"
+
+    def sqrt(self, a):
+        self.a = a
+        if self.a >= 0:
+            result = self.a ** 0.5
+            return result
+        else:
+            return "Square root of negative number is not allowed"
+
+    def square(self, a):
+        self.a = a
+        result = self.a ** 2
+        return result
+    
+    def power(self, a, b):
+        self.a = a
+        self.b = b
+        result = self.a ** self.b
+        return result
+
+    def factorial(self, a):
+        self.a = a
+        if self.a < 0:
+            return "Factorial of negative number is not allowed"
+        elif self.a == 0 or self.a == 1:
+            return 1
+        else:
+            result = 1
+            for i in range(2, self.a + 1):
+                result *= i
+            return result
+        
+    def gcd(self, a, b):
+        self.a = a
+        self.b = b
+        while self.b:
+            self.a, self.b = self.b, self.a % self.b
+        return abs(self.a)
+    
+    def lcm(self, a, b):
+        self.a = a
+        self.b = b
+        if self.a == 0 or self.b == 0:
+            return 0
+        else:
+            return abs(self.a * self.b) // self.gcd(self.a, self.b)
+        
+    def hcf(self, a, b):
+        return self.gcd(a, b)
+    
+    def lcm_hcf(self, a, b):
+        hcf = self.hcf(a, b)
+        lcm = self.lcm(a, b)
+        return hcf, lcm
+    
+    def is_prime(self, a):
+        self.a = a
+        if self.a <= 1:
+            return False
+        for i in range(2, int(self.a ** 0.5) + 1):
+            if self.a % i == 0:
+                return False
+        return True
+    
+    def prime_factors(self, a):
+        self.a = a
+        factors = []
+        for i in range(2, int(self.a ** 0.5) + 1):
+            while self.a % i == 0:
+                factors.append(i)
+                self.a //= i
+        if self.a > 1:
+            factors.append(self.a)
+        return factors
+    
+    def gst_calculator(self, price, gst_rate):
+        self.price = price
+        self.gst_rate = gst_rate
+        gst_amount = (self.price * self.gst_rate) / 100
+        total_price = self.price + gst_amount
+        return gst_amount, total_price
+    
+    def discount_calculator(self, price, discount_rate):
+        self.price = price
+        self.discount_rate = discount_rate
+        discount_amount = (self.price * self.discount_rate) / 100
+        final_price = self.price - discount_amount
+        return discount_amount, final_price
+    
+    def simple_interest(self, principal, rate, time):
+        self.principal = principal
+        self.rate = rate
+        self.time = time
+        interest = (self.principal * self.rate * self.time) / 100
+        return interest
+    
+    def compound_interest(self, principal, rate, time, n=1):
+        self.principal = principal
+        self.rate = rate
+        self.time = time
+        self.n = n
+        amount = self.principal * (1 + (self.rate / (100 * self.n))) ** (self.n * self.time)
+        return amount - self.principal
+    
+    def percentage_increase(self, original, new):
+        self.original = original
+        self.new = new
+        if self.original != 0:
+            increase = self.new - self.original
+            percentage_increase = (increase / self.original) * 100
+            return percentage_increase
+        else:
+            return "Original value cannot be zero for percentage increase calculation"
+    
+    def percentage_decrease(self, original, new):
+        self.original = original
+        self.new = new
+        if self.original != 0:
+            decrease = self.original - self.new
+            percentage_decrease = (decrease / self.original) * 100
+            return percentage_decrease
+        else:
+            return "Original value cannot be zero for percentage decrease calculation"
+    
+    def average(self, numbers):
+        self.numbers = numbers
+        if len(self.numbers) > 0:
+            return sum(self.numbers) / len(self.numbers)
+        else:
+            return "No numbers provided for average calculation"
+    
+    def median(self, numbers):
+        self.numbers = sorted(numbers)
+        n = len(self.numbers)
+        if n % 2 == 0:
+            median = (self.numbers[n // 2 - 1] + self.numbers[n // 2]) / 2
+        else:
+            median = self.numbers[n // 2]
+        return median
+    
+    def mode(self, numbers):
+        self.numbers = numbers
+        from collections import Counter
+        count = Counter(self.numbers)
+        mode_data = count.most_common()
+        mode = [num for num, freq in mode_data if freq == mode_data[0][1]]
+        return mode
+