feat(cli): add support for .po format (#275)

* feat(cli): add support for `.po` format

* chore: add `.po` example

Author: maxprilutskiy

.changeset/weak-fans-sort.md

@@ -0,0 +1,7 @@
+---
+"@replexica/spec": minor
+"@replexica/cli": minor
+"replexica": minor
+---
+
+add support for `.po` format

package/demo/po/en.po

@@ -0,0 +1,6 @@
+# This is a comment
+msgid "greeting"
+msgstr "Hello, {name}!"
+
+msgid "farewell"
+msgstr "Goodbye, {name}!"

package/demo/po/es.po

@@ -0,0 +1,5 @@
+msgid "greeting"
+msgstr "¡Hola, {name}!"
+
+msgid "farewell"
+msgstr "¡Adiós, {name}!"

package/i18n.json

@@ -40,6 +40,11 @@
         "demo/markdown/[locale]/ignored.md"
       ]
     },
+    "po": {
+      "include": [
+        "demo/po/[locale].po"
+      ]
+    },
     "properties": {
       "include": [
         "demo/properties/[locale].properties"

package/i18n.lock

@@ -178,3 +178,6 @@ checksums:
     home/title%2Fmain: ef1fb56b8dafd605fb267df2b0a8a91f
     home/description%2Fdev: b866f4d6b135451633de827fc20f4fdb
     home/i-am-a-developer: d8feacce28faea3fd4228a1ebcb11473
+  cd761e96e923fc52320b39dc7a0089c8:
+    greeting: a4028aa70eaa7049318f039837199173
+    farewell: 0361aa0c2874ff3ffca6c7ae87e1c73b

packages/cli/src/loaders/index.spec.ts

@@ -406,6 +406,73 @@ Otro párrafo con texto en **negrita** y en *cursiva*.
     });
   });
 
+  describe('po bucket loader', () => {
+    it('should load and handle various po data', async () => {
+      setupFileMocks();
+
+      const input = `
+# This is a comment
+msgid "greeting"
+msgstr "Hello, {name}!"
+
+msgid "farewell"
+msgstr "Goodbye, {name}!"
+
+# Another comment
+msgid "empty"
+msgstr ""
+      `.trim();
+      const expectedOutput = {
+        greeting: 'Hello, {name}!',
+        farewell: 'Goodbye, {name}!',
+        empty: ''
+      };
+
+      mockFileOperations(input);
+
+      const poLoader = createBucketLoader('po', 'i18n/[locale].po');
+      poLoader.setDefaultLocale('en');
+      const data = await poLoader.pull('en');
+
+      expect(data).toEqual(expectedOutput);
+    });
+
+    it('should save po data with variable patterns and comments', async () => {
+      setupFileMocks();
+
+      const input = `
+# This is a comment
+msgid "greeting"
+msgstr "Hello, {name}!"
+      `.trim();
+      const payload = {
+        greeting: '¡Hola, {name}!',
+        farewell: '¡Adiós, {name}!'
+      };
+      const expectedOutput = `
+msgid "greeting"
+msgstr "¡Hola, {name}!"
+
+msgid "farewell"
+msgstr "¡Adiós, {name}!"
+      `.trim() + '\n';
+
+      mockFileOperations(input);
+
+      const poLoader = createBucketLoader('po', 'i18n/[locale].po');
+      poLoader.setDefaultLocale('es');
+      await poLoader.pull('es');
+
+      await poLoader.push('es', payload);
+
+      expect(fs.writeFile).toHaveBeenCalledWith(
+        'i18n/es.po',
+        expectedOutput,
+        { encoding: 'utf-8', flag: 'w' },
+      );
+    });
+  });
+
   describe('properties bucket loader', () => {
     it('should load properties data', async () => {
       setupFileMocks();

packages/cli/src/loaders/index.ts

@@ -18,6 +18,7 @@ import createXcodeStringsdictLoader from './xcode-stringsdict';
 import createXcodeXcstringsLoader from './xcode-xcstrings';
 import createPrettierLoader from './prettier';
 import createUnlocalizableLoader from './unlocalizable';
+import createPoLoader from './po';
 
 export default function createBucketLoader(
   bucketType: Z.infer<typeof bucketTypeSchema>,
@@ -56,6 +57,11 @@ export default function createBucketLoader(
       createMarkdownLoader(),
       createUnlocalizableLoader(),
     );
+    case 'po': return composeLoaders(
+      createTextFileLoader(bucketPathPattern),
+      createPoLoader(),
+      createUnlocalizableLoader(),
+    );
     case 'properties': return composeLoaders(
       createTextFileLoader(bucketPathPattern),
       createPropertiesLoader(),

packages/cli/src/loaders/po.ts

@@ -0,0 +1,63 @@
+import { ILoader } from "./_types";
+import { createLoader } from './_utils';
+
+export default function createPoLoader(): ILoader<string, Record<string, any>> {
+  return createLoader({
+    async pull(locale, text) {
+      const result: Record<string, string> = {};
+      const lines = text.split('\n');
+      let currentKey = '';
+      let currentValue = '';
+
+      for (const line of lines) {
+        const trimmed = line.trim();
+
+        // Skip empty lines and comments
+        if (isSkippableLine(trimmed)) {
+          continue;
+        }
+
+        if (trimmed.startsWith('msgid')) {
+          // If we have a current key, save it before moving to the next
+          if (currentKey) {
+            result[currentKey] = currentValue;
+          }
+          currentKey = parseMsgId(trimmed);
+          currentValue = ''; // Reset current value
+        } else if (trimmed.startsWith('msgstr')) {
+          currentValue = parseMsgStr(trimmed);
+        }
+      }
+
+      // Save the last key-value pair
+      if (currentKey) {
+        result[currentKey] = currentValue;
+      }
+
+      return result;
+    },
+    async push(locale, payload) {
+      const result = Object.entries(payload)
+        .map(([key, value]) => {
+          return `msgid "${key}"\nmsgstr "${value}"`;
+        })
+        .join('\n\n');
+
+      return result;
+    }
+  });
+}
+
+function isSkippableLine(line: string): boolean {
+  return !line || line.startsWith('#');
+}
+
+function parseMsgId(line: string): string {
+  const match = line.match(/msgid "(.*)"/);
+  return match ? match[1] : '';
+}
+
+function parseMsgStr(line: string): string {
+  const match = line.match(/msgstr "(.*)"/);
+  return match ? match[1] : '';
+}

packages/spec/src/formats.ts

@@ -13,6 +13,7 @@ export const bucketTypes = [
   'yaml',
   'yaml-root-key',
   'properties',
+  'po',
 
   'compiler',
 ] as const;