triplep 1.0.0__tar.gz

triplep-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nikita Belomestnykh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

triplep-1.0.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: triplep
+Version: 1.0.0
+Summary: TripleP - PPP - PyProject Parser is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime.
+Author-email: Nikita Belomestnykh <medbeebs@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/medbeebs/triplep
+Project-URL: Repository, https://github.com/medbeebs/triplep
+Project-URL: Issues, https://github.com/medbeebs/triplep/issues
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TripleP - PPP - PyProject Parser
+
+![PyPI - License](https://img.shields.io/pypi/l/triplep?style=for-the-badge)
+![PyPI - Types](https://img.shields.io/pypi/types/triplep?style=for-the-badge)
+![PyPI - Version](https://img.shields.io/pypi/v/triplep?style=for-the-badge)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/triplep?style=for-the-badge)
+
+WAI (What Am I?) is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime.
+
+## Installation
+
+`pip install triplep`
+
+## Features
+
+- Automatic `pyproject.toml` file discovery
+- Parsing metadata into dataclass objects
+- Raw access when required
+- Fully typed
+
+## Limitations
+
+- Basic support for dataclass parsing of `[project]` block
+- Sync only

triplep-1.0.0/README.md

@@ -0,0 +1,24 @@
+# TripleP - PPP - PyProject Parser
+
+![PyPI - License](https://img.shields.io/pypi/l/triplep?style=for-the-badge)
+![PyPI - Types](https://img.shields.io/pypi/types/triplep?style=for-the-badge)
+![PyPI - Version](https://img.shields.io/pypi/v/triplep?style=for-the-badge)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/triplep?style=for-the-badge)
+
+WAI (What Am I?) is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime.
+
+## Installation
+
+`pip install triplep`
+
+## Features
+
+- Automatic `pyproject.toml` file discovery
+- Parsing metadata into dataclass objects
+- Raw access when required
+- Fully typed
+
+## Limitations
+
+- Basic support for dataclass parsing of `[project]` block
+- Sync only

triplep-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "triplep"
+version = "1.0.0"
+description = "TripleP - PPP - PyProject Parser is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.13"
+authors = [{ name = "Nikita Belomestnykh", email = "medbeebs@gmail.com" }]
+classifiers = [
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development",
+    "Typing :: Typed",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/medbeebs/triplep"
+Repository = "https://github.com/medbeebs/triplep"
+Issues = "https://github.com/medbeebs/triplep/issues"
+
+[dependency-groups]
+dev = ["ruff>=0.14.8"]

triplep-1.0.0/setup.cfg

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

triplep-1.0.0/triplep.egg-info/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: triplep
+Version: 1.0.0
+Summary: TripleP - PPP - PyProject Parser is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime.
+Author-email: Nikita Belomestnykh <medbeebs@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/medbeebs/triplep
+Project-URL: Repository, https://github.com/medbeebs/triplep
+Project-URL: Issues, https://github.com/medbeebs/triplep/issues
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development
+Classifier: Typing :: Typed
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Utilities
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# TripleP - PPP - PyProject Parser
+
+![PyPI - License](https://img.shields.io/pypi/l/triplep?style=for-the-badge)
+![PyPI - Types](https://img.shields.io/pypi/types/triplep?style=for-the-badge)
+![PyPI - Version](https://img.shields.io/pypi/v/triplep?style=for-the-badge)
+![PyPI - Python Version](https://img.shields.io/pypi/pyversions/triplep?style=for-the-badge)
+
+WAI (What Am I?) is a lightweight Python utility that enables effortless access to your project's metadata directly from pyproject.toml at runtime.
+
+## Installation
+
+`pip install triplep`
+
+## Features
+
+- Automatic `pyproject.toml` file discovery
+- Parsing metadata into dataclass objects
+- Raw access when required
+- Fully typed
+
+## Limitations
+
+- Basic support for dataclass parsing of `[project]` block
+- Sync only

triplep-1.0.0/triplep.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+triplep.egg-info/PKG-INFO
+triplep.egg-info/SOURCES.txt
+triplep.egg-info/dependency_links.txt
+triplep.egg-info/top_level.txt
+wai/__init__.py
+wai/main.py
+wai/models.py
+wai/utils.py

triplep-1.0.0/triplep.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

triplep-1.0.0/triplep.egg-info/top_level.txt

@@ -0,0 +1 @@
+wai

triplep-1.0.0/wai/__init__.py

@@ -0,0 +1,13 @@
+from .main import PyProject, load_pyproject
+from .models import Project
+from .utils import find_pyproject
+
+pyproject = load_pyproject()
+
+__version__ = "1.0.0"
+__all__ = [
+    "load_pyproject",
+    "find_pyproject",
+    "PyProject",
+    "Project",
+]

triplep-1.0.0/wai/main.py

@@ -0,0 +1,64 @@
+import io
+import logging
+import tomllib
+from contextlib import contextmanager
+from typing import IO, Any, Iterator
+
+from .models import Project
+from .utils import StrPath, find_pyproject, is_file_or_fifo
+
+logger = logging.getLogger(__name__)
+
+
+class PyProject:
+    def __init__(self, pyproject_path: StrPath | None):
+        self.pyproject_path = pyproject_path
+
+        self.parse()
+
+    @contextmanager
+    def _get_fp(self) -> Iterator[IO[bytes]]:
+        if self.pyproject_path and is_file_or_fifo(self.pyproject_path):
+            with open(self.pyproject_path, mode="rb") as fp:
+                yield fp
+
+        else:
+            if self.verbose:
+                logger.info(
+                    "WAI could not find configuration file %s.",
+                    self.pyproject_path or "pyproject.toml",
+                )
+            yield io.BytesIO(b"")
+
+    def load(self) -> dict[str, Any]:
+        """Returns contents of pyproject TOML file as dict"""
+
+        with self._get_fp() as fp:
+            return tomllib.load(fp)
+
+    def parse(self):
+        """Loads/reloads and parses contents of pyproject TOML file as dataclass entities"""
+        self.raw = self.load()
+        self.project = Project(**(self.raw["project"]))
+
+
+def load_pyproject(
+    pyproject_path: StrPath | None = None,
+) -> PyProject:
+    """Parse a pyproject.toml file and return contents
+
+    Parameters:
+        pyproject_path: Absolute or relative path to pyproject.toml file.
+    Returns:
+        PyProject: A class defining parsed and war contents of pyproject file.
+
+    If `pyproject_path` is `None`, `find_pyproject()` is used to find the
+    pyproject.toml file with it's default parameters. If you need to change the default parameters
+    of `find_pyproject()`, you can explicitly call `find_pyproject()` and pass the result
+    to this function as `pyproject_path`.
+    """
+
+    if pyproject_path is None:
+        pyproject_path = find_pyproject()
+
+    return PyProject(pyproject_path=pyproject_path)

triplep-1.0.0/wai/models.py

@@ -0,0 +1,51 @@
+from dataclasses import dataclass, fields
+from functools import wraps
+
+
+def kebab_to_snake(name: str) -> str:
+    """Convert kebab-case string to snake_case"""
+    return name.replace("-", "_")
+
+
+def accept_kebab_case(cls):
+    """Decorator to allow dataclasses to accept kebab-case kwargs"""
+
+    original_init = cls.__init__
+
+    @wraps(original_init)
+    def new_init(self, *args, **kwargs):
+        transformed_kwargs = {
+            kebab_to_snake(key): value for key, value in kwargs.items()
+        }
+
+        valid_fields = {f.name for f in fields(cls)}
+        filtered_kwargs = {
+            key: value
+            for key, value in transformed_kwargs.items()
+            if key in valid_fields
+        }
+
+        original_init(self, *args, **filtered_kwargs)
+
+    cls.__init__ = new_init
+    return cls
+
+
+@accept_kebab_case
+@dataclass(kw_only=True)
+class Project:
+    """Dataclass model defining [project] section of pyproject.toml"""
+
+    name: str
+    version: str
+    description: str | None
+
+    urls: dict[str, str] | None
+
+    readme: str | None
+    license: str | None
+    license_files: str | None
+
+    requires_python: str | None
+    classifiers: list[str] | None
+    dependencies: list[str] | None

triplep-1.0.0/wai/utils.py

@@ -0,0 +1,121 @@
+"""
+Copyright (c) 2014, Saurabh Kumar (python-dotenv), 2013, Ted Tieken (django-dotenv-rw), 2013, Jacob Kaplan-Moss (django-dotenv)
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+- Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+- Neither the name of django-dotenv nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+"""
+
+import os
+import stat
+import sys
+from typing import Iterator, Union
+
+# A type alias for a string path to be used for the paths in this file.
+# These paths may flow to `open()` and `shutil.move()`; `shutil.move()`
+# only accepts string paths, not byte paths or file descriptors. See
+# https://github.com/python/typeshed/pull/6832.
+StrPath = Union[str, "os.PathLike[str]"]
+
+
+def is_file_or_fifo(path: StrPath) -> bool:
+    """Return True if `path` exists and is either a regular file or a FIFO"""
+
+    if os.path.isfile(path):
+        return True
+
+    try:
+        st = os.stat(path)
+    except (FileNotFoundError, OSError):
+        return False
+
+    return stat.S_ISFIFO(st.st_mode)
+
+
+def walk_to_root(path: str) -> Iterator[str]:
+    """Yield directories starting from the given directory up to the root"""
+
+    if not os.path.exists(path):
+        raise IOError("Starting path not found")
+
+    if os.path.isfile(path):
+        path = os.path.dirname(path)
+
+    last_dir = None
+    current_dir = os.path.abspath(path)
+    while last_dir != current_dir:
+        yield current_dir
+        parent_dir = os.path.abspath(os.path.join(current_dir, os.path.pardir))
+        last_dir, current_dir = current_dir, parent_dir
+
+
+def find_pyproject(
+    filename: str = "pyproject.toml",
+    raise_error_if_not_found: bool = False,
+    usecwd: bool = False,
+) -> str:
+    """Search in increasingly higher folders for the given file
+
+    Returns path to the file if found, or an empty string otherwise
+    """
+
+    def _is_interactive():
+        """Decide whether this is running in a REPL or IPython notebook"""
+        if hasattr(sys, "ps1") or hasattr(sys, "ps2"):
+            return True
+        try:
+            main = __import__("__main__", None, None, fromlist=["__file__"])
+        except ModuleNotFoundError:
+            return False
+        return not hasattr(main, "__file__")
+
+    def _is_debugger():
+        return sys.gettrace() is not None
+
+    if usecwd or _is_interactive() or _is_debugger() or getattr(sys, "frozen", False):
+        # Should work without __file__, e.g. in REPL or IPython notebook.
+        path = os.getcwd()
+    else:
+        # will work for .py files
+        frame = sys._getframe()
+        current_file = __file__
+
+        while frame.f_code.co_filename == current_file or not os.path.exists(
+            frame.f_code.co_filename
+        ):
+            assert frame.f_back is not None
+            frame = frame.f_back
+        frame_filename = frame.f_code.co_filename
+        path = os.path.dirname(os.path.abspath(frame_filename))
+
+    for dirname in walk_to_root(path):
+        check_path = os.path.join(dirname, filename)
+        if is_file_or_fifo(check_path):
+            return check_path
+
+    if raise_error_if_not_found:
+        raise IOError("File not found")
+
+    return ""