paramtrack 0.1.0__tar.gz

paramtrack-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alessio Popovic
+
+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.

paramtrack-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: paramtrack
+Version: 0.1.0
+Summary: Remembers the arguments of each method's last call, defaults included.
+Author: Alessio Popovic
+Author-email: Alessio Popovic <alessiopopovic@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.9
+Project-URL: Repository, https://github.com/AlessioPop/paramtrack
+Description-Content-Type: text/markdown
+
+# paramtrack
+
+Remembers the arguments of each method's last call, defaults included.
+
+## Install
+
+```bash
+pip install paramtrack
+```
+
+## Usage
+
+```python
+from paramtrack import track_class
+
+@track_class
+class Telescope:
+    def observe(self, target, exposure=30, filter="V"):
+        ...
+
+telescope = Telescope()
+telescope.observe("Vega", exposure=60)
+
+print(telescope.parameters)
+```
+
+```
+observe
+├─ target   = 'Vega'
+├─ exposure = 60
+└─ filter   = 'V'
+```
+
+In Jupyter, put `telescope.parameters` on the last line of a cell for a foldable view.

paramtrack-0.1.0/README.md

@@ -0,0 +1,34 @@
+# paramtrack
+
+Remembers the arguments of each method's last call, defaults included.
+
+## Install
+
+```bash
+pip install paramtrack
+```
+
+## Usage
+
+```python
+from paramtrack import track_class
+
+@track_class
+class Telescope:
+    def observe(self, target, exposure=30, filter="V"):
+        ...
+
+telescope = Telescope()
+telescope.observe("Vega", exposure=60)
+
+print(telescope.parameters)
+```
+
+```
+observe
+├─ target   = 'Vega'
+├─ exposure = 60
+└─ filter   = 'V'
+```
+
+In Jupyter, put `telescope.parameters` on the last line of a cell for a foldable view.

paramtrack-0.1.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "paramtrack"
+version = "0.1.0"
+description = "Remembers the arguments of each method's last call, defaults included."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Alessio Popovic", email = "alessiopopovic@gmail.com" }
+]
+requires-python = ">=3.9"
+dependencies = []
+
+[project.urls]
+Repository = "https://github.com/AlessioPop/paramtrack"
+
+[build-system]
+requires = ["uv_build>=0.11.28,<0.12.0"]
+build-backend = "uv_build"

paramtrack-0.1.0/src/paramtrack/__init__.py

@@ -0,0 +1,48 @@
+import inspect
+from functools import wraps
+from html import escape
+
+__all__ = ["track_class"]
+
+
+# "name = value" lines with the "=" signs lined up, drawn as a tree.
+def tree(arguments):
+    width = max(map(len, arguments), default=0)
+    lines = [f"{k:<{width}} = {v}" for k, v in arguments.items()]
+    return [f"├─ {line}" for line in lines[:-1]] + [f"└─ {line}" for line in lines[-1:]]
+
+
+class Parameters(dict):
+    # Text version, used by print() and the terminal.
+    def __repr__(self):
+        blocks = []
+        for name, arguments in self.items():
+            blocks.append("\n".join([f"\033[1m{name}\033[0m", *tree(arguments)]))  # \033[1m = bold
+        return "\n\n".join(blocks)
+
+    # Clickable version, used by Jupyter; click a method name to unfold it.
+    def _repr_html_(self):
+        html = ""
+        for name, arguments in self.items():
+            lines = escape("\n".join(tree(arguments)))
+            html += f"<details><summary><b>{name}</b></summary><pre style='margin: 0 0 0 1.2em'>{lines}</pre></details>"
+        return html
+
+
+def track(method, parameters):
+    @wraps(method)
+    def wrapper(*args, **kwargs):
+        bound = inspect.signature(method).bind(*args, **kwargs)
+        bound.apply_defaults()
+        parameters[method.__name__] = {k: repr(v) for k, v in bound.arguments.items() if k != "self"}
+        return method(*args, **kwargs)
+    return wrapper
+
+
+# Class decorator: track every method and store the arguments as cls.parameters.
+def track_class(cls):
+    cls.parameters = Parameters()
+    for name, method in list(vars(cls).items()):
+        if inspect.isfunction(method):
+            setattr(cls, name, track(method, cls.parameters))
+    return cls