Metadata-Version: 2.5
Name: jupyterlab_fit_image_size_extension
Version: 1.0.6
Summary: Jupyterlab extension to fit image to view size when image too large, and leave it as-is when smaller. This applies to all raster images (png, jpg etc..) and vector images (svg etc..)
Project-URL: Homepage, https://github.com/stellarshenson/jupyterlab_fit_image_size_extension
Project-URL: Bug Tracker, https://github.com/stellarshenson/jupyterlab_fit_image_size_extension/issues
Project-URL: Repository, https://github.com/stellarshenson/jupyterlab_fit_image_size_extension.git
Author-email: Stellars Henson <konrad.jelen@gmail.com>
License-Expression: BSD-3-Clause
License-File: LICENSE
Keywords: jupyter,jupyterlab,jupyterlab-extension
Classifier: Framework :: Jupyter
Classifier: Framework :: Jupyter :: JupyterLab
Classifier: Framework :: Jupyter :: JupyterLab :: 4
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions
Classifier: Framework :: Jupyter :: JupyterLab :: Extensions :: Prebuilt
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Provides-Extra: dev
Requires-Dist: jupyter-builder<2,>=1.2.0; extra == 'dev'
Requires-Dist: jupyterlab<5,>=4.6; extra == 'dev'
Description-Content-Type: text/markdown

# jupyterlab_fit_image_size_extension

[![GitHub Actions](https://github.com/stellarshenson/jupyterlab_fit_image_size_extension/actions/workflows/build.yml/badge.svg)](https://github.com/stellarshenson/jupyterlab_fit_image_size_extension/actions/workflows/build.yml)
[![npm version](https://img.shields.io/npm/v/@stellarshenson/jupyterlab-fit-image-size-extension.svg)](https://www.npmjs.com/package/@stellarshenson/jupyterlab-fit-image-size-extension)
[![PyPI version](https://img.shields.io/pypi/v/jupyterlab-fit-image-size-extension.svg)](https://pypi.org/project/jupyterlab-fit-image-size-extension/)
[![Total PyPI downloads](https://static.pepy.tech/badge/jupyterlab-fit-image-size-extension)](https://pepy.tech/project/jupyterlab-fit-image-size-extension)
[![JupyterLab 4](https://img.shields.io/badge/JupyterLab-4-orange.svg)](https://jupyterlab.readthedocs.io/en/stable/)
[![Brought To You By KOLOMOLO](https://img.shields.io/badge/Brought%20To%20You%20By-KOLOMOLO-00ffff?style=flat)](https://kolomolo.com)

> [!TIP]
> This extension is part of the [stellars_jupyterlab_extensions](https://github.com/stellarshenson/stellars_jupyterlab_extensions) metapackage. Install all Stellars extensions at once: `pip install stellars_jupyterlab_extensions`

Automatically scales images to fit within the view when they exceed container dimensions, while preserving original size for smaller images. Applies to both raster formats (PNG, JPG) and vector formats (SVG).

**Full disclosure:** This extension is mass-produced mediocrity at its finest. It does one thing that probably should have been a default setting. No configuration, no options, no preferences panel - just CSS that your browser was already capable of applying. You're essentially installing a stylesheet. Revolutionary. We're almost ashamed of it. Almost.

## Features

- **Automatic image scaling** - Large images are scaled down to fit within view boundaries
- **Preserves small images** - Images smaller than container remain at original size
- **Raster format support** - Works with PNG, JPG, GIF, and other raster formats
- **Vector format support** - SVG images also respect container bounds
- **Notebook outputs** - Handles images in code cell outputs
- **Markdown cells** - Images in markdown cells are also scaled
- **Standalone viewer** - Works when opening image files directly in JupyterLab
- **Zero configuration** - Just install and forget

## Installation

Requires JupyterLab 4.6.0 or higher.

```bash
pip install jupyterlab_fit_image_size_extension
```

## Uninstall

```bash
pip uninstall jupyterlab_fit_image_size_extension
```

## License

BSD-3-Clause
