A Modular Python Library for Efficient and Secure File Operations
BetterFileHandling is a developer-focused utility library that simplifies and streamlines common file operations in Python. Designed for clarity, reliability, and modularity, this package offers well-structured methods for reading, writing, encoding, and managing files with clean exception handling.
- Modular and extensible architecture
- Read/write support for plain text and JSON
- Line-by-line and range-based reading
- Base64 and plain encoding/decoding
- Detailed file metadata inspection
- Safe file operations: copy, move, rename, delete
- File listing with filtering
- Consistent error handling
| Module | Description | Key Functions |
|---|---|---|
reading.py |
Flexible file reading methods | read_text(), readline(), read_lines(), read_all_lines(), read_until() |
writing.py |
Structured file writing methods | write_text(), write_lines(), write_json() |
security.py |
File encoding and decoding | encode_file(), decode_file(), encode_file_base64(), decode_file_base64() |
file_management.py |
File and directory operations | get_file_info(), copy_file(), move_file(), rename_file(), list_files_in_directory() |
BetterFileHandling is published on PyPI. Install it using pip:
pip install BetterFileHandlingTo use specific modules:
from reading import read_text
from writing import write_json
from file_management import get_file_info
from security import encode_file_base64Read a specific line:
from reading import readline
line = readline('example.txt', 3)
print(line)Write multiple lines to a file:
from writing import write_lines
write_lines('log.txt', ['Process started.', 'Success.'], clear=True)Encode file contents to Base64:
from security import encode_file_base64
encoded = encode_file_base64('data.txt')Move a file safely:
from file_management import move_file
move_file('data.csv', 'backup/data.csv')All functions are designed to provide:
- Clear, consistent error messages
- Meaningful exceptions
- Safe defaults that prevent destructive actions
This ensures predictable behavior and safer integration into automation scripts or production systems.
- Python 3.8 and above
- Cross-platform support: Linux, Windows, macOS
This project is released under the MIT License. See the LICENSE file for details.
Aksh
Front-End Engineer, UI/UX Designer, and Python Developer
Created and maintained by a passionate 10th-grade developer from Delhi.