rpds-py

0.30.0 · active · verified Sat Mar 28

rpds-py provides Python bindings to Rust's persistent data structures (rpds), offering immutable collections with efficient structural sharing. The current version is 0.30.0, released on March 28, 2026. The library has a regular release cadence, with multiple updates per year.

Warnings

breaking rpds-py requires Python 3.10 or higher.
Fix: Ensure your Python environment is version 3.10 or higher.
gotcha rpds-py collections are immutable; modifying them returns a new instance.
Fix: Assign the result of any modification to a new variable or overwrite the existing one.

Install

pip install rpds-py Install rpds-py

Imports

HashTrieMap
```
from rpds import HashTrieMap
```
HashMap is not available; use HashTrieMap instead.
HashTrieSet
```
from rpds import HashTrieSet
```
HashSet is not available; use HashTrieSet instead.

Quickstart

Demonstrates creating a HashTrieMap, inserting a key-value pair, and retrieving a value.

from rpds import HashTrieMap

# Create an empty HashTrieMap
map = HashTrieMap()

# Insert a key-value pair
map = map.set('key', 'value')

# Retrieve a value
value = map.get('key')
print(value)  # Output: 'value'

view raw JSON →