.. -*- restructuredtext -*-

jaraco.util
===========

Overview
--------

``jaraco.util`` contains a number of nominally useful, reusable classes
and functions. Each is designed to be intuitively named and
self-documenting (many with extensive doctests), though
the project is also `documented with runnable tests
<https://pythonhosted.org/jaraco.util>`_.

Deprecation
-----------

In general, this grab-bag of routines is deprecated, with much of the
functionality moved or pending move to another, more appropriate home.

Highlights
----------

Some of the more interesting modules include:

 - ``.dictlib`` contains RangeMap, a dictionary-like object that maps a
   range of values to a given value.

Status and License
------------------

``jaraco.util`` provides miscellaneous utility functions used across
projects developed by the author.

``jaraco.util`` is written by Jason R. Coombs.  It is licensed under an
`MIT-style permissive license
<http://www.opensource.org/licenses/mit-license.php>`_.

You can install it with ``easy_install jaraco.util``, or grab the code
from the `mercurial repository
<https://bitbucket.org/jaraco/jaraco.util>`_.
