Skip to main content

An ordered, one-to-many mapping.

Project description

An ordered, one-to-many mapping.

Thread Safety

FrozenMagicDict and its classes should be thread safe without additional locking. If any data races occurred during using, then that’s a bug. Please file an issue with reproducing procedure.


MagicDict should function like a collections.OrderedDict except move_to_end is not defined and the item selection always returns the first item. It it is not, submit an issue.

FrozenMagicDict is an immutable version of MagicDict. Also, compared to MagicDict, FrozenMagicDict is lockless. Hence, when an action is available in both dictionaries, FrozenMagicDict is usually faster.

FrozenTolerantMagicDict and TolerantMagicDict are case-insensitive version of FrozenMagicDict and MagicDict respectively.

get_first, get_last, get_iter, and get_list: These methods are available in FrozenMagicDict and its subclasses to get the elements. For more details, please read the comments of each method.

add: Method add is available in MagicDict and TolerantMagicDict. This method is used as an instead of dic[“key”] = “value” as it can append a value to the dictionary without removing the former one. Setting values like normal OrderedDict will clear the stored value(s) if any.


Data Structure is one of the bedrocks of all the other Python applications. Hence, code quality is really important. Basically, to be qualified for merging into master, the code should pass the mypy and pycodestyle check and have a 100% unit test coverage.

The repository is hosted on GitLab.


Copyright 2017 Kaede Hoshikawa

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

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 magicdict, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size magicdict-0.1.0-py3-none-any.whl (8.7 kB) File type Wheel Python version 3.6 Upload date Hashes View
Filename, size magicdict-0.1.0.tar.gz (6.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