Implement DbDelete()

TODO.txt

@@ -11,7 +11,7 @@ Key:
 Milestone: v0.1.1
 -----------------
 
-[ ] DbDelete()
+[x] DbDelete()
 [ ] UtilRandomString()
 [ ] Database version file
 [ ] User registration

man/man7/telodendria-changelog.7

@@ -1,4 +1,4 @@
-.Dd $Mdocdate: December 14 2022 $
+.Dd $Mdocdate: December 15 2022 $
 .Dt TELODENDRIA-CHANGELOG 7
 .Os Telodendria Project
 .Sh NAME
@@ -37,6 +37,12 @@ Changes:
 .It
 Improved HTTP request logging by removing unnecessary
 log entries and making errors more specific.
+.It
+Added a way to safely delete objects from the database.
+While the database is for persistent storage, there may
+be some ephemeral data that lives there only for a short
+while, so it will be necessary to remove that data when
+necessary.
 .El
 .Pp
 Bug fixes:

src/Db.c

@@ -537,6 +537,76 @@ DbCreate(Db * db, size_t nArgs,...)
     return DbLockFromArr(db, args);
 }
 
+int
+DbDelete(Db * db, size_t nArgs,...)
+{
+    va_list ap;
+    Array *args;
+    char *file;
+    char *hash;
+    int ret = 1;
+    DbRef *ref;
+
+    if (!db)
+    {
+        return 0;
+    }
+
+    va_start(ap, nArgs);
+    args = ArrayFromVarArgs(nArgs, ap);
+    va_end(ap);
+
+    pthread_mutex_lock(&db->lock);
+
+    hash = DbHashKey(args);
+    file = DbFileName(db, args);
+
+    ref = HashMapGet(db->cache, hash);
+    if (ref)
+    {
+        pthread_mutex_lock(&ref->lock);
+
+        HashMapDelete(db->cache, hash);
+        JsonFree(ref->json);
+        ArrayFree(ref->name);
+
+        db->cacheSize -= ref->size;
+
+        if (ref->next)
+        {
+            ref->next->prev = ref->prev;
+        }
+        else
+        {
+            db->mostRecent = ref->prev;
+        }
+
+        if (ref->prev)
+        {
+            ref->prev->next = ref->next;
+        }
+        else
+        {
+            db->leastRecent = ref->next;
+        }
+
+        pthread_mutex_unlock(&ref->lock);
+        pthread_mutex_destroy(&ref->lock);
+        Free(ref);
+    }
+
+    Free(hash);
+
+    if (UtilLastModified(file))
+    {
+        ret = remove(file) == 0;
+    }
+
+    pthread_mutex_unlock(&db->lock);
+
+    return ret;
+}
+
 DbRef *
 DbLock(Db * db, size_t nArgs,...)
 {

src/include/Db.h

@@ -44,6 +44,9 @@ extern void
 extern DbRef *
  DbCreate(Db *, size_t,...);
 
+extern int
+ DbDelete(Db *, size_t,...);
+
 extern DbRef *
  DbLock(Db *, size_t,...);