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