Commit: 10397c449c9099fb392148d82297641645555b5b - medialist-cli (git)

CLI interface to medialist (fossil mirror)

Commit MetaInfo

• Révision: 10397c449c9099fb392148d82297641645555b5b (tree)
• l'heure: 2022-01-25 13:09:56
• Auteur: mio <stigma@disr...>
• Commiter: mio

Message de Log

move unit tests from medialist.d to unittest.d

FossilOrigin-Name: 82ff8c2665959337a4091820b7086c2ae37d41dd555dfff6bbca47320c746ba0

Change Summary

• modified: medialist.d
• modified: unittests.d

Modification

--- a/medialist.d
+++ b/medialist.d
@@ -205,7 +205,7 @@ MediaListItem ml_fetch_item(MediaList* list, size_t id, MLError* err = null)
     if (true == list.isOpen) {
         if (null !is err)
             *err = MLError.fileAlreadyOpen;
-        
+
         return newItem;
     }
 
@@ -730,7 +730,7 @@ private MLError _ml_update(MediaList* list, string[] args)
 
         if (currentIndex == id) {
             string[] sections = line.strip().split("\t");
-            
+
             /* Add missing columns if required (e.g. updating pre-0.2 file). */
             if (sections.length < headerPositions.length) {
                 while (sections.length < headerPositions.length)
@@ -879,758 +879,3 @@ private int[2][6] _ml_get_header_positions(MediaList* list)
     return headerPositions;
 }
 
-
-/*
- * The rest of this file consists of unittests.
- */
-
-version(unittest):
-
-import tap;
-
-public void runMediaListUnitTests()
-{
-    ok(unittest_createNewList(), "Create a new list.");
-    ok(unittest_addNewItemNoProgressNoStatus(),
-        "Can add a new item with no progress or status.");
-    ok(unittest_addNewItemWithProgressNoStatus(),
-        "Can add a new item with progress but no status.");
-    ok(unittest_addNewItemNoProgressWithStatus(),
-        "Can add a new item with status but no progress.");
-    ok(unittest_addNewItemWithProgressWithStatus(),
-        "Can add a new item with progress and status.");
-    ok(unittest_fetchItem2(),
-        "Can fetch a singular item by ID (2).");
-    ok(unittest_checkPre02MLFileHeaderOrder(),
-        "Check header position variance and case-insensitivity.");
-    ok(unittest_fetchItems124(),
-        "Can fetch multiple items by ID (1, 4, and 2).");
-    ok(unittest_updateItemTitle(),
-        "Can update an item's title.");
-    ok(unittest_updateItemStatus(),
-        "Can update an item's status.");
-    ok(unittest_updateItemProgress(),
-        "Can update an item's progress.");
-    ok(unittest_updateItemAll(),
-        "Can update all aspects of an item.");
-}
-
-private bool unittest_createNewList()
-{
-    import std.path : buildPath;
-
-    const listPath = buildPath(tempDir(), "unittest1.tsv");
-    scope(exit) remove(listPath);
-
-    MediaList* list = ml_open_list(listPath);
-    scope(exit) ml_free_list(list);
-
-    if (null is list) {
-        diag("Memory allocation failed (list is null)");
-        return false;
-    }
-
-    if (false == exists(listPath)) {
-        diag("A new file wasn't created for the list");
-        return false;
-    }
-
-    int[2][6] headerPositions = -1;
-
-    headerPositions = _ml_get_header_positions(list);
-
-    foreach(size_t idx, const ref int[2] headerPosition; headerPositions) {
-        if (headerPosition[0] == -1) {
-            diag("Empty header type: " ~ to!string(idx));
-            return false;
-        }
-        if (headerPosition[1] == -1) {
-            diag("Empty header position: " ~ to!string(idx));
-            return false;
-        }
-    }
-
-    return true;
-}
-
-private bool unittest_addNewItemNoProgressNoStatus()
-{
-    import std.path : buildPath;
-
-    const listPath = buildPath(tempDir(), "unittest2.tsv");
-    scope(exit) remove(listPath);
-
-    MediaList* list = ml_open_list(listPath);
-    scope(exit) ml_free_list(list);
-
-    MLError res = ml_send_command(list, MLCommand.add, ["Item 1"]);
-    if (res != MLError.success) {
-        diag(`Failed to send MLCommand.add ["Item 1"].`);
-        return false;
-    }
-
-    auto f = File(listPath);
-    string line;
-    bool readHeader = false;
-    string[] sections;
-
-    while ((line = f.readln) !is null) {
-        if (line[0] == '#')
-            continue;
-
-        if (false == readHeader) {
-            readHeader = true;
-            continue;
-        }
-
-        sections = line.strip().split("\t");
-        break;
-    }
-
-    int[2][6] headerPositions = _ml_get_header_positions(list);
-
-    if (sections.length != MLHeaders.max + 1) {
-        diag("Differing amount of headers in unit test files.");
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.title][1]] != "Item 1") {
-        diag(`New item with title "Item 1" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.progress][1]] != "-/-") {
-        diag(`New item with unspecified progress wasn't "-/-".`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.status][1]] != "UNKNOWN") {
-        diag(`New item with unspecified status wasn't "UNKNOWN".`);
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.startDate][1]] != "") {
-        diag(`New item does not have blank "start_date" field.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.endDate][1]] != "") {
-        diag(`New item does not have blank "end_date" field.`);
-        return false;
-    }
-
-    DateTime currentDT = cast(DateTime)Clock.currTime;
-    string currentDS = format!"%d-%02d-%02d"(currentDT.year,
-        currentDT.month, currentDT.day);
-
-    if (sections[headerPositions[MLHeaders.lastUpdated][1]] != currentDS) {
-        diag(`New item was not "last_updated" with today's date.`);
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_addNewItemWithProgressNoStatus()
-{
-    import std.path : buildPath;
-
-    const listPath = buildPath(tempDir(), "unittest3.tsv");
-    scope(exit) remove(listPath);
-
-    MediaList* list = ml_open_list(listPath);
-    scope(exit) ml_free_list(list);
-
-    MLError res = ml_send_command(list, MLCommand.add, ["Item 1", "10/-"]);
-    if (res != MLError.success) {
-        diag(`Failed to send MLCommand.add with ["Item 1", "10/-"].`);
-        return false;
-    }
-
-    auto f = File(listPath);
-    string line;
-    bool readHeader = false;
-    string[] sections;
-
-    while ((line = f.readln) !is null) {
-        if (line[0] == '#')
-            continue;
-
-        if (false == readHeader) {
-            readHeader = true;
-            continue;
-        }
-
-        sections = line.strip().split("\t");
-    }
-
-    int[2][6] headerPositions = _ml_get_header_positions(list);
-
-    if (sections.length != MLHeaders.max + 1) {
-        diag("Differing amount of headers in unit test files.");
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.title][1]] != "Item 1") {
-        diag(`New item with title "Item 1" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.progress][1]] != "10/-") {
-        diag(`New item with progress "10/-" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.status][1]] != "UNKNOWN") {
-        diag(`New item with unspecified status wasn't "UNKNOWN".`);
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.startDate][1]] != "") {
-        diag(`New item does not have blank "start_date" field.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.endDate][1]] != "") {
-        diag(`New item does not have blank "end_date" field.`);
-        return false;
-    }
-
-    DateTime currentDT = cast(DateTime)Clock.currTime;
-    string currentDS = format!"%d-%02d-%02d"(currentDT.year,
-        currentDT.month, currentDT.day);
-
-    if (sections[headerPositions[MLHeaders.lastUpdated][1]] != currentDS) {
-        diag(`New item was not "last_updated" with today's date.`);
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_addNewItemNoProgressWithStatus()
-{
-    import std.path : buildPath;
-
-    const listPath = buildPath(tempDir(), "unittest3.tsv");
-    scope(exit) remove(listPath);
-
-    MediaList* list = ml_open_list(listPath);
-    scope(exit) ml_free_list(list);
-
-    MLError res = ml_send_command(list, MLCommand.add,
-        ["Item 1", null, "COMPLETE"]);
-    if (res != MLError.success) {
-        diag(`Failed to send MLCommand.add with ["Item 1", null, "COMPLETE"].`);
-        return false;
-    }
-
-    auto f = File(listPath);
-    string line;
-    bool readHeader = false;
-    string[] sections;
-
-    while ((line = f.readln) !is null) {
-        if (line[0] == '#')
-            continue;
-
-        if (false == readHeader) {
-            readHeader = true;
-            continue;
-        }
-
-        sections = line.strip().split("\t");
-    }
-
-    int[2][6] headerPositions = _ml_get_header_positions(list);
-
-    if (sections.length != MLHeaders.max + 1) {
-        diag("Differing amount of headers in unit test files.");
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.title][1]] != "Item 1") {
-        diag(`New item with title "Item 1" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.progress][1]] != "-/-") {
-        diag(`New item with unspecified progress wasn't "-/-".`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.status][1]] != "COMPLETE") {
-        diag(`New item with status "COMPLETE" wasn't saved.`);
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.startDate][1]] != "") {
-        diag(`New item does not have blank "start_date" field.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.endDate][1]] != "") {
-        diag(`New item does not have blank "end_date" field.`);
-        return false;
-    }
-
-    DateTime currentDT = cast(DateTime)Clock.currTime;
-    string currentDS = format!"%d-%02d-%02d"(currentDT.year,
-        currentDT.month, currentDT.day);
-
-    if (sections[headerPositions[MLHeaders.lastUpdated][1]] != currentDS) {
-        diag(`New item was not "last_updated" with today's date.`);
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_addNewItemWithProgressWithStatus()
-{
-    import std.path : buildPath;
-
-    const listPath = buildPath(tempDir(), "unittest3.tsv");
-    scope(exit) remove(listPath);
-
-    MediaList* list = ml_open_list(listPath);
-    scope(exit) ml_free_list(list);
-
-    MLError res = ml_send_command(list, MLCommand.add,
-        ["Item 1", "10/-", "COMPLETE"]);
-    if (res != MLError.success) {
-        diag(`Failed to send MLCommand.add with `
-            ~ `["Item 1", "10/-", "COMPLETE"].`);
-        return false;
-    }
-
-    auto f = File(listPath);
-    string line;
-    bool readHeader = false;
-    string[] sections;
-
-    while ((line = f.readln) !is null) {
-        if (line[0] == '#')
-            continue;
-
-        if (false == readHeader) {
-            readHeader = true;
-            continue;
-        }
-
-        sections = line.strip().split("\t");
-    }
-
-    int[2][6] headerPositions = _ml_get_header_positions(list);
-
-    if (sections.length != MLHeaders.max + 1) {
-        diag("Differing amount of headers in unit test files.");
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.title][1]] != "Item 1") {
-        diag(`New item with title "Item 1" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.progress][1]] != "10/-") {
-        diag(`New item with progress "10/-" wasn't saved.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.status][1]] != "COMPLETE") {
-        diag(`New item with status "COMPLETE" wasn't saved.`);
-        return false;
-    }
-
-    if (sections[headerPositions[MLHeaders.startDate][1]] != "") {
-        diag(`New item does not have blank "start_date" field.`);
-        return false;
-    }
-    if (sections[headerPositions[MLHeaders.endDate][1]] != "") {
-        diag(`New item does not have blank "end_date" field.`);
-        return false;
-    }
-
-    DateTime currentDT = cast(DateTime)Clock.currTime;
-    string currentDS = format!"%d-%02d-%02d"(currentDT.year,
-        currentDT.month, currentDT.day);
-
-    if (sections[headerPositions[MLHeaders.lastUpdated][1]] != currentDS) {
-        diag(`New item was not "last_updated" with today's date.`);
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_fetchItem2()
-{
-    MediaList *list = ml_open_list(buildPath(getcwd(), "unittest_fetchItem2.tsv"));
-
-    if (null is list)
-        return false;
-
-    scope(exit) {
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError ec;
-
-    ec = ml_send_command(list, MLCommand.add, ["Item 1"]);
-    if (MLError.success != ec) {
-        diag("Failed to send add command [Item 1].");
-        return false;
-    }
-
-    ec = ml_send_command(list, MLCommand.add, ["Item 2", "1/-", "READING"]);
-    if (MLError.success != ec) {
-        diag("Failed to send add command [Item 2, 1/-, READING]");
-        return false;
-    }
-
-    MediaListItem item2 = ml_fetch_item(list, 2, &ec);
-    if (MLError.success != ec) {
-        diag(`Failed to fetch item 2 (ec = ` ~ to!string(ec) ~ `)`);
-        return false;
-    }
-
-    if ("Item 2" != item2.title) {
-        diag(`ml_fetch_item(2).title != "Item 2". (got: ` ~ item2.title ~ ")");
-        return false;
-    }
-
-    if ("1/-" != item2.progress) {
-        diag(`ml_fetch_item(2).progress != "1/-". (got: ` ~ item2.progress ~ ")");
-        return false;
-    }
-
-    if ("READING" != item2.status) {
-        diag(`ml_fetch_item(2).status != "READING". (got: ` ~ item2.status ~ ")");
-        return false;
-    }
-
-    return true;
-}
-
-/*
- * Emulate pre-0.2 medialist files to confirm that headers can be in any order
- * and that it is case-insensitive.
- */
-private bool unittest_checkPre02MLFileHeaderOrder()
-{
-    enum listName = "checkPre02MLFileHeaderOrder";
-    enum fileName = listName ~ ".tsv";
-
-    /* case-insensitive */
-    auto listFile = File(fileName, "w+");
-    listFile.writeln("TITLE\tPROGRESS\tSTATUS");
-    listFile.writeln("Item 1\t??/??\tUNKNOWN");
-    listFile.close();
-
-    MediaList *list = ml_open_list(fileName);
-
-    /* shouldn't crash */
-    MediaListHeader[] headers = ml_fetch_headers(list);
-    if (headers.length != 3) {
-        diag("headers.length != 3 (case IS sensitive)");
-        return false;
-    }
-
-    /* shouldn't crash */
-    MediaListItem[] items = ml_fetch_all(list);
-
-    ml_send_command(list, MLCommand.delete_, []);
-    ml_free_list(list);
-
-    listFile = File(fileName, "w+");
-    listFile.writeln ("PROGRESS\tTItLE\tstatus");
-    listFile.writeln ("??/??\tItem 1\tUNKNOWN");
-    listFile.close();
-
-    list = ml_open_list(fileName);
-    items = ml_fetch_all(list);
-
-    headers = ml_fetch_headers(list);
-    if (headers.length != 3) {
-        diag("headers.length != 3 (order IS hard-coded)");
-        return false;
-    }
-
-    ml_send_command(list, MLCommand.delete_, []);
-    ml_free_list(list);
-
-    return true;
-}
-
-private bool unittest_fetchItems124()
-{
-    enum listName = __FUNCTION__;
-    enum fileName = listName ~ ".tsv";
-
-    MediaList* list = ml_open_list(fileName);
-    if (null is list) {
-        diag("list returned from ml_open_list is null.");
-        return false;
-    }
-
-    scope (exit) {
-        /* delete the entire list and file. */
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError res;
-
-    res = ml_send_command(list, MLCommand.add, ["Item 1", "PLAN-TO-READ", "-/-"]);
-    if (MLError.success != res) {
-        diag("Couldn't add [Item 1, PLAN-TO-READ, -/-] to list.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.add, ["Item 2", "READING", "10/12"]);
-    if (MLError.success != res) {
-        diag("Couldn't add [Item 2, READING, 10/12] to list.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.add, ["Item 3"]);
-    if (MLError.success != res) {
-        diag("Couldn't add [Item 3] to list");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.add, ["Item 4", "COMPLETE", "123/123"]);
-    if (MLError.success != res) {
-        diag("Couldn't add [Item 4, COMPLETE, 123/123] to list.");
-        return false;
-    }
-
-    MediaListItem[] specificItems = ml_fetch_items(list, null, 1, 4, 2);
-    if (null is specificItems) {
-        diag("ml_fetch_items(list, 1, 4, 2) returned null.");
-        return false;
-    }
-
-    if (3 != specificItems.length) {
-        diag("ml_fetch_items(list, 1, 4, 2) didn't return 3 items.");
-        return false;
-    }
-
-    if ("Item 1" != specificItems[0].title) {
-        diag("specificItems[0].title != Item 1.");
-        return false;
-    }
-
-    if ("Item 2" != specificItems[1].title) {
-        diag("specificItems[1].title != Item 2.");
-        return false;
-    }
-
-    if ("Item 4" != specificItems[2].title) {
-        diag("specificItems[2].title != Item 4.");
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_updateItemTitle()
-{
-    enum listName = __FUNCTION__;
-    enum fileName = listName ~ ".tsv";
-
-    MediaList* list = ml_open_list(fileName);
-    if (list is null) {
-        diag("ml_open_list returned null.");
-        return false;
-    }
-
-    scope(exit) {
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError res;
-
-    res = ml_send_command(list, MLCommand.add, ["Ietm 1"]);
-    if (MLError.success != res) {
-        diag("ml_send_command(list, add, [Ietm 1]) failed.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.update, ["1", "title::Item 1"]);
-    if (MLError.success != res) {
-        diag("Failed to send UPDATE command [1, title::Item 1].");
-        return false;
-    }
-
-    MediaListItem item = ml_fetch_item(list, 1, &res);
-    if (MLError.success != res) {
-        diag("Failed to fetch item 1 from list.");
-        return false;
-    }
-
-    if ("Item 1" != item.title) {
-        diag("Failed to update title from 'Ietm 1' to 'Item 1'.");
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_updateItemStatus()
-{
-    enum listName = __FUNCTION__;
-    enum fileName = listName ~ ".tsv";
-
-    MediaList* list = ml_open_list(fileName);
-    if (list is null) {
-        diag("ml_open_list returned null.");
-        return false;
-    }
-
-    scope(exit) {
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError res;
-
-    res = ml_send_command(list, MLCommand.add, ["Item 1", null, "PLAN-TO-READ"]);
-    if (MLError.success != res) {
-        diag("ml_send_command(list, add, [Item 1, null, PLAN-TO-READ]) failed.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.update, ["1", "status::READING"]);
-    if (MLError.success != res) {
-        diag("Failed to send UPDATE command [1, status::READING].");
-        return false;
-    }
-
-    MediaListItem item = ml_fetch_item(list, 1, &res);
-    if (MLError.success != res) {
-        diag("Failed to fetch item 1 from list.");
-        return false;
-    }
-
-    if ("READING" != item.status) {
-        diag("Failed to update status from 'PLAN-TO-READ' to 'READING'.");
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_updateItemProgress()
-{
-    enum listName = __FUNCTION__;
-    enum fileName = listName ~ ".tsv";
-
-    MediaList* list = ml_open_list(fileName);
-    if (list is null) {
-        diag("ml_open_list returned null.");
-        return false;
-    }
-
-    scope(exit) {
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError res;
-
-    res = ml_send_command(list, MLCommand.add, ["Item 1"]);
-    if (MLError.success != res) {
-        diag("ml_send_command(list, add, [Item 1]) failed.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.update, ["1", "progress::10/10"]);
-    if (MLError.success != res) {
-        diag("Failed to send UPDATE command [1, progress::10/10].");
-        return false;
-    }
-
-    MediaListItem item = ml_fetch_item(list, 1);
-    if (false == item.valid) {
-        diag("Failed to fetch item 1 from list.");
-        return false;
-    }
-
-    if ("10/10" != item.progress) {
-        diag("Failed to update progress from '-/-' to '10/10'.");
-        return false;
-    }
-
-    return true;
-}
-
-private bool unittest_updateItemAll()
-{
-    enum listName = __FUNCTION__;
-    enum fileName = listName ~ ".tsv";
-
-    MediaList* list = ml_open_list(fileName);
-    if (list is null) {
-        diag("ml_open_list returned null.");
-        return false;
-    }
-
-    scope(exit) {
-        ml_send_command(list, MLCommand.delete_, []);
-        ml_free_list(list);
-    }
-
-    MLError res;
-
-    res = ml_send_command(list, MLCommand.add, ["Ietm 1"]);
-    if (MLError.success != res) {
-        diag("ml_send_command(list, add, [Ietm 1]) failed.");
-        return false;
-    }
-
-    res = ml_send_command(list, MLCommand.update,
-        ["1",
-        "start_date::2021-02-16",
-        "end_date::2022-01-20",
-        "progress::60/100",
-        "status::READING",
-        "title::MediaList"]
-    );
-    if (MLError.success != res) {
-        diag("Failed to send UPDATE command.");
-        return false;
-    }
-
-    MediaListItem item = ml_fetch_item(list, 1, &res);
-    if (MLError.success != res) {
-        diag("Failed to fetch item 1 from list.");
-        return false;
-    }
-
-    if ("MediaList" != item.title) {
-        diag("Failed to update item title from 'Ietm 1' to 'MediaList'.");
-        return false;
-    }
-
-    if ("60/100" != item.progress) {
-        diag("Failed to update progress from '-/-' to '60/100'.");
-        return false;
-    }
-
-    if ("READING" != item.status) {
-        diag("Failed to update status from 'UNKNOWN' to 'READING'.");
-        return false;
-    }
-
-    if ("2021-02-16" != item.startDate) {
-        diag("Failed to update start_date from '' to '2021-02-16'.");
-        return false;
-    }
-
-    if ("2022-01-20" != item.endDate) {
-        diag("Failed to update end_date from '' to '2022-01-20'.");
-        return false;
-    }
-
-    Date date = cast(Date)Clock.currTime;
-    string currentDate = format!"%d-%02d-%02d"(date.year, date.month, date.day);
-    if (currentDate != item.lastUpdated) {
-        diag("Failed to update last_update when running the UPDATE command.");
-        return false;
-    }
-
-    return true;
-}

--- a/unittests.d
+++ b/unittests.d
@@ -20,6 +20,12 @@ module unittests;
 
 version(unittest):
 
+import std.conv;
+import std.datetime.date;
+import std.file;
+import std.path;
+import std.string;
+
 import medialist;
 import tap;
 
@@ -40,9 +46,7 @@ void main()
 {
     alias tests = Tuple!(__traits(getUnitTests, unittests));
 
-    plan(TAPPlan.noPlan);
-    runMediaListUnitTests();
-
+    plan(tests.length);
 
     foreach(i, test; tests) {
         alias attributes = Tuple!(__traits(getAttributes, tests[i]));
@@ -171,7 +175,7 @@ unittest
     assert(MLError.success == err, "Failed to send ADD command [Item 1].");
 
     string currentDate = format!"%d-%02d-%02d"(date.year, date.month, date.day);
-    
+
     MediaListItem item = ml_fetch_item(ml, 1, &err);
     assert(MLError.success == err, "Failed to FETCH item ID 1.");
     assert(item.lastUpdated == currentDate,
@@ -198,7 +202,7 @@ unittest
 
     MediaList* ml = ml_open_list(fileName);
     assert(ml !is null, "ml_open_list returned null.");
-    
+
     scope (exit) {
         ml_send_command(ml, MLCommand.delete_, []);
         ml_free_list(ml);
@@ -207,7 +211,7 @@ unittest
     File listFile = File(fileName, "a+");
     listFile.writeln("4d4545979a\tUNKNOWN\t??/??"); // id will be 1
     listFile.close();
-    
+
     MLError err = ml_send_command(ml, MLCommand.update, ["1", "progress::-/-"]);
     assert(MLError.success == err, "Failed to send UPDATE command [1, progress::-/-].");
 
@@ -248,3 +252,590 @@ unittest
     assert("" != sections[lu_index],
         `Missing "last_updated" value after updating pre-0.2 list.`);
 }
+
+@(`Create a new list.`)
+unittest
+{
+    const listPath = buildPath(tempDir(), "unittest1.tsv");
+    scope(exit) remove(listPath);
+
+    MediaList* list = ml_open_list(listPath);
+    scope(exit) ml_free_list(list);
+
+    assert(null !is list, "Memory allocation failed (list is null).");
+    assert(true == exists(listPath), "A new file wasn't created for the list.");
+
+    MediaListHeader[] headers = ml_fetch_headers(list, null);
+    assert(null !is headers, "Failed to parse headers");
+
+    foreach(const ref header; headers) {
+        assert(null !is header.tsvName, "Failed to find header line in mTSV file");
+    }
+}
+
+@(`Can add a new item with no progress or status.`)
+unittest
+{
+    const listPath = buildPath(tempDir(), "unittest2.tsv");
+    scope(exit) remove(listPath);
+
+    MediaList* list = ml_open_list(listPath);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope(exit) ml_free_list(list);
+
+    MLError res = ml_send_command(list, MLCommand.add, ["Item 1"]);
+    assert(res == MLError.success, `Failed to send MLCommand.add ["Item 1"].`);
+
+    auto f = File(listPath);
+    string line;
+    bool readHeader = false;
+    string[] sections;
+
+    while ((line = f.readln) !is null) {
+        if (line[0] == '#')
+            continue;
+
+        if (false == readHeader) {
+            readHeader = true;
+            continue;
+        }
+
+        sections = line.strip().split("\t");
+        break;
+    }
+
+    Date currentD = cast(Date)Clock.currTime;
+    string currentDS = format!"%d-%02d-%02d"(currentD.year,
+        currentD.month, currentD.day);
+
+    MediaListHeader[] headers = ml_fetch_headers(list, null);
+    assert(null !is headers, "Failed to fetch headers from list.");
+    assert(sections.length == headers.length,
+        "Differing amount of headers in unit test file.");
+
+    foreach(const ref header; headers) {
+        switch (header.tsvName) {
+        case "title":
+            assert("Item 1" == sections[header.column],
+                `New item with title "Item 1" wasn't saved.`);
+            break;
+        case "progress":
+            assert("-/-" == sections[header.column],
+                `New item with unspecified progress wasn't "-/-".`);
+            break;
+        case "status":
+            assert("UNKNOWN" == sections[header.column],
+                `New item with unspecified status wasn't "UNKNOWN".`);
+            break;
+        case "start_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "start_date" field.`);
+            break;
+        case "end_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "end_date" field.`);
+            break;
+        case "last_updated":
+            assert(currentDS == sections[header.column],
+                `New item was not "last_updated" with today's date.`);
+            break;
+        default:
+            assert(false, "Unknown header: " ~ header.tsvName);
+        }
+    }
+}
+
+@(`Can add a new item with progress but no status.`)
+unittest
+{
+    const listPath = buildPath(tempDir(), "unittest3.tsv");
+    scope(exit) remove(listPath);
+
+    MediaList* list = ml_open_list(listPath);
+    assert(null !is list, "Failed to allocate memory for list.");
+    scope(exit) ml_free_list(list);
+
+    MLError res = ml_send_command(list, MLCommand.add, ["Item 1", "10/-"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add with ["Item 1", "10/-"].`);
+
+    auto f = File(listPath);
+    string line;
+    bool readHeader = false;
+    string[] sections;
+
+    while ((line = f.readln) !is null) {
+        if (line[0] == '#')
+            continue;
+
+        if (false == readHeader) {
+            readHeader = true;
+            continue;
+        }
+
+        sections = line.strip().split("\t");
+    }
+
+    Date currentD = cast(Date)Clock.currTime;
+    string currentDS = format!"%d-%02d-%02d"(currentD.year,
+        currentD.month, currentD.day);
+
+    MediaListHeader[] headers = ml_fetch_headers(list, null);
+    assert(null !is headers, "Failed to fetch headers from list.");
+    assert(sections.length == headers.length,
+        "Differing amount of headers in unit test file.");
+
+    foreach(const ref header; headers) {
+        switch (header.tsvName) {
+        case "title":
+            assert("Item 1" == sections[header.column],
+                `New item with title "Item 1" wasn't saved.`);
+            break;
+        case "progress":
+            assert("10/-" == sections[header.column],
+                `New item with progress "10/-" wasn't saved.`);
+            break;
+        case "status":
+            assert("UNKNOWN" == sections[header.column],
+                `New item with unspecified status wasn't "UNKNOWN".`);
+            break;
+        case "start_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "start_date" field.`);
+            break;
+        case "end_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "end_date" field.`);
+            break;
+        case "last_updated":
+            assert(currentDS == sections[header.column],
+                `New item was not "last_updated" with today's date.`);
+            break;
+        default:
+            assert(false, "Unknown header: " ~ header.tsvName);
+        }
+    }
+}
+
+@(`Can add a new item with status but no progress.`)
+unittest
+{
+    const listPath = buildPath(tempDir(), "unittest3.tsv");
+    scope(exit) remove(listPath);
+
+    MediaList* list = ml_open_list(listPath);
+    assert(null !is list, "Failed to allocate memory for list.");
+    scope(exit) ml_free_list(list);
+
+    MLError res = ml_send_command(list, MLCommand.add,
+        ["Item 1", null, "COMPLETE"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add with ["Item 1", null, "COMPLETE"].`);
+
+    auto f = File(listPath);
+    string line;
+    bool readHeader = false;
+    string[] sections;
+
+    while ((line = f.readln) !is null) {
+        if (line[0] == '#')
+            continue;
+
+        if (false == readHeader) {
+            readHeader = true;
+            continue;
+        }
+
+        sections = line.strip().split("\t");
+    }
+
+    Date currentD = cast(Date)Clock.currTime;
+    string currentDS = format!"%d-%02d-%02d"(currentD.year,
+        currentD.month, currentD.day);
+
+    MediaListHeader[] headers = ml_fetch_headers(list, null);
+    assert(null !is headers, "Failed to fetch headers from list.");
+    assert(sections.length == headers.length,
+        "Differing amount of headers in unit test file.");
+
+    foreach(const ref header; headers) {
+        switch (header.tsvName) {
+        case "title":
+            assert("Item 1" == sections[header.column],
+                `New item with title "Item 1" wasn't saved.`);
+            break;
+        case "progress":
+            assert("-/-" == sections[header.column],
+                `New item with unspecified progress wasn't "-/-".`);
+            break;
+        case "status":
+            assert("COMPLETE" == sections[header.column],
+                `New item with status "COMPLETE" wasn't saved.`);
+            break;
+        case "start_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "start_date" field.`);
+            break;
+        case "end_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "end_date" field.`);
+            break;
+        case "last_updated":
+            assert(currentDS == sections[header.column],
+                `New item was not "last_updated" with today's date.`);
+            break;
+        default:
+            assert(false, "Unknown header: " ~ header.tsvName);
+        }
+    }
+}
+
+@(`Can add a new item with progress and status.`)
+unittest
+{
+    const listPath = buildPath(tempDir(), "unittest3.tsv");
+    scope(exit) remove(listPath);
+
+    MediaList* list = ml_open_list(listPath);
+    assert(null !is list, "Failed to allocate memory for list.");
+    scope(exit) ml_free_list(list);
+
+    MLError res = ml_send_command(list, MLCommand.add,
+        ["Item 1", "10/-", "COMPLETE"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add with ["Item 1", "10/-", "COMPLETE"].`);
+
+    auto f = File(listPath);
+    string line;
+    bool readHeader = false;
+    string[] sections;
+
+    while ((line = f.readln) !is null) {
+        if (line[0] == '#')
+            continue;
+
+        if (false == readHeader) {
+            readHeader = true;
+            continue;
+        }
+
+        sections = line.strip().split("\t");
+    }
+
+    Date currentD = cast(Date)Clock.currTime;
+    string currentDS = format!"%d-%02d-%02d"(currentD.year,
+        currentD.month, currentD.day);
+
+    MediaListHeader[] headers = ml_fetch_headers(list, null);
+    assert(null !is headers, "Failed to fetch headers from list.");
+    assert(sections.length == headers.length,
+        "Differing amount of headers in unit test file.");
+
+    foreach(const ref header; headers) {
+        switch (header.tsvName) {
+        case "title":
+            assert("Item 1" == sections[header.column],
+                `New item with title "Item 1" wasn't saved.`);
+            break;
+        case "progress":
+            assert("10/-" == sections[header.column],
+                `New item with progress "10/-" wasn't saved.`);
+            break;
+        case "status":
+            assert("COMPLETE" == sections[header.column],
+                `New item with status "COMPLETE" wasn't saved.`);
+            break;
+        case "start_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "start_date" field.`);
+            break;
+        case "end_date":
+            assert("" == sections[header.column],
+                `New item does not have blank "end_date" field.`);
+            break;
+        case "last_updated":
+            assert(currentDS == sections[header.column],
+                `New item was not "last_updated" with today's date.`);
+            break;
+        default:
+            assert(false, "Unknown header: " ~ header.tsvName);
+        }
+    }
+}
+
+@(`Can fetch a singular item by ID (2).`)
+unittest
+{
+    MediaList* list = null;
+    list = ml_open_list(buildPath(getcwd(), "unittest_fetchItem2.tsv"));
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope(exit) {
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError ec;
+
+    ec = ml_send_command(list, MLCommand.add, ["Item 1"]);
+    assert(MLError.success == ec, `Failed to send MLCommand.add ["Item 1"].`);
+
+    ec = ml_send_command(list, MLCommand.add, ["Item 2", "1/-", "READING"]);
+    assert(MLError.success == ec,
+        `Failed to send MLCommand.add ["Item 2", "1/-", "READING"].`);
+
+    MediaListItem item2 = ml_fetch_item(list, 2, &ec);
+    assert(MLError.success == ec,
+        `Failed to fetch item 2 (ec == ` ~ to!string(ec) ~ `).`);
+
+    assert("Item 2" == item2.title,
+        `ml_fetch_item(2).title != "Item 2" (got: ` ~ item2.title ~ `).`);
+    assert("1/-" == item2.progress,
+        `ml_fetch_item(2).progress != "1/-" (got: ` ~ item2.progress ~ `).`);
+    assert("READING" == item2.status,
+        `ml_fetch_item(2).status != "READING" (got: ` ~  item2.status ~ `).`);
+    assert("" == item2.startDate,
+        `ml_fetch_item(2).startDate != "" (got: ` ~ item2.startDate ~ `).`);
+    assert("" == item2.endDate,
+        `ml_fetch_item(2).endDate != "" (got: ` ~ item2.endDate ~ `).`);
+}
+
+/*
+ * Emulate pre-0.2 medialist files to confirm that headers can be in any order
+ * and that it is case-insensitive.
+ */
+@(`Check header position variance and case-insensitivity.`)
+unittest
+{
+    enum listName = "checkPre02MLFileHeaderOrder";
+    enum fileName = listName ~ ".tsv";
+
+    /* case-insensitive */
+    auto listFile = File(fileName, "w+");
+    listFile.writeln("TITLE\tPROGRESS\tSTATUS");
+    listFile.writeln("Item 1\t??/??\tUNKNOWN");
+    listFile.close();
+
+    MediaList *list = ml_open_list(fileName);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    /* shouldn't crash */
+    MediaListHeader[] headers = ml_fetch_headers(list);
+    assert(3 == headers.length, "ml_fetch_headers IS case-sensitive.");
+
+    /* shouldn't crash */
+    MediaListItem[] items = ml_fetch_all(list);
+
+    ml_send_command(list, MLCommand.delete_, []);
+    ml_free_list(list);
+
+    listFile = File(fileName, "w+");
+    listFile.writeln ("PROGRESS\tTItLE\tstatus");
+    listFile.writeln ("??/??\tItem 1\tUNKNOWN");
+    listFile.close();
+
+    list = ml_open_list(fileName);
+    items = ml_fetch_all(list);
+
+    headers = ml_fetch_headers(list);
+    assert(3 == headers.length, "ml_fetch_headers USES hard-coded positions");
+
+    ml_send_command(list, MLCommand.delete_, []);
+    ml_free_list(list);
+}
+
+@(`Can fetch multiple items by ID (1, 4, and 2).`)
+unittest
+{
+    enum listName = __FUNCTION__;
+    enum fileName = listName ~ ".tsv";
+
+    MediaList* list = ml_open_list(fileName);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope (exit) {
+        /* delete the entire list and file. */
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError res;
+
+    res = ml_send_command(list, MLCommand.add, ["Item 1", "PLAN-TO-READ", "-/-"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 1", "PLAN-TO-READ", "-/-"].`);
+
+    res = ml_send_command(list, MLCommand.add, ["Item 2", "READING", "10/12"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 2", "READING", "10/12".`);
+
+    res = ml_send_command(list, MLCommand.add, ["Item 3"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 3"].`);
+
+    res = ml_send_command(list, MLCommand.add, ["Item 4", "COMPLETE", "123/123"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 4", "COMPLETE", "123/123"].`);
+
+    MediaListItem[] specificItems = ml_fetch_items(list, null, 1, 4, 2);
+    assert(null !is specificItems,
+        `ml_fetch_items(list, null, 1, 4, 2) returned null.`);
+
+    assert(3 == specificItems.length,
+        `ml_fetch_items(list, null, 1, 4, 2) didn't return 3 items.`);
+
+    assert("Item 1" == specificItems[0].title,
+        `specificItems[0].title != "Item 1".`);
+
+    assert("Item 2" == specificItems[1].title,
+        `specificItems[1].title != "Item 2".`);
+
+    assert("Item 4" == specificItems[2].title,
+        `specificItems[2].title != "Item 4".`);
+}
+
+@(`Can update an item's title.`)
+unittest
+{
+
+    enum listName = __FUNCTION__;
+    enum fileName = listName ~ ".tsv";
+
+    MediaList* list = ml_open_list(fileName);
+    assert(null !is list, `Failed to allocate memory for list.`);
+
+    scope(exit) {
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError res;
+
+    res = ml_send_command(list, MLCommand.add, ["Ietm 1"]);
+    assert(MLError.success == res, `Failed to send MLCommand.add ["Ietm 1"].`);
+
+    res = ml_send_command(list, MLCommand.update, ["1", "title::Item 1"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.update ["1", "title::Item 1"].`);
+
+    MediaListItem item = ml_fetch_item(list, 1, &res);
+    assert(MLError.success == res, `Failed to fetch item 1 from list.`);
+
+    assert("Item 1" == item.title,
+        `Failed to update title from "Ietm 1" to "Item 1".`);
+}
+
+@(`Can update an item's status.`)
+unittest
+{
+    enum listName = __FUNCTION__;
+    enum fileName = listName ~ ".tsv";
+
+    MediaList* list = ml_open_list(fileName);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope(exit) {
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError res;
+
+    res = ml_send_command(list, MLCommand.add, ["Item 1", null, "PLAN-TO-READ"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 1", null, "PLAN-TO-READ"].`);
+
+    res = ml_send_command(list, MLCommand.update, ["1", "status::READING"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.update ["1", "status::READING"].`);
+
+    MediaListItem item = ml_fetch_item(list, 1, &res);
+    assert(MLError.success == res, `Failed to fetch item 1 from list.`);
+
+    assert("READING" == item.status,
+        `Failed to update status from "PLAN-TO-READ" to "READING".`);
+}
+
+@(`Can update an item's progress.`)
+unittest
+{
+    enum listName = __FUNCTION__;
+    enum fileName = listName ~ ".tsv";
+
+    MediaList* list = ml_open_list(fileName);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope(exit) {
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError res;
+
+    res = ml_send_command(list, MLCommand.add, ["Item 1"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Item 1"].`);
+
+    res = ml_send_command(list, MLCommand.update, ["1", "progress::10/10"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.update ["1", "progress::10/10"].`);
+
+    MediaListItem item = ml_fetch_item(list, 1);
+    assert(true == item.valid, `Failed to fetch item 1 from list.`);
+    assert("10/10" == item.progress,
+        `Failed to update progress from "-/-" to "10/10".`);
+}
+
+@(`Can update all aspects of an item.`)
+unittest
+{
+    enum listName = __FUNCTION__;
+    enum fileName = listName ~ ".tsv";
+
+    MediaList* list = ml_open_list(fileName);
+    assert(null !is list, "Failed to allocate memory for list.");
+
+    scope(exit) {
+        ml_send_command(list, MLCommand.delete_, []);
+        ml_free_list(list);
+    }
+
+    MLError res;
+
+    res = ml_send_command(list, MLCommand.add, ["Ietm 1"]);
+    assert(MLError.success == res,
+        `Failed to send MLCommand.add ["Ietm1"].`);
+
+    res = ml_send_command(list, MLCommand.update,
+        ["1",
+        "start_date::2021-02-16",
+        "end_date::2022-01-20",
+        "progress::60/100",
+        "status::READING",
+        "title::MediaList"]
+    );
+    assert(MLError.success == res,
+        `Failed to send MLCommand.update ["1", "start_date::2021-02-16", ` ~
+            `"end_date::2022-01-20", "progress::60/100", "status::READING", ` ~
+            `"title::MediaList"].`);
+
+    MediaListItem item = ml_fetch_item(list, 1, &res);
+    assert(MLError.success == res, `Failed to fetch item 1 from list.`);
+
+    assert("MediaList" == item.title,
+        `Failed to update item title from "Ietm 1" to "MediaList".`);
+    assert("60/100" == item.progress,
+        `Failed to update item progress from "-/-" to "60/100".`);
+    assert("READING" == item.status,
+        `Failed to update item status from "UNKNOWN" to "READING".`);
+    assert("2021-02-16" == item.startDate,
+        `Failed to update item start date from "" to "2021-02-16".`);
+    assert("2022-01-20" == item.endDate,
+        `Failed to update item end date from "" to "2022-01-20".`);
+
+    Date date = cast(Date)Clock.currTime;
+    string currentDate = format!"%d-%02d-%02d"(date.year, date.month, date.day);
+    assert(currentDate == item.lastUpdated,
+        `Failed to update item's last_update when sending MLCommand.update.`);
+}