py-12-txn-kvstore
1.000
Challenge · difficulty 5/5
# Transactional key-value store
Implement a file **`solution.py`** containing a class `KVStore` that behaves like an in-memory
key-value map with **nested transactions**.
```python
class KVStore:
def __init__(self): ...
def get(self, key): ... # current value, or None if absent
def set(self, key, value): ...
def delete(self, key): ... # remove key (no-op if absent)
def keys(self): ... # sorted list of currently-visible keys
def __len__(self): ... # number of currently-visible keys
def begin(self): ... # open a new (nested) transaction
def commit(self): ... # merge the innermost open transaction into its parent
def rollback(self): ... # discard the innermost open transaction
```
## Semantics
- With **no open transaction**, `set`/`delete` mutate the committed store directly.
- `begin()` opens a transaction. Transactions **nest**: a second `begin()` opens a child of the
first. All `set`/`delete` calls apply to the **innermost** open transaction only.
- `get`, `keys`, and `__len__` always reflect the **currently-visible** state: the committed store
overlaid by every open transaction in order (innermost wins). A key `delete`d in an open
transaction is invisible even if it exists in the committed store.
- `commit()` merges the innermost transaction's changes (both sets and deletes) into its parent
(the enclosing transaction, or the committed store if it was the outermost). The transaction is
then closed.
- `rollback()` discards the innermost transaction's changes entirely and closes it.
- `commit()` or `rollback()` with **no open transaction** must raise `RuntimeError`.
- `keys()` returns the visible keys in **sorted order**.
## Example
```python
s = KVStore()
s.set("a", 1)
s.begin()
s.set("a", 2)
s.set("b", 3)
assert s.get("a") == 2 # innermost transaction wins
s.begin()
s.delete("a")
assert s.get("a") is None # deleted in the inner transaction
assert s.get("b") == 3 # still visible from the outer transaction
s.rollback() # discard the inner transaction
assert s.get("a") == 2 # back to the outer transaction's value
s.commit() # merge outer transaction into the committed store
assert s.get("a") == 2 and s.get("b") == 3
assert s.keys() == ["a", "b"]
```
tests/test_kvstore.py
import pytest
from solution import KVStore
def test_basic_set_get_delete():
s = KVStore()
assert s.get("a") is None
s.set("a", 1)
s.set("b", 2)
assert s.get("a") == 1
assert s.get("b") == 2
s.delete("a")
assert s.get("a") is None
s.delete("missing") # no-op, must not raise
def test_len_and_keys_sorted():
s = KVStore()
s.set("z", 1)
s.set("a", 1)
s.set("m", 1)
assert s.keys() == ["a", "m", "z"]
assert len(s) == 3
s.delete("m")
assert s.keys() == ["a", "z"]
assert len(s) == 2
def test_transaction_isolation_then_commit():
s = KVStore()
s.set("a", 1)
s.begin()
s.set("a", 2)
s.set("b", 3)
assert s.get("a") == 2
assert s.get("b") == 3
s.commit()
assert s.get("a") == 2
assert s.get("b") == 3
def test_rollback_discards_changes():
s = KVStore()
s.set("a", 1)
s.begin()
s.set("a", 99)
s.set("b", 5)
s.rollback()
assert s.get("a") == 1
assert s.get("b") is None
assert s.keys() == ["a"]
def test_delete_within_transaction_is_isolated():
s = KVStore()
s.set("a", 1)
s.begin()
s.delete("a")
assert s.get("a") is None
assert s.keys() == []
assert len(s) == 0
s.rollback()
assert s.get("a") == 1 # delete was rolled back
def test_commit_propagates_delete_to_committed_store():
s = KVStore()
s.set("a", 1)
s.begin()
s.delete("a")
s.commit()
assert s.get("a") is None
assert s.keys() == []
def test_nested_transactions_inner_rollback():
s = KVStore()
s.set("a", 1)
s.begin()
s.set("a", 2)
s.set("b", 3)
s.begin()
s.delete("a")
assert s.get("a") is None
assert s.get("b") == 3
s.rollback() # discard inner
assert s.get("a") == 2 # outer value restored
s.commit() # merge outer into committed
assert s.get("a") == 2
assert s.get("b") == 3
def test_nested_commit_merges_into_parent_not_base():
s = KVStore()
s.begin()
s.set("a", 1)
s.begin()
s.set("a", 2)
s.set("b", 3)
s.commit() # inner -> outer (NOT committed store yet)
assert s.get("a") == 2
assert s.get("b") == 3
s.rollback() # discard outer -> everything gone
assert s.get("a") is None
assert s.get("b") is None
assert len(s) == 0
def test_commit_without_transaction_raises():
s = KVStore()
with pytest.raises(RuntimeError):
s.commit()
def test_rollback_without_transaction_raises():
s = KVStore()
with pytest.raises(RuntimeError):
s.rollback()
def test_deep_nesting_visibility_and_merge():
s = KVStore()
s.set("k", 0)
for depth in range(1, 6):
s.begin()
s.set("k", depth)
assert s.get("k") == depth
# commit all five layers down to the base
for _ in range(5):
s.commit()
assert s.get("k") == 5
assert s.keys() == ["k"]
def test_reset_value_after_delete_in_same_transaction():
s = KVStore()
s.set("a", 1)
s.begin()
s.delete("a")
s.set("a", 7) # re-add after delete within the same transaction
assert s.get("a") == 7
s.commit()
assert s.get("a") == 7
System prompt
You are an expert programmer. Solve the task exactly as specified. Output your solution as fenced code blocks using the required file name(s) and the exact function/type signatures requested. Prefer correctness; do not include prose outside code unless asked.
Proposed solution
```python
class KVStore:
def __init__(self):
self._committed = {}
self._transactions = []
def get(self, key):
# Check from innermost to outermost transaction
for tx in reversed(self._transactions):
if key in tx.get("sets", {}):
return tx["sets"][key]
if key in tx.get("deletes", set()):
return None
return self._committed.get(key)
def set(self, key, value):
if not self._transactions:
self._committed[key] = value
else:
tx = self._transactions[-1]
if "sets" not in tx:
tx["sets"] = {}
tx["sets"][key] = value
# Remove from deletes if present
if "deletes" in tx and key in tx["deletes"]:
tx["deletes"].remove(key)
def delete(self, key):
if not self._transactions:
self._committed.pop(key, None)
else:
tx = self._transactions[-1]
if "deletes" not in tx:
tx["deletes"] = set()
tx["deletes"].add(key)
# Remove from sets if present
if "sets" in tx and key in tx["sets"]:
del tx["sets"][key]
def keys(self):
visible = set()
# Add from committed store
visible.update(self._committed.keys())
# Apply transactions from outermost to innermost
for tx in self._transactions:
if "sets" in tx:
visible.update(tx["sets"].keys())
if "deletes" in tx:
visible.difference_update(tx["deletes"])
return sorted(visible)
def __len__(self):
return len(self.keys())
def begin(self):
self._transactions.append({})
def commit(self):
if not self._transactions:
raise RuntimeError("No open transaction")
tx = self._transactions.pop()
if not self._transactions:
# Merge into committed store
if "sets" in tx:
self._committed.update(tx["sets"])
if "deletes" in tx:
for key in tx["deletes"]:
self._committed.pop(key, None)
else:
# Merge into parent transaction
parent = self._transactions[-1]
if "sets" in tx:
if "sets" not in parent:
parent["sets"] = {}
parent["sets"].update(tx["sets"])
if "deletes" in tx:
if "deletes" not in parent:
parent["deletes"] = set()
parent["deletes"].update(tx["deletes"])
def rollback(self):
if not self._transactions:
raise RuntimeError("No open transaction")
self._transactions.pop()
```Test output (stdout)
............ [100%] 12 passed in 0.02s