localizer 0.1.1

Localizer - Manage your app translations with ease.

localizer

Manage your app translations with ease. localizer is a command-line tool that helps you manage, validate, and generate translations for your applications.

Features

• 🚀 Quick Setup: Initialize translation configs with a single command
• ✅ Validation: Ensure translation references are valid and documented
• 🌍 Multi-language: Generate translations for multiple languages
• 📝 Documentation: Keep translation contexts organized

Installation

pip install localizer-cli

Quick Start

1. Initialize localizer in your project:

localizer init

2. Add languages to your configuration:

localizer config --add-language fr

3. Generate translations:

localizer translate all -o ./translations

Configuration

When you run localizer init, it creates a .localizer directory with three files:

1. localizer.config.yaml

files:
  reference: reference.yaml  # Source translations file
  docs: docs.md             # Documentation file
languages:
  - en                      # Default languages
  - ko
  - vi

2. reference.yaml

Your source translations in YAML format:

# Example structure
welcome:
  title: "Welcome to our app!"
  subtitle: "Get started by..."
errors:
  not_found: "Page not found"

3. docs.md

Documentation for translators:

# Translation Documentation

## Welcome Screen
- `welcome.title`: Main welcome message on the landing page
- `welcome.subtitle`: Secondary text below the welcome message

## Error Messages
- `errors.not_found`: Shown when a page cannot be found

Commands

Config Management

# Add a language
localizer config --add-language fr

# Remove a language
localizer config --remove-language fr

# List configured languages
localizer config --list-languages

Validation

# Validate all documentation references
localizer validate docs

# Validate specific reference
localizer validate ref welcome.title

Translation Generation

# Generate for specific language
localizer translate generate fr -o fr.json

# Generate for all languages
localizer translate all -o ./translations

CLI Reference

localizer init

Initializes the localizer configuration in your project.

localizer config

Option	Description
--add-language CODE	Add a language code
--remove-language CODE	Remove a language code
--list-languages	Show configured languages

localizer validate

Command	Description
docs	Validate all docs references
ref PATH	Validate specific reference path

localizer translate

Command	Description
generate LANG [-o FILE]	Generate translation for language
all -o DIR	Generate all translations

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.