pkg-about 1.2.8__tar.gz

pkg_about-1.2.8/.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

pkg_about-1.2.8/CHANGES.rst

@@ -0,0 +1,105 @@
+Changelog
+=========
+
+1.2.8 (2025-01-25)
+------------------
+- Setup (dependencies) update.
+
+1.2.7 (2025-01-20)
+------------------
+- Copyright year update.
+- Setup (dependencies) update.
+
+1.2.6 (2024-12-13)
+------------------
+- Source distribution (\*.tar.gz now) is compliant with PEP-0625.
+- Setup (dependencies) update.
+
+1.2.5 (2024-11-13)
+------------------
+- More unittests.
+- 100% code linting.
+- 100% code coverage.
+- Tox configuration is now in native (toml) format.
+- Setup (dependencies) update.
+
+1.2.2 (2024-10-30)
+------------------
+- Setup (dependencies) update.
+
+1.2.0 (2024-09-30)
+------------------
+- Drop support for Python 3.8
+- Ability to obtain __copyright__ from the README.rst content.
+- Setup (dependencies) update.
+
+1.1.8 (2024-08-13)
+------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+
+1.1.7 (2024-07-15)
+------------------
+- Setup (dependencies) update.
+
+1.1.6 (2024-06-20)
+------------------
+- Setup (dependencies) update.
+
+1.1.5 (2024-01-26)
+------------------
+- Setup update (now based on tox >= 4.0).
+- Cleanup.
+
+1.1.0 (2023-12-15)
+------------------
+- Add support for Python 3.12
+- Drop support for Python 3.7
+- Add support for PyPy 3.10
+- Drop support for PyPy 3.7 and 3.8
+- Bugfix for parsing metadata's "Project-URL".
+- Bugfix of about_from_setup() for __version_info__.
+- | Enhancement" the 'package_path' parameter of the about_from_setup()
+  | can now be of type string or Path.
+- Bugfix of about_from_setup() for parsing author and maintainer emails.
+- Copyright year update.
+- Added a trivial unit test.
+
+1.0.8 (2022-10-18)
+------------------
+- Tox configuration has been moved to pyproject.toml
+
+1.0.7 (2022-08-22)
+------------------
+- Setup update.
+
+1.0.6 (2022-07-24)
+------------------
+- Add __author_email__ (as alias of __email__).
+- Add __maintainer_email__.
+- Setup update (currently based mainly on pyproject.toml).
+
+1.0.5 (2022-07-20)
+------------------
+- Add about_from_setup() (to use e.g. in docs.conf.py).
+- Add support for Python 3.10 and 3.11
+- Add support for PyPy 3.7, 3.8 and 3.9
+- Setup update.
+
+1.0.4 (2022-01-10)
+------------------
+- Drop support for Python 3.6
+- Copyright year update.
+- Setup update.
+
+1.0.3 (2021-10-14)
+------------------
+- Setup update.
+
+1.0.2 (2021-07-20)
+------------------
+- First functional release.
+
+0.0.1 (2020-10-16)
+------------------
+- Initial commit.

pkg_about-1.2.8/LICENSE

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

pkg_about-1.2.8/MANIFEST.in

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

pkg_about-1.2.8/PKG-INFO

@@ -0,0 +1,250 @@
+Metadata-Version: 2.2
+Name: pkg_about
+Version: 1.2.8
+Summary: Shares Python package metadata at runtime.
+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/pkg-about/
+Project-URL: Documentation, https://pkg-about.readthedocs.io/
+Project-URL: Download, https://pypi.org/project/pkg-about/
+Project-URL: Source, https://github.com/karpierz/pkg_about
+Project-URL: Issues, https://github.com/karpierz/pkg_about/issues
+Keywords: pkg_about,__about__,packaging
+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.8.0
+Requires-Dist: packaging>=24.2.0
+Requires-Dist: importlib-metadata>=8.6.1
+Requires-Dist: tomli>=2.2.1; python_version < "3.11"
+Requires-Dist: docutils>=0.21.2
+Provides-Extra: doc
+Requires-Dist: Sphinx>=7.4.7; extra == "doc"
+Requires-Dist: sphinx-autodoc-typehints>=2.3.0; 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.6; extra == "doc"
+Provides-Extra: test
+Requires-Dist: deepdiff>=8.1.1; extra == "test"
+Requires-Dist: rich>=13.9.4; extra == "test"
+
+pkg_about
+=========
+
+Shares Python package metadata at runtime.
+
+Overview
+========
+
+TBD...
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+TBD...
+
+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:: pkg_about
+.. |package_bold| replace:: **pkg_about**
+.. |copyright| replace:: Copyright (c) 2020-2025 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/pkg_about.git
+.. _Development page: https://github.com/karpierz/pkg_about
+.. _PyPI record: https://pypi.org/project/pkg-about/
+.. _Documentation: https://pkg-about.readthedocs.io/
+
+Changelog
+=========
+
+1.2.8 (2025-01-25)
+------------------
+- Setup (dependencies) update.
+
+1.2.7 (2025-01-20)
+------------------
+- Copyright year update.
+- Setup (dependencies) update.
+
+1.2.6 (2024-12-13)
+------------------
+- Source distribution (\*.tar.gz now) is compliant with PEP-0625.
+- Setup (dependencies) update.
+
+1.2.5 (2024-11-13)
+------------------
+- More unittests.
+- 100% code linting.
+- 100% code coverage.
+- Tox configuration is now in native (toml) format.
+- Setup (dependencies) update.
+
+1.2.2 (2024-10-30)
+------------------
+- Setup (dependencies) update.
+
+1.2.0 (2024-09-30)
+------------------
+- Drop support for Python 3.8
+- Ability to obtain __copyright__ from the README.rst content.
+- Setup (dependencies) update.
+
+1.1.8 (2024-08-13)
+------------------
+- Add support for Python 3.13
+- Setup (dependencies) update.
+
+1.1.7 (2024-07-15)
+------------------
+- Setup (dependencies) update.
+
+1.1.6 (2024-06-20)
+------------------
+- Setup (dependencies) update.
+
+1.1.5 (2024-01-26)
+------------------
+- Setup update (now based on tox >= 4.0).
+- Cleanup.
+
+1.1.0 (2023-12-15)
+------------------
+- Add support for Python 3.12
+- Drop support for Python 3.7
+- Add support for PyPy 3.10
+- Drop support for PyPy 3.7 and 3.8
+- Bugfix for parsing metadata's "Project-URL".
+- Bugfix of about_from_setup() for __version_info__.
+- | Enhancement" the 'package_path' parameter of the about_from_setup()
+  | can now be of type string or Path.
+- Bugfix of about_from_setup() for parsing author and maintainer emails.
+- Copyright year update.
+- Added a trivial unit test.
+
+1.0.8 (2022-10-18)
+------------------
+- Tox configuration has been moved to pyproject.toml
+
+1.0.7 (2022-08-22)
+------------------
+- Setup update.
+
+1.0.6 (2022-07-24)
+------------------
+- Add __author_email__ (as alias of __email__).
+- Add __maintainer_email__.
+- Setup update (currently based mainly on pyproject.toml).
+
+1.0.5 (2022-07-20)
+------------------
+- Add about_from_setup() (to use e.g. in docs.conf.py).
+- Add support for Python 3.10 and 3.11
+- Add support for PyPy 3.7, 3.8 and 3.9
+- Setup update.
+
+1.0.4 (2022-01-10)
+------------------
+- Drop support for Python 3.6
+- Copyright year update.
+- Setup update.
+
+1.0.3 (2021-10-14)
+------------------
+- Setup update.
+
+1.0.2 (2021-07-20)
+------------------
+- First functional release.
+
+0.0.1 (2020-10-16)
+------------------
+- Initial commit.

pkg_about-1.2.8/README.rst

@@ -0,0 +1,90 @@
+pkg_about
+=========
+
+Shares Python package metadata at runtime.
+
+Overview
+========
+
+TBD...
+
+`PyPI record`_.
+
+`Documentation`_.
+
+Usage
+-----
+
+TBD...
+
+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:: pkg_about
+.. |package_bold| replace:: **pkg_about**
+.. |copyright| replace:: Copyright (c) 2020-2025 Adam Karpierz
+.. |respository| replace:: https://github.com/karpierz/pkg_about.git
+.. _Development page: https://github.com/karpierz/pkg_about
+.. _PyPI record: https://pypi.org/project/pkg-about/
+.. _Documentation: https://pkg-about.readthedocs.io/

pkg_about-1.2.8/docs/CHANGES.rst

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

pkg_about-1.2.8/docs/README.rst

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

pkg_about-1.2.8/docs/conf.py

@@ -0,0 +1,115 @@
+# 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_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

pkg_about-1.2.8/docs/index.rst

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