{"author":null,"author_email":"Mahmoud Hashemi ","bugtrack_url":null,"classifiers":["Development Status :: 5 - Production/Stable","Intended Audience :: Developers","License :: OSI Approved :: BSD License","Operating System :: OS Independent","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12","Programming Language :: Python :: 3.13","Programming Language :: Python :: 3.7","Programming Language :: Python :: 3.8","Programming Language :: Python :: 3.9","Programming Language :: Python :: Implementation :: CPython","Programming Language :: Python :: Implementation :: PyPy","Topic :: Software Development :: Libraries","Topic :: Utilities"],"description":"# Boltons\n\n*boltons should be builtins.*\n\n

\n\n**Boltons** is a set of over 230 BSD-licensed, pure-Python utilities\nin the same spirit as — and yet conspicuously missing from —\n[the standard library][stdlib], including:\n\n * [Atomic file saving][atomic], bolted on with [fileutils][fileutils]\n * A highly-optimized [OrderedMultiDict][omd], in [dictutils][dictutils]\n * *Two* types of [PriorityQueue][pq], in [queueutils][queueutils]\n * [Chunked][chunked] and [windowed][windowed] iteration, in [iterutils][iterutils]\n * Recursive data structure [iteration and merging][remap], with [iterutils.remap][iterutils.remap]\n * Exponential backoff functionality, including jitter, through [iterutils.backoff][iterutils.backoff]\n * A full-featured [TracebackInfo][tbinfo] type, for representing stack traces,\n in [tbutils][tbutils]\n\n**[Full and extensive docs are available on Read The Docs.][rtd]** See\nwhat's new [by checking the CHANGELOG][changelog].\n\nBoltons is tested against Python 3.7-3.13, as well as PyPy3.\n\n[stdlib]: https://docs.python.org/3/library/index.html\n[rtd]: https://boltons.readthedocs.org/en/latest/\n[changelog]: https://github.com/mahmoud/boltons/blob/master/CHANGELOG.md\n\n[atomic]: https://boltons.readthedocs.org/en/latest/fileutils.html#boltons.fileutils.atomic_save\n[omd]: https://boltons.readthedocs.org/en/latest/dictutils.html#boltons.dictutils.OrderedMultiDict\n[pq]: https://boltons.readthedocs.org/en/latest/queueutils.html#boltons.queueutils.PriorityQueue\n[chunked]: https://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.chunked\n[windowed]: https://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.windowed\n[tbinfo]: https://boltons.readthedocs.org/en/latest/tbutils.html#boltons.tbutils.TracebackInfo\n\n[fileutils]: https://boltons.readthedocs.org/en/latest/fileutils.html#module-boltons.fileutils\n[ioutils]: https://boltons.readthedocs.org/en/latest/ioutils.html#module-boltons.ioutils\n[dictutils]: https://boltons.readthedocs.org/en/latest/dictutils.html#module-boltons.dictutils\n[queueutils]: https://boltons.readthedocs.org/en/latest/queueutils.html#module-boltons.queueutils\n[iterutils]: https://boltons.readthedocs.org/en/latest/iterutils.html#module-boltons.iterutils\n[iterutils.remap]: http://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.remap\n[iterutils.backoff]: http://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.backoff\n[tbutils]: https://boltons.readthedocs.org/en/latest/tbutils.html#module-boltons.tbutils\n\n[remap]: http://sedimental.org/remap.html\n\n## Installation\n\nBoltons can be added to a project in a few ways. There's the obvious one:\n\n```bash\npip install boltons\n```\nOn macOS, it can also be installed via [MacPorts](https://ports.macports.org/port/py-boltons/summary):\n\n```bash\nsudo port install py-boltons\n```\n\n\nThen, [thanks to PyPI][boltons_pypi], dozens of boltons are just an import away:\n\n```python\nfrom boltons.cacheutils import LRU\nmy_cache = LRU()\n```\n\nHowever, due to the nature of utilities, application developers might\nwant to consider other options, including vendorization of individual\nmodules into a project. Boltons is pure-Python and has no\ndependencies. If the whole project is too big, each module is\nindependent, and can be copied directly into a project. See the\n[Integration][integration] section of the docs for more details.\n\n[boltons_pypi]: https://pypi.python.org/pypi/boltons\n[integration]: https://boltons.readthedocs.org/en/latest/architecture.html#integration\n\n## Third-party packages\n\nThe majority of boltons strive to be \"good enough\" for a wide range of\nbasic uses, leaving advanced use cases to Python's [myriad specialized\n3rd-party libraries][pypi]. In many cases the respective ``boltons`` module\nwill describe 3rd-party alternatives worth investigating when use\ncases outgrow `boltons`. If you've found a natural \"next-step\"\nlibrary worth mentioning, see the next section!\n\n[pypi]: https://pypi.python.org/pypi\n\n## Gaps\n\nFound something missing in the standard library that should be in\n`boltons`? Found something missing in `boltons`? First, take a\nmoment to read the very brief [architecture statement][architecture] to make\nsure the functionality would be a good fit.\n\nThen, if you are very motivated, submit [a Pull Request][prs]. Otherwise,\nsubmit a short feature request on [the Issues page][issues], and we will\nfigure something out.\n\n[architecture]: https://boltons.readthedocs.org/en/latest/architecture.html\n[issues]: https://github.com/mahmoud/boltons/issues\n[prs]: https://github.com/mahmoud/boltons/pulls\n","description_content_type":"text/markdown","docs_url":null,"download_url":null,"downloads":{"last_day":-1,"last_month":-1,"last_week":-1},"dynamic":null,"home_page":null,"keywords":null,"license":null,"license_expression":null,"license_files":null,"maintainer":null,"maintainer_email":null,"name":"boltons","package_url":"https://pypi.org/project/boltons/","platform":null,"project_url":"https://pypi.org/project/boltons/","project_urls":{"Homepage":"https://github.com/mahmoud/boltons"},"provides_extra":null,"release_url":"https://pypi.org/project/boltons/25.0.0/","requires_dist":null,"requires_python":">=3.7","summary":"When they're not builtins, they're boltons.","version":"25.0.0","yanked":false,"yanked_reason":null}

Package search

boltons

project_urls

Dependencies

All package metadata

Releases