Metadata-Version: 2.4
Name: webimg
Version: 0.1.0
Summary: Download all images from a webpage in one function call
Author: Himal Bhattarai
License-Expression: MIT
Keywords: images,download,scraping,webpage,web scraping
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: beautifulsoup4
Dynamic: license-file

# webimg

Download every image from a webpage in one function call.

## Install

```bash
pip install webimg
```

(This also installs its two dependencies, `requests` and `beautifulsoup4`.)

## Usage

```python
import webimg

webimg.download("https://example.com")
```

That's it — it scans the page, finds every image, and saves them into an
`images/` folder in your current directory.

### Optional: choose the output folder

```python
import webimg

webimg.download("https://example.com", output_dir="my_photos")
```

### Optional: get the list of saved file paths

```python
import webimg

saved_files = webimg.download("https://example.com")
print(saved_files)
```

## Notes

- Only works on static HTML pages. JS-heavy sites that load images dynamically
  won't be fully captured.
- Please make sure you have the right to download and use the images.
