Skip to main content

A collection of utilities for working with Dictionaries in Python.

Project description

dict-tape

A collection of Python utilities for manipulating dictionaries

ko-fi

Installation

pip install dict-tape

Usage

from dict_tape import chain_get

Features

Traversal

chain_get

This is intended to help solve problems like this with deeply nested dictionaries:

some_dict.get('a', {})[0].get('b', {}).get('e', 'default')

The problem is that while .get() can help with chains of dictionaries, if you have lists intermixed in there, you can't sanely default things and have to just hope the list has items (since list indexing will throw an exception if the list is empty).

But with chain_get() you can accomplish this in a way that will sanely default:

from dict_tape import chain_get

some_dict = {'a': [{'b': {'e': 'value'}}]}
# Prints 'value'
print(chain_get(some_dict, 'a', 0, 'b', 'e', default='default'))

some_dict = {'a': []}
# Prints 'default'
print(chain_get(some_dict, 'a', 0, 'b', 'e', default='default'))

chain_get() will also do some sanity checking on your types and arguments:

  • Checks to make sure that every new level is a dict, list, or str
  • If the current data being indexed is a list or str, it will check that the arg provided is an int
  • If the current data being indexed is a dict, it will check that the arg provided is an int or str
  • If the resulting data it finds with traversal doesn't match the type provided for default, it will throw an error so you know you got something you apparently didn't expect

Options

  • default: The default value to return if the chain fails at any point.
  • check_arg_types: You can set this to False to disable checking whether arg types are valid for data. If this is disabled, when it would normally throw an error for this problem it will instead return the default value.
  • check_data_types: You can set this to False to disable checking whether the data types are valid. If this is disabled, when it would normally throw an error for this problem it will instead return the default value.

Project details


Download files

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

Source Distribution

dict_tape-1.3.0.tar.gz (17.7 kB view details)

Uploaded Source

Built Distribution

dict_tape-1.3.0-py3-none-any.whl (15.8 kB view details)

Uploaded Python 3

File details

Details for the file dict_tape-1.3.0.tar.gz.

File metadata

  • Download URL: dict_tape-1.3.0.tar.gz
  • Upload date:
  • Size: 17.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.0

File hashes

Hashes for dict_tape-1.3.0.tar.gz
Algorithm Hash digest
SHA256 3562e55576d80bde655549ac91afd06239a4a8a2bae68f78f8740eba6488edea
MD5 c3ad965093fe0df82bd086c08b8a1cad
BLAKE2b-256 d0e05be0fc7f37c53e2e3738b360ca609de09ddbc81c6bb826ae9615380f5ee3

See more details on using hashes here.

File details

Details for the file dict_tape-1.3.0-py3-none-any.whl.

File metadata

  • Download URL: dict_tape-1.3.0-py3-none-any.whl
  • Upload date:
  • Size: 15.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.0

File hashes

Hashes for dict_tape-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c0167d52a7bf239d85273cd5ab046a526883b30fd1d55fed8189486ab8e474db
MD5 0ded94c239a46a075ccfe501c4510ac1
BLAKE2b-256 d7d1d451c54bf49f8240cef01255769742966825edc41ed680af3fe1eee38070

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page