Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

Support for various integer-to-numeral conversion.

Project description

This Python library implements integer-to-numeral and numeral-to-integer conversion for a variety of numeral representations, including:

  • alphabetic representation, i.e. a, b, c, d, … for 0, 1, 2, 3, …
  • Roman numbers, i.e. I, II, III, IV, … for 1, 2, 3, 4, …
  • generic tokens set representation, i.e. !, @, !!, !@, … for 0, 1, 2, 3… (given the tokens set {!, @}).

The generic tokens set representation uses the least number of tokens for representing a given integer, and uses an exponential-like notation similar to base-n conversion, except that the first symbol is used. The alphabetic representation is a special case of a generic tokens set representation, where the latin alphabet is used as tokens set. Upper/lower case conversion should be handled through Python built-ins. All representation support negative values.

Detailed documentation is available for all functions through docstrings.

Of note, the Roman numbers support include:

Installation

The recommended way of installing the software is through PyPI:

$ pip install numeral

Alternatively, you can clone the source repository from Bitbucket:

$ mkdir numeral
$ cd numeral
$ git clone git@bitbucket.org:norok2/numeral.git
$ python setup.py install

(some steps may require additional permissions depending on your configuration)

The software does not have additional dependencies beyond Python and its standard library.

It was tested with Python 2.7 and 3.5. Other version were not tested.

Usage

The following functions are defined:

int2letter

Convert a number to the least amount letters (within an alphabet).

>>> int2letter(10)
'k'
>>> import string  # Common string operations
>>> int2letter(10, string.ascii_letters)  # using both lower and upper cases
'aW'

letter2int

Convert a group of letters (within a given alphabet) to a number.

>>> letter2int('aa')
26

int2tokens

Convert a number to the least amount tokens (within a tokens set).

>>> int2tokens(12, ('!', '@', '#', '$'))
'#!'

tokens2int

Convert a group of tokens (within a given set) to a number.

>>> tokens2int('#!', ('!', '@', '#', '$'))
12

int2roman

Convert an integer to its corresponding Roman number representation.

>>> int2roman(1666)  # using dedicated unicode chars
'ⅯⅮⅭⅬⅩⅥ'
>>> int2roman(1666, only_ascii=True)  # using only ASCII
'MDCLXVI'

roman2int

Convert a string representation of a Roman number to integer.

>>> int2roman('MDCLXVI')
1666

Project details


Release history Release notifications

This version
History Node

0.1.0.11

History Node

0.1.0.10

History Node

0.1.0.9

History Node

0.1.0.8

History Node

0.1.0.7

History Node

0.1.0.6

History Node

0.1.0.5

History Node

0.1.0.4

History Node

0.1.0.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
numeral-0.1.0.11-py2.py3-none-any.whl (12.3 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Nov 15, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page