Metadata-Version: 2.1
Name: timer-dict
Version: 0.1.0
Summary: A dictionary where values are removed after a certain time
License: MIT
Author: Jakob Pinterits
Author-email: jakob.pinterits@gmail.com
Requires-Python: >=3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Description-Content-Type: text/markdown

# TimedDict

This package provides a simple dictionary-like class, which drops items after a
set amount of time.

```python
from datetime import timedelta
from typing import Union

# When creating a TimedDict specify for how long items should live for:
my_dict = TimedDict(default_duration=timedelta(minutes=5))

# Then add items like you would to any dictionary
my_dict["foo"] = "bar"

# Or use the `put` method if you want to explicitly set the duration for a key
my_dict.put('foo', 'bar', timedelta(seconds=10))

# Getting items also works just like you'd would expect
print(my_dict['foo'])
```

## Implementation Details

Internally, the dict keeps a queue of all items and when they should be removed.
The items are then purged whenever control flow passes to the dictionary, such
as when adding or getting an item. There is no separate thread or `async` task
running in the background.

