24-languages.sh

#!/bin/bash
# Example 24: List Supported Languages
# Demonstrates listing source and target languages supported by DeepL,
# including extended languages and graceful degradation without an API key

set -e  # Exit on error

echo "=== DeepL CLI Example 24: Supported Languages ==="
echo

# Check if API key is configured
if ! deepl auth show &>/dev/null; then
  echo "❌ Error: API key not configured"
  echo "Run: deepl auth set-key YOUR_API_KEY"
  exit 1
fi

echo "✓ API key configured"
echo

# Example 1: List all languages (both source and target)
echo "1. List all supported languages (both source and target)"
deepl languages
echo

# Example 2: List only source languages
echo "2. List only source languages"
deepl languages --source
echo

# Example 3: List only target languages
echo "3. List only target languages"
deepl languages --target
echo

# Example 4: Use in scripts to check language support
echo "4. Checking language support in scripts"
echo "   Example: Check if Japanese is supported as target language"
echo
cat << 'EOF'
# Bash script snippet for checking language support:
if deepl languages --target | grep -q "ja"; then
  echo "✓ Japanese is supported as a target language"
  # Proceed with Japanese translation
else
  echo "❌ Japanese is not supported"
  exit 1
fi
EOF
echo

echo "5. Languages in JSON format (for scripting):"
deepl languages --format json | head -10
echo

echo "6. Target languages in JSON format:"
deepl languages --target --format json | head -10
echo

echo "=== Language listing example completed! ===="
echo

echo "💡 Language categories:"
echo "   - Core (32): Full support - formality, glossaries, all model types"
echo "   - Regional (7): Target-only variants (en-us, en-gb, pt-br, etc.)"
echo "   - Extended (82): quality_optimized only, no formality or glossaries"
echo

echo "📚 Language notes:"
echo "   - Source languages: Languages you can translate FROM"
echo "   - Target languages: Languages you can translate TO"
echo "   - Regional variants only available as targets (e.g., en-us, en-gb)"
echo "   - Extended languages shown in a separate section"
echo "   - Works without API key (shows local registry data with a warning)"
echo

echo "🔍 Common language codes:"
echo "   - en: English (source only)"
echo "   - en-us: English (American) - target only"
echo "   - en-gb: English (British) - target only"
echo "   - de: German"
echo "   - fr: French"
echo "   - es: Spanish"
echo "   - ja: Japanese"
echo "   - zh: Chinese"
echo "   - hi: Hindi (extended)"
echo "   - sw: Swahili (extended)"
echo

echo "=== All examples completed successfully! ==="