This commit is contained in:
2025-09-13 11:19:06 -04:00
parent 87d846546c
commit c421a6e42b
+33 -19
View File
@@ -1,32 +1,46 @@
# ShowMe v1.0.0 Released
*January 2010*
This weekend, I released a new Python module to PyPI: ShowMe v1.0.0.
ShowMe is a simple set of function decorators that give you easy diagnosis of common problems in your Python applications.
## Basic Usage
```python
@showme.trace
def complex_function(a, b, c, **kwargs):
...
```
```python
>>> complex_function('alpha', 'beta', False, debug=True)
calling haystack.submodule.complex_function() with
args: ({'a': 'alpha', 'b': 'beta', 'c': False},)
kwargs: {'debug': True}
```
It currently supports:
* Argument call tracing
* Execution Time (in seconds)
* CPU Execution Time
* Docstrings
<label for="sn-dev-philosophy" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-dev-philosophy" class="margin-toggle"/><span class="sidenote">This announcement reflects the era of rapid Python library development, where individual developers could create and distribute debugging tools with minimal friction. The focus on "easy diagnosis" anticipates modern observability practices.</span>
## Roadmap
This weekend, I released a new Python module to PyPi: ShowMe v1\.0\.0\.ShowMe is a simple set of function decorators that give you easy diagnose common problems in your Python applications.
* Add `@showme.locals` Support
* Add `@showme.globals` Support
\#\#\# Basic Usage
@showme.tracedef complex\_function(a, b, c, \*\*kwargs):....
## Installation
\>\>\> complex\_function('alpha', 'beta', False, debug\=True)calling haystack.submodule.complex\_function() withargs: ({'a': 'alpha', 'b': 'beta', 'c': False},)kwargs: {'debug': True}<label for="sn-decorator-pattern" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-decorator-pattern" class="margin-toggle"/><span class="sidenote">The use of decorators for tracing demonstrates early adoption of Pythonic debugging patterns. This approach would later influence modern APM tools and logging frameworks that use similar non-invasive instrumentation.</span>
```bash
$ pip install showme
```
It currently supports:
**Links:**
- [Source on GitHub](http://github.com/kennethreitz/showme)
\* Argument call tracing\* Execution Time (in seconds)\* CPU Execution Time\* Docstrings<label for="sn-observability" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-observability" class="margin-toggle"/><span class="sidenote">These four capabilities represent core observability primitives that would become standard in production Python applications. The inclusion of docstring support suggests an early focus on self-documenting code.</span>
Roadmap:
\* Add @showme.locals Support\* Add @showme.globals Support<label for="sn-scope-introspection" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-scope-introspection" class="margin-toggle"/><span class="sidenote">The planned features for locals/globals inspection represent advanced debugging capabilities that would later be incorporated into IDEs and debugging tools like pdb and modern Python debuggers.</span>
Installation
pip install showme
\[\[Source on GitHub](http://github.com/kennethreitz/showme)]<label for="sn-distribution" class="margin-toggle sidenote-number"></label><input type="checkbox" id="sn-distribution" class="margin-toggle"/><span class="sidenote">The straightforward pip installation and GitHub hosting represent the democratization of Python package distribution that made the language's ecosystem so vibrant. This was cutting-edge developer experience in 2010.</span>