py-utlx 0.0.0__tar.gz

py_utlx-0.0.0/.readthedocs.yml

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

py_utlx-0.0.0/CHANGES.rst

@@ -0,0 +1,6 @@
+Changelog
+=========
+
+0.0.0 (2024-08-13)
+------------------
+- Initial commit.

py_utlx-0.0.0/LICENSE

@@ -0,0 +1,19 @@
+zlib License
+
+Copyright (C) 2004-2025 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.

py_utlx-0.0.0/MANIFEST.in

@@ -0,0 +1,18 @@
+# Copyright (c) 2004 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__ .mypy_cache

py_utlx-0.0.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: py-utlx
+Version: 0.0.0
+Summary: Utilities.
+Author: Adam Karpierz
+Author-email: adam@karpierz.net
+Maintainer: Adam Karpierz
+Maintainer-email: adam@karpierz.net
+License-Expression: Zlib
+Project-URL: Homepage, https://pypi.org/project/py-utlx/
+Project-URL: Documentation, https://py-utlx.readthedocs.io/
+Project-URL: Download, https://pypi.org/project/py-utlx/
+Project-URL: Source, https://github.com/karpierz/py-utlx
+Project-URL: Issues, https://github.com/karpierz/py-utlx/issues
+Keywords: py-utlx,utlx,util,utils
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Polish
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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.14
+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.10.0
+Description-Content-Type: text/x-rst; charset=UTF-8
+License-File: LICENSE
+Requires-Dist: setuptools>=80.9.0
+Requires-Dist: pkg-about>=1.4.0
+Provides-Extra: doc
+Requires-Dist: Sphinx>=8.1.3; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints>=3.0.1; extra == "doc"
+Requires-Dist: sphinx-toolbox>=4.0.0; 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.1; 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.7; extra == "doc"
+Provides-Extra: test
+Requires-Dist: deepdiff>=8.6.0; extra == "test"
+Requires-Dist: rich>=14.1.0; extra == "test"
+Dynamic: license-file
+
+py-utlx
+=======
+
+Utilities.
+
+Overview
+========
+
+TBD
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+TBD
+
+Installation
+============
+
+Prerequisites:
+
++ Python 3.10 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:: py-utlx
+.. |package_bold| replace:: **py-utlx**
+.. |copyright| replace:: Copyright (c) 2004-2025 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/py-utlx.git
+.. _Development page: https://github.com/karpierz/py-utlx
+.. _PyPI record: https://pypi.org/project/py-utlx/
+.. _Documentation: https://py-utlx.readthedocs.io/
+
+Changelog
+=========
+
+0.0.0 (2024-08-13)
+------------------
+- Initial commit.

py_utlx-0.0.0/README.rst

@@ -0,0 +1,90 @@
+py-utlx
+=======
+
+Utilities.
+
+Overview
+========
+
+TBD
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+TBD
+
+Installation
+============
+
+Prerequisites:
+
++ Python 3.10 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:: py-utlx
+.. |package_bold| replace:: **py-utlx**
+.. |copyright| replace:: Copyright (c) 2004-2025 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/py-utlx.git
+.. _Development page: https://github.com/karpierz/py-utlx
+.. _PyPI record: https://pypi.org/project/py-utlx/
+.. _Documentation: https://py-utlx.readthedocs.io/

py_utlx-0.0.0/docs/CHANGES.rst

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

py_utlx-0.0.0/docs/README.rst

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

py_utlx-0.0.0/docs/conf.py

@@ -0,0 +1,117 @@
+# 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
+
+from sphinx import application
+
+about = __import__("pkg_about").about_from_setup()
+
+def setup(app: application.Sphinx) -> None:
+    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__
+author    = about.__author__
+copyright = about.__copyright__
+
+# 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 = '8.1.3'
+
+# 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_autodoc_typehints',
+   #'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

py_utlx-0.0.0/docs/index.rst

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

py_utlx-0.0.0/pyproject.toml

@@ -0,0 +1,314 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+[build-system]
+build-backend = 'setuptools.build_meta'
+requires = ['setuptools>=80.9.0', 'packaging>=25.0.0', 'tox>=4.29.0']
+
+[project]
+name        = 'py-utlx'
+version     = '0.0.0'
+description = 'Utilities.'
+authors = [
+    { name  = 'Adam Karpierz' },
+    { email = 'adam@karpierz.net' },
+]
+maintainers = [
+    { name  = 'Adam Karpierz' },
+    { email = 'adam@karpierz.net' },
+]
+license = 'Zlib'
+license-files = ['LICENSE']
+urls.Homepage      = 'https://pypi.org/project/py-utlx/'
+urls.Documentation = 'https://py-utlx.readthedocs.io/'
+urls.Download      = 'https://pypi.org/project/py-utlx/'
+urls.Source        = 'https://github.com/karpierz/py-utlx'
+urls.Issues        = 'https://github.com/karpierz/py-utlx/issues'
+keywords = ['py-utlx', 'utlx', 'util', 'utils']
+classifiers = [
+    'Development Status :: 5 - Production/Stable',
+    'Intended Audience :: Developers',
+    'Operating System :: OS Independent',
+    'Natural Language :: Polish',
+    'Programming Language :: Python',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
+    'Programming Language :: Python :: 3 :: Only',
+    'Programming Language :: Python :: Implementation :: CPython',
+    'Programming Language :: Python :: Implementation :: PyPy',
+    'Topic :: Software Development :: Libraries :: Python Modules',
+]
+requires-python = '>=3.10.0,<4.0.0'
+dependencies = [
+    # mandatory
+    'setuptools>=80.9.0',
+    'pkg-about>=1.4.0',
+    # others
+]
+dynamic = ['readme']
+optional-dependencies.'doc' = [
+    'Sphinx>=8.1.3',
+    'sphinx-autodoc-typehints>=3.0.1',
+    'sphinx-toolbox>=4.0.0',
+    'sphinx-tabs>=3.4.5', # don't touch! sphinx-toolbox requires <3.4.7
+    'sphinx-copybutton>=0.5.2',
+    'sphinxcontrib-spelling>=8.0.1',
+    'sphinx-lint>=1.0.0',
+    'restructuredtext-lint>=1.4.0',
+    'nbsphinx>=0.9.7',
+]
+optional-dependencies.'test' = [
+    'deepdiff>=8.6.0',
+    'rich>=14.1.0',
+]
+
+[project.scripts]
+#'utlx' = 'utlx.__main__:main'
+
+[project.gui-scripts]
+#'utlx-gui' = 'utlx:main_gui'
+
+#[project.entry-points.'utlx.magical']
+#epoint = 'utlx:main_epoint'
+
+[tool.setuptools.dynamic]
+readme = { file = ['README.rst', 'CHANGES.rst'], content-type = 'text/x-rst; charset=UTF-8' }
+
+[tool.setuptools]
+include-package-data = true
+platforms = ['any']
+zip-safe = true
+
+[tool.setuptools.packages.find]
+namespaces = false
+where = ['src']
+
+[tool.setuptools.package-dir]
+'' = 'src'
+#'utlx.tests' = 'tests'
+
+[tool.setuptools.package-data]
+utlx = [
+]
+
+[tool.setuptools.exclude-package-data]
+'*' = ['*.c','*.h','*.cpp','*.hpp','*.cxx','*.hxx','*.pyx','*.pxd']
+utlx = [
+]
+
+[tool.coverage]
+# run
+run.source = [
+    'utlx',
+    'tests',
+]
+run.omit = [
+    '**/tests/tman_*.py',
+]
+run.branch = true
+run.data_file = '.tox/coverage/.coverage'
+run.plugins = ['covdefaults']
+# report
+report.exclude_also = [
+    # Regexes
+    # Have to re-enable the standard pragma
+    '^\s*if\s+self\.debug\s*:',
+    '^\s*if\s+__debug__\s*:',
+    '^\s*if\s+(0|False)\s*:',
+    '''if\s+__name__.*\s*==\s*['"]__main__['"]\s*:''',
+    '^\s*@unittest\.skip\(',
+    '^\s*@unittest\.skipIf\(sys\.platform\.startswith\("win"\)',
+    'if typing.TYPE_CHECKING:',
+]
+report.omit = [
+    'tests/run.py',
+]
+report.skip_covered = false
+# html report
+html.directory = '.tox/coverage/.coverage.html'
+
+[tool.flake8]
+filename = ['*.py','*.pyx']
+#include = ['tests']
+#exclude = ['.tox','*.egg','.git','__pycache__','build','_build','docs/_build','dist']
+max-line-length = 99
+ignore = ['E126','E203','E221','E251','E302','E701','E702','E731',
+          'E122','E127','E128','E222','E272','E241','E266','E226',
+          'D100','D101','D102','D103','D104','D400','D401','D202',
+          'N806','N802','N803','N801',
+          'I100','W503']
+# (e.g. 'E4','W') default: 'E121','E123','126','226','E24','704'
+#select =
+#select = ['E','W','F','N','I']
+output-file = '.tox/lint/flake8out.txt'
+count = true
+#show-pep8,
+#show-source
+#verbose
+#quiet
+
+[tool.mypy]
+python_version = '3.10'
+strict = true
+sqlite_cache = true
+warn_unused_configs = true
+exclude_gitignore = true
+install_types = true
+non_interactive = true
+pretty = true
+check_untyped_defs = true
+#ignore_missing_imports = true
+files = ['src']
+#exclude = ['docs/', 'tests/']
+
+#
+# Configuration(s) for tox
+#
+
+[tool.tox]
+env_list = [{replace='ref',of=['tool','tox','labels','py'],extend=true},
+            'coverage', 'typing', 'lint', 'docs']
+min_version = '4.29.0'
+skip_missing_interpreters = true
+requires = [
+    {replace='ref',of=['tool','tox','_','base','deps'],extend=true},
+    'virtualenv>=20.34.0',
+    'tox-backtick>=0.7.0',
+]
+[tool.tox.labels]
+py = ['py310','py311','py312','py313','py314', 'pypy310','pypy311']
+prepare = ['prepare']
+coverage = ['coverage']
+typing = ['typing']
+lint = ['lint']
+docs = ['docs']
+build  = [{replace='ref',of=['tool','tox','labels','py'],extend=true}, 'docs', 'build']
+deploy = [{replace='ref',of=['tool','tox','labels','build'],extend=true}, 'publish']
+
+[tool.tox._.base]
+base_python = ['python3.13']
+deps = [
+    'pip>=25.2',
+    'setuptools>=80.9.0',
+]
+package_subdir = 'utlx'
+
+[tool.tox.env_run_base]
+description = 'Run tests under {base_python}'
+set_env.PYTHONDONTWRITEBYTECODE = '1'
+set_env.PKG_IMPL = "`python -W ignore -c \"import platform ; pimpl = platform.python_implementation() ; print('cp' if pimpl == 'CPython' else 'pp' if pimpl == 'PyPy' else '', end='')\" 2> nul`"
+set_env.PKG_PVER = "`python -W ignore -c \"import platform ; print(''.join(platform.python_version_tuple()[:2]), end='')\" 2> nul`"
+set_env.PKG_NAME = "`python -W ignore -c \"import setuptools ; setuptools._distutils.core._setup_stop_after='config' ; print(setuptools.setup().metadata.get_name(),     end='')\" 2> nul`"
+set_env.PKG_DIST = "`python -W ignore -c \"import setuptools ; setuptools._distutils.core._setup_stop_after='config' ; print(setuptools.setup().metadata.get_fullname(), end='')\" 2> nul`"
+commands = [
+    ['{env_python}','--version'],
+    ['{env_python}','-m','tests',{replace='posargs',extend=true}],
+]
+extras = ['test']
+deps = [
+    {replace='ref',of=['tool','tox','_','base','deps'],extend=true},
+]
+
+[tool.tox.env.'prepare']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+skip_install = true
+allowlist_externals = [
+    'cmd',
+    '.build',
+]
+commands = [
+    ['cmd','/C','if','exist','.build.cmd','.build.cmd'],
+]
+extras = []
+deps = []
+
+[tool.tox.env.'coverage']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+commands = [
+    ['{env_python}','-m','coverage','erase'],
+    ['-','{env_python}','-m','coverage','run','-m','tests',{replace='posargs',extend=true}],
+    ['-','{env_python}','-m','coverage','html'],
+    ['{env_python}','-m','coverage','report'],
+]
+deps = [
+    {replace='ref',of=['tool','tox','env_run_base','deps'],extend=true},
+    'coverage>=7.10.6',
+    'covdefaults>=2.3.0',
+    'diff-cover>=9.6.0',
+]
+
+[tool.tox.env.'docs']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+commands = [
+    ['{env_python}','-m','sphinxlint','--ignore','.tox','--ignore','build','--ignore','dist'],
+   #['{env_python}','-m','sphinx.apidoc','-f','{env_site_packages_dir}/{[tool.tox._.base]package_subdir}'],
+    ['{env_python}','-m','sphinx.cmd.build','-W','-a','-b','html','-E','./docs','./build/docs/html'],
+    ['{env_python}','-m','sphinx.cmd.build','-W','-a','-b','linkcheck','./docs','./build/docs/html'],
+    ['{env_python}','-m','sphinx.cmd.build','-W','-a','-b','doctest',  './docs','./build/docs/html'],
+]
+extras = ['doc']
+deps = [
+    {replace='ref',of=['tool','tox','_','base','deps'],extend=true},
+]
+
+[tool.tox.env.'build']
+depends = [{replace='ref',of=['tool','tox','labels','py'],extend=true}, 'docs']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+commands = [
+    ['{env_python}','-m','build'],
+    # check out for PyPi
+    ['{env_python}','-m','twine','check','dist/*'],
+]
+deps = [
+    {replace='ref',of=['tool','tox','env_run_base','deps'],extend=true},
+    'build>=1.3.0',
+    'twine>=6.1.0',
+]
+
+[tool.tox.env.'publish']
+depends = ['build']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+skip_install = true
+commands = [
+    # publish on PyPi
+    ['{env_python}','-m','twine','upload','dist/*'],
+]
+extras = []
+deps = [
+    'twine>=6.1.0',
+]
+
+[tool.tox.env.'typing']
+description = 'Static type checking'
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+commands = [
+    ['{env_python}','-m','mypy'],
+]
+extras = []
+deps = [
+    {replace='ref',of=['tool','tox','_','base','deps'],extend=true},
+    'mypy>=1.17.1',
+    'mypy_extensions>=1.1.0',
+    'types-setuptools>=80.9.0.20250822',
+]
+
+[tool.tox.env.'lint']
+base_python = {replace='ref',of=['tool','tox','_','base','base_python']}
+commands = [
+    ['{env_python}','-m','flake8','{env_site_packages_dir}/{[tool.tox._.base]package_subdir}/'],
+]
+extras = []
+deps = [
+    {replace='ref',of=['tool','tox','env_run_base','deps'],extend=true},
+    'flake8>=7.3.0',
+    'flake8-in-file-ignores>=0.3.0',
+    'flake8-pyproject>=1.2.3',
+    'flake8-docstrings>=1.7.0',
+    'pep8-naming>=0.15.1',
+    'flake8-builtins>=3.0.0',
+    'flake8-deprecated>=2.2.1',
+]

py_utlx-0.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

py_utlx-0.0.0/src/py_utlx.egg-info/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: py-utlx
+Version: 0.0.0
+Summary: Utilities.
+Author: Adam Karpierz
+Author-email: adam@karpierz.net
+Maintainer: Adam Karpierz
+Maintainer-email: adam@karpierz.net
+License-Expression: Zlib
+Project-URL: Homepage, https://pypi.org/project/py-utlx/
+Project-URL: Documentation, https://py-utlx.readthedocs.io/
+Project-URL: Download, https://pypi.org/project/py-utlx/
+Project-URL: Source, https://github.com/karpierz/py-utlx
+Project-URL: Issues, https://github.com/karpierz/py-utlx/issues
+Keywords: py-utlx,utlx,util,utils
+Platform: any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Natural Language :: Polish
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+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.14
+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.10.0
+Description-Content-Type: text/x-rst; charset=UTF-8
+License-File: LICENSE
+Requires-Dist: setuptools>=80.9.0
+Requires-Dist: pkg-about>=1.4.0
+Provides-Extra: doc
+Requires-Dist: Sphinx>=8.1.3; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints>=3.0.1; extra == "doc"
+Requires-Dist: sphinx-toolbox>=4.0.0; 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.1; 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.7; extra == "doc"
+Provides-Extra: test
+Requires-Dist: deepdiff>=8.6.0; extra == "test"
+Requires-Dist: rich>=14.1.0; extra == "test"
+Dynamic: license-file
+
+py-utlx
+=======
+
+Utilities.
+
+Overview
+========
+
+TBD
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+TBD
+
+Installation
+============
+
+Prerequisites:
+
++ Python 3.10 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:: py-utlx
+.. |package_bold| replace:: **py-utlx**
+.. |copyright| replace:: Copyright (c) 2004-2025 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/py-utlx.git
+.. _Development page: https://github.com/karpierz/py-utlx
+.. _PyPI record: https://pypi.org/project/py-utlx/
+.. _Documentation: https://py-utlx.readthedocs.io/
+
+Changelog
+=========
+
+0.0.0 (2024-08-13)
+------------------
+- Initial commit.

py_utlx-0.0.0/src/py_utlx.egg-info/SOURCES.txt

@@ -0,0 +1,26 @@
+.readthedocs.yml
+CHANGES.rst
+LICENSE
+MANIFEST.in
+README.rst
+pyproject.toml
+docs/CHANGES.rst
+docs/README.rst
+docs/conf.py
+docs/index.rst
+docs/_static/.keep
+docs/_templates/.keep
+src/py_utlx.egg-info/PKG-INFO
+src/py_utlx.egg-info/SOURCES.txt
+src/py_utlx.egg-info/dependency_links.txt
+src/py_utlx.egg-info/requires.txt
+src/py_utlx.egg-info/top_level.txt
+src/py_utlx.egg-info/zip-safe
+src/utlx/__about__.py
+src/utlx/__init__.py
+src/utlx/_utlx.py
+src/utlx/py.typed
+tests/__init__.py
+tests/__main__.py
+tests/test_main.py
+tests/data/.keep

py_utlx-0.0.0/src/py_utlx.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

py_utlx-0.0.0/src/py_utlx.egg-info/requires.txt

@@ -0,0 +1,17 @@
+setuptools>=80.9.0
+pkg-about>=1.4.0
+
+[doc]
+Sphinx>=8.1.3
+sphinx-autodoc-typehints>=3.0.1
+sphinx-toolbox>=4.0.0
+sphinx-tabs>=3.4.5
+sphinx-copybutton>=0.5.2
+sphinxcontrib-spelling>=8.0.1
+sphinx-lint>=1.0.0
+restructuredtext-lint>=1.4.0
+nbsphinx>=0.9.7
+
+[test]
+deepdiff>=8.6.0
+rich>=14.1.0

py_utlx-0.0.0/src/py_utlx.egg-info/top_level.txt

@@ -0,0 +1 @@
+utlx

py_utlx-0.0.0/src/py_utlx.egg-info/zip-safe

@@ -0,0 +1 @@
+

py_utlx-0.0.0/src/utlx/__about__.py

@@ -0,0 +1,4 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+__import__("pkg_about").about("py-utlx")

py_utlx-0.0.0/src/utlx/__init__.py

@@ -0,0 +1,6 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+from .__about__ import * ; del __about__  # type: ignore[name-defined]  # noqa
+
+from ._utlx import * ; del _utlx  # type: ignore[name-defined]  # noqa

py_utlx-0.0.0/src/utlx/_utlx.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+from typing import Any
+from collections.abc import Sequence
+
+__all__ = ('aaa',)
+
+aaa = "aaa"

py_utlx-0.0.0/tests/__init__.py

@@ -0,0 +1,10 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+__all__ = ('top_dir', 'test_dir')
+
+import sys, pathlib
+sys.dont_write_bytecode = True
+test_dir = pathlib.Path(__file__).resolve().parent
+top_dir = test_dir.parent
+del sys, pathlib

py_utlx-0.0.0/tests/__main__.py

@@ -0,0 +1,36 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+import unittest
+import sys
+import logging
+
+from . import test_dir
+
+log = logging.getLogger(__name__)
+
+
+def test_suite(names=None, omit=()):
+    from . import __name__ as pkg_name
+    from . import __path__ as pkg_path
+    import unittest
+    import pkgutil
+    if names is None:
+        names = [name for _, name, _ in pkgutil.iter_modules(pkg_path)
+                 if name.startswith("test_") and name not in omit]
+    names = [".".join((pkg_name, name)) for name in names]
+    tests = unittest.defaultTestLoader.loadTestsFromNames(names)
+    return tests
+
+
+def main(argv=sys.argv[1:]):
+    print("Running tests\n", file=sys.stderr)
+    tests = test_suite(argv or None)
+    result = unittest.TextTestRunner(verbosity=2).run(tests)
+    return 0 if result.wasSuccessful() else 1
+
+
+if __name__.rpartition(".")[-1] == "__main__":
+    # logging.basicConfig(level=logging.INFO)
+    # logging.basicConfig(level=logging.DEBUG)
+    sys.exit(main())

py_utlx-0.0.0/tests/test_main.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2004 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+import unittest
+
+import utlx
+from utlx import *
+
+
+class UtlxTestCase(unittest.TestCase):
+
+    def test_utlx(self):
+        pass