Skip to content

erivlis/mappingtools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

MappingTools

Do stuff with Mappings and more

This library provides utility functions for creating, manipulating, and transforming data structures, which have or include Mapping-like characteristics.

Including inverting dictionaries, converting class-like objects to dictionaries, creating nested defaultdicts, and unwrapping complex objects.

Package PyPI - Version PyPI - Status PyPI - Python Version PyPI - Downloads PyPI - Dependents Libraries.io SourceRank
Code GitHub GitHub repo size GitHub last commit (by committer) Contributors
Tools PyCharm uv Ruff Hatch project commitizen
CI/CD Test Publish Publish Publish Docs
Scans Coverage Quality Gate Status Security Rating Maintainability Rating Reliability Rating Lines of Code Vulnerabilities Bugs Codacy Quality Codacy Coverage CodeFactor DeepSource DeepSource Snyk

๐Ÿš€ Why use MappingTools?

Built for developers who need more than just standard dictionaries.

Problem Solution
Boilerplate Reduction Use Dictifier to broadcast method calls to a collection of objects (users.greet() instead of a for loop).
Deep JSON Diffing Use flatten() to collapse nested JSON into single-layer paths for easy comparison.
Data Collisions Use inverse() to swap keys/values without losing data (automatically creates sets for duplicates).
Slow Config Loading Use MeteredDict to profile exactly how many times your app reads specific config keys.
Quick Serialization Use simplify() to instantly convert Dataclasses, DateTime, and custom objects into pure Dicts.
Complex Grouping Use reshape() to pivot lists of dicts into N-dimensional nested dictionaries (tensors).
Key Remapping Use rename() or rekey() to transform dictionary keys using functions or maps.
Multi-Dimensional Counting Use CategoryCollector to aggregate data into multiple buckets simultaneously (e.g., by type AND by status).
Safe Deep Modification Use Lens to immutably update nested values without cloning the entire structure manually.

Documentation

https://erivlis.github.io/mappingtools/

Development

Ruff

ruff check src

ruff check tests

Test

Standard (cobertura) XML Coverage Report

python -m pytest tests --cov=src --cov-branch --doctest-modules --cov-report=xml

HTML Coverage Report

python -m pytest tests --cov=src --cov-branch --doctest-modules --cov-report=html

About

Python tools to manipulate Mapping objects

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages