pythonbundle 1.3.4

PyPI package designed to make development in Python easier.

pythonbundle

pythonbundle A PyPI package for Python 3.10+ that provides useful tools for data conversion and validation, a custom EasySQL class for simplified SQLite operations, a custom excel file handler, and a custom file IO handler..

---

Features

pythonbundle contains several distinct modules to help keep your codebase clean and readable:

Validation (Check)

A robust validation class to simplify standard string and format checks.

• Email formatting and customizable domain validation.
• Validates Philippine mobile numbers (+639 / 09).
• Check for spaces, symbols, and pure numerical strings.

Cryptography (Cipher)

A basic cryptography class to implement classic cipher techniques.

• Transposition Cipher
• Giovanni Cipher
• Keyword Cipher
• Caesar Cipher

Data Conversion (Convert)

Effortless type casting and data encoding.

• Hex, Binary, and Base64 encoding/decoding.
• String reversal and byte-array conversions.
• Quick casting for Int, Float, Double, and Long.

Data Structures

Custom implementations for improved data manipulation.

• Dictionarily: An enhanced Dictionary object with built-in sorting (alphabetical and numerical-first).
• Memory: A clean, object-oriented list/array wrapper to handle storage, indexing, and removal.
• Stackily: A classic Stack implementation (push, pop, peek, is_empty, size).
• Node: A lightweight binary tree node implementation.

Database Management (EasySQL)

A simplified wrapper around Python's built-in sqlite3.

• Create tables with ease by passing lists of dictionaries.
• Insert, delete, and clear records directly via Python dictionaries.
• Fetch and print table values seamlessly.

Excel Operations

A wrapper for openpyxl allowing for extremely fast Excel file data manipulation.

• Read and write to specific columns across single or multiple sheets.
• Skip header rows easily using skip_rows.
• Zero-hassle reading/writing to entire column letters (e.g., Column 'A').

File Handling (SimpleFileHandler)

Static methods to rapidly read(), write(), and append() to text files using utf-8 encoding.

Sorting Algorithms

A massive suite of sorting algorithms available as quick plug-and-play functions.

• Quick Sort, Merge Sort, Heap Sort, Selection Sort, Insertion Sort, Bubble Sort.
• Advanced/Niche Sorts: Tim Sort, Intro Sort, Cocktail Shaker Sort, Shell Sort, Pigeonhole Sort, Bead Sort, and even Bogo Sort!

---

Installation

pip install pythonbundle

Dependencies

The package largely uses Python's standard library (e.g., sqlite3, math, re, base64). However, the Excel operations module requires:

• openpyxl
• unidecode

---

Quick Usage Examples

1. Simple SQLite Database Queries (EasySQL)

from pythonbundle import EasySQL

db = EasySQL("my_database")

# Create a database table
db.create_table("users", {
    "id": "INTEGER PRIMARY KEY", 
    "name": "TEXT",
    "age": "INTEGER"
})

# Insert data
db.insert_to_table("users", {"id": 1, "name": "Alice", "age": 28})

# Fetch values
records = db.get_table_values("users")
print(records)

2. Validating Phone Numbers & Emails (Check)

from pythonbundle import Check

# Validate Philippine Phone Numbers
is_valid = Check.is_a_valid_philippine_mobile_number("[phone]")
print(is_valid)  # True

# Validate Emails with strict domain rules
Check.Email.add_valid_domain_name("gmail")
Check.Email.add_valid_domain_extension("com")
print(Check.Email.is_valid("[e-mail]"))  # True

3. File Handling (SimpleFileHandler)

from pythonbundle import SimpleFileHandler

# Write, Append, and Read
SimpleFileHandler.write("log.txt", "Process started.\n")
SimpleFileHandler.append("log.txt", "Process finished.\n")

print(SimpleFileHandler.read("log.txt"))

4. Text Encryption (Cipher)

from pythonbundle import Cipher

encrypted = Cipher.caesar_cipher("HELLO WORLD", shift=3)
print(encrypted)  # KHOOR ZRUOG

5. Sorting Array Data

from pythonbundle import quicksort, merge_sort

array = [5, 2, 9, 1, 5, 6]
print(quicksort(array)) #[1, 2, 5, 5, 6, 9]

---

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.

License

MIT