Skip to content
@python-boltons

python-boltons (AKA "big boltons")

python libraries made available as "boltons"; we think they should be "builtins"

Inspired by the original mahmoud/boltons GitHub repository / boltons PyPI package (founded ~10 years ago), this organization takes a modern approach to solving the same problem. Namely, while we strive to adhere (more-or-less) to the design tenets of the original project, we choose to utilize separate GitHub repositories and separate PyPI packages for each cohesive set of library utilities.

The original project's architecture statement can be found here; we summarize the design guidelines found on that page below:

  1. Be pure-Python and as self-contained as possible.
  2. Perform a common task or fulfill a common role.
  3. Demonstrate and mitigate some insufficiency in the standard library.
  4. Strive for the standard set forth by the standard library by striking a balance between best practice and “good enough”, correctness and common sense. When in doubt, ask, “what would the standard library do?”
  5. Have approachable documentation with at least one helpful doctest, links to relevant standard library functionality, as well as any 3rd-party packages that provide further capabilities.

Here is another telling quote taken from the original boltons project's Architecture document:

The larger the problem solved, the less likely the functionality is suitable for inclusion in boltons; boltons are fundamental and self-contained, not sweeping and architecture-defining.

In the python-boltons (AKA "big boltons") organization, we still believe that every bolton should be fundamental and self-contained. Moreover, we largely support the statement quoted above as a whole. With that said, one of the benefits of breaking each bolton out into its own repository is that it makes it easier to scale these utility libraries to higher levels of abstractions later; we shall allow this to occur organically and will not cripple library growth for the sake of keeping all libraries "small".

For more information on the design of this organization, refer to the documents in this organization's design repo, which we consider to be mandatory reading for anyone interested in contributing / maintaining boltons.

Pinned

  1. design design Public

    python-boltons design repo... We use this repository to design the rules and guidelines of this organization (e.g. via PlantUML diagrams and RFCs).

  2. cc-python cc-python Public

    general-purpose Python cookiecutter... Used by all repos in this organization.

    Shell 3

  3. docker-python docker-python Public

    general-purpose Python docker image... Contains the Dockerfile that defines the "pythonboltons/main" image, which is used by all repos in this organization.

    Shell 1

Repositories

Showing 10 of 12 repositories
  • clack Public

    command-line application configuration kit (CLACK)... A wrapper around the `argparse` library that aims to handle _all_ application configuration.

    Python 1 0 0 0 Updated Apr 6, 2024
  • cc-python Public

    general-purpose Python cookiecutter... Used by all repos in this organization.

    Shell 3 0 2 0 Updated Apr 5, 2024
  • docker-python Public

    general-purpose Python docker image... Contains the Dockerfile that defines the "pythonboltons/main" image, which is used by all repos in this organization.

    Shell 1 0 0 0 Updated Jan 18, 2024
  • logrus Public

    Better logging made easy with support for structlog and the standard logging module.

    Python 1 0 0 0 Updated Jan 16, 2024
  • metaman Public

    metadata manager (METAMAN)... Makes use of Python's dynamic nature to inspect a program's internals.

    Shell 0 0 0 0 Updated Jun 6, 2022
  • proctor Public

    process doctor (PROCTOR)... Utilities related to process / thread management.

    Shell 0 0 0 0 Updated Feb 14, 2022
  • eris Public

    The Greek Goddess of Strife and Discord... A better way to handle, trace, and log errors in Python.

    Python 0 0 0 0 Updated Jan 14, 2022
  • typist Public

    Typing utilities we wish were in the standard library.

    Shell 0 0 0 0 Updated Jan 14, 2022
  • .github Public
    0 0 0 0 Updated Dec 26, 2021
  • design Public

    python-boltons design repo... We use this repository to design the rules and guidelines of this organization (e.g. via PlantUML diagrams and RFCs).

    0 0 0 0 Updated Dec 25, 2021

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…