Skip to main content

Polish spelled-out numbers and amounts.

Project description


Polish spelled-out numbers and amounts.



Provides routines to spell out numbers and amounts in Polish.

PyPI record.



>>> from slownie import *
>>> slownie(12892)
dwanaście tysięcy osiemset dziewięćdziesiąt dwa
>>> slownie_zl(123.34)
sto dwadzieścia trzy złote trzydzieści cztery grosze
>>> slownie_zl100gr(123.34)
sto dwadzieścia trzy złote 34/100



To install run:

python -m pip install --upgrade slownie



  • Development is strictly based on tox. To install it run:

    python -m pip install --upgrade tox

Visit Development page.

Installation from sources:

clone the sources:

git clone slownie

and run:

python -m pip install ./slownie

or on development mode:

python -m pip install --editable ./slownie


Copyright (c) 2016-2024 Adam Karpierz
Licensed under the zlib/libpng License
Please refer to the accompanying LICENSE file.



1.2.3 (2024-01-26)

  • Setup update (now based on tox >= 4.0).

  • Cleanup.

1.2.0 (2023-12-15)

  • Added ‘conjunction’ parameter for the slownie_zl() function.
    Thanks to Tomasz Pichlinski (@tomaszpichlinskiapz).
  • The supported parts of the amount have been extended up to
  • Add support for Python 3.12

  • Drop support for Python 3.7

  • Add support for PyPy 3.9 and 3.10

  • Copyright year update.

  • Tox configuration has been moved to pyproject.toml

1.1.3 (2022-09-02)

  • Add support for Python 3.10 and 3.11

  • Drop support for Python 3.6

  • Copyright year update.

  • Setup update (currently based mainly on pyproject.toml).

1.1.2 (2020-10-17)

  • Add support for Python 3.8 and 3.9

  • Drop support for Python 3.5

  • Drop support for Python 2

  • Fix a bug in slownie_zl().

  • Add unittests.

  • General update and cleanup.

  • Fixed docs setup.

1.0.0rc1 (2018-11-21)

  • Fix a bug in slownie_zl() and slownie_zl100gr()

  • Code improvement according to the suggestion and the patch
    from Michal Borkowski (
    Thank you very much, Michal!

1.0.0b5 (2018-11-08)

  • Drop support for Python 2.6 and 3.0-3.3

  • Update required setuptools version.

1.0.0b4 (2018-05-08)

  • Update required setuptools version.

  • Improve and simplify setup and packaging.

1.0.0b3 (2018-02-26)

  • Improve and simplify setup and packaging.

1.0.0b2 (2018-01-28)

  • Fix a bug and inconsistencies in tox.ini

  • Update of README.rst.

0.9.7b2 (2018-01-24)

  • Little update of README.rst

0.9.7b1 (2018-01-24)

  • Update required Sphinx version.

  • Update doc Sphinx configuration files.

0.9.5b1 (2017-11-18)

  • Add slownie_zl and slownie_zl100gr.

  • Setup improvements.

  • Other minor improvements.

0.9.0b0 (2017-04-03)

  • First useful release.

0.1.0 (2016-09-23)

  • Initial release.

Project details

Download files

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

Source Distribution (19.1 kB view hashes)

Uploaded source

Built Distribution

slownie-1.2.3-py3-none-any.whl (5.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page