sujithx 0.1.0__tar.gz

sujithx-0.1.0/LICENSE.txt

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

sujithx-0.1.0/PKG-INFO

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: sujithx
+Version: 0.1.0
+Summary: A multipurpose Python toolkit for files, security, automation, and system utilities
+Author: Sujith
+License-Expression: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Dynamic: license-file
+
+SUJITHX — The Ultimate Python Toolkit
+
+
+
+SUJITHX is a modular Python toolkit that combines file management, security utilities, automation, terminal styling, logging, system information, and network checks in one command-line application.
+
+
+
+Features
+
+
+
+\- File Intelligence: Search files, analyze folders, identify duplicates, and find large files.
+
+\- Security Utilities: Generate random tokens and passwords, calculate SHA-256 hashes, and perform basic password-strength checks.
+
+\- Automation: Create directories, inspect files, read text, and copy files safely without overwriting by default.
+
+\- Terminal Styling: Colored messages, banners, and progress bars.
+
+\- Logging: Write structured log messages to the console and log files.
+
+\- System Information: Inspect Python, operating system, and disk usage information.
+
+\- Network Utilities: Retrieve hostname and local IP information and check internet connectivity.
+
+\- Command Center: Access the tools through an interactive menu.
+
+
+
+Requirements
+
+
+
+\- Python 3.12 or newer
+
+\- Windows, macOS, or Linux
+
+\- No third-party runtime dependencies
+
+
+
+Installation
+
+
+
+Clone the repository, enter its folder, and install it in editable mode:
+
+
+
+git clone YOUR\_GITHUB\_REPOSITORY\_URL
+
+cd SUJITHX
+
+python -m venv .venv
+
+
+
+Activate the environment on Windows:
+
+
+
+.venv\\Scripts\\activate
+
+
+
+Install SUJITHX:
+
+
+
+python -m pip install -e .
+
+
+
+Run
+
+
+
+Launch the command center:
+
+
+
+python -m sujithx.cli
+
+
+
+After installation, you can also run:
+
+
+
+sujithx
+
+
+
+Example
+
+
+
+from sujithx import (
+
+    hello,
+
+    generate\_token,
+
+    analyze\_folder,
+
+)
+
+
+
+print(hello("Developer"))
+
+print(generate\_token())
+
+print(analyze\_folder("."))
+
+
+
+Security Notes
+
+
+
+\- Tokens and passwords are generated using Python's "secrets" module.
+
+\- SHA-256 functions calculate file or text hashes; they do not encrypt data.
+
+\- The password-strength checker is a basic heuristic, not a complete security assessment.
+
+\- Review file paths before running file operations.
+
+\- Keep generated passwords and tokens private.
+
+
+
+Project Status
+
+
+
+Version: 0.1.0
+
+
+
+This project is under active development. Contributions, suggestions, and bug reports are welcome.
+
+
+
+Author
+
+
+
+Sujith
+
+
+
+License
+
+
+
+MIT License.
+

sujithx-0.1.0/README.md

@@ -0,0 +1,160 @@
+SUJITHX — The Ultimate Python Toolkit
+
+
+
+SUJITHX is a modular Python toolkit that combines file management, security utilities, automation, terminal styling, logging, system information, and network checks in one command-line application.
+
+
+
+Features
+
+
+
+\- File Intelligence: Search files, analyze folders, identify duplicates, and find large files.
+
+\- Security Utilities: Generate random tokens and passwords, calculate SHA-256 hashes, and perform basic password-strength checks.
+
+\- Automation: Create directories, inspect files, read text, and copy files safely without overwriting by default.
+
+\- Terminal Styling: Colored messages, banners, and progress bars.
+
+\- Logging: Write structured log messages to the console and log files.
+
+\- System Information: Inspect Python, operating system, and disk usage information.
+
+\- Network Utilities: Retrieve hostname and local IP information and check internet connectivity.
+
+\- Command Center: Access the tools through an interactive menu.
+
+
+
+Requirements
+
+
+
+\- Python 3.12 or newer
+
+\- Windows, macOS, or Linux
+
+\- No third-party runtime dependencies
+
+
+
+Installation
+
+
+
+Clone the repository, enter its folder, and install it in editable mode:
+
+
+
+git clone YOUR\_GITHUB\_REPOSITORY\_URL
+
+cd SUJITHX
+
+python -m venv .venv
+
+
+
+Activate the environment on Windows:
+
+
+
+.venv\\Scripts\\activate
+
+
+
+Install SUJITHX:
+
+
+
+python -m pip install -e .
+
+
+
+Run
+
+
+
+Launch the command center:
+
+
+
+python -m sujithx.cli
+
+
+
+After installation, you can also run:
+
+
+
+sujithx
+
+
+
+Example
+
+
+
+from sujithx import (
+
+    hello,
+
+    generate\_token,
+
+    analyze\_folder,
+
+)
+
+
+
+print(hello("Developer"))
+
+print(generate\_token())
+
+print(analyze\_folder("."))
+
+
+
+Security Notes
+
+
+
+\- Tokens and passwords are generated using Python's "secrets" module.
+
+\- SHA-256 functions calculate file or text hashes; they do not encrypt data.
+
+\- The password-strength checker is a basic heuristic, not a complete security assessment.
+
+\- Review file paths before running file operations.
+
+\- Keep generated passwords and tokens private.
+
+
+
+Project Status
+
+
+
+Version: 0.1.0
+
+
+
+This project is under active development. Contributions, suggestions, and bug reports are welcome.
+
+
+
+Author
+
+
+
+Sujith
+
+
+
+License
+
+
+
+MIT License.
+

sujithx-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sujithx"
+version = "0.1.0"
+description = "A multipurpose Python toolkit for files, security, automation, and system utilities"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+    {name = "Sujith"}
+]
+dependencies = []
+
+[project.scripts]
+sujithx = "sujithx.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["sujithx*"]

sujithx-0.1.0/setup.cfg

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

sujithx-0.1.0/sujithx/__init__.py

@@ -0,0 +1,80 @@
+"""
+SUJITHX - The Ultimate Python Toolkit
+"""
+
+_version_ = "0.1.0"
+_author_ = "Sujith"
+
+
+def hello(name="Developer"):
+    """Return a personalized greeting."""
+    return f"Hello, {name}! Welcome to SUJITHX."
+
+
+def add(a, b):
+    """Add two numbers."""
+    return a + b
+
+
+def multiply(a, b):
+    """Multiply two numbers."""
+    return a * b
+
+
+def percentage(value, total):
+    """Calculate a percentage safely."""
+    if total == 0:
+        raise ValueError("Total cannot be zero.")
+
+    return (value / total) * 100
+from .files import (
+    search_files,
+    analyze_folder,
+    find_duplicates,
+    largest_files,
+    format_bytes,
+)
+from .security import (
+    sha256_text,
+    sha256_file,
+    generate_token,
+    generate_password,
+    check_password_strength,
+)
+from .colors import (
+    color_text,
+    success,
+    error,
+    warning,
+    info,
+    banner,
+    progress_bar,
+    print_progress,
+)
+from .logger import (
+    create_logger,
+    log_info,
+    log_warning,
+    log_error,
+    log_debug,
+)
+from .automation import (
+    ensure_directory,
+    list_files,
+    get_file_info,
+    copy_file,
+    read_text,
+    write_text,
+    file_exists,
+)
+from .system_info import (
+    get_system_info,
+    get_disk_info,
+    display_system_info,
+)
+from .network import (
+    get_hostname,
+    get_local_ip,
+    check_internet,
+    get_network_info,
+)

sujithx-0.1.0/sujithx/automation.py

@@ -0,0 +1,96 @@
+"""Safe file and folder automation utilities for SUJITHX."""
+
+from pathlib import Path
+import shutil
+
+
+def ensure_directory(folder):
+    """Create a folder if it does not already exist."""
+    path = Path(folder).expanduser()
+    path.mkdir(parents=True, exist_ok=True)
+    return str(path.resolve())
+
+
+def list_files(folder, pattern="*"):
+    """List files inside a folder and its subfolders."""
+    root = Path(folder).expanduser()
+
+    if not root.is_dir():
+        raise NotADirectoryError(f"Folder not found: {root}")
+
+    return sorted(
+        (str(path) for path in root.rglob(pattern) if path.is_file()),
+        key=str.lower,
+    )
+
+
+def get_file_info(file_path):
+    """Return basic information about a file."""
+    path = Path(file_path).expanduser()
+
+    if not path.is_file():
+        raise FileNotFoundError(f"File not found: {path}")
+
+    details = path.stat()
+
+    return {
+        "name": path.name,
+        "path": str(path.resolve()),
+        "extension": path.suffix.lower(),
+        "size_bytes": details.st_size,
+        "size_kb": round(details.st_size / 1024, 2),
+    }
+
+
+def copy_file(source, destination, overwrite=False):
+    """Copy a file without overwriting an existing file by default."""
+    source_path = Path(source).expanduser()
+    destination_path = Path(destination).expanduser()
+
+    if not source_path.is_file():
+        raise FileNotFoundError(f"Source file not found: {source_path}")
+
+    if destination_path.exists() and not overwrite:
+        raise FileExistsError(
+            f"Destination already exists: {destination_path}"
+        )
+
+    destination_path.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(source_path, destination_path)
+
+    return str(destination_path.resolve())
+
+
+def read_text(file_path, encoding="utf-8"):
+    """Read a UTF-8 text file."""
+    path = Path(file_path).expanduser()
+
+    if not path.is_file():
+        raise FileNotFoundError(f"File not found: {path}")
+
+    return path.read_text(encoding=encoding)
+
+
+def write_text(file_path, content, overwrite=False, encoding="utf-8"):
+    """Write a text file, refusing to overwrite by default."""
+    path = Path(file_path).expanduser()
+
+    if path.exists() and not overwrite:
+        raise FileExistsError(
+            f"File already exists: {path}. Set overwrite=True to replace it."
+        )
+
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    if overwrite:
+        path.write_text(content, encoding=encoding)
+    else:
+        with path.open("x", encoding=encoding) as file:
+            file.write(content)
+
+    return str(path.resolve())
+
+
+def file_exists(file_path):
+    """Check whether a file exists."""
+    return Path(file_path).expanduser().is_file()

sujithx-0.1.0/sujithx/cli.py

@@ -0,0 +1,132 @@
+"""SUJITHX - Unified Python Toolkit Command Center."""
+
+from . import (
+    hello,
+    analyze_folder,
+    search_files,
+    find_duplicates,
+    largest_files,
+    format_bytes,
+    generate_token,
+    generate_password,
+    check_password_strength,
+    ensure_directory,
+    get_file_info,
+    banner,
+    success,
+    error,
+    info,
+    display_system_info,
+    get_network_info,
+    create_logger,
+)
+
+
+def show_menu():
+    print("\n1. Welcome")
+    print("2. Analyze folder")
+    print("3. Search files")
+    print("4. Find duplicate files")
+    print("5. Show largest files")
+    print("6. Generate secure token")
+    print("7. Generate password")
+    print("8. Check password strength")
+    print("9. Create folder")
+    print("10. Get file information")
+    print("11. System information")
+    print("12. Network information")
+    print("13. Logging demonstration")
+    print("0. Exit")
+
+
+def main():
+    print(banner("SUJITHX COMMAND CENTER"))
+    logger = create_logger("SUJITHX_CLI", "sujithx_cli.log")
+
+    while True:
+        show_menu()
+        choice = input("\nChoose an option: ").strip()
+
+        try:
+            if choice == "1":
+                name = input("Your name: ").strip() or "Developer"
+                print(success(hello(name)))
+
+            elif choice == "2":
+                folder = input("Folder path: ").strip().strip('"')
+                result = analyze_folder(folder)
+                print("Folder:", result["folder"])
+                print("Files:", result["file_count"])
+                print("Size:", format_bytes(result["total_bytes"]))
+                print("Extensions:", result["extensions"])
+
+            elif choice == "3":
+                folder = input("Folder path: ").strip().strip('"')
+                pattern = input("Pattern (default ): ").strip() or ""
+                results = search_files(folder, pattern)
+                for path in results:
+                    print(path)
+                print(f"Found {len(results)} file(s).")
+
+            elif choice == "4":
+                folder = input("Folder path: ").strip().strip('"')
+                groups = find_duplicates(folder)
+                if not groups:
+                    print(success("No duplicates found."))
+                else:
+                    for group in groups:
+                        print("\nDuplicate group:")
+                        for path in group:
+                            print(" ", path)
+
+            elif choice == "5":
+                folder = input("Folder path: ").strip().strip('"')
+                for path, size in largest_files(folder, 10):
+                    print(f"{format_bytes(size):>12}  {path}")
+
+            elif choice == "6":
+                print("Generated token:", generate_token())
+
+            elif choice == "7":
+                print("Generated password:", generate_password())
+
+            elif choice == "8":
+                password = input("Password to evaluate: ")
+                result = check_password_strength(password)
+                print("Rating:", result["rating"])
+                print("Checks:", result["checks"])
+
+            elif choice == "9":
+                folder = input("Folder path to create: ").strip().strip('"')
+                print(success(ensure_directory(folder)))
+
+            elif choice == "10":
+                path = input("File path: ").strip().strip('"')
+                for key, value in get_file_info(path).items():
+                    print(f"{key}: {value}")
+
+            elif choice == "11":
+                display_system_info()
+
+            elif choice == "12":
+                for key, value in get_network_info().items():
+                    print(f"{key.replace('_', ' ').title()}: {value}")
+
+            elif choice == "13":
+                logger.info("SUJITHX logging demonstration.")
+                logger.warning("This is a sample warning.")
+                print(success("Log messages written to sujithx_cli.log"))
+
+            elif choice == "0":
+                print(success("SUJITHX closed. Goodbye!"))
+                break
+
+            else:
+                print(error("Choose a number from 0 to 13."))
+
+        except (OSError, ValueError, TypeError) as exc:
+            print(error(str(exc)))
+
+
+if __name__ == "__main__":
+    main()