num2label 1.0.0

A package to map numbers to text labels.

num2label

A package to map numbers to text labels. For example, n maps to the nth letter of the alphabet. You can also map numbers to their corresponding spreadsheet column labels.

Quick start

Map an integer to a lowercase letter of the alphabet:

>>> import num2label
>>> 
>>> num2label.lowercase_letter(1)
'a'

Or an uppercase letter:

>>> num2label.uppercase_letter(26)
'Z'

Or even map a number to a spreadsheet column label:

>>> num2label.spreadsheet_column(28)
'AB'

The number must always be greater than zero. The number can be greater than 26. lowercase_letter and uppercase_letter will effectively loop the alphabet until the corresponding letter is reached (i.e. 27 => 'a', 55 => 'C'). To ensure the number passed is strictly less than 27, pass strict=True. num2label.lowercase_letter(27, strict=True) will raise an error because the number is not between one and 26 (inclusive).