refactor: move core-tools to monorepo

packages/core-tools/src/util/collections.ts

@@ -0,0 +1,37 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {omitBy, isNil, reject, isEmpty, isArray, isObject} from 'lodash';
+
+/**
+ * Filters only defined elements
+ */
+export function rejectNil<T>(array: Array<T | undefined | null>): T[] {
+  return reject(array, isNil) as T[];
+}
+
+/**
+ * Map elements that are not null
+ */
+export function mapNotNil<T, S>(array: readonly T[], transform: (element: T) => S | undefined | null): S[] {
+  return rejectNil(array.map(transform));
+}
+
+/**
+ * Deletes all properties with the value 'undefined', [] or {}
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+export function cleanupEmpty<T extends object>(object: T): T {
+  return omitBy(object, it => isNil(it) || ((isObject(it) || isArray(it)) && isEmpty(it))) as T;
+}

packages/core-tools/src/util/guards.ts

@@ -0,0 +1,35 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {JSONSchema7 as JSONSchema} from 'json-schema';
+import {SchemaWithDefinitions} from '../types/schema';
+
+/**
+ * Guard for if a JSON schema is in fact a schema with definitions
+ */
+export function isSchemaWithDefinitions(schema: JSONSchema): schema is SchemaWithDefinitions {
+  return schema.definitions !== undefined;
+}
+
+/**
+ * Guard method for determining if an object (a thing) has a type property with a type of string
+ */
+export function isThingWithType(thing: unknown): thing is {type: string} {
+  return (
+    typeof thing === 'object' &&
+    thing !== null &&
+    'type' in thing &&
+    typeof (thing as {type: unknown}).type === 'string'
+  );
+}

packages/core-tools/src/util/io.ts

@@ -0,0 +1,38 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import {readdirSync, statSync} from 'fs';
+import {flatMap} from 'lodash';
+import path from 'path';
+
+/**
+ * Expand a path to a list of all files deeply contained in it
+ */
+export function expandPathToFilesSync(sourcePath: string, accept: (fileName: string) => boolean): string[] {
+  const fullPath = path.resolve(sourcePath);
+  const directory = statSync(fullPath);
+
+  return directory.isDirectory()
+    ? flatMap(readdirSync(fullPath), fragment =>
+        expandPathToFilesSync(path.resolve(sourcePath, fragment), accept),
+      )
+    : [fullPath].filter(accept);
+}
+
+/**
+ * Take a Windows path and make a Unix path out of it
+ */
+export function toUnixPath(pathString: string): string {
+  return pathString.replace(/\\/g, '/');
+}

packages/core-tools/src/util/posix-path.ts

@@ -0,0 +1,30 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+import path from 'path';
+import {PathLike} from 'fs';
+
+/**
+ * Convert a path to a POSIX path
+ *
+ * Replaces the system separator with posix separators
+ * Replaces Windows drive letters with a root '/'
+ */
+export function toPosixPath(pathLike: PathLike, separator = path.sep): string {
+  return pathLike
+    .toString()
+    .split(separator)
+    .join(path.posix.sep)
+    .replace(/^[A-z]:\//, '/');
+}

packages/core-tools/src/util/string.ts

@@ -0,0 +1,20 @@
+/*
+ * Copyright (C) 2021 StApps
+ * This program is free software: you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by the Free
+ * Software Foundation, version 3.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+ * more details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+/**
+ * Creates sentence cased string
+ */
+export function capitalize(string?: string): string {
+  return `${string?.charAt(0).toUpperCase()}${string?.slice(1).toLowerCase()}`;
+}