pockets

0.9.1 · maintenance · verified Tue Apr 14

The Pockets library is a collection of Python helper functions that streamline common development tasks. It provides utilities for logging, collections, datetime manipulation, object inspection, string operations, and iterators. The current version is 0.9.1, last updated in November 2019, suggesting a maintenance or slow release cadence.

Warnings

breaking The library's last update was in November 2019. While it aims for Python 2/3 compatibility, this old version may have compatibility issues or lack features with newer Python 3.x releases (e.g., Python 3.10+).
Fix: Thoroughly test `pockets` in your target Python environment. Consider migrating to more actively maintained, purpose-built libraries for specific utilities if compatibility issues arise or if modern Python features are desired.
gotcha The `resolve` function, which converts a string name into a Python object, can be a security risk if the input string is from an untrusted source. Malicious input could lead to arbitrary code execution.
Fix: Always restrict the search path by explicitly specifying the `modules` parameter when using `resolve` with user-provided input. E.g., `resolve('my_module.MyClass', modules=['my_module'])`.
deprecated Some classes in `pockets.iterators` were renamed in version 0.9 (e.g., `modify_iter` to `itermod`, `peek_iter` to `iterpeek`). While original names are still exported for backwards compatibility, relying on them might lead to issues in future versions if they are eventually removed.
Fix: Use the new names (`itermod`, `iterpeek`) for clarity and future compatibility.
gotcha The library's reliance on `six` and notes about Python 2.6 specific behaviors (e.g., `groupify` returning regular dicts instead of OrderedDicts) suggest it was developed with older Python versions in mind. Using it in a modern Python 3-only project might introduce unnecessary overhead or less Pythonic patterns.
Fix: Be aware of potential performance or style implications. For new Python 3 projects, evaluate if a more modern, Python 3-native utility library or built-in functions would be more appropriate.

Install

pip install pockets Install latest version

Imports

log
```
from pockets.autolog import log
```
camel
```
from pockets import camel
```
Functions are often hoisted to the top-level 'pockets' package for convenience, making direct submodule imports less common but still correct.
uncamel
```
from pockets import uncamel
```
Functions are often hoisted to the top-level 'pockets' package for convenience, making direct submodule imports less common but still correct.
resolve
```
from pockets import resolve
```
Functions are often hoisted to the top-level 'pockets' package for convenience, making direct submodule imports less common but still correct.
iterpeek
```
from pockets import iterpeek
```
Functions are often hoisted to the top-level 'pockets' package for convenience, making direct submodule imports less common but still correct.

groupify

from pockets.collections import groupify

Quickstart

This quickstart demonstrates common string manipulation utilities like `camel` and `uncamel`, object resolution using `resolve`, and advanced iterator functionality with `iterpeek`.

from pockets import camel, uncamel, resolve, iterpeek

# String utilities
camel_case_str = camel("xml_http_request", upper_segments=[1])
print(f"Camel case: {camel_case_str}")

underscore_str = uncamel("XmlHTTPRequest")
print(f"Underscore case: {underscore_str}")

# Object resolution
list_class = resolve("builtins.list")
print(f"Resolved object: {list_class}")

# Iterator peeking
p = iterpeek(["a", "b", "c", "d", "e"])
print(f"Peek next: {p.peek()}")
print(f"Next item: {next(p)}")
print(f"Peek 3 items: {p.peek(3)}")

view raw JSON →