slownie 1.3.4__tar.gz

slownie-1.3.4/.readthedocs.yml

@@ -0,0 +1,15 @@
+version: 2
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.12"
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - doc
+sphinx:
+  builder: html
+  configuration: docs/conf.py
+  fail_on_warning: true

slownie-1.3.4/CHANGES.rst

@@ -0,0 +1,97 @@
+Changelog
+=========
+
+1.3.4 (2024-12-13)
+------------------
+- Source distribution (\*.tar.gz now) is compliant with PEP-0625.
+- Setup (dependencies) update.
+
+1.3.3 (2024-11-13)
+------------------
+- More unittests.
+- 100% code linting.
+- 100% code coverage.
+- Tox configuration is now in native (toml) format.
+- Setup (dependencies) update.
+
+1.3.2 (2024-10-30)
+------------------
+- Drop support for Python 3.8
+- Setup (dependencies) update.
+
+1.2.4 (2024-08-13)
+------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+
+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
+  | 'duodecyliard'.
+- 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 (https://github.com/wielkiborsuk).
+  | 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.0b2 (2018-01-28)
+--------------------
+- Fix a bug and inconsistencies in tox.ini
+- Update of README.rst.
+- 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.

slownie-1.3.4/LICENSE

@@ -0,0 +1,19 @@
+zlib License
+
+Copyright (C) 2016-2024 Adam Karpierz
+
+This software is provided 'as-is', without any express or implied
+warranty.  In no event will the authors be held liable for any damages
+arising from the use of this software.
+
+Permission is granted to anyone to use this software for any purpose,
+including commercial applications, and to alter it and redistribute it
+freely, subject to the following restrictions:
+
+1. The origin of this software must not be misrepresented; you must not
+   claim that you wrote the original software. If you use this software
+   in a product, an acknowledgment in the product documentation would be
+   appreciated but is not required.
+2. Altered source versions must be plainly marked as such, and must not be
+   misrepresented as being the original software.
+3. This notice may not be removed or altered from any source distribution.

slownie-1.3.4/MANIFEST.in

@@ -0,0 +1,18 @@
+# Copyright (c) 2016 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+include README.rst
+include CHANGES.rst
+include LICENSE
+include pyproject.toml
+include .readthedocs.yml
+
+graft docs
+
+graft src
+
+graft tests
+
+global-exclude \#* \#*/**
+global-exclude .build .build/** .build.* .build.*/**
+global-exclude *.py[cod] __pycache__

slownie-1.3.4/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.1
+Name: slownie
+Version: 1.3.4
+Summary: Polish spelled-out numbers and amounts.
+Author: Adam Karpierz
+Author-email: adam@karpierz.net
+Maintainer: Adam Karpierz
+Maintainer-email: adam@karpierz.net
+License: zlib/libpng License ; https://opensource.org/license/zlib
+Project-URL: Homepage, https://pypi.org/project/slownie/
+Project-URL: Documentation, https://slownie.readthedocs.io/
+Project-URL: Download, https://pypi.org/project/slownie/
+Project-URL: Source, https://github.com/karpierz/slownie
+Project-URL: Issues, https://github.com/karpierz/slownie/issues
+Keywords: slownie
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: zlib/libpng License
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Polish
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <4.0.0,>=3.9.0
+Description-Content-Type: text/x-rst; charset=UTF-8
+License-File: LICENSE
+Requires-Dist: setuptools>=75.6.0
+Requires-Dist: pkg-about>=1.2.6
+Provides-Extra: doc
+Requires-Dist: Sphinx>=7.4.7; extra == "doc"
+Requires-Dist: sphinx-toolbox>=3.8.1; extra == "doc"
+Requires-Dist: sphinx-tabs>=3.4.5; extra == "doc"
+Requires-Dist: sphinx-copybutton>=0.5.2; extra == "doc"
+Requires-Dist: sphinxcontrib-spelling>=8.0.0; extra == "doc"
+Requires-Dist: sphinx-lint>=1.0.0; extra == "doc"
+Requires-Dist: restructuredtext-lint>=1.4.0; extra == "doc"
+Requires-Dist: nbsphinx>=0.9.5; extra == "doc"
+Provides-Extra: test
+Requires-Dist: deepdiff>=8.0.1; extra == "test"
+Requires-Dist: rich>=13.9.4; extra == "test"
+
+slownie
+=======
+
+Polish spelled-out numbers and amounts.
+
+Overview
+========
+
+| **slownie(value):**
+| **slownie_zl(amount):**
+| **slownie_zl100gr(amount):**
+
+Provides routines to spell out numbers and amounts in Polish.
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+.. code:: python
+
+  >>> 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
+
+Installation
+============
+
+Prerequisites:
+
++ Python 3.9 or higher
+
+  * https://www.python.org/
+
++ pip and setuptools
+
+  * https://pypi.org/project/pip/
+  * https://pypi.org/project/setuptools/
+
+To install run:
+
+  .. parsed-literal::
+
+    python -m pip install --upgrade |package|
+
+Development
+===========
+
+Prerequisites:
+
++ 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:
+
+  .. parsed-literal::
+
+    git clone |respository| |package|
+
+and run:
+
+  .. parsed-literal::
+
+    python -m pip install ./|package|
+
+or on development mode:
+
+  .. parsed-literal::
+
+    python -m pip install --editable ./|package|
+
+License
+=======
+
+  | |copyright|
+  | Licensed under the zlib/libpng License
+  | https://opensource.org/license/zlib
+  | Please refer to the accompanying LICENSE file.
+
+Authors
+=======
+
+* Adam Karpierz <adam@karpierz.net>
+
+.. |package| replace:: slownie
+.. |package_bold| replace:: **slownie**
+.. |copyright| replace:: Copyright (c) 2016-2024 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/slownie.git
+.. _Development page: https://github.com/karpierz/slownie
+.. _PyPI record: https://pypi.org/project/slownie/
+.. _Documentation: https://slownie.readthedocs.io/
+
+Changelog
+=========
+
+1.3.4 (2024-12-13)
+------------------
+- Source distribution (\*.tar.gz now) is compliant with PEP-0625.
+- Setup (dependencies) update.
+
+1.3.3 (2024-11-13)
+------------------
+- More unittests.
+- 100% code linting.
+- 100% code coverage.
+- Tox configuration is now in native (toml) format.
+- Setup (dependencies) update.
+
+1.3.2 (2024-10-30)
+------------------
+- Drop support for Python 3.8
+- Setup (dependencies) update.
+
+1.2.4 (2024-08-13)
+------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+
+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
+  | 'duodecyliard'.
+- 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 (https://github.com/wielkiborsuk).
+  | 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.0b2 (2018-01-28)
+--------------------
+- Fix a bug and inconsistencies in tox.ini
+- Update of README.rst.
+- 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.

slownie-1.3.4/README.rst

@@ -0,0 +1,102 @@
+slownie
+=======
+
+Polish spelled-out numbers and amounts.
+
+Overview
+========
+
+| **slownie(value):**
+| **slownie_zl(amount):**
+| **slownie_zl100gr(amount):**
+
+Provides routines to spell out numbers and amounts in Polish.
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+.. code:: python
+
+  >>> 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
+
+Installation
+============
+
+Prerequisites:
+
++ Python 3.9 or higher
+
+  * https://www.python.org/
+
++ pip and setuptools
+
+  * https://pypi.org/project/pip/
+  * https://pypi.org/project/setuptools/
+
+To install run:
+
+  .. parsed-literal::
+
+    python -m pip install --upgrade |package|
+
+Development
+===========
+
+Prerequisites:
+
++ 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:
+
+  .. parsed-literal::
+
+    git clone |respository| |package|
+
+and run:
+
+  .. parsed-literal::
+
+    python -m pip install ./|package|
+
+or on development mode:
+
+  .. parsed-literal::
+
+    python -m pip install --editable ./|package|
+
+License
+=======
+
+  | |copyright|
+  | Licensed under the zlib/libpng License
+  | https://opensource.org/license/zlib
+  | Please refer to the accompanying LICENSE file.
+
+Authors
+=======
+
+* Adam Karpierz <adam@karpierz.net>
+
+.. |package| replace:: slownie
+.. |package_bold| replace:: **slownie**
+.. |copyright| replace:: Copyright (c) 2016-2024 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/slownie.git
+.. _Development page: https://github.com/karpierz/slownie
+.. _PyPI record: https://pypi.org/project/slownie/
+.. _Documentation: https://slownie.readthedocs.io/

slownie-1.3.4/docs/CHANGES.rst

@@ -0,0 +1,2 @@
+.. _changes:
+.. include:: ../CHANGES.rst

slownie-1.3.4/docs/README.rst

@@ -0,0 +1 @@
+.. include:: ../README.rst

slownie-1.3.4/docs/conf.py

@@ -0,0 +1,114 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+__import__("pkg_about").about_from_setup()
+
+def setup(app):
+    pass
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project   = about.__title__
+copyright = about.__copyright__
+author    = about.__author__
+
+# The full version, including alpha/beta/rc tags
+release = about.__version__
+
+
+# -- General configuration ---------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+needs_sphinx = '7.4.7'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+    'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
+    'sphinx.ext.doctest',
+    'sphinx.ext.intersphinx',
+   #'sphinx.ext.todo',
+   #'sphinx.ext.coverage',
+    'sphinx.ext.ifconfig',
+    'sphinx.ext.napoleon',
+   #'sphinx_toolbox',
+    'sphinx_tabs.tabs',
+    'sphinx_copybutton',
+    'sphinxcontrib.spelling',
+    'nbsphinx',
+]
+
+# Needed for e.g. linkcheck builder
+tls_verify = False
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The encoding of source files.
+#
+source_encoding = 'utf-8'
+
+# The master toctree document.
+master_doc = 'index'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'bizstyle'  # 'alabaster'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+
+# -- Extension configuration -------------------------------------------------
+
+# -- Options for autodoc extension -------------------------------------------
+
+autoclass_content = 'both'
+autodoc_member_order = 'bysource'
+
+# -- Options for apidoc extension --------------------------------------------
+
+apidoc_separate_modules = True
+apidoc_module_first = True
+apidoc_output_dir = 'api'
+
+# -- Options for intersphinx extension ---------------------------------------
+
+# Example configuration for intersphinx: refer to the Python standard library.
+# intersphinx_mapping = {'https://docs.python.org/': None}
+
+# -- Options for todo extension ----------------------------------------------
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = False

slownie-1.3.4/docs/index.rst

@@ -0,0 +1,19 @@
+slownie documentation
+=====================
+
+.. _readme:
+.. include:: README.rst
+
+Contents
+========
+
+.. toctree::
+   :maxdepth: 2
+
+   CHANGES.rst
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`search`