filehandler6027 1.0.0

Flexible and beginner-friendly Python package for safe and cross-platform file operations.

📦 FileHandler

A flexible and beginner-friendly Python package for safe and cross-platform file operations.
Supports both traditional (Unix-style ~) and modern (pathlib) path handling modes with built-in logging, error management, and content retrieval.

---

✨ Features

• 🗂️ Read, write, and append to files with automatic encoding (utf-8)
• 🔁 Switchable file handling modes: Traditional and Modern
• 🧠 FullPathBuilder for safe home-relative paths
• 🔐 Exception-safe file operations
• 📄 License: MIT (free for all use)

---

📥 Installation

git clone https://github.com/charlie6027/filehandler.git
cd filehandler
pip install -e .

---

🧪 Running Tests

python -m unittest discover -s tests

---

🚀 Usage Example

from filehandler import FileHandler, FileHandleMode

handler = FileHandler()
handler.write('~/Documents/test.txt', 'Hello, world!')
print(handler.read('~/Documents/test.txt'))

---

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

---

🧑 Author

Charlie Sky
Feel free to ⭐ the repo if you find it useful!