NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #4585 most downloaded on PyPI
Monty is the missing complement to Python.
Latest stable
2026.10.21
Last release 1 months ago
20 Oct 2026
Release timing varies
gaps range from 8 days to 12 months
Nearly every release is documented
notes for 56 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
13 years old
130 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Preserve callable signatures and types in the requires and deprecated decorators (#806, @Andrew-S-Rosen).
2026.10.21
return_if_raise raising TypeError when given a tuple of exceptions (#808).subprocess.Command raising UnboundLocalError for list/tuple commands (#808).loadfn ignoring a custom cls decoder for YAML files (#808).bisect.index(..., atol=...) missing values just above an element; it now returns the leftmost value within tolerance (#808).dumpfn error messages for a missing msgpack/YAML backend (#808).requires and deprecated decorators (#806, @Andrew-S-Rosen).Command.run uses Popen.communicate(timeout=...), termcolor.get_terminal_size wraps shutil.get_terminal_size, iuptri uses itertools.combinations, singleton uses functools.cache. Remove unused functools._HashedSeq/_make_key (#809).monty.os.cd and monty.os.makedirs_p in favor of contextlib.chdir and os.makedirs(path, exist_ok=True) (#809).lazy_property now subclasses functools.cached_property. Fixes private (name-mangled) lazy properties never caching on subclass instances, and aliased names recomputing on every access (#810).monty.functools.TimeoutError now subclasses the built-in TimeoutError (and therefore OSError) (#810).Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add YAML round-trip support for MSONable and TypeHandler-registered types (numpy, pandas, pint, torch, uuid, pathlib, bson, and user-registered handle
2026.7.16
TypeHandler-registered types (numpy, pandas, pint, torch, uuid, pathlib, bson, and user-registered handlers). dumpfn/loadfn now treat YAML symmetrically with JSON via the @module/@class envelope, with a cls=None opt-out matching the JSON path (closes #587).YAML race condition by using a thread-local instance (closes #795).MSONable object whose originating module is missing.Deprecate monty.fractions.gcd, monty.fractions.lcm, monty.functools.nCr, monty.functools.nPr, and monty.string.is_string in favor of stdlib equivalent…
2026.5.18
monty.json, monty.collections, monty.dev, monty.inspect, and monty.io (#791).monty.json.TypeHandler + register/unregister plugin API so third-party packages can teach MontyEncoder/MontyDecoder about custom types without forking. Built-in types (datetime, uuid, pathlib, numpy, torch, pandas, pint, bson) are migrated to handlers with identical dict shapes.bson.dbref.DBRef (collection, id, optional database, optional extras; nested ids recurse through MontyDecoder). Closes #746, @mkhorton.monty.fractions.gcd, monty.fractions.lcm, monty.functools.nCr, monty.functools.nPr, and monty.string.is_string in favor of stdlib equivalents.Deprecate delete_removed_files from ScratchDir (#762, @DanielYang59)
2026.2.18
delete_removed_files from ScratchDir (#762, @DanielYang59)task dependency group, merge into maintain (#771, @DanielYang59)zopen no longer allows default/implicit text/binary mode; allow mode as positional argument (#752, @DanielYang59)size when encoding torch tensor in JSON; release <3.13 pin for pint and torch (#755, @DanielYang59)zopen (#757, @DanielYang59)copy_r in favor of shutil.copytree(src, dst, dirs_exist_ok=True) (#761, @DanielYang59)Move Partial Serialization out of MSONable (@jmmshn)
2025.3.3
2025.1.9 - Re-add python 3.9 support
2025.1.9
Drop deadline warning in dev.deprecated
2025.1.3
zopen changes: forbid implicit binary/text mode, signature change, default UTF-8 encoding in text mode, drop .z support after one-year. (@DanielYang59
2024.12.10
Lazily import torch/pydantic in json module, speedup from monty.json import by 10x (@DanielYang59)
2024.10.21
Nothing published for this version
deprecated decorator allow replacement as string (@DanielYang59)
2024.6.12
Extend dev.deprecated to decorate classes and improve message (@DanielYang59)
2024.5.24
Reimplemented support for pickle in MSONAble. (@matthewcarbone)
2024.5.15
Revert changes to json.py for now.
2024.4.17
Misc bug fixes for jsanitize (@Andrew-S-Rosen).
2024.4.16
Add an optional arg deadline to dev.deprecated to raise warning after deadline (@DanielYang59)
2024.3.31
Bug fix for symlinks when using copy_r (@Andrew-S-Rosen)
2024.2.26
Bug fix for Enum subclasses with custom as_dict, from_dict (@jmmshn)
2024.2.2
Fix import of optional libraries.
2024.1.26
Lazy import of optional libraries to speed up startup.
2024.1.23
Improved pydantic2 support (@munrojm).
2023.9.25
Improved pydantic2 support (@munrojm).
2023.9.25
Support pathlib.Path in shutil (@arosen93).
2023.9.5
Bug fix for decompress_file() to maintain backwards compatibility (@janosh)
2023.8.8
Return path to decompressed file from decompress_file() (@janosh)
v2023.8.7
Pytorch tensor support for MontyEncoder/Decoder.
Pytorch tensor support for MontyEncoder/Decoder.
Fix for datetime support in jsanitize (@arosen93).
Support for DataClasses in MontyEncoder, MontyDecoder and MSONable.
Support for DataClasses in MontyEncoder, MontyDecoder and MSONable.
Fall back on json if orjson is not present. (@munrojm)
Fall back on json if orjson is not present. (@munrojm)
Allow recursive MSON in jsanitize (@arosen93)
Fix ruamel.yaml backwards compatibility.
Fix decoding of dictionaries (@arosen93).
Adds support for lzma/xz format in zopen (@zhubonan).
Support serialization for Pandas DataFrames (@mkhorton).
Support the specification of fmt keyword arg in monty.serialization loadfn and dumpfn.
fmt keyword arg in monty.serialization
loadfn and dumpfn.Expanded support for built-in functions, numpy types, etc. in MSON serialization (@utf).
- Drop py3.5 support.
UUID serialization support (@utf)
Allow specification of warning category in deprecated wrapper.
USe FutureWarning in the monty.dev.deprecated wrapper instead.
Nothing published for this version
Add support for complex dtypes in MSONable numpy arrays. (@fracci)
Improvements to MSONAble to support Varidac Args (@shyamd).
Nothing published for this version
------ 1. Bug fixes for Windows.
1. Py3 only version.
MSONable now supports Enum types. (@mkhorton)
Revert py27 incompatible fmt spec for loadfn and dumpfn for now. This is a much less common use case.
Checking for extension type in loadfn and dumpfn now relies on ".json", ".yaml" or ".mpk". Further, now ".yml" and ".yaml" are both recognized as YAML
Bug fix for invert MSON caused by @version.
@version.Support for nested MSONAble objects with MontyEncoder and dumpfn. (@davidwaroquiers)
Use basename instead of full path to determine whether file type in loadfn and dumpfn. (@JosephMontoya-TRI)
Use basename instead of full path to determine whether file type in loadfn and dumpfn. (@JosephMontoya-TRI)
Nothing published for this version
Bug fix for io.reverse_readfile to ensure txt or binary string.
monty.shutil.remove which allows symlinks removal. Also improved monty.tempfile.ScratchDir cleanup. (@shyamd)
Bug fix for reverse_readfile for bz2 files (Alex Urban)
One column per quarter.