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,106 @@
 Changelog
 =========
 
+Version 0.5.14 -- 2024/12/16
+----------------------------
+
+* Fixed a typo in PL (#466)
+* Run tests against Python 3.12 (#544)
+* ADD num2words: es_CR language (#565)
+* New languages: Welsh (Celtic) and Chechen (Nakho-Dagestanian) (#543)
+* Add catalan language support (#581)
+* Adding Tetum Language (#576)
+* FIX ISO code for Belarusian language is be, not by. (#574)
+* Add test to improve coverage (#595)
+* Added Bangla language support to num2word for Bangladesh. (#589)
+* Czech language ISO 639-1 code fix (#587)
+* Added support for Tunisian Dinar  (#593)
+* Change danish language code to DA (#596)
+
+
+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 +133,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,42 +76,61 @@ 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)
-* ``cz`` (Czech)
+* ``az`` (Azerbaijani)
+* ``be`` (Belarusian)
+* ``bn`` (Bangladeshi)
+* ``ca`` (Catalan)
+* ``ce`` (Chechen)
+* ``cs`` (Czech)
+* ``cy`` (Welsh)
+* ``da`` (Danish)
 * ``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_GT`` (Spanish - Guatemala)
 * ``es_VE`` (Spanish - Venezuela)
 * ``eu`` (EURO)
+* ``fa`` (Farsi)
 * ``fi`` (Finnish)
 * ``fr`` (French)
-* ``fr_CH`` (French - Switzerland)
 * ``fr_BE`` (French - Belgium)
+* ``fr_CH`` (French - Switzerland)
 * ``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)
+* ``nl`` (Dutch)
 * ``no`` (Norwegian)
 * ``pl`` (Polish)
 * ``pt`` (Portuguese)
 * ``pt_BR`` (Portuguese - Brazilian)
-* ``sl`` (Slovene)
-* ``sr`` (Serbian)
 * ``ro`` (Romanian)
 * ``ru`` (Russian)
 * ``sl`` (Slovene)
+* ``sk`` (Slovak)
+* ``sr`` (Serbian)
+* ``sv`` (Swedish)
+* ``te`` (Telugu)
+* ``tet`` (Tetum)
+* ``tg`` (Tajik)
 * ``tr`` (Turkish)
 * ``th`` (Thai)
-* ``vi`` (Vietnamese)
-* ``nl`` (Dutch)
 * ``uk`` (Ukrainian)
+* ``vi`` (Vietnamese)
 
 You can supply values like ``fr_FR``; if the country doesn't exist but the
 language does, the code will fall back to the base language (i.e. ``fr``). If
@@ -144,4 +163,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.14"
 __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>']))