2 Issues Potentially Fixed

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on: [push, pull_request]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: [3.7, 3.8, 3.9, '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install tox tox-gh-actions coveralls
+        pip install -r requirements-test.txt
+    - name: Test with tox
+      run: |
+        tox
+    - name: Upload coverage data to coveralls.io
+      run: coveralls --service=github
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        COVERALLS_FLAG_NAME: ${{ matrix.python-version }}
+        COVERALLS_PARALLEL: true
+
+  coveralls:
+    name: Indicate completion to coveralls.io
+    needs: build
+    runs-on: ubuntu-latest
+    container: python:3-slim
+    steps:
+      - name: Finished
+        run: |
+          pip3 install --upgrade coveralls
+          coveralls --service=github --finish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -4,3 +4,6 @@ dist
 .idea/
 *.egg-info
 /.tox
+.eggs/
+/venv/
+.venv/

CHANGES.rst

@@ -1,6 +1,89 @@
 Changelog
 =========
 
+Version 0.5.13 -- 2023/10/18
+---------------------------
+
+* Fix a problem in Brazilian Portuguese code referred to thousands when the hundreds are exact. (#421)
+* Fix issue with the hundreds of millions, billions, ... when the hundreds of those are exact. (#436)
+* Fix negative number problem (#477)
+* Fix lang_DK issues (#366)
+* Norwegian uplift (#484)
+* BYN to EU and RU (#439)
+* Change python3.6 to python3.11 because deprecation in ubuntu 22.04 (#494)
+* Add support for Azerbaijani language (#495)
+* Add Icelandic (#380)
+* Hebrew long-form spelling, gender, ordinals, fractions, maxval=1e66, construct forms (#490)
+* Fix 15, 16, 17, 18, 19 issue (#505)
+* Added support for the Nigerian Naira (#507)
+* Fix several issues with num2words in Arabic (#512)
+* Guatemalan currency support (#510)
+* Fix #508: Handle string inputs in Italian to_ordinal (#518)
+* Add Slovak language support (#533)
+* Add gender and morphological cases support for Ukrainian (#530)
+* Adding genders for Russian language (#503)
+* Lang By Added (#506)
+* Add Saudi Riyal to english (#531)
+
+Version 0.5.12 -- 2022/08/19
+----------------------------
+
+* Support Japanese Reiwa (令和/れいわ) era. (#412)
+* Add basic farsi support (#354)
+* Added Tajik language support (#406)
+* Fix Amharic language support (#465)
+* Fix Hebrew pluralize and implement to_currency (#330)
+* Add support to translate some currencies in italian language (#434)
+* Fix Polish twenties (#345)
+* Add uzs for ru and en (#422)
+* Added support for Esperanto numbers. (#387)
+* [ADD] to ordinal number for Turkish (#468)
+* Fix zeroth in Dutch to nulde fixing (#326)
+
+Version 0.5.11 -- 2022/08/03
+----------------------------
+
+* Add KZT and UAH currencies to lang RU (#264)
+* Add es_NI currency (#276)
+* Update .gitignore to add .eggs/ directory (#280)
+* Fix Hebrew support (#289)
+* Update test_tr.py to increase coverage (#298)
+* Add ordinal 12,345 to ES test suite to increase coverage (#287)
+* Add simple tests for lang_DK.py (#286)
+* Add testcase for lang_EN.py (#288)
+* Add more tests to base.py (#283)
+* Fixed misspelling of 21 (cardinal and ordinal number) in IT language (#270)
+* Romanian issues 259 (#260)
+* Adding Language Support for Telugu / Bug Fix in Kannada (#263)
+* Add support of Kazakh language (KZ) (#306)
+* Update README.rst (#307)
+* Added support for Hungarian language (#310)
+* [UPD] Readme file (#363)
+* [ADD] num2words: add traslation to spanish of several currencies (#356)
+* added swedish language including test cases (#352)
+* Remove dupplicated line in lang_PT_BR (#355)
+* Fix ordinal_num output for Dutch (NL) (#369)
+* Polishordinals (#367)
+* [tr] return Turkish 0 ordinal and cardinal (#347)
+* Improve Ukrainian support and minor fixes in CZ, KZ, LT, LV, PL, RU, SR languages (#400)
+* feat: ci: replace travis by github workflows (#448)
+* [ES] Added missing accents ("dieciséis", "dólar", "dólares", "veintiún"), improved currency gender handling, fixed pound cent names (#443)
+
+Version 0.5.10 -- 2019/05/12
+----------------------------
+
+* Add Kannada language localization (#243)
+* Revert some copyrights changed by mistake (#254)
+* Add indian rupee to the supported currencies (#248)
+* Improve currency functions for German and French (#247)
+* Improve Slovene localization (#246)
+* Improve Spanish localization (#240)
+* Fix typo 'seperator' on source code (#238)
+* Convert string to decimal values (#223)
+* Improve German localization and test coverage (#237)
+* Improve Polish localization (#233)
+* Fix ordinal number for French ending on 1 (#236)
+
 Version 0.5.9 -- 2019/01/10
 ---------------------------
 
@@ -33,9 +116,9 @@ Version 0.5.7 -- 2018/06/27
 * Add Finnish localization. (#170)
 * Add Japanese localization. (#171)
 * Add belgian-french localization. (#151)
-* Add Czech localization. (#154) 
+* Add Czech localization. (#154)
 * Add Thai localization. (#139)
-* Improve English localization. (#144) 
+* Improve English localization. (#144)
 * Improve Spanish localization. (#167)
 * Improve Italian localization. (#143)
 * Improve documentation. (#155, #145, #174)

README.rst

@@ -1,5 +1,5 @@
-num2words - Convert numbers to words in multiple languages
-==========================================================
+num2words library - Convert numbers to words in multiple languages
+==================================================================
 
 .. image:: https://img.shields.io/pypi/v/num2words.svg
    :target: https://pypi.python.org/pypi/num2words
@@ -51,7 +51,7 @@ Command line::
     $ num2words 24,120.10 -l es
     veinticuatro mil ciento veinte punto uno
     $num2words 2.14 -l es --to currency
-    dos euros con catorce centimos
+    dos euros con catorce céntimos
 
 In code there's only one function to use::
 
@@ -63,7 +63,7 @@ In code there's only one function to use::
     >>> num2words(42, lang='fr')
     quarante-deux
 
-Besides the numerical argument, there are two main optional arguments.
+Besides the numerical argument, there are two main optional arguments, ``to:`` and ``lang:``
 
 **to:** The converter to use. Supported values are:
 
@@ -76,26 +76,39 @@ Besides the numerical argument, there are two main optional arguments.
 **lang:** The language in which to convert the number. Supported values are:
 
 * ``en`` (English, default)
+* ``am`` (Amharic)
 * ``ar`` (Arabic)
+* ``az`` (Azerbaijani)
+* ``be`` (Belarusian)
+* ``ce`` (Chechen)
+* ``cy`` (Welsh)
 * ``cz`` (Czech)
 * ``de`` (German)
 * ``dk`` (Danish)
 * ``en_GB`` (English - Great Britain)
 * ``en_IN`` (English - India)
+* ``en_NG`` (English - Nigeria)
 * ``es`` (Spanish)
 * ``es_CO`` (Spanish - Colombia)
+* ``es_CR`` (Spanish - Costa Rica)
 * ``es_VE`` (Spanish - Venezuela)
+* ``es_GT`` (Spanish - Guatemala)
 * ``eu`` (EURO)
+* ``fa`` (Farsi)
 * ``fi`` (Finnish)
 * ``fr`` (French)
 * ``fr_CH`` (French - Switzerland)
 * ``fr_BE`` (French - Belgium)
 * ``fr_DZ`` (French - Algeria)
 * ``he`` (Hebrew)
+* ``hu`` (Hungarian)
 * ``id`` (Indonesian)
+* ``is`` (Icelandic)
 * ``it`` (Italian)
 * ``ja`` (Japanese)
+* ``kn`` (Kannada)
 * ``ko`` (Korean)
+* ``kz`` (Kazakh)
 * ``lt`` (Lithuanian)
 * ``lv`` (Latvian)
 * ``no`` (Norwegian)
@@ -104,9 +117,12 @@ Besides the numerical argument, there are two main optional arguments.
 * ``pt_BR`` (Portuguese - Brazilian)
 * ``sl`` (Slovene)
 * ``sr`` (Serbian)
+* ``sv`` (Swedish)
 * ``ro`` (Romanian)
 * ``ru`` (Russian)
-* ``sl`` (Slovene)
+* ``te`` (Telugu)
+* ``tet`` (Tetum)
+* ``tg`` (Tajik)
 * ``tr`` (Turkish)
 * ``th`` (Thai)
 * ``vi`` (Vietnamese)
@@ -144,4 +160,4 @@ added Lithuanian support, but didn't take over maintenance of the project.
 I am thus basing myself on Marius Grigaitis' improvements and re-publishing
 ``pynum2word`` as ``num2words``.
 
-Virgil Dupras, Savoir-faire Linux
+Virgil Dupras, Savoir-faire Linux

bin/num2words

@@ -34,7 +34,7 @@ Options:
     -t --to=<to>            Output converter [default: cardinal].
     -h --help               Show this message.
     -v --version            Show version.
-    
+
 Examples:
     $ num2words 10001
     ten thousand and one
@@ -46,7 +46,7 @@ Examples:
     veinticuatro mil ciento veinte punto uno
 
     $num2words 2.14 -l es --to currency
-    dos euros con catorce centimos
+    dos euros con catorce céntimos
 """
 
 from __future__ import print_function, unicode_literals
@@ -55,7 +55,7 @@ import sys
 from docopt import docopt
 import num2words
 
-__version__ = "0.5.9"
+__version__ = "0.5.13"
 __license__ = "LGPL"
 
 
@@ -76,13 +76,13 @@ def main():
             sys.stdout.write(os.linesep)
         sys.exit(0)
     if args["--list-converters"]:
-        for lang in get_converters():
-            sys.stdout.write(lang)
+        for cvt in get_converters():
+            sys.stdout.write(cvt)
             sys.stdout.write(os.linesep)
         sys.exit(0)
     try:
         words = num2words.num2words(args['<number>'], lang=args['--lang'], to=args['--to'])
-        sys.stdout.write(words+os.linesep)
+        sys.stdout.write(words + os.linesep)
         sys.exit(0)
     except Exception as err:
         sys.stderr.write(str(args['<number>']))

num2words/README.md

@@ -0,0 +1,70 @@
+# Add new language
+
+for each new language you must create a file `lang_NN.py` where `NN` is the 
+ISO 639-1 or ISO 639-3 [language code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).
+
+This class must be a subclass of `Num2Word_EU` and implement at least the following methods
+
+```
+to_cardinal(self, number)
+to_ordinal(self, number)
+``
+
+To integrate your language into the `num2words` module, add the name of  your file
+to the import list in [num2words/__init__.py](num2words/__init__.py) (top of the file),
+and `'nn': lang_NN.Num2Word_NN()` to the `CONVERTER_CLASSES` list in the same file.
+Do not forget to remplace `NN` by the appropriate ISO 639 language code.
+
+The following is a template for a new language class
+
+```
+from .lang_EU import Num2Word_EU
+
+class Num2Word_CY(Num2Word_EU):
+    def setup(self):
+        Num2Word_EU.setup(self)
+
+    def __init__(self):
+        pass
+
+    def to_ordinal(self, number):
+	# implement here your code. number is the integer to be transformed into an ordinal
+        # as a word (str)
+	# which is returned
+	return "NOT IMPLEMENTED"
+
+    def to_cardinal(self, number):
+	# implement here your code. number is the integer to be transformed into an cardinal
+        # as a word (str)
+	# which is returned
+	return "NOT IMPLEMENTED"
+```
+
+You can use as manu auxiliary methods as you need to make your code efficient and readable.
+If you need further options like Gender, Formal/Informal, add those parameters to the methods,
+e.g.
+
+```
+    def to_ordinal(self, number, gender="fem", informal=True)
+	# your code
+	pass
+```
+
+More inspiration can be found in existing `num2words/lang_NN.py` files
+
+## Code validation
+
+In order to get your contribution merged into the main project, your code must test the validation tests.
+For this install the packages needed to test
+
+```
+pip install -r requirements-test.txt
+```
+
+run `tox` and `coverage` to check that the code is well formated and all parts of the code are tested
+
+```
+tox
+python3 -m coverage report -m
+```
+