Document revocation and bump to 0.3.0

sigil/__init__.py

@@ -22,12 +22,19 @@ without the private key, which never leaves the agent.
     # And the rule that holds it together
     sessions.assert_may_act_as_agent(sessions.resolve(store, view["token"]))
     # -> raises AgentImpersonationDenied
+
+    # Suspension and death are separate. No end time is permanent.
+    identity.revoke(store, "bigpickle", reason="key compromise", actor="leora")
+    identity.revoke(store, "bigpickle", until=int(time.time()) + 3600)
+    identity.reinstate(store, "bigpickle")
 """
 
+import time
+
 from . import errors, identity, keys, sessions, store, viewcodes
 from .store import Store
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"
 
 __all__ = [
     "Store",