Eonums

About

Eonums is a simple module providing conversion between normal
integer numbers and the corresponding textual expression in the
Esperano language.
It was mainly developped in order to explore the regularity of
Esperanto expressions for big integer numbers.

Names for 10k (k = 6, 9, 12, ...) like "miliono" (106) or
"miliardo" (109) are chosen from the so-called "Longa Skalo"
as described on this page about
big numbers
(in Esperanto).

The integer numbers eonums can convert to or from such Esperanto
expressions can be arbitrarily large, but are limited in practice
by the largest number for which there is a name in Esperanto (on
the "Longa Skalo")", which is, on the previous page, 1063
(dekiliardo). Hence, the largest integer you can handle with this
module is 1066 - 1. (This module makes no attempt to extend the
Esperanto naming rules by introducing names like "undekiliono",
"undekiliardo", "dudekiliono" etc.)

Version 0.9.1 now works on Python 2 and Python 3.

Features

convert Python integers to Esperanto integer strings (Unicode)

convert Esperanto integer strings (Unicode) to Python integers

validate Esperanto integer strings (Unicode)

handle integers from 0 to 1066 - 1

provide conversion functions and command-line scripts

provide a Unittest test suite

runs the same code under Python 2 and Python 3

Examples

You can use eonums as a Python module e.g. like in the following
interactive sessions:

You can also install eonums using pip the usual way, if it is already
installed:

$ pip install eonums

2. Manual installation

Alternatively, you can install the eonums tarball after downloading
the file eonums-0.9.1.tar.gz and decompressing it with the following
command:

$ tar xfz eonums-0.9.1.tar.gz

Then change into the newly created directory eonums and install
eonums by running the following command:

$ python setup.py install

This will install a Python module named eonums in the
site-packages subfolder of your Python interpreter and two scripts
tool named int2eo and eo2int in your bin directory, usually
in /usr/local/bin.

Testing

The eonums distribution contains a Unittest test suite (not installed
during installation) which can be run by simply executing the module
test_eonums.py like the following on the system command-line in
the unpacked distribution folder: