aspect-ratio-too 0.2.0

Aspect ratio calculations.

Aspect Ratio Too

Overview

Aspect ratio calculations.

Installation

uv add aspect-ratio-too

For CLI use, install optional extras:

uv add "aspect-ratio-too[cli]"

Usage

Know the aspect ratio you want but do not know the corresponding width/height? Try this:

from aspect_ratio_too import AspectRatioCalculator

arc = AspectRatioCalculator(16, 9)

# Get (width/height) tuple
arc.width_to_dimensions(1920)  # (1920, 1080)
arc.height_to_dimensions(1080)  # (1920, 1080)

arc.width_to_height(1920)  # 1080
arc.height_to_width(1080)  # 1920

Or calculate the aspect ratio given known pixel dimensions:

from aspect_ratio_too import aspect_ratio, aspect_ratio_str

aspect_ratio(1920, 1080)  # 1.7777777777777777
aspect_ratio_str(1920, 1080)  # 16:9

CLI

aspect-ratio ratio 1920 1080
aspect-ratio ratio-str 1920 1080
aspect-ratio width-to-height 16 9 1920
aspect-ratio height-to-width 16 9 1080
aspect-ratio width-to-dimensions 16 9 1920
aspect-ratio height-to-dimensions 16 9 1080

Development

just --list
just env
just uv-install-dev
just pip-install-editable

Testing

just pytest
just coverage
just open-coverage

For quick local quality checks:

just check

Issues

If you experience any issues, please create one in the issue tracker.

---

History

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

0.2.0 (2026-04-22)

• Added an aspect-ratio CLI wrapper command.
• Added optional cli dependencies (click and rich) so library-only installs do not require CLI packages.
• Added CLI command coverage in tests and packaging script entrypoint wiring.

0.1.1 (2023-06-22)

• Update packaging method to pyproject.toml.

0.0.1 (2022-11-07)

• First release