This repository has been archived by the owner. It is now read-only.
Time dimensional dictionaries
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Build Status Version

Time dimensional dictionaries, featuring expiring and future key values. dictime extends the standard python dict with 3 distinct additions


pip install dictime

Extends dict with

  1. keys that may have a future value, but not exist now
  2. keys that can expire in the future
  3. keys that have multiple values, but only one value at any given time


  1. keys can only have 1 value at any moment
    • the extra values will be removed in the order they were added
  2. calling methods like ":key" in dictime or dictime.has_key(":key") will result in True only when the key has a value that is present.
    • Therefore, if the key has no value now, but does so in the future it will return False


from dictime import dictime
from datetime import timedelta
from time import sleep

best = dictime()
best.set("who", "corey", expires=timedelta(seconds=10))
best.set("who", "casey", future=timedelta(seconds=10))

best.get("who") # "corey"

best.get("who") # "casey"

Notice in the example below how the key who will have 2 values but they are at different times


The method .set() accepts inline arguments in the following arrangement

_dictime.set(:key, :value, :expires default None, :future default None)
  • key: any object
  • value: any object
  • expres accepts:
    • None: the value will never expire
    • datetime.datetime: the value will expire on datetime
    • datetime.timedelta: the value will expire on now + timedelta
    • dict: expire on now + timedelta(**dict)
  • future accepts:
    • None: set this keys value now
    • datetime.datetime: the key will have this value on datetime
    • datetime.timedelta: the value will have this value on now + timedelta
    • dict: the key will have this value on now + timedelta(**dict)