level-zero

Convert building floor numbering to start from 0 — because arrays start at zero.

Supports US, UK, European, Japanese, Chinese, and Indian floor systems.

Installation

pip install level-zero

Usage

from level_zero import convert, FloorSystem, Building

# Quick conversions
convert("3", FloorSystem.US, FloorSystem.ZERO)        # "2"
convert("G", FloorSystem.UK, FloorSystem.ZERO)         # "0"
convert("5F", FloorSystem.JAPAN, FloorSystem.ZERO)      # "4"
convert("2", FloorSystem.ZERO, FloorSystem.US)          # "3"

# Shorthand helpers
from level_zero.converter import us_to_zero, zero_to_us
us_to_zero(3)    # 2
zero_to_us(0)    # 1

# Full building conversion table
b = Building(name="Empire State", system=FloorSystem.US, total_floors=102, basements=2)
print(b.mapping_table())
print(b.to_zero("13"))   # handles skipped floors
print(b.from_zero("0"))  # "1"

CLI

level-zero convert 3 --from us --to zero
level-zero convert G --from uk --to us
level-zero building --name "Tokyo Tower" --system japan --floors 20 --basements 3
level-zero systems

Why?

Because elevator[0] should be the ground floor.

License

MIT