Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

A collection of nice utility functions for python

Project description

Understreck Documentation Status Code style: black downloads

A collection of nice utility functions for python


  • Perform a safe get on a nested dictionary with the nested_get function
  • Split a list into chunks
  • Filter a list of dictionaries
  • Strip indents from multiline strings


Get example:

import understreck as _

test_dictionary = {
    "foo": {
        "second_level": {"third_level": "it works", "third_level_sibling": False},
        "second_level_list": ["Hello", "World", {"planet": "Earth"}, ["Hello", "World", {"planet": "jupiter"}, ]],

# Using dot delimited strings
result = _.get(test_dictionary, "foo.second_level.third_level")  # result == "it works"
result = _.get(test_dictionary, "foo.second_level.DOES_NOT_EXIST")  # result == None

# Using a list or tuple
result = _.get(test_dictionary, ["foo", "second_level", "third_level"])  # result == "it works"
result = _.get(test_dictionary, ["foo", "second_level", "DOES_NOT_EXIST"])  # result == None

# Getting elements in list

result = _.get(test_dictionary, "foo.second_level_list[0]")  # result == "Hello"
result = _.get(test_dictionary, "foo.second_level_list[1]")  # result == "World"
result = _.get(test_dictionary, "foo.second_level_list[2].planet")  # result == "Earth"

# Getting a property in a nested list
nested_list = {
                "foo": {
                    "bar": [
                        "x", [
                            "first", "second", {"name": "Hello World"}

result = _.get(nested_list, "[1][2].name")  # result == "Hello World"

Chunks example:

import understreck as _

to_chunk = ["one", "two", "three", "four", "five"]
result = _.chunks.split(to_chunk, 2)  # result == [["one", "two", "three"], ["four", "five"]]

Filter example:

import understreck as _

users = [
        {"user": "barney", "age": 36, "active": True},
        {"user": "fred", "age": 40, "active": False},

# Using a lambda function
result = _.filter(users, lambda x: not x.get("active"))  # result == [{"user": "fred", "age": 40, "active": False}]

# Using partial dictionary
result = _.filter(users, {"age": 36, "active": True})  # result == [{"user": "barney", "age": 36, "active": True}]

# Using a list with a property name and value
result = _.filter(users, ["active", False])  # result == [{"user": "fred", "age": 40, "active": False}]

# Using a list with a property name. The value must be truthy.
result = _.filter(users, ["active"])  # result == [{"user": "barney", "age": 36, "active": True}]

Strip indents example:

import understreck as _

def some_function():
    to_strip = """This is a

    _.strip(to_strip)  # "This is a\nmulti-line\nstring"


I have to credit the Lodash project for inspiration!

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.



1.0.0 (2020-03-03)

  • Get elements from nested lists

0.5.1 (2019-11-09)

  • Updates dev dependencies

0.5.0 (2019-05-03)

  • Updates dev dependencies
  • Moves to the new repository

0.4.0 (2019-05-03)

  • Adds Understreck.strip that strips indents

0.3.0 (2019-05-03)

  • Adds Understreck.filter with inspired by
  • Updated the travis button URL
  • Replaced nested_get with get in the README. (nested_get still works)
  • Black formatting

0.2.1 (2018-12-10)

  • Add Understreck.chunks

0.2.0 (2018-11-12)

  • Add get as an alias for nested get

0.1.1 (2018-11-02)

  • Update the readme

0.1.0 (2018-11-02)

  • First release on PyPI.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for understreck, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size understreck-1.0.0-py2.py3-none-any.whl (7.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size understreck-1.0.0.tar.gz (27.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page