comsci-tools 0.1.0__tar.gz

comsci_tools-0.1.0/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: comsci-tools
+Version: 0.1.0
+Summary: A comprehensive utility toolkit for Computer Science students and developers.
+Author: Chatchai Naktae
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# comsci-tools
+
+A comprehensive utility toolkit designed to make the lives of Computer Science students and developers easier. Whether you are calculating GPA, converting number bases for Digital Logic class, or generating secure passwords, this package has you covered!
+
+## Installation
+
+You can easily install this package via pip:
+
+```bash
+pip install comsci-tools
+```
+
+## Quick Start & Examples
+
+Here are some real-world examples of how to use the modules included in this package:
+
+### 1. Base Converter (Digital Logic & Architecture)
+Perfect for computer science math and architecture calculations.
+
+```python
+from comsci_tools import dec_to_bin, dec_to_hex
+
+print(dec_to_bin(255))  # Output: 11111111
+print(dec_to_hex(255))  # Output: FF
+```
+
+### 2. Academic Tools
+Easily calculate your exact GPA using standard university formats.
+
+```python
+from comsci_tools import gpa_calculator
+
+# Format: [(Grade Point, Credits), ...]
+my_grades = [
+    (4.0, 3),  # Programming (A)
+    (3.5, 3),  # Mathematics (B+)
+    (3.0, 3)   # English (B)
+]
+print(f"My GPA is: {gpa_calculator(my_grades)}")
+# Output: My GPA is: 3.5
+```
+
+### 3. Web Development Tools (HTML/CSS)
+Quickly convert RGB colors to HEX codes for web design.
+
+```python
+from comsci_tools import rgb_to_hex
+
+color = rgb_to_hex(255, 99, 71)
+print(f"Tomato color hex: {color}") 
+# Output: Tomato color hex: #FF6347
+```
+
+### 4. Cryptography & Security
+Generate secure passwords or use basic encryption.
+
+```python
+from comsci_tools import generate_password, hash_md5
+
+# Generate a 16-character secure password
+print(generate_password(16)) 
+
+# Hash a string using MD5
+print(hash_md5("my_secret_data"))
+```
+
+## Available Modules Included
+This package contains 10 powerful modules:
+1. `logic`: Base conversions (Bin, Oct, Hex)
+2. `academic`: Grading and GPA calculations
+3. `crypto`: Hashing and basic encryption
+4. `storage`: Byte conversions and download time estimation
+5. `color`: RGB and HEX color tools
+6. `randomizer`: Password generators and coin flips
+7. `time_utils`: Timestamps and formatting
+8. `network`: Local IP fetching
+9. `file_ops`: File extension extraction
+10. `utils`: Cross-platform console clearing

comsci_tools-0.1.0/README.md

@@ -0,0 +1,78 @@
+# comsci-tools
+
+A comprehensive utility toolkit designed to make the lives of Computer Science students and developers easier. Whether you are calculating GPA, converting number bases for Digital Logic class, or generating secure passwords, this package has you covered!
+
+## Installation
+
+You can easily install this package via pip:
+
+```bash
+pip install comsci-tools
+```
+
+## Quick Start & Examples
+
+Here are some real-world examples of how to use the modules included in this package:
+
+### 1. Base Converter (Digital Logic & Architecture)
+Perfect for computer science math and architecture calculations.
+
+```python
+from comsci_tools import dec_to_bin, dec_to_hex
+
+print(dec_to_bin(255))  # Output: 11111111
+print(dec_to_hex(255))  # Output: FF
+```
+
+### 2. Academic Tools
+Easily calculate your exact GPA using standard university formats.
+
+```python
+from comsci_tools import gpa_calculator
+
+# Format: [(Grade Point, Credits), ...]
+my_grades = [
+    (4.0, 3),  # Programming (A)
+    (3.5, 3),  # Mathematics (B+)
+    (3.0, 3)   # English (B)
+]
+print(f"My GPA is: {gpa_calculator(my_grades)}")
+# Output: My GPA is: 3.5
+```
+
+### 3. Web Development Tools (HTML/CSS)
+Quickly convert RGB colors to HEX codes for web design.
+
+```python
+from comsci_tools import rgb_to_hex
+
+color = rgb_to_hex(255, 99, 71)
+print(f"Tomato color hex: {color}") 
+# Output: Tomato color hex: #FF6347
+```
+
+### 4. Cryptography & Security
+Generate secure passwords or use basic encryption.
+
+```python
+from comsci_tools import generate_password, hash_md5
+
+# Generate a 16-character secure password
+print(generate_password(16)) 
+
+# Hash a string using MD5
+print(hash_md5("my_secret_data"))
+```
+
+## Available Modules Included
+This package contains 10 powerful modules:
+1. `logic`: Base conversions (Bin, Oct, Hex)
+2. `academic`: Grading and GPA calculations
+3. `crypto`: Hashing and basic encryption
+4. `storage`: Byte conversions and download time estimation
+5. `color`: RGB and HEX color tools
+6. `randomizer`: Password generators and coin flips
+7. `time_utils`: Timestamps and formatting
+8. `network`: Local IP fetching
+9. `file_ops`: File extension extraction
+10. `utils`: Cross-platform console clearing

comsci_tools-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "comsci-tools"
+version = "0.1.0"
+authors = [
+  { name="Chatchai Naktae" },
+]
+description = "A comprehensive utility toolkit for Computer Science students and developers."
+readme = "README.md"
+requires-python = ">=3.8"
+
+[tool.setuptools.packages.find]
+where = ["src"]

comsci_tools-0.1.0/setup.cfg

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

comsci_tools-0.1.0/src/comsci_tools/__init__.py

@@ -0,0 +1,31 @@
+# 1. Logic & Math
+from .logic import dec_to_bin, dec_to_hex, base_converter
+
+# 2. Academic tools
+from .academic import calculate_grade, gpa_calculator
+
+# 3. Utilities
+from .utils import clear_console
+
+# 4. Cryptography
+from .crypto import encrypt_caesar, hash_md5
+
+# 5. Storage
+from .storage import convert_bytes, calculate_download_time
+
+# 6. Color (Web/UI)
+from .color import rgb_to_hex, hex_to_rgb
+
+# 7. Randomizer
+from .randomizer import generate_password, coin_flip
+
+# 8. Time Utils
+from .time_utils import get_current_timestamp, format_seconds
+
+# 9. Network
+from .network import get_local_ip
+
+# 10. File Operations
+from .file_ops import get_file_extension
+
+__version__ = "0.1.0"

comsci_tools-0.1.0/src/comsci_tools/academic.py

@@ -0,0 +1,20 @@
+def calculate_grade(score: float) -> str:
+    """Standard Thai University grading system."""
+    if score >= 80: return "A"
+    if score >= 75: return "B+"
+    if score >= 70: return "B"
+    if score >= 65: return "C+"
+    if score >= 60: return "C"
+    if score >= 55: return "D+"
+    if score >= 50: return "D"
+    return "F"
+
+def gpa_calculator(grades_with_credits: list) -> float:
+    """
+    Calculate GPA.
+    Input: [(grade_point, credit), (grade_point, credit)]
+    Example: [(4.0, 3), (3.5, 3)]
+    """
+    total_points = sum(g * c for g, c in grades_with_credits)
+    total_credits = sum(c for g, c in grades_with_credits)
+    return round(total_points / total_credits, 2)

comsci_tools-0.1.0/src/comsci_tools/color.py

@@ -0,0 +1,14 @@
+def rgb_to_hex(r: int, g: int, b: int) -> str:
+    """Convert RGB values to a HEX color code."""
+    # Ensure values are within 0-255 range
+    r = max(0, min(255, r))
+    g = max(0, min(255, g))
+    b = max(0, min(255, b))
+    return f"#{r:02X}{g:02X}{b:02X}"
+
+def hex_to_rgb(hex_code: str) -> tuple:
+    """Convert HEX color code to RGB tuple."""
+    hex_code = hex_code.lstrip('#')
+    if len(hex_code) != 6:
+        raise ValueError("HEX code must be 6 characters long")
+    return tuple(int(hex_code[i:i+2], 16) for i in (0, 2, 4))

comsci_tools-0.1.0/src/comsci_tools/crypto.py

@@ -0,0 +1,19 @@
+import hashlib
+
+def encrypt_caesar(text: str, shift: int) -> str:
+    """Encrypt text using basic Caesar Cipher."""
+    result = ""
+    for char in text:
+        if char.isalpha():
+            # Check if uppercase or lowercase
+            ascii_offset = 65 if char.isupper() else 97
+            # Shift character and wrap around alphabet
+            result += chr((ord(char) - ascii_offset + shift) % 26 + ascii_offset)
+        else:
+            result += char
+    return result
+
+def hash_md5(text: str) -> str:
+    """Convert string text to an MD5 hash string."""
+    # Encode text to bytes, then hash, then return as hex string
+    return hashlib.md5(text.encode()).hexdigest()

comsci_tools-0.1.0/src/comsci_tools/file_ops.py

@@ -0,0 +1,6 @@
+import os
+
+def get_file_extension(filename: str) -> str:
+    """Extract the extension from a filename (e.g., '.txt')."""
+    _, extension = os.path.splitext(filename)
+    return extension.lower()

comsci_tools-0.1.0/src/comsci_tools/logic.py

@@ -0,0 +1,17 @@
+def dec_to_bin(number: int) -> str:
+    """Convert decimal to binary string."""
+    return bin(number).replace("0b", "")
+
+def dec_to_hex(number: int) -> str:
+    """Convert decimal to uppercase hexadecimal string."""
+    return hex(number).replace("0x", "").upper()
+
+def base_converter(number_str: str, from_base: int, to_base: int) -> str:
+    """Convert any base to any base (Basic version)."""
+    # Step 1: Convert input to decimal
+    decimal_num = int(number_str, from_base)
+    # Step 2: Convert decimal to target base
+    if to_base == 2: return bin(decimal_num).replace("0b", "")
+    if to_base == 8: return oct(decimal_num).replace("0o", "")
+    if to_base == 16: return hex(decimal_num).replace("0x", "").upper()
+    return str(decimal_num)

comsci_tools-0.1.0/src/comsci_tools/network.py

@@ -0,0 +1,13 @@
+import socket
+
+def get_local_ip() -> str:
+    """Get the local IP address of the current machine."""
+    try:
+        # Create a dummy socket to find the local IP
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip = s.getsockname()[0]
+        s.close()
+        return ip
+    except Exception:
+        return "127.0.0.1"

comsci_tools-0.1.0/src/comsci_tools/randomizer.py

@@ -0,0 +1,15 @@
+import random
+import string
+
+def generate_password(length: int = 12) -> str:
+    """Generate a secure random password."""
+    if length < 4:
+        raise ValueError("Password length must be at least 4")
+
+    characters = string.ascii_letters + string.digits + string.punctuation
+    # Ensure at least one of each type is theoretically possible
+    return ''.join(random.choice(characters) for _ in range(length))
+
+def coin_flip() -> str:
+    """Simulate a 50/50 coin flip."""
+    return random.choice(["Heads", "Tails"])

comsci_tools-0.1.0/src/comsci_tools/storage.py

@@ -0,0 +1,18 @@
+def convert_bytes(size_in_bytes: float) -> str:
+    """Convert raw bytes to human-readable format (KB, MB, GB, TB)."""
+    for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
+        if size_in_bytes < 1024.0:
+            return f"{round(size_in_bytes, 2)} {unit}"
+        # Divide by exact 1024 for computer science standard
+        size_in_bytes /= 1024.0
+    return f"{round(size_in_bytes, 2)} PB"
+
+def calculate_download_time(file_size_mb: float, speed_mbps: float) -> float:
+    """
+    Calculate exact download time in seconds.
+    Note: Internet speed is in Megabits (Mb), File size is in Megabytes (MB).
+    """
+    # 1 Byte = 8 bits, so we divide speed by 8 to match MB
+    speed_mb_per_sec = speed_mbps / 8.0
+    time_seconds = file_size_mb / speed_mb_per_sec
+    return round(time_seconds, 2)

comsci_tools-0.1.0/src/comsci_tools/time_utils.py

@@ -0,0 +1,12 @@
+import time
+
+def get_current_timestamp() -> int:
+    """Get the current Unix timestamp in seconds."""
+    return int(time.time())
+
+def format_seconds(seconds: int) -> str:
+    """Convert raw seconds into HH:MM:SS format."""
+    hours = seconds // 3600
+    minutes = (seconds % 3600) // 60
+    secs = seconds % 60
+    return f"{hours:02d}:{minutes:02d}:{secs:02d}"

comsci_tools-0.1.0/src/comsci_tools/utils.py

@@ -0,0 +1,9 @@
+import os
+import platform
+
+def clear_console():
+    """Clears the terminal screen regardless of OS."""
+    if platform.system() == "Windows":
+        os.system("cls")
+    else:
+        os.system("clear")

comsci_tools-0.1.0/src/comsci_tools.egg-info/PKG-INFO

@@ -0,0 +1,86 @@
+Metadata-Version: 2.4
+Name: comsci-tools
+Version: 0.1.0
+Summary: A comprehensive utility toolkit for Computer Science students and developers.
+Author: Chatchai Naktae
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# comsci-tools
+
+A comprehensive utility toolkit designed to make the lives of Computer Science students and developers easier. Whether you are calculating GPA, converting number bases for Digital Logic class, or generating secure passwords, this package has you covered!
+
+## Installation
+
+You can easily install this package via pip:
+
+```bash
+pip install comsci-tools
+```
+
+## Quick Start & Examples
+
+Here are some real-world examples of how to use the modules included in this package:
+
+### 1. Base Converter (Digital Logic & Architecture)
+Perfect for computer science math and architecture calculations.
+
+```python
+from comsci_tools import dec_to_bin, dec_to_hex
+
+print(dec_to_bin(255))  # Output: 11111111
+print(dec_to_hex(255))  # Output: FF
+```
+
+### 2. Academic Tools
+Easily calculate your exact GPA using standard university formats.
+
+```python
+from comsci_tools import gpa_calculator
+
+# Format: [(Grade Point, Credits), ...]
+my_grades = [
+    (4.0, 3),  # Programming (A)
+    (3.5, 3),  # Mathematics (B+)
+    (3.0, 3)   # English (B)
+]
+print(f"My GPA is: {gpa_calculator(my_grades)}")
+# Output: My GPA is: 3.5
+```
+
+### 3. Web Development Tools (HTML/CSS)
+Quickly convert RGB colors to HEX codes for web design.
+
+```python
+from comsci_tools import rgb_to_hex
+
+color = rgb_to_hex(255, 99, 71)
+print(f"Tomato color hex: {color}") 
+# Output: Tomato color hex: #FF6347
+```
+
+### 4. Cryptography & Security
+Generate secure passwords or use basic encryption.
+
+```python
+from comsci_tools import generate_password, hash_md5
+
+# Generate a 16-character secure password
+print(generate_password(16)) 
+
+# Hash a string using MD5
+print(hash_md5("my_secret_data"))
+```
+
+## Available Modules Included
+This package contains 10 powerful modules:
+1. `logic`: Base conversions (Bin, Oct, Hex)
+2. `academic`: Grading and GPA calculations
+3. `crypto`: Hashing and basic encryption
+4. `storage`: Byte conversions and download time estimation
+5. `color`: RGB and HEX color tools
+6. `randomizer`: Password generators and coin flips
+7. `time_utils`: Timestamps and formatting
+8. `network`: Local IP fetching
+9. `file_ops`: File extension extraction
+10. `utils`: Cross-platform console clearing

comsci_tools-0.1.0/src/comsci_tools.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+src/comsci_tools/__init__.py
+src/comsci_tools/academic.py
+src/comsci_tools/color.py
+src/comsci_tools/crypto.py
+src/comsci_tools/file_ops.py
+src/comsci_tools/logic.py
+src/comsci_tools/network.py
+src/comsci_tools/randomizer.py
+src/comsci_tools/storage.py
+src/comsci_tools/time_utils.py
+src/comsci_tools/utils.py
+src/comsci_tools.egg-info/PKG-INFO
+src/comsci_tools.egg-info/SOURCES.txt
+src/comsci_tools.egg-info/dependency_links.txt
+src/comsci_tools.egg-info/top_level.txt
+tests/test_main.py

comsci_tools-0.1.0/src/comsci_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

comsci_tools-0.1.0/src/comsci_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+comsci_tools

comsci_tools-0.1.0/tests/test_main.py

@@ -0,0 +1,36 @@
+import comsci_tools as tools
+
+print("=== ComSci Tools Test Run ===")
+
+# 1. Test Base Converter (Digital Logic)
+decimal_number = 255
+binary_result = tools.dec_to_bin(decimal_number)
+hex_result = tools.dec_to_hex(decimal_number)
+print(f"\n[1] Logic Test: {decimal_number} in Binary is {binary_result}, in Hex is {hex_result}")
+
+# 2. Test GPA Calculator (Academic)
+# Format: [(Grade Point, Credits)]
+my_grades = [
+    (4.0, 3),  # Programming (A)
+    (3.5, 3),  # Mathematics (B+)
+    (3.0, 3)   # English (B)
+]
+gpa = tools.gpa_calculator(my_grades)
+print(f"\n[2] Academic Test: My calculated GPA is {gpa}")
+
+# 3. Test RGB to HEX Converter (Web Development)
+r, g, b = 255, 99, 71
+hex_color = tools.rgb_to_hex(r, g, b)
+print(f"\n[3] Color Test: RGB({r}, {g}, {b}) is HEX {hex_color}")
+
+# 4. Test Password Generator (Security)
+secure_pass = tools.generate_password(16)
+print(f"\n[4] Security Test: Generated 16-char Password -> {secure_pass}")
+
+# 5. Test Download Time Calculator (Storage & Network)
+file_size = 1024.0  # 1024 MB (1 GB)
+internet_speed = 500.0  # 500 Mbps
+download_time = tools.calculate_download_time(file_size, internet_speed)
+print(f"\n[5] Network Test: Time to download {file_size}MB at {internet_speed}Mbps is {download_time} seconds")
+
+print("\n=============================")