Merge pull request #47 from mProjectsCode/master

changes for release 0.3.2

Author: mProjectsCode

README.md

@@ -130,6 +130,15 @@ Now you select the result you want and the plugin will cast it's magic and creat
 You are more than welcome to open an issue on [GitHub](https://github.com/mProjectsCode/obsidian-media-db-plugin/issues).
 
 ### Changelog
+
+#### 0.3.2
+- Added Board Game Geek API (documentation pending)
+- More information in the search results
+- various fixes
+
+#### 0.3.1
+- various fixes
+
 #### 0.3.0
 - Added bulk import. Import a folder of media notes as Media DB entries (thanks to [PaperOrb](https://github.com/PaperOrb) on GitHub for their input and for helping me test this feature)
 - Added a custom result select modal that allows you to select multiple results at once

manifest.json

@@ -1,7 +1,7 @@
 {
 	"id": "obsidian-media-db-plugin",
 	"name": "Media DB Plugin",
-	"version": "0.3.1",
+	"version": "0.3.2",
 	"minAppVersion": "0.14.0",
 	"description": "A plugin that can query multiple APIs for movies, series, anime, games, music and wiki articles, and import them into your vault.",
 	"author": "Moritz Jung",

src/api/apis/BoardGameGeekAPI.ts

@@ -0,0 +1,104 @@
+import {APIModel} from '../APIModel';
+import {MediaTypeModel} from '../../models/MediaTypeModel';
+import MediaDbPlugin from '../../main';
+import {BoardGameModel} from 'src/models/BoardGameModel';
+import {debugLog} from '../../utils/Utils';
+import {requestUrl} from 'obsidian';
+import {MediaType} from '../../utils/MediaType';
+
+export class BoardGameGeekAPI extends APIModel {
+	plugin: MediaDbPlugin;
+
+	constructor(plugin: MediaDbPlugin) {
+		super();
+
+		this.plugin = plugin;
+		this.apiName = 'BoardGameGeekAPI';
+		this.apiDescription = 'A free API for BoardGameGeek things.';
+		this.apiUrl = 'https://api.geekdo.com/xmlapi';
+		this.types = ['boardgames'];
+	}
+
+	async searchByTitle(title: string): Promise<MediaTypeModel[]> {
+		console.log(`MDB | api "${this.apiName}" queried by Title`);
+
+		const searchUrl = `${this.apiUrl}/search?search=${encodeURIComponent(title)}`;
+		const fetchData = await requestUrl({
+			url: searchUrl,
+		});
+
+		if (fetchData.status !== 200) {
+			throw Error(`MDB | Received status code ${fetchData.status} from an API.`);
+		}
+
+		const data = fetchData.text;
+		const response = new window.DOMParser().parseFromString(data, "text/xml")
+
+		debugLog(response);
+
+		let ret: MediaTypeModel[] = [];
+
+		for (const boardgame of Array.from(response.querySelectorAll("boardgame"))) {
+			const id = boardgame.attributes.getNamedItem("objectid")!.value;
+			const title = boardgame.querySelector("name")!.textContent!;
+			const year = boardgame.querySelector("yearpublished")?.textContent ?? "";
+
+			ret.push(new BoardGameModel({
+				dataSource: this.apiName,
+				id,
+				title,
+				englishTitle: title,
+				year,
+			} as BoardGameModel));
+		}
+
+		return ret;
+	}
+
+	async getById(id: string): Promise<MediaTypeModel> {
+		console.log(`MDB | api "${this.apiName}" queried by ID`);
+
+		const searchUrl = `${this.apiUrl}/boardgame/${encodeURIComponent(id)}?stats=1`;
+		const fetchData = await requestUrl({
+			url: searchUrl,
+		});
+
+		if (fetchData.status !== 200) {
+			throw Error(`MDB | Received status code ${fetchData.status} from an API.`);
+		}
+
+		const data = fetchData.text;
+		const response = new window.DOMParser().parseFromString(data, "text/xml")
+		debugLog(response);
+
+		const boardgame = response.querySelector("boardgame")!;
+		const title = boardgame.querySelector("name")!.textContent!;
+		const year = boardgame.querySelector("yearpublished")?.textContent ?? "";
+		const image = boardgame.querySelector("image")?.textContent ?? undefined;
+		const onlineRating = Number.parseFloat(boardgame.querySelector("statistics ratings average")?.textContent ?? "");
+		const genres = Array.from(boardgame.querySelectorAll("boardgamecategory")).map(n => n!.textContent!);
+
+		const model = new BoardGameModel({
+			type: MediaType.BoardGame,
+			title,
+			englishTitle: title,
+			year: year === "0" ? "" : year,
+			dataSource: this.apiName,
+			url: `https://boardgamegeek.com/boardgame/${id}`,
+			id,
+
+			genres,
+			onlineRating,
+			image,
+			released: true,
+
+			userData: {
+				played: false,
+				personalRating: 0,
+			},
+		} as BoardGameModel);
+
+		return model;
+
+	}
+}

src/api/apis/SteamAPI.ts

@@ -100,7 +100,7 @@ export class SteamAPI extends APIModel {
 			englishTitle: result.name,
 			year: (new Date(result.release_date.date)).getFullYear().toString(),
 			dataSource: this.apiName,
-			url: `https://store.steampowered.com/app/${result.id}`,
+			url: `https://store.steampowered.com/app/${result.steam_appid}`,
 			id: result.steam_appid,
 
 			genres: result.genres?.map((x: any) => x.description) ?? [],

src/main.ts

@@ -12,6 +12,7 @@ import {WikipediaAPI} from './api/apis/WikipediaAPI';
 import {MusicBrainzAPI} from './api/apis/MusicBrainzAPI';
 import {MediaTypeManager} from './utils/MediaTypeManager';
 import {SteamAPI} from './api/apis/SteamAPI';
+import {BoardGameGeekAPI} from './api/apis/BoardGameGeekAPI';
 import {ModelPropertyMapper} from './settings/ModelPropertyMapper';
 import {YAMLConverter} from './utils/YAMLConverter';
 import {MediaDbFolderImportModal} from './modals/MediaDbFolderImportModal';
@@ -79,6 +80,7 @@ export default class MediaDbPlugin extends Plugin {
 		this.apiManager.registerAPI(new WikipediaAPI(this));
 		this.apiManager.registerAPI(new MusicBrainzAPI(this));
 		this.apiManager.registerAPI(new SteamAPI(this));
+		this.apiManager.registerAPI(new BoardGameGeekAPI(this));
 		// this.apiManager.registerAPI(new LocGovAPI(this)); // TODO: parse data
 
 		this.mediaTypeManager = new MediaTypeManager(this.settings);

src/modals/MediaDbSearchResultModal.ts

@@ -29,7 +29,7 @@ export class MediaDbSearchResultModal extends SelectModal<MediaTypeModel> {
 	// Renders each suggestion item.
 	renderElement(item: MediaTypeModel, el: HTMLElement) {
 		el.createEl('div', {text: this.plugin.mediaTypeManager.getFileName(item)});
-		el.createEl('small', {text: `${item.englishTitle}\n`});
+		el.createEl('small', {text: `${item.getSummary()}\n`});
 		el.createEl('small', {text: `${item.type.toUpperCase() + (item.subType ? ` (${item.subType})` : '')} from ${item.dataSource}`});
 	}
 

src/models/BoardGameModel.ts

@@ -0,0 +1,39 @@
+import {MediaTypeModel} from './MediaTypeModel';
+import {mediaDbTag} from '../utils/Utils';
+import {MediaType} from '../utils/MediaType';
+
+
+export class BoardGameModel extends MediaTypeModel {
+	genres: string[];
+	onlineRating: number;
+	image?: string;
+
+	released: boolean;
+
+	userData: {
+		played: boolean;
+		personalRating: number;
+	};
+
+
+	constructor(obj: any = {}) {
+		super();
+
+		Object.assign(this, obj);
+
+		this.type = this.getMediaType();
+	}
+
+	getTags(): string[] {
+		return [mediaDbTag, 'boardgame'];
+	}
+
+	getMediaType(): MediaType {
+		return MediaType.BoardGame;
+	}
+
+	getSummary(): string {
+		return this.englishTitle + ' (' + this.year + ')';
+	}
+
+}

src/models/GameModel.ts

@@ -42,4 +42,8 @@ export class GameModel extends MediaTypeModel {
 		return MediaType.Game;
 	}
 
+	getSummary(): string {
+		return this.englishTitle + ' (' + this.year + ')';
+	}
+
 }

src/models/MediaTypeModel.ts

@@ -14,6 +14,9 @@ export abstract class MediaTypeModel {
 
 	abstract getMediaType(): MediaType;
 
+	//a string that contains enough info to disambiguate from similar media
+	abstract getSummary(): string;
+
 	abstract getTags(): string[];
 
 	toMetaDataObject(): object {

src/models/MovieModel.ts

@@ -44,4 +44,7 @@ export class MovieModel extends MediaTypeModel {
 		return MediaType.Movie;
 	}
 
+	getSummary(): string {
+		return this.englishTitle + ' (' + this.year + ')';
+	}
 }