From 4b91478dd762881f81300bbcbb2edc6fcabc536b Mon Sep 17 00:00:00 2001 From: jsteuer <jan.steuer.htw@gmail.com> Date: Tue, 17 Dec 2019 09:05:14 +0100 Subject: [PATCH] add unit tests --- src/Helpers.ts | 125 ++++++++++++++++++++++++++++------------- 1 files changed, 86 insertions(+), 39 deletions(-) diff --git a/src/Helpers.ts b/src/Helpers.ts index 3ec398c..c1b69ec 100644 --- a/src/Helpers.ts +++ b/src/Helpers.ts @@ -1,18 +1,17 @@ /// <reference path="../mathcoach-api.d.ts"/> + /** * Hilfsfunktionen für Werkzeug-Entwickler. Diese werden nicht durch die `ide-lib.js` * ausgeliefert! */ export namespace Helpers { + /** * Bildet die MathCoach API nach, sodass diese auch Offline (ohne IDE) - * verfügbar ist. - * - * Das Dateisystem wird durch den LocalStorage des Browsers implementiert. - * Einige Features der IDE (beispielsweise der Navigator) sind nicht verfügbar - * und führen keine Aktionen durch. Alle Aktionen werden in der Browser-Console - * geloggt. + * verfügbar ist. Aktuell wird eine Implementierung auf Basis des LocalStorage + * verwendet. Funktionen wie der Navigator sind nicht verfügbar. Alle API Aufrufe + * werden in der Browser-Console geloggt. * * **Hinweis**: Wenn die echte MathCoach-API der IDE verfügbar ist, hat der Aufruf * dieser Funktion keinen Seiteneffekt. @@ -21,7 +20,7 @@ * * import { Helpers } from "@mathcoach/ide-api"; * Helpers.enableOfflineUsageIfNecessary(); - * + * MC.isReady() // use the api * * @param contextFileExtension Datei-Erweiterung der Kontext-Datei (Das Werkzeug soll * jedoch unabhängig von der Endung arbeiten können) @@ -29,11 +28,34 @@ * wurde, andernfalls `false` */ export function enableOfflineUsageIfNecessary(contextFileExtension: string = "dummy.json"): boolean { + if (typeof MC === "undefined") { + console.warn("you are offline - offline api is used"); + const WINDOW = (typeof window === "undefined") ? {} as any : window; + WINDOW.MC = createStorageBasedApi(contextFileExtension); + return true; + } else { + return false; + } + } + /** + * Implementierung der MathCoach IDE API zu Testzwecken. + * + * Das Dateisystem wird durch den LocalStorage des Browsers (oder InMemory) implementiert. + * Einige Features der IDE (beispielsweise der Navigator) sind nicht verfügbar + * und führen keine Aktionen durch. Alle Aktionen werden in der Browser-Console + * geloggt. + * + * Anwendungsbeispiel + * + * const MC = new LocalStorageBasedApi(); + * const contextFile = await MC.ide.getContextFile() // use the api + */ + export function createStorageBasedApi(contextFileExtension: string = "dummy.json"): MathCoach.Api { const fileIdentifier = (file: MathCoach.File) => `mock-file://${file.owner}@${file.part}/${file.path}`; const traceMethod = (method: string, args?: any[]) => console.log(["[MC MOCK API]", " ", method, "(", (args ? args : [""]).join(","), ")"].join("")); - - class MockAPI implements MathCoach.Api { + let storage: Storage = (typeof localStorage === "undefined") ? new InMemoryStorage() : localStorage; + class LocalStorageBasedApi implements MathCoach.Api { public ide: MathCoach.IdeApi = { async getContextFile(): Promise<MathCoach.File> { @@ -51,11 +73,11 @@ fs: { async readFile(file: MathCoach.File) { traceMethod("MC.ide.fs.readFile", [JSON.stringify(file)]); - return localStorage.getItem(fileIdentifier(file)) || ""; + return storage.getItem(fileIdentifier(file)) || ""; }, async writeFile(file: MathCoach.File, text: string) { traceMethod("MC.ide.fs.writeFile", [JSON.stringify(file), JSON.stringify(`...${text.length} chars...`)]); - return localStorage.setItem(fileIdentifier(file), text); + return storage.setItem(fileIdentifier(file), text); } }, navigator: { @@ -68,20 +90,27 @@ } }; public async isReady(): Promise<boolean> { - traceMethod("MC.isReady()"); + traceMethod("MC.isReady"); return true; } } - if (typeof MC === "undefined") { - console.warn("you are offline - offline api is used"); - (window as any).MC = new MockAPI(); // fake the MathCoach-API - return true; - } else { - return false; - } + return new LocalStorageBasedApi(); } + /** + * Type Guard, der prüft, ob es sich um eine gültige `MathCoach.File`-Referenz handelt. + * + * @param maybeFile Ein beliebiges Objekt, das geprüft werden soll + */ + export function isFile(maybeFile: any): maybeFile is MathCoach.File { + return (maybeFile ? true : false) + && (maybeFile.owner ? true : false) && (typeof maybeFile.owner === "string") + && (maybeFile.part ? true : false) && (typeof maybeFile.part === "string") + && (maybeFile.part === "vfs" || maybeFile.part === "www") + && (maybeFile.path ? true : false) && (typeof maybeFile.path === "string") + && (maybeFile.path.indexOf("/") === 0) + } /** @@ -101,29 +130,47 @@ * const exerciseFile: MathCoach.File = Helpers.contextFileToExerciseFile(contextFile); */ export function contextFileToExerciseFile(contextFile: MathCoach.File): MathCoach.File { - if (contextFile) { - if (!contextFile.owner || !(typeof contextFile.owner === "string") || !(contextFile.owner.trim() === "")) { - throw new Error("Context file has no valid 'owner' property."); - } - if (!contextFile.part || !(typeof contextFile.part === "string")) { - if (contextFile.part !== "vfs" && contextFile.part !== "www") { - throw new Error("Context file has no valid 'part' property. Allowed values are 'vfs' and 'www'."); - } - } - if (!contextFile.path || !(typeof contextFile.path === "string") || !(contextFile.owner.trim().startsWith("/"))) { - throw new Error("Context file has no valid 'path' property."); - } + if (isFile(contextFile)) { + let exerciseFile: MathCoach.File = { + part: contextFile.part, + owner: contextFile.owner, + path: contextFile.path.split(".")[0] + ".groovy" + }; + return exerciseFile; } else { - throw new Error("No context file object given.") + throw new Error("no valid file reference given, expected object like {owner:'demo', part:'vfs'|'www', path: '/...'}") } - let file: MathCoach.File = { - part: contextFile.part, - owner: contextFile.owner, - path: contextFile.path.split(".")[0] + ".groovy" - }; - return file; } + /** + * Storage auf Basis einer Map. Kann z.B. bei Unit-Tests verwendet + * werden, beid denen der LocalStorage nicht verfügbar ist. + */ + class InMemoryStorage implements Storage { + private readonly items: Map<string, string> = new Map(); -} \ No newline at end of file + get length(): number { + return this.items.size; + } + clear(): void { + this.items.clear(); + } + getItem(key: string): string | null { + const value = this.items.get(key); + return value ? value : null; + } + key(index: number): string | null { + throw new Error("FakeStorage: key function is not implemented now"); + } + removeItem(key: string): void { + this.items.delete(key); + } + setItem(key: string, value: string): void { + this.items.set(key, value); + } + + } + +} + -- Gitblit v1.10.0-SNAPSHOT