arango-models branch

[geomat0101]

Here is a quickstart for what I've got going over in the new branch:

Import, Connect to DB

(mediamgr) mdg@ftl:~/src/mediamgr/python$ python
Python 3.10.6 (main, Mar 10 2023, 10:55:28) [GCC 11.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import mediamgr as mm
>>> db = mm.connect()

Instantiate a document object for the 'media' collection in the db

>>> x = mm.models.MediaDocument(db)
>>> x
null
>>> x.collection.all()
<Cursor>
>>> [ _ for _ in x.collection.all() ]
[{'_key': '50197', '_id': 'media/50197', '_rev': '_g_wDdvC---', 'metadata': {}}]

Nuke the contents of the existing db collection (delete all records)

>>> x.collection.truncate()
True
>>> [ _ for _ in x.collection.all() ]
[]

Create a new blank media document record and save it

>>> x
null
>>> x.new()
>>> x
{
    "metadata": {}
}
>>> x.save()
{'_id': 'media/50357', '_key': '50357', '_rev': '_g_wI8Tu---'}
>>> 
>>> [ _ for _ in x.collection.all() ]
[{'_key': '50357', '_id': 'media/50357', '_rev': '_g_wI8Tu---', 'metadata': {}}]

Instantiate a document object for the 'faces' collection in the db

>>> f = mm.models.FacesDocument(db)
>>> f
null
>>> f.collection.all()
<Cursor>
>>> [ _ for _ in f.collection.all() ]
[]

create a new document and set some of the properties on it, then save

>>> f.new()
>>> f
{
    "face_identifier": "",
    "media_id": "",
    "cast_id": ""
}
>>> f.document['face_identifier'] = 'foobar'
>>> f.document['media_id'] = 'media/50357'
>>> 
>>> f
{
    "face_identifier": "foobar",
    "media_id": "media/50357",
    "cast_id": ""
}
>>> f.save()
{'_id': 'faces/50433', '_key': '50433', '_rev': '_g_wLORy---'}
>>> 
>>> 
>>> [ _ for _ in f.collection.all() ]
[{'_key': '50433', '_id': 'faces/50433', '_rev': '_g_wLORy---', 'face_identifier': 'foobar', 'media_id': 'media/50357', 'cast_id': ''}]
>>> 

[geomat0101]

Create a new cast document and create an appears_in graph edge from there to a media document

>>> x = mm.models.CastDocument(db)
>>> x.new()
>>> x.save()
{'_id': 'cast/51714', '_key': '51714', '_rev': '_g_w6Tyu---'}
>>> x._id
'cast/51714'

>>> m = mm.models.MediaDocument(db)
>>> [ _ for _ in m.collection.all() ]
[{'_key': '50357', '_id': 'media/50357', '_rev': '_g_wI8Tu---', 'metadata': {}}]
>>> m.get('50357')
>>> m
{
    "_key": "50357",
    "_id": "media/50357",
    "_rev": "_g_wI8Tu---",
    "metadata": {}
}

>>> x.appears_in(m._id)
{'_id': 'appears_in/52606', '_key': '52606', '_rev': '_g_xSdUW---'}

Create a face_matches_face graph edge between two face documents

>>> f = mm.models.FacesDocument(db)
>>> f.new()
>>> f
{
    "face_identifier": "",
    "media_id": "",
    "cast_id": ""
}
>>> f.document['face_identifier'] = 'feedfacedeadbeef'
>>> f.document['media_id'] = 'media/50357'
>>> f.save()
{'_id': 'faces/52001', '_key': '52001', '_rev': '_g_xCiAu---'}
>>> [ _['_id'] for _ in f.collection.all() ]
['faces/50433', 'faces/52001']
>>> f._id
'faces/52001'

>>> f.get('50433')
>>> f
{
    "_key": "50433",
    "_id": "faces/50433",
    "_rev": "_g_wLORy---",
    "face_identifier": "foobar",
    "media_id": "media/50357",
    "cast_id": ""
}
>>> f.matches_face('faces/52001')
{'_id': 'face_matches_face/52685', '_key': '52685', '_rev': '_g_xTnp6---'}

[geomat0101]

Create cast and face documents, set foreign key, demo relational get methods, how to reuse document objects with lists of results via setDocument()

>>> c = mm.models.CastDocument(db)
>>> c.new()
>>> c.save()
{'_id': 'cast/71687', '_key': '71687', '_rev': '_g_7lnWG---'}
>>>
>>> f = mm.models.FacesDocument(db)
>>> f.new()
>>> f.document['cast_id'] = 'cast/71687'
>>>
>>>
>>> list(c.get_faces())
[]
>>> f.save()
{'_id': 'faces/71738', '_key': '71738', '_rev': '_g_7nM0S---'}
>>> list(c.get_faces())
[{'_key': '71738', '_id': 'faces/71738', '_rev': '_g_7nM0S---', 'face_identifier': '', 'media_id': '', 'cast_id': 'cast/71687'}]
>>>
>>> first_face = list(c.get_faces())[0]
>>> first_face
{'_key': '71738', '_id': 'faces/71738', '_rev': '_g_7nM0S---', 'face_identifier': '', 'media_id': '', 'cast_id': 'cast/71687'}
>>> f.setDocument(first_face)
>>> f._id
'faces/71738'