webimg 0.1.0__tar.gz

webimg-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Himal Bhattarai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

webimg-0.1.0/PKG-INFO

@@ -0,0 +1,63 @@
+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.

webimg-0.1.0/README.md

@@ -0,0 +1,45 @@
+# 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.

webimg-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "webimg"
+version = "0.1.0"
+description = "Download all images from a webpage in one function call"
+readme = "README.md"
+requires-python = ">=3.7"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Himal Bhattarai" }
+]
+keywords = ["images", "download", "scraping", "webpage", "web scraping"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+dependencies = [
+    "requests",
+    "beautifulsoup4"
+]
+
+[tool.setuptools]
+packages = ["webimg"]

webimg-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

webimg-0.1.0/webimg/__init__.py

@@ -0,0 +1,4 @@
+from .core import download
+
+__all__ = ["download"]
+__version__ = "0.1.0"

webimg-0.1.0/webimg/core.py

@@ -0,0 +1,88 @@
+import os
+import requests
+from bs4 import BeautifulSoup
+from urllib.parse import urljoin, urlparse
+
+HEADERS = {
+    "User-Agent": (
+        "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
+        "AppleWebKit/537.36 (KHTML, like Gecko) "
+        "Chrome/120.0 Safari/537.36"
+    )
+}
+
+
+def _get_image_urls(page_url):
+    resp = requests.get(page_url, headers=HEADERS, timeout=15)
+    resp.raise_for_status()
+    soup = BeautifulSoup(resp.text, "html.parser")
+
+    urls = set()
+    for img in soup.find_all("img"):
+        for attr in ("src", "data-src"):
+            val = img.get(attr)
+            if val:
+                urls.add(urljoin(page_url, val))
+        srcset = img.get("srcset")
+        if srcset:
+            for part in srcset.split(","):
+                candidate = part.strip().split(" ")[0]
+                if candidate:
+                    urls.add(urljoin(page_url, candidate))
+    return list(urls)
+
+
+def _safe_filename(url, index):
+    name = os.path.basename(urlparse(url).path)
+    if not name or "." not in name:
+        name = f"image_{index}.jpg"
+    return name
+
+
+def download(url, output_dir="images"):
+    """
+    Download every image found on the given webpage URL.
+
+    Usage:
+        import webimg
+        webimg.download("https://example.com")
+
+    Args:
+        url (str): The webpage URL to scan for images.
+        output_dir (str): Folder to save images into (default "images").
+
+    Returns:
+        list[str]: Paths of the successfully saved image files.
+    """
+    os.makedirs(output_dir, exist_ok=True)
+    image_urls = _get_image_urls(url)
+
+    if not image_urls:
+        print("No images found on this page.")
+        return []
+
+    saved = []
+    print(f"Found {len(image_urls)} image(s). Downloading to '{output_dir}'...")
+
+    for i, img_url in enumerate(image_urls, start=1):
+        filename = _safe_filename(img_url, i)
+        filepath = os.path.join(output_dir, filename)
+
+        base, ext = os.path.splitext(filepath)
+        counter = 1
+        while os.path.exists(filepath):
+            filepath = f"{base}_{counter}{ext}"
+            counter += 1
+
+        try:
+            img_resp = requests.get(img_url, headers=HEADERS, timeout=15)
+            img_resp.raise_for_status()
+            with open(filepath, "wb") as f:
+                f.write(img_resp.content)
+            saved.append(filepath)
+            print(f"  Saved: {filepath}")
+        except Exception as e:
+            print(f"  Failed ({img_url}): {e}")
+
+    print("Done.")
+    return saved

webimg-0.1.0/webimg.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+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.

webimg-0.1.0/webimg.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+webimg/__init__.py
+webimg/core.py
+webimg.egg-info/PKG-INFO
+webimg.egg-info/SOURCES.txt
+webimg.egg-info/dependency_links.txt
+webimg.egg-info/requires.txt
+webimg.egg-info/top_level.txt

webimg-0.1.0/webimg.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

webimg-0.1.0/webimg.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests
+beautifulsoup4

webimg-0.1.0/webimg.egg-info/top_level.txt

@@ -0,0 +1 @@
+webimg