smpldta 0.2.1

Fetch sample data like images, videos, code, GIFs, text, and JSON files.

📦 smpldta — Sample Data Fetcher

smpldta is a Python library to fetch and generate real sample data like images, videos, gifs, code, JSON, text files, and PDFs — in any quantity you specify.

It helps developers, testers, and data scientists quickly build test environments, validate pipelines, or create dummy data for demos, machine learning, or automation.

---

🚀 Features

• 📸 Download real images from the web with size/dimension constraints
• 🎥 Fetch videos in multiple formats like mp4, mkv, flv, 3gp
• 🎞️ Get animated GIFs from Giphy
• 📄 Generate PDFs with size limits
• 📁 Create structured JSON files with a schema
• 💬 Generate random text files with word/size limits
• 💻 Generate code files in Python, Java, JavaScript, C, etc.

---

📦 smpldta

smpldta is a Python-based utility that generates sample data files for testing and prototyping. It supports fetching images, videos, code snippets, text, JSON, and PDFs—organized in a clear directory structure.

---

📚 Table of Contents

• Features
• Installation
• Usage
  • 🖼️ fetch_images(config)
  • 🎥 fetch_videos(config)
  • 🎞️ fetch_gifs(count)
  • 💻 fetch_code(config)
  • 📝 fetch_text(config)
  • 🧾 fetch_json(config)
  • 📄 fetch_pdfs(config)
• 📂 Output Structure
• 💡 Why Use smpldta?
• 📄 License

---

🛠️ Installation

pip install smpldta

requires python>=3.0

---

📦 Usage

from smpldta import Smpldta

fetcher = Smpldta("FOLDER_NAME")

Add folder name where the data will be stored

🖼️ fetch_images(config)

config = {
    "jpg": {
        "count": 3,
        "min_size": "5kb",
        "max_size": "500kb",
        "height": 400,
        "width": 400
    },
    "jpeg": {
        "count": 2,
        "min_size": "10kb",
        "max_size": "1mb",
        "height": 600,
        "width": 300
    }
}
fetcher.fetch_images(config = config, subdir="name_of_the_folder(images)")

---

🎥 fetch_videos(config)

config = {
    "mp4": {
        "count": 3,
        "min_size":"100kb,
        "max_size": "20mb"
    },
    "3gp": {
        "count": 2,
        "min_size":"10kb"
        "max_size": "10mb"
    }
}
fetcher.fetch_videos(config = config, subdir="name_of_the_folder(videos)")

Note: Formats can be mp4, flv, mkv, 3gp

---

🎞️ fetch_gifs(count)

fetcher.fetch_gifs(count=5, subdir="name_of_the_folder(gifs)")

---

💻 fetch_code(config)

config = {
    "python": 2,
    "java": 2,
    "c": 1,
    "cpp": 1,
    "javascript": 1,
    "typescript": 1
}
fetcher.fetch_code(config = config, subdir="name_of_the_folder(code)")

Note: Only Python, Cpp, C, Java, Typescript, Javascript can be used

---

📝 fetch_text(config)

config = {
    "count": 4,
    "min_words": 100,
    "max_words": 1000,
    "max_size": "200kb"
}
fetcher.fetch_text(config = config, subdir="name_of_the_folder(text)")

---

🧾 fetch_json(config)

config = {
    "schema": {
        "id": "uuid",
        "name": "str",
        "email": "email",
        "age": "int",
        "joined": "date",
        "score": "float"
    },
    "min_data_per_file": 5,
    "max_data_per_file": 15,
    "count": 5
}
fetcher.fetch_json(config = config, subdir="name_of_the_folder(json)")

---

📄 fetch_pdfs(config)

config = {
    "count": 3,
    "min_size": "100kb",
    "max_size": "500kb"
}
fetcher.fetch_pdfs(config = config, subdir="name_of_the_folder(pdfs)")

Note: Generate less size of pdf

---

📂 Output Structure

output/
├── images/
├── videos/
├── gifs/
├── code/
├── text/
├── json/
└── pdfs/

Each data type is saved in its own subfolder with unique filenames.

To change the names of the folder use this

subdir="name_of_the_folder"

Example:
fetcher.fetch_images(config, subdir="name_of_the_folder")

---

💡 Why Use smpldta?

• Eliminate the need to manually source or generate test data
• Supports a variety of formats and customization options
• Ideal for pipelines, automated tests, and demos

---

📄 License

MIT License

Author: Parteek