Skip to main content

Abstraction layer for creating hash maps to speed up extracting subsets out of objects in collection

Project description


Latest PyPI version Documentation Status Wheel Status Supported Python Versions License

Package status

Tests Coverage Status
Matchbox is a simple python library designed to make selecting object, or object’s set based on
required characteristics quick operation. No iterating, and no value checking on actual objects, just select and operations on dictionaries.




  • Add support for python 3.9
  • Replace NamedTuple usage with dataclass for the Trait class
  • Support PEP 561


  • [enhancement] support only python 3.7 and up
  • [enhancement] Add type hints
  • small code enhancement during adding matching entities to boxes
  • remove method - ability to remove entity from already built box
  • fix license information


  • added short glossary
  • updated docs to reflect naming changes
  • rewritten usage
  • renamed various object’s usages and index_object to entity [thanks Michael Sweeney]
  • renamed characteristics_value and value references to traits, as in Characteristic’s trait. [thanks Michael Sweeney]
  • renamed MatchBox.not_matching method into MatchBox.mismatch - signature remained the same.
  • only None and empty list will be treated as a value not used for matching
  • added repr method to box
  • renamed exclude_unknown to mismatch_unknown to clarify set’s meaning
  • Extracted indexing logic from MatchBox to a base class.


  • extended tests to cover python 3.5
  • merge MultiMatchBox into MatchBox - now anyone extending MatchBoxes will be able to work with value extractors rather than re-implementing MatchBoxes.


  • MatchBox - single value based Matching Box
  • MultiMatchBox - multivalue based Matching Box
  • package structure
  • documentation

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 matchbox, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size matchbox-1.1.0-py3-none-any.whl (11.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size matchbox-1.1.0.tar.gz (20.1 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