wp-po-to-mo

A command-line tool and Node.js library for converting WordPress .po translation files to .mo format.

Features

• ✅ Convert single .po files to .mo format
• 📁 Batch convert entire directories of .po files
• 👀 Watch mode for automatic conversion on file changes
• 🔍 WordPress compatibility validation
• 📊 Conversion statistics
• 🚀 Fast and efficient processing

Installation

Global Installation

1npm install -g wp-po-to-mo

Local Installation

1npm install --save-dev wp-po-to-mo

Usage

Command Line Interface

Basic Usage

Convert a single file:

1wp-po-to-mo languages/de_DE.po

Convert all .po files in a directory:

1wp-po-to-mo languages/

Watch Mode

Watch a directory for changes and automatically convert .po files:

1wp-po-to-mo watch languages/

Validation

Validate .po files for WordPress compatibility:

1wp-po-to-mo validate languages/

Options

Options:
  -o, --output <dir>     Output directory for .mo files
  -r, --recursive        Search directories recursively (default: true)
  --no-recursive         Disable recursive search
  -e, --exclude <pattern> Exclude files matching pattern
  --validate             Validate .po files for WordPress compatibility
  --stats                Show conversion statistics
  -h, --help             Show this help message

NPM Scripts Integration

Add to your package.json:

1{
2  "scripts": {
3    "convert": "wp-po-to-mo languages/",
4    "convert:watch": "wp-po-to-mo watch languages/"
5  }
6}

Then run:

1npm run convert
2# or
3npm run convert:watch

Programmatic Usage

1const { PoToMoConverter } = require('wp-po-to-mo');
2
3// Create a converter instance
4const converter = new PoToMoConverter();
5
6// Convert a single file
7converter.convertSingle('path/to/file.po')
8  .then(moFilePath => {
9    console.log(`Converted to: ${moFilePath}`);
10  })
11  .catch(error => {
12    console.error('Conversion failed:', error);
13  });
14
15// Batch convert a directory
16converter.convertBatch('path/to/directory', {
17  recursive: true,
18  outputDir: 'path/to/output',
19  exclude: ['backup', 'temp']
20})
21  .then(convertedFiles => {
22    console.log(`Converted ${convertedFiles.length} files`);
23  })
24  .catch(error => {
25    console.error('Batch conversion failed:', error);
26  });

Requirements

• Node.js 14 or higher

License

MIT