Popular recipes by Jan Kaliszewski

Fast and elegant switch/case-like dispatch (Python)

2011-09-02T01:49:40-07:00

Python recipe 577864 by Jan Kaliszewski (case, decorator, dispatcher, performance, switch). Revision 4.

My approach to that common issue focuses on efficiency and elegant, declarative style of definition. That's why:

The way switches work is based on unwrapped defaultdict/list lookup.
The way you define switches is based on classes and easy-to-use decorators (note that you can use subclassing in a flexible way -- without any negative impact on efficiency!).
Its use cases focus on a-lot-of-keys situations and it does not cover the fall-through feature (though you can reach its semantics if you really need that -- by calling class methods...).

CLOS-like around/before/after auxiliary methods (Python)

2011-08-25T22:59:22-07:00

Python recipe 577859 by Jan Kaliszewski (auxiliary, class, clos, decorator, inheritance, method, object, super).

This module provides an easy way to define and use your own around/before/after auxiliary methods, similar to those used in CLOS (Common Lisp Object System).

namedtuple.abc - abstract base class + mix-in for named tuples (Python)

2011-04-02T02:07:00-07:00

Python recipe 577629 by Jan Kaliszewski (abc, collections, dry, inheritance, namedtuple, shortcuts). Revision 7.

If you need

to define named tuple subclasses (including reusable abstract ones), adding/overriding some methods, in a convenient way;
to have the named tuple ABC (abstract base class) for isinstance/issubclass tests;
or simply would like to define your named tuple classes in a class-syntax-based and DRY way (without repeating type names...)

-- this recipe is for you.

Tiny trace/debug-logging tool with smart event filtering (Python)

2011-04-29T02:23:37-07:00

Python recipe 577429 by Jan Kaliszewski (debugging, logging, trace). Revision 3.

Just import, call and log your selected call/return/exception/etc. events.
You can use a standard Python logger from the logging module.
Quite flexible tool and about 50 efective SLOC only (excluding the example script).
For debugging rather than production environments (programs noticeably slow down).

Multiprocess-safe logging file-handler + interprocess RLock (Python)

2010-09-22T17:30:10-07:00

Python recipe 577395 by Jan Kaliszewski (concurrency, file, file_lock, flock, handler, logging, process, rlock, threading, threadsafe). Revision 11.

A Python 2.x/3.x-compatibile multiprocess-safe logging file-handler (logging.FileHandler replacement, designed for logging to a single file from multiple independent processes) together with a simple interprocess recursive lock -- universal abstract classes + Unix/Linux implementation.

Update: It's is a deeply revised version. Especially, now it --

is Python 2.4, 2.5, 2.6, 3.1 -compatibile (previously Py>=2.6 was needed); probably works also with 2.7, 3.0 and 3.2 (but not tested if it does);
is multiprocess-safe as well as thread-safe (proviously thread safety within a process was missed);
is based on public interfaces only (previously FileHandler._open() was called and overriden);
implement full RLock instance interface, as documented for threading.RLock (previously non-blocking mode and context-manager interface were missing).

The module contains:

Unix/Linux-only example implementation (with flock-based locking): FLockRLock and FLockFileHandler classes.
universal abstract classes -- which may be useful at developing implementation for non-Unix platforms: MultiprocessRLock, MultiprocessFileHandler, LockedFileHandler,

Also a quick-and-dirty test was added.

It is still an alpha version -- I'll be very grateful for any feedback.

Further updates:

2010-09-20: Some corrections, especially: non-blocking mode bug in MultiprocessRLock.acquire() fixed; _test() function improved; plus fixes in the description below.
2010-09-22: _test() improved and moved to description section. Mistaken copyright-notice removed.

fcntl.flock() (Unix file lock) behaviour sampling script (Python)

2010-09-22T00:11:12-07:00

Python recipe 577404 by Jan Kaliszewski (file, file_descriptor, file_lock, flock, process, thread). Revision 3.

A quick fcntl.flock(fcntl.LOCK_EX | fcntl.LOCK_NB) call sampling script: with one file object (and descriptor) or separate file objects (and different descriptors) pointing to the same filesystem path -- with/without threading or forking.

It's rather exemplum-and-educational piece of code than utility-script, unless somebody has to few slots in their memory to remember that flock is file-descriptor-tacked (then quick run of the script can save web-searching) :)

Sorted dictionary (Python)

2010-01-20T17:11:59-08:00

Python recipe 576998 by Jan Kaliszewski (collections, dict, dictionary, mapping, sorted, sorteddict). Revision 29.

A simple implementation of a dictionary which always (when applicable) returns keys, values, items (key-value pairs) sorted by keys (inserting/removing order doesn't matter and only keys are important; so please note that it is something different than OrderedDict in Python 3.1/2.7 or Django's SortedDict).