sandyie-read 1.1.0

A lightweight Python library to read various data formats including PDF, images, YAML, and more.

Sandyie Read 📚

Effortlessly read files like PDFs, images, YAML, CSV, Excel, and more — powered by logging and custom exceptions.

---

⚠️ Python Compatibility

🐍 This library requires Python 3.7+.

🔧 Features

• ✅ Read and extract content from:
  • PDF (text-based and scanned with OCR)
  • Image files (JPG, PNG, SVG)
  • YAML files
  • Text files
  • CSV, Excel
  • TSV files
  • PARQUET file
  • PICKLE , Model
  • HTML
  • JS, JSON,
  • zip
  • DOCX file
• 🧠 OCR support using Tesseract
• 📋 Human-readable logging
• 🛡️ Clean exception handling (SandyieException)

---

📦 Installation

> First check your pip 
python.exe -m pip install --upgrade pip
python.exe -m pip install --upgrade setuptools
pip cache purge


pip install sandyie_read

---

🚀 Quick Start

from sandyie_read import read

data = read("example.pdf")
print(data)

---

📁 Supported File Types & Examples

1. 📄 PICKLE (Text-based or Scanned)

data = read("sample.pkl")
print(data)

🟢 Returns: A Model container.

---

2. 🖼️ Image Files (PNG, JPG)

data = read("photo.jpg")
print(data)

🟢 Returns: A numpy array format of OCR-extracted text.

---

3. 📊 PARQUET Files

data = read("data.parquet")
print(data)

🟢 Returns: pandas.DataFrame with structured data.

---

4. 📊 CSV Files

data = read("data.csv")
print(data)

🟢 Returns: pandas.DataFrame with structured data.

---

⚠️ Error Handling

All exceptions are wrapped inside a custom SandyieException, making debugging simple and consistent.

---

🧪 Logging

Logs show:

• File type detection
• Success/failure for reads
• Detailed processing insights

---

📚 Auto-Generated Docs

Coming soon at 👉 https://sandyie.in/docs

It will include:

• 📘 API Reference
• ❌ Exception explanations
• 📓 Usage examples and notebooks

---

🤝 Contribute

Spotted a bug or have a new idea?
Open an Issue or send a Pull Request.

---

📄 License

Licensed under the MIT License.
See LICENSE for more.

---

👤 Author

Sanju (aka Sandyie)
🌐 Website: www.sandyie.in
📧 Email: [e-mail]
🐍 PyPI: https://pypi.org/project/sandyie-read

---