diff --git a/data/essays/2010-01-showme_v100_released.md b/data/essays/2010-01-showme_v100_released.md index cf0d133..68ca81f 100644 --- a/data/essays/2010-01-showme_v100_released.md +++ b/data/essays/2010-01-showme_v100_released.md @@ -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 -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. +## 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}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. +```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\* DocstringsThese 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. - - Roadmap: - - \* Add @showme.locals Support\* Add @showme.globals SupportThe 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. - - Installation - - pip install showme - - \[\[Source on GitHub](http://github.com/kennethreitz/showme)]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. - - \ No newline at end of file