🔤 Localization Keys Generator & Cleaner for iOS (SwiftGen-style)

🤖 CHATGPT DRIVEN PROJECT

This script (L10nXcstrings.py) automates the management of iOS localization strings using the new Localizable.xcstrings format. It helps you:

• ✅ Generate a Swift enum (L10n) with all localization keys as case constants
• ✅ Automatically annotate unused keys with //TODO: Unused
• ✅ Find and export a list of unused localization keys to Unused.txt

---

🛠 Features

• Supports .xcstrings: Parses Xcode's new JSON-based localization format.
• CamelCase key formatting: Converts login.title_screen → loginTitleScreen.
• Safe enum generation: Outputs a clean Strings+Generated.swift with localize() helper.
• Usage analysis: Scans your Swift codebase for usage of L10n.<key>.
• Unused keys check: Detects and marks localization keys that are not used anywhere in the codebase.

---

📦 File Structure Sample

SRC/
├── Resources/
│   ├── Localizable.xcstrings
│   └── Generated/
│       └── Strings+Generated.swift   ← ✅ Auto-generated
└── Unused.txt                        ← 📄 List of unused keys (if any)

---

🚀 Usage

0. Install the script via Homebrew

   brew tap disconnecter/l10n https://github.com/Disconnecter/homebrew-l10n
   

   brew install l10n-xcstrings
   

1. Place your .xcstrings file in the correct path (Resources/Localizable.xcstrings)

2. Run the script:

l10n-xcstrings

4. 🎉 You’ll get:

• Strings+Generated.swift (updated)
• Unused.txt (if unused keys found)
• Output in terminal showing the count of unused keys

---

🧪 Requirements

• Python 3.6+
• Xcode .xcstrings file format (JSON)
• Swift codebase that uses L10n. to reference localizations

---

📝 Notes

• The script automatically camelCases keys like k-about.welcome_screen → kAboutWelcomeScreen
• Unused keys are marked in the enum like so:

#warning("Unused key: loginTitle")
case loginTitle = "login.title" //TODO: Unused

🎮 Parameters

• Path to .xcstrings file

 "--input", default="Localizable.xcstrings"

• Path to output .swift file

 "--output-swift", default="Generated/Strings+Generated.swift"

• Directory to scan Swift source code

 "--source-dir", default="."

• Directories to ignore during scanning. Space-separated.

 "--ignore-dirs", default=[]

• Name of the generated enum

 "--enum-name", default="L10n"

---

📝TODO:

• ✅ add parameters
• Make a SPM compatible Not working solution, because of the sandbox of SPM
• ✅ Make a brew package

---

📄 License

MIT — free to use, modify, and contribute.

---

🙌 Contributions

Feel free to open issues or submit PRs to extend functionality — e.g., support for filtering folders, checking .localized() string usage, or CLI argument support.