tweaking index copy and adding proper linkage

This commit is contained in:
Mahmoud Hashemi 2015-04-08 21:24:57 -07:00
parent 6fbaa8cc26
commit aee394a5f4
1 changed files with 29 additions and 20 deletions

View File

@ -4,22 +4,26 @@ boltons
*boltons should be builtins.* *boltons should be builtins.*
**Boltons** is a set of pure-Python utilities in the same spirit as **Boltons** is a set of pure-Python utilities in the same spirit as
the Python builtins, and yet conspicuously missing from the `the and yet conspicuously missing from the `the standard library`_,
standard library`_, including: including:
* Atomic file saving, bolted on with :mod:`fileutils` * :func:`Atomic file saving <boltons.fileutils.atomic_save>`, bolted on with
* A highly-optimized :class:`OrderedMultiDict`, in :mod:`dictutils` :mod:`~boltons.fileutils`
* Two types of ``PriorityQueue``, in :mod:`queueutils` * A highly-optimized :class:`~boltons.dictutils.OrderedMultiDict`,
* "Chunked" and "windowed" iteration, among many others, in :mod:`iterutils` in :mod:`boltons.dictutils`
* A full-featured ``TracebackInfo`` type, for representing stack * Two types of :class:`~boltons.queueutils.PriorityQueue`, in
traces, in :mod:`tbutils` :mod:`boltons.queueutils`
* :func:`Chunked <boltons.iterutils.chunked>` and :func:`windowed
<boltons.iterutils.windowed>` iteration, in :mod:`boltons.iterutils`
* A full-featured :class:`~boltons.tbutils.TracebackInfo` type, for
representing stack traces, in :mod:`boltons.tbutils`
And that's just a small selection. As of |today|, ``boltons`` is And that's just a small selection. As of |today|, ``boltons`` is
|b_type_count| types and |b_func_count| functions spread across |b_type_count| types and |b_func_count| functions spread across
|b_mod_count| modules. |b_mod_count| modules.
.. appx 50, 75, and 23, respectively, as of initial docs writing .. counts are appx 50, 75, and 23, respectively, as of initial docs writing
.. _the standard library: https://docs.python.org/2.7/library/index.html .. _the standard library: https://docs.python.org/2.7/library/index.html
@ -43,22 +47,27 @@ Third-party packages
-------------------- --------------------
The majority of boltons strive to be "good enough" for a wide range of The majority of boltons strive to be "good enough" for a wide range of
basic uses, leaving advanced use cases to specialized 3rd party basic uses, leaving advanced use cases to Python's `myriad specialized
libraries. For example, no radical recommendations of NumPy inclusion 3rd-party libraries`_. In many cases the respective ``boltons`` module
in the standard lib; the builtin number types and operations are will describe 3rd-party alternatives worth investigating when use
great! Built-in support for imaginary numbers for goodness sake! cases outgrow ``boltons``. If you've found a natural "next-step"
library worth mentioning, :ref:`consider filing an issue <Gaps>`!
.. _myriad specialized 3rd-party libraries: https://pypi.python.org/pypi
.. _gaps:
Gaps Gaps
---- ----
Found something missing in the standard library that should be in Found something missing in the standard library that should be in
``boltons``? First, take a moment to read the very brief ``boltons``? Found something missing in ``boltons``? First, take a
:doc:`architecture` statement to make sure the functionality would be moment to read the very brief :doc:`architecture` statement to make
a good fit. sure the functionality would be a good fit.
Then, if you are very motivated, submit `a Pull Then, if you are very motivated, submit `a Pull Request`_. Otherwise,
Request`_. Otherwise, submit a feature request on `the Issues page`_, submit a short feature request on `the Issues page`_, and we will
and we will figure something out. figure something out.
.. _a Pull Request: https://github.com/mahmoud/boltons/pulls .. _a Pull Request: https://github.com/mahmoud/boltons/pulls
.. _the Issues Page: https://github.com/mahmoud/boltons/issues .. _the Issues Page: https://github.com/mahmoud/boltons/issues