feat: create initial library

Author: lino-levan

.gitignore

@@ -0,0 +1,3 @@
+.vscode
+*.wav
+.DS_Store

README.md

@@ -0,0 +1,25 @@
+# deno-gtts
+
+A simple text-to-speech library using the google translate api. It is designed
+to be used either as a deno library or as a cli tool.
+
+## Usage
+
+```typescript
+import { save } from "https://deno.land/x/gtts/mod.ts";
+
+await save("./demo.wav", "This sentence is being read by a machine");
+```
+
+OR
+
+```bash
+deno install --allow-write --allow-net -n gtts https://deno.land/x/gtts/cli.ts
+gtts "some text to speak"
+gtts "some text to speak to a destination" --path="./test.wav"
+gtts "text but in a french accent" --lang=fr
+gtts "text at a destination but in a french accent" --path="./french.wav" --lang=fr
+```
+
+Very loosely inspired by
+[this nightmare of a library](https://github.com/lino-levan/better-node-gtts)

cli.ts

@@ -0,0 +1,24 @@
+import { parse } from "./deps.ts";
+import { save } from "./mod.ts";
+import { LANGUAGES } from "./src/languages.ts";
+
+const args = parse(Deno.args, {
+  string: ["lang", "path"],
+  alias: {
+    "L": "lang",
+    "P": "path",
+  },
+});
+
+const text = args._.join(" ");
+const language = args.lang as keyof typeof LANGUAGES ?? "en-us";
+const path = args.path ??
+  "./" + text.slice(0, 10).replace(/([^a-z0-9]+)/gi, "-") + ".wav";
+
+if (!Object.hasOwn(LANGUAGES, language)) {
+  throw `Invalid language: ${language}`;
+}
+
+await save(path, text, {
+  language,
+});

deps.ts

@@ -0,0 +1,3 @@
+export { writeAll } from "https://deno.land/[email protected]/streams/write_all.ts";
+export { assert } from "https://deno.land/[email protected]/testing/asserts.ts";
+export { parse } from "https://deno.land/[email protected]/flags/mod.ts";

mod.ts

@@ -0,0 +1,61 @@
+import { writeAll } from "./deps.ts";
+import { LANGUAGES } from "./src/languages.ts";
+
+const GOOGLE_TTS_URL = "http://translate.google.com/translate_tts";
+const headers = {
+  "User-Agent":
+    "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebKit/536.26.17 (KHTML like Gecko) Version/6.0.2 Safari/536.26.17",
+};
+
+function tokenize(text: string) {
+  return text.split(/¡|!|\(|\)|\[|\]|\¿|\?|\.|\,|\;|\:|\—|\«|\»|\n/).filter(
+    (p) => p,
+  );
+}
+
+export interface SaveOptions {
+  language: keyof typeof LANGUAGES;
+}
+
+export async function save(
+  path: string,
+  text: string,
+  options?: Partial<SaveOptions>,
+) {
+  const config: SaveOptions = {
+    ...{
+      language: "en-us",
+    },
+    ...options,
+  };
+  const textParts = tokenize(text);
+
+  try {
+    await Deno.remove(path);
+  } catch {
+    // swallow error
+  }
+
+  const file = await Deno.open(path, {
+    create: true,
+    append: true,
+    write: true,
+  });
+
+  for (const [i, part] of Object.entries(textParts)) {
+    const encodedText = encodeURIComponent(part);
+    const args =
+      `?ie=UTF-8&tl=${config.language}&q=${encodedText}&total=${textParts.length}&idx=${i}&client=tw-ob&textlen=${encodedText.length}`;
+    const url = GOOGLE_TTS_URL + args;
+
+    const req = await fetch(url, {
+      headers,
+    });
+    const buffer = await req.arrayBuffer();
+    const data = new Uint8Array(buffer);
+
+    await writeAll(file, data);
+  }
+
+  file.close();
+}

mod_test.ts

@@ -0,0 +1,24 @@
+import { assert } from "./deps.ts";
+import { save } from "./mod.ts";
+
+async function exists(path: string) {
+  try {
+    await Deno.lstat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+Deno.test("saving short text works", async () => {
+  await save("./test.wav", "Testing a basic string");
+  assert(await exists("./test.wav"));
+});
+
+Deno.test("saving long text also works", async () => {
+  await save(
+    "./long.wav",
+    "Testing a very long string. One with multiple periods and, maybe even some commas. The grammar is completely off, but that is part of the fun of the string experience. They will never know how this is set up. No one will read the tests for this module. I hope not at least.",
+  );
+  assert(await exists("./long.wav"));
+});

src/languages.ts

@@ -0,0 +1,53 @@
+export const LANGUAGES = {
+  af: "Afrikaans",
+  sq: "Albanian",
+  ar: "Arabic",
+  hy: "Armenian",
+  ca: "Catalan",
+  zh: "Chinese",
+  "zh-cn": "Chinese (Mandarin/China)",
+  "zh-tw": "Chinese (Mandarin/Taiwan)",
+  "zh-yue": "Chinese (Cantonese)",
+  hr: "Croatian",
+  cs: "Czech",
+  da: "Danish",
+  nl: "Dutch",
+  en: "English",
+  "en-au": "English (Australia)",
+  "en-uk": "English (United Kingdom)",
+  "en-us": "English (United States)",
+  eo: "Esperanto",
+  fi: "Finnish",
+  fr: "French",
+  de: "German",
+  el: "Greek",
+  ht: "Haitian Creole",
+  hi: "Hindi",
+  hu: "Hungarian",
+  is: "Icelandic",
+  id: "Indonesian",
+  it: "Italian",
+  ja: "Japanese",
+  ko: "Korean",
+  la: "Latin",
+  lv: "Latvian",
+  mk: "Macedonian",
+  no: "Norwegian",
+  pl: "Polish",
+  pt: "Portuguese",
+  "pt-br": "Portuguese (Brazil)",
+  ro: "Romanian",
+  ru: "Russian",
+  sr: "Serbian",
+  sk: "Slovak",
+  es: "Spanish",
+  "es-es": "Spanish (Spain)",
+  "es-us": "Spanish (United States)",
+  sw: "Swahili",
+  sv: "Swedish",
+  ta: "Tamil",
+  th: "Thai",
+  tr: "Turkish",
+  vi: "Vietnamese",
+  cy: "Welsh",
+};