add get package docs

Author: pngwn

src/fs/fixtures/repo-1/packages/no-readme/README.md

@@ -0,0 +1,3 @@
+{
+	"name": "no-readme"
+}

src/fs/fixtures/repo-1/packages/no-readme/package.json

@@ -0,0 +1 @@
+random-extra-files

src/fs/fixtures/repo-1/packages/random-extra-files/README.md

@@ -0,0 +1,3 @@
+{
+	"name": "random-extra-files"
+}

src/fs/fixtures/repo-1/packages/random-extra-files/package.json

@@ -0,0 +1 @@
+standard-package

src/fs/fixtures/repo-1/packages/standard-package/README.md

@@ -0,0 +1,3 @@
+{
+	"name": "standard-package"
+}

src/fs/fixtures/repo-1/packages/standard-package/package.json

@@ -1,7 +1,10 @@
 import { suite } from "uvu";
 import * as assert from "uvu/assert";
 
-import { get_base_documentation } from "./get_content";
+import {
+	get_base_documentation,
+	get_package_docuementation,
+} from "./get_content";
 import * as path from "path";
 
 const repo = path.join(__dirname, "fixtures", "repo-1");
@@ -20,4 +23,17 @@ get_docs("gets the api documentation correctly", async () => {
 	]);
 });
 
+get_pkg_docs(
+	"get documentation for packages ignoring invaliud packages",
+	async () => {
+		const content = await get_package_docuementation("packages", repo);
+
+		assert.equal(content, [
+			["random-extra-files", "random-extra-files\n"],
+			["standard-package", "standard-package\n"],
+		]);
+	}
+);
+
 get_docs.run();
+get_pkg_docs.run();

src/fs/get_content.test.ts

@@ -5,15 +5,17 @@ interface BaseDocs {
 	api: [string, string][];
 }
 
+const fs_opts = {
+	encoding: "utf-8",
+} as const;
+
 function get_content_and_filename(
 	base: string,
 	filename: string
 ): Promise<[string, string]> {
 	return new Promise(async (rs, rj) => {
 		try {
-			const content = await fs.readFile(path.join(base, filename), {
-				encoding: "utf-8",
-			});
+			const content = await fs.readFile(path.join(base, filename), fs_opts);
 			rs([filename, content]);
 		} catch (e) {
 			rj(e);
@@ -39,7 +41,30 @@ export async function get_base_documentation(
 	};
 }
 
-export function get_package_docuementation(
+function get_pkg_and_readme(
+	base: string,
+	pkg_dir: string
+): Promise<[string, string] | false> {
+	return new Promise(async (rs, rj) => {
+		try {
+			const [pkg, docs] = await Promise.all([
+				fs.readFile(path.join(base, pkg_dir, "package.json"), fs_opts),
+				fs.readFile(path.join(base, pkg_dir, "README.md"), fs_opts),
+			]);
+			rs([JSON.parse(pkg).name, docs]);
+		} catch (e) {
+			rs(false);
+		}
+	});
+}
+
+export async function get_package_docuementation(
 	pkg_path: string,
 	working_directory: string = process.cwd()
-) {}
+) {
+	const pkg_dir = path.join(working_directory, pkg_path);
+	const packages = await fs.readdir(pkg_dir);
+	return (
+		await Promise.all(packages.map((f) => get_pkg_and_readme(pkg_dir, f)))
+	).filter(Boolean);
+}