Skip to main content

Removes values from nested dicts and lists

Project description


A simple package that filters out values from dicts/lists, including all dicts/lists nested within it.


from deep_filter import deep_filter
x = {
    'nope': 69,
    'yep': [
        {'maybe': None},
def filter_func:
    return value != 69
result = deep_filter(x, filter_func)
# {'yep': [{}, 99]}

deep_filter(dict_or_list, filter_func=default_filter_func)

  • dict_or_list: A dictionary or list
  • filter_func: An optional callback function. It will take a value as an argument, and return True if the value will be kept and False if not. If omitted, None values will be filtered out.

Returns your dict or list, filtered.

Dev instructions

Get started

  1. Install Python (Python 3.7 works, probably other versions too)
  2. Install Poetry. Poetry is used to manage dependencies, the virtual environment and publishing to PyPI
  3. Run poetry install to install Python package dependencies

I recommend running poetry config true, which makes Poetry store your Python virtual environment inside the project folder. Additionally, it lets VSCode's Python extension detect the virtual environment if you set the python.pythonPath setting to ${workspaceFolder}/.venv/bin/python in your settings.


To test if things work, you can run the following command to open the Python REPL. Then you can write Python, such as the usage examples:

poetry run python

Releasing a new version

  1. Consider updating the lockfile by running poetry update, then check if thing still work
  2. Bump the version number:
    poetry version <version>
  3. Update
  4. Build:
    poetry build
  5. Commit and create git tag
  6. Create GitHub release with release notes and attach the build files
  7. Publish to PyPi:
    poetry publish

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

deep-filter-1.0.1.tar.gz (2.4 kB view hashes)

Uploaded source

Built Distribution

deep_filter-1.0.1-py3-none-any.whl (2.3 kB view hashes)

Uploaded py3

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