pyvgx Vertex TTL Methods Description

pyvgx.Vertex.SetExpiration()

Set vertex expiration

pyvgx.Vertex.GetExpiration()

Get vertex expiration

pyvgx.Vertex.IsExpired()

Check if vertex expiration timestamp has passed

pyvgx.Vertex.ClearExpiration()

Remove vertex expiration

1. pyvgx.Vertex.SetExpiration()

Set vertex expiration.

1.1. Syntax

pyvgx.Vertex.SetExpiration( expires[, relative ] )

Schedule vertex for automatic deletion at timestamp expires, which when relative is False is given in absolute seconds since 1970, or when relative is True is given in number of seconds into the future relative to current time.

1.2. Example

import time
from pyvgx import *
g = Graph( "g1" )
V = g.NewVertex( "shortlived" )
V.SetExpiration( 30, True )      # delete vertex after 30 seconds
g.CloseVertex( V )
"shortlived" in g                # True, vertex exists
time.sleep( 15 )                 # Sleep for 15 seconds
"shortlived" in g                # True, vertex still exists
time.sleep( 20 )                 # Sleep for 20 more seconds
"shortlived" in g                # False, vertex has expired

2. pyvgx.Vertex.GetExpiration()

Get vertex expiration.

2.1. Syntax

pyvgx.Vertex.GetExpiration()

2.2. Example

from pyvgx import *
g = Graph( "g1" )
V = g.NewVertex( "V" )
V.GetExpiration()            # 4102444800 (T_NEVER)
V.SetExpiration( 60, True )
V.GetExpiration()            # 1585516307

3. pyvgx.Vertex.IsExpired()

Check if vertex expiration timestamp has passed

3.1. Syntax

pyvgx.Vertex.IsExpired()

3.2. Example

import time
from pyvgx import *
g = Graph( "g1" )
V = g.NewVertex( "shortlived" )
V.SetExpiration( 5, True )       # delete vertex after 5 seconds
"shortlived" in g                # True, vertex exists
time.sleep( 10 )                 # Sleep for 10 seconds
V.IsExpired()                    # True
"shortlived" in g                # True, because still open
g.CloseVertex( V )               # give up ownership
"shortlived" in g                # False, expired vertex deleted

4. pyvgx.Vertex.ClearExpiration()

Remove vertex expiration

4.1. Syntax

pyvgx.Vertex.ClearExpiration()

4.2. Example

import time
from pyvgx import *
g = Graph( "g1" )
V = g.NewVertex( "vertex" )
V.SetExpiration( 10, True )      # delete vertex after 10 seconds
g.CloseVertex( V )
"vertex" in g                    # True, vertex exists
time.sleep( 5 )                  # Sleep for 5 seconds
V = g.OpenVertex( "vertex" )
V.ClearExpiration()              # cancel TTL
g.CloseVertex( V )
time.sleep( 10 )
"vertex" in g                    # True, vertex still exists

PYVGX