PyPI - android-localisation - Versions diffs - 1.0.7__tar.gz → 1.1.2__tar.gz - Mend

android-localisation 1.0.7tar.gz → 1.1.2tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (21) hide show

{android_localisation-1.0.7/android_localisation.egg-info → android_localisation-1.1.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-localisation
-Version: 1.0.7
+Version: 1.1.2
 Summary: Zero-dependency Android strings.xml translation and verification using LLMs (Gemini, OpenAI, Anthropic, Ollama).
 License: MIT
 Project-URL: Homepage, https://github.com/BharathKmalviya/android-llm-localization
@@ -54,6 +54,26 @@ pip install android-localisation
 Requires Python 3.8+. No other dependencies.
+CLI output uses UTF-8, including when redirected to a file or pipe on Windows.
+### Update notices
+Interactive `android-localise` commands check PyPI for a newer stable release in
+the background, at most once every 24 hours. When available, a note on stderr
+shows `pip install --upgrade android-localisation`. The CLI never waits for the
+lookup or installs an update automatically. A first short command may finish
+before the lookup completes; a notice appears when a check completes during a
+command or a later invocation can use its cached result.
+Checks are skipped for help/version output, CI (`CI` set), redirected output and
+pipes. Set `ANDROID_LOCALISE_NO_UPDATE_CHECK=1` to disable them, including when
+using a local model offline. Lookup or cache failures stay silent and do not
+change command exit codes. The small cache lives under
+`%LOCALAPPDATA%/android-localisation` on Windows, or
+`${XDG_CACHE_HOME:-~/.cache}/android-localisation` elsewhere. Only the package's
+public release metadata is requested; API keys and Android resources are never
+included.
 ---
 ## Quick start
@@ -65,7 +85,7 @@ android-localise translate --api-key YOUR_GEMINI_KEY
 # Step 2 — fix any formatting issues the LLM may have introduced
 android-localise fix
-# Step 3 — verify nothing will crash at runtime
+# Step 3 — check resources and Java formatting
 android-localise verify
 ```
@@ -78,9 +98,9 @@ That's the full workflow. Run these three commands after every time you update y
 When you run `android-localise translate --api-key YOUR_KEY`, here's exactly what it does:
 1. Looks for `app/src/main/res/values/strings.xml` — this is your English source
-2. If `--languages` is provided, creates any missing `values-<lang>/` folders automatically. Otherwise scans the `res/` directory for existing `values-*` folders
-3. For each locale, if `strings.xml` doesn't exist it creates the file first, then sends your full English XML to the LLM with a prompt that instructs it to translate naturally, preserve all XML structure, and never touch format specifiers like `%1$s` or `%d`
-4. Writes the translated `strings.xml` directly into each locale folder
+2. If `--languages` is provided, selects those locales. Otherwise scans existing locale folders, skipping configuration-only folders such as `values-night`, `values-land`, `values-car`, and `values-sw600dp`
+3. Sends your English XML to the LLM with app context and instructions to preserve resource structure, protected values, namespaces and format specifiers. With `--missing-only`, requests only resources absent from the target file; existing resources remain untouched, and complete locales make no API request
+4. Parses the response and checks duplicate/unexpected/missing resources, attributes, inline markup, item structure, control escapes and format arguments. A valid result replaces the file atomically; new folders are created only when saving. `--dry-run` shows a diff without writing any files or creating folders
 5. Waits 5 seconds between each language request to avoid hitting API rate limits
 **Defaults used when you don't specify anything:**
@@ -88,12 +108,14 @@ When you run `android-localise translate --api-key YOUR_KEY`, here's exactly wha
 | What | Default |
 |---|---|
 | Provider | Gemini |
-| Model | `gemini-3.5-flash` |
+| Model | `gemini-3.8-flash` |
 | Source directory | `app/src/main/res` |
 | Delay between requests | 5 seconds |
 | App context | none (generic prompt) |
-Nothing is modified unless the translation comes back with valid XML. If a request fails, that language is skipped and logged — other languages continue.
+An invalid or incomplete response leaves the existing file unchanged. Other locales continue, and the final summary shows succeeded, failed and skipped counts. Exit code **0** means success; **1** means a setup, validation, API or save failure (including partial failure). Argument syntax errors use argparse's exit code **2**.
+Normal translation still replaces the whole locale file. Use `--missing-only` to retain reviewed translations or combine it with `--dry-run` to preview additions. No cache, database or configuration file is needed.
 ---
@@ -107,7 +129,7 @@ For target languages, you have two options:
 ```bash
 android-localise translate --api-key YOUR_KEY --languages hi,es,fr,de
 ```
-This creates `values-hi/`, `values-es/`, `values-fr/`, `values-de/` folders and their `strings.xml` files automatically, then translates into each one.
+This translates into Hindi, Spanish, French and German, creating each folder and `strings.xml` when its translation passes validation.
 **Option B — pre-create folders yourself:**
 ```
@@ -118,7 +140,7 @@ app/src/main/res/
 ├── values-es/
 └── values-fr/
 ```
-Run `android-localise translate --api-key YOUR_KEY` and it picks up any `values-*` folder it finds, creating `strings.xml` inside each one if it doesn't exist yet.
+Run `android-localise translate --api-key YOUR_KEY` and it picks up locale folders, creating `strings.xml` inside each one after successful translation. Locale examples include `values-hi`, `values-es-rES`, `values-b+zh+Hans`, and `values-en-night`; qualifier-only folders are skipped. `--languages` accepts the same forms without the optional `values-` prefix and rejects path separators or non-locale names.
 **Get a free API key:** [Google Gemini AI Studio](https://aistudio.google.com/) → Get API Key. The free tier handles most apps without hitting limits.
@@ -153,6 +175,19 @@ android-localise translate \
 | `--base-url` | API endpoint for local/custom providers | — |
 | `--sleep` | Seconds to wait between language requests | `5.0` |
 | `--timeout` | Seconds to wait for each API response (up to 3 attempts on timeout) | `180` |
+| `--missing-only` | Translate absent resources; retain existing translations | off (refresh whole file) |
+| `--dry-run` | Generate and validate output, then print a diff without writing files | off |
+**Preserve reviewed translations:**
+```bash
+android-localise translate --languages hi,es --missing-only
+android-localise translate --languages hi --missing-only --dry-run
+```
+`--dry-run` still calls the selected provider and may incur API charges. It is a translation preview, not a no-network estimate. `--missing-only` keeps existing resources, comments and text, but validates them against the current source first. An invalid existing file is reported rather than silently repaired. It does not detect changed English text for an existing key; use the normal translation mode when you deliberately want to refresh those resources. Arrays and plurals count as whole resources: this mode does not fill individual missing items.
+Validation permits positional placeholder reordering such as `%s %d` becoming `%2$d %1$s`, while checking argument identities, conversions, formatting options and occurrence counts. Non-translatable resources may be omitted from locale files to use Android's default fallback, but must remain unchanged if included.
 ---
@@ -163,12 +198,14 @@ android-localise fix
 android-localise fix --res-dir path/to/res
 ```
-LLMs occasionally produce output that looks correct but breaks the Android build — curly apostrophes (`'`) instead of escaped ones (`\'`), unescaped double quotes, or mangled `%` signs. This command scans every translated `strings.xml` and corrects these silently.
+This command scans locale `strings.xml` files, converts curly apostrophes, escapes raw apostrophes, and doubles bare percent signs while retaining recognized format patterns. It checks XML before and after changes and saves atomically. Inline markup attributes and non-translatable values are left alone. It handles single- and double-quoted resource names.
 Strings marked `formatted="false"` are skipped — their `%` signs are literal, not format specifiers.
 Always run this before `verify` and before building.
+`fix` repairs `<string>` text only. It does not repair arbitrary malformed XML, double-quote handling, or array/plural items, and it does not prove a format pattern is valid. Review its changes and use `verify` and your Android build afterward.
 ---
 ### `verify`
@@ -178,10 +215,12 @@ android-localise verify
 android-localise verify --res-dir path/to/res
 ```
-Takes every translated string that contains a format specifier (`%1$s`, `%d`, `%1$f`, etc.) and calls `String.format()` on it using Java's actual runtime. If a translated string would throw `UnknownFormatConversionException` or `MissingFormatArgumentException` in your app, this catches it before your users do.
+First parses XML and compares localized resources with `values/strings.xml`, checking coverage, duplicates, protected content, attributes, inline markup and format-argument preservation. Then checks formatted strings and array/plural items with Java's actual `String.format()` runtime, including date/time and relative argument indexing. Both checks return nonzero on failure. Empty locale folders without a `strings.xml` are skipped.
 Strings marked `formatted="false"` are skipped. Requires `javac` in your PATH. If you don't have it system-wide, run this from the Terminal tab inside Android Studio — it ships with a JDK.
+`formatted="false"` skips formatting checks only; XML, resource coverage and attribute checks still apply. Java compilation uses a temporary directory, so installed package files are not modified. Verification is deliberately stricter than Android's missing-string fallback: missing translatable resources are reported. Passing these checks does not replace an Android build, native-speaker review or device layout checks.
 ---
 ### `models`
@@ -191,27 +230,33 @@ android-localise models                  # all providers
 android-localise models --provider openai  # one provider
 ```
-Lists every available model and fallback for each provider.
+Lists this CLI's configured defaults and automatic fallbacks, not the provider's entire model catalog. Any supported model can still be selected with `--model`.
 ---
 ## Providers
-By default the tool uses Gemini with `gemini-3.5-flash`. You can switch providers with `--provider` and optionally pin a specific model with `--model`.
+By default the tool uses Gemini with `gemini-3.8-flash`. You can switch providers with `--provider` and optionally pin a specific model with `--model`. Configured defaults and fallbacks use only the latest general-purpose text-model lineup, with defaults favoring speed and cost within that lineup.
 | Provider | Default model | Fallbacks | API key env var |
 |---|---|---|---|
-| `gemini` _(default)_ | `gemini-3.5-flash` | `gemini-3.1-flash-lite` → `gemini-2.5-flash` → `gemini-2.5-flash-lite` | `GEMINI_API_KEY` |
-| `openai` | `gpt-5.4-mini` | `gpt-5-mini` → `gpt-4o-mini` | `OPENAI_API_KEY` |
-| `anthropic` | `claude-haiku-4-5` | `claude-sonnet-4-6` → `claude-opus-4-8` | `ANTHROPIC_API_KEY` |
+| `gemini` _(default)_ | `gemini-3.8-flash` | none | `GEMINI_API_KEY` |
+| `openai` | `gpt-6-luna` | `gpt-6.1-sol` → `gpt-6-astra` | `OPENAI_API_KEY` |
+| `anthropic` | `claude-sonnet-5-5` | `claude-opus-5-5` | `ANTHROPIC_API_KEY` |
 | `custom` | set with `--model` | none | `OPENAI_API_KEY` (optional) |
 If the default model returns a "model not found" error (e.g. it was deprecated), the tool automatically retries with the next fallback. If you pin a model with `--model`, no fallback is used.
+Model IDs and compatibility checked against [Google's model catalog](https://ai.google.dev/gemini-api/docs/models), [OpenAI's model catalog](https://developers.openai.com/api/docs/models) and [Anthropic's model catalog](https://platform.claude.com/docs/en/models/overview) on **2026-10-02**. Older Gemini, GPT-5 and Haiku 4.5 models are excluded from automatic selection. Gemini has no fallback in its latest stable text generation. OpenAI and Anthropic fallbacks are higher-cost models; pin `--model` to avoid automatic tier changes. Explicit model selection and custom/local endpoints remain available. The catalog is bundled with each CLI release, rather than automatically discovering models at runtime.
+OpenAI and local providers retain the Chat Completions request format. Provider replies indicating truncation or blocked/incomplete output are rejected. Anthropic allows up to 16,384 output tokens per request and text blocks are collected separately from thinking blocks. Large files can still exceed a model's limits; automatic batching is future work.
 **Using OpenAI:**
 ```bash
 android-localise translate --provider openai --api-key YOUR_KEY
-android-localise translate --provider openai --model gpt-5.4-mini --api-key YOUR_KEY
+android-localise translate --provider openai --model gpt-6-luna --api-key YOUR_KEY
+# Optional stronger tier; different cost/latency
+android-localise translate --provider openai --model gpt-6.1-sol --api-key YOUR_KEY
 ```
 **Using Anthropic:**
@@ -262,6 +307,8 @@ android-localise translate
 | `OPENAI_API_KEY` | `--provider openai` and `--provider custom` |
 | `ANTHROPIC_API_KEY` | `--provider anthropic` |
 | `API_KEY` | fallback for any provider if the provider-specific var is not set |
+| `ANDROID_LOCALISE_NO_UPDATE_CHECK` | Set to `1` to disable update checks/notices |
+| `CI` | When nonempty, skips update checks/notices |
 ---
@@ -290,15 +337,15 @@ android-localise verify
 ./gradlew assembleDebug
 ```
-After this, whenever you add or change strings in your English `strings.xml`, run the same three commands again. Existing translated strings will be overwritten with fresh translations.
+After this, whenever you add or change strings in your English `strings.xml`, run the same three commands again. Existing translated strings are refreshed by default. For additions that should retain existing translations, run `translate --missing-only` instead; it does not detect changed source text for existing keys.
 ---
 ## Platform support
-This project is developed and **manually tested on Windows only** at the moment. It is written in pure Python (stdlib only) and should run on macOS and Linux, but those platforms have **not been verified** by the maintainer yet.
+I develop and **manually test this project on Windows only** at the moment. It is written in pure Python (stdlib only) and should run on macOS and Linux, but I have **not verified** those platforms yet.
-We especially need help testing on:
+I especially need help testing on:
 - **macOS** — `translate`, `fix`, `verify` (including `javac` / Android Studio terminal)
 - **Linux** — same workflow, plus common CI environments
@@ -309,7 +356,7 @@ If you use another OS, please try the [quick start](#quick-start) workflow and r
 - **Broken?** — open a [bug report](https://github.com/BharathKmalviya/android-llm-localization/issues/new?template=bug_report.md) with the full error output
 - **Want to help more?** — see [Contributing](#contributing) and [CONTRIBUTING.md](CONTRIBUTING.md)
-Cross-platform fixes and test notes in pull requests are very welcome.
+PRs with cross-platform fixes and test notes are especially appreciated.
 ---
@@ -317,10 +364,13 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 | Topic | Detail |
 |---|---|
-| **Platform testing** | Maintainer-tested on **Windows only** — macOS and Linux need community verification (see [Platform support](#platform-support)) |
-| **Scope** | Translates `values/strings.xml` only — not `plurals.xml`, `arrays.xml`, or other resource files |
-| **Overwrite** | Each run replaces the entire `strings.xml` in each locale folder with a fresh LLM translation |
-| **Folder scan** | Without `--languages`, every `values-*` folder is treated as a locale. Qualifier-only folders like `values-night` or `values-sw600dp` may be picked up incorrectly — prefer `--languages` or keep only locale folders in `res/` |
+| **Platform testing** | I test on **Windows only** — macOS and Linux need community verification (see [Platform support](#platform-support)) |
+| **Scope** | Reads `values/strings.xml` only. Strings, arrays and plurals within that file are checked; separate XML files are not scanned |
+| **Plurals** | Preserves source quantities and item structure; does not generate target-language plural categories. Review plural completeness for each language |
+| **Overwrite** | Normal runs refresh whole files. `--missing-only` retains existing resources but does not detect source changes |
+| **Folder scan** | Recognizes language-first and Android `b+` locale forms, with optional trailing qualifiers. MCC/MNC-prefixed resource folders are not scanned |
+| **Validation** | Requires source attributes, inline element order and formatting options to match. DTD/entity declarations are unsupported; checks do not replace Android compilation or language review |
+| **Large files** | One request per locale; no automatic batching or resume cache. Incomplete output is rejected |
 | **Network** | `translate` requires internet access to reach the LLM API (except local `custom` providers) |
 | **JDK** | `verify` requires `javac` on your PATH |
@@ -333,6 +383,7 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 | `Could not find English strings.xml` | Check `--res-dir` points to your `res/` folder and `values/strings.xml` exists |
 | `No locale directories found` | Add `--languages hi,es,fr` or create `values-<lang>/` folders manually |
 | API auth errors | Confirm your key env var or `--api-key` matches the `--provider` |
+| Resource validation fails | Read the named resource error; check source/target keys, attributes, placeholders and markup. Existing files are retained |
 | `javac` not found | Install a JDK or run `verify` from Android Studio's terminal |
 | Build fails on apostrophes | Run `android-localise fix` before building |
 | `%` crashes at runtime | Run `android-localise verify` — it catches bad format specifiers before release |
@@ -345,17 +396,17 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 - [ ] **iOS support** — translate `Localizable.strings` and `Localizable.xcstrings` for iOS/macOS apps. The LLM prompt and provider logic is already in place — it mainly needs a parser for Apple's strings format and the right folder structure (`<lang>.lproj/`). Good first contribution if you're familiar with iOS projects.
 - [ ] **Smarter locale folder detection** — skip non-locale `values-*` qualifiers (`night`, `sw600dp`, `v21`, etc.) when scanning without `--languages`
 - [ ] **Automated test suite** — unit tests for `fix`, XML parsing, and format-specifier edge cases
-- [ ] **Cross-platform verification** — confirm `translate`, `fix`, and `verify` on macOS and Linux (Windows is maintainer-tested today)
+- [ ] **Cross-platform verification** — confirm `translate`, `fix`, and `verify` on macOS and Linux (I currently test on Windows only)
 ---
 ## Contributing
-Bug reports, pull requests, and **cross-platform testing** are all welcome. For larger changes, open an issue first.
+I welcome bug reports, pull requests, and **cross-platform testing**. For larger changes, please open an issue first.
 **No code required** — if you are on macOS or Linux, running the tool and filing an issue (pass or fail) is a real contribution. See [Platform support](#platform-support).
-See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, branch strategy, and release process.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the development workflow, branch strategy, and release process.
 ```bash
 git clone https://github.com/BharathKmalviya/android-llm-localization

{android_localisation-1.0.7 → android_localisation-1.1.2}/README.md RENAMED Viewed

@@ -26,6 +26,26 @@ pip install android-localisation
 Requires Python 3.8+. No other dependencies.
+CLI output uses UTF-8, including when redirected to a file or pipe on Windows.
+### Update notices
+Interactive `android-localise` commands check PyPI for a newer stable release in
+the background, at most once every 24 hours. When available, a note on stderr
+shows `pip install --upgrade android-localisation`. The CLI never waits for the
+lookup or installs an update automatically. A first short command may finish
+before the lookup completes; a notice appears when a check completes during a
+command or a later invocation can use its cached result.
+Checks are skipped for help/version output, CI (`CI` set), redirected output and
+pipes. Set `ANDROID_LOCALISE_NO_UPDATE_CHECK=1` to disable them, including when
+using a local model offline. Lookup or cache failures stay silent and do not
+change command exit codes. The small cache lives under
+`%LOCALAPPDATA%/android-localisation` on Windows, or
+`${XDG_CACHE_HOME:-~/.cache}/android-localisation` elsewhere. Only the package's
+public release metadata is requested; API keys and Android resources are never
+included.
 ---
 ## Quick start
@@ -37,7 +57,7 @@ android-localise translate --api-key YOUR_GEMINI_KEY
 # Step 2 — fix any formatting issues the LLM may have introduced
 android-localise fix
-# Step 3 — verify nothing will crash at runtime
+# Step 3 — check resources and Java formatting
 android-localise verify
 ```
@@ -50,9 +70,9 @@ That's the full workflow. Run these three commands after every time you update y
 When you run `android-localise translate --api-key YOUR_KEY`, here's exactly what it does:
 1. Looks for `app/src/main/res/values/strings.xml` — this is your English source
-2. If `--languages` is provided, creates any missing `values-<lang>/` folders automatically. Otherwise scans the `res/` directory for existing `values-*` folders
-3. For each locale, if `strings.xml` doesn't exist it creates the file first, then sends your full English XML to the LLM with a prompt that instructs it to translate naturally, preserve all XML structure, and never touch format specifiers like `%1$s` or `%d`
-4. Writes the translated `strings.xml` directly into each locale folder
+2. If `--languages` is provided, selects those locales. Otherwise scans existing locale folders, skipping configuration-only folders such as `values-night`, `values-land`, `values-car`, and `values-sw600dp`
+3. Sends your English XML to the LLM with app context and instructions to preserve resource structure, protected values, namespaces and format specifiers. With `--missing-only`, requests only resources absent from the target file; existing resources remain untouched, and complete locales make no API request
+4. Parses the response and checks duplicate/unexpected/missing resources, attributes, inline markup, item structure, control escapes and format arguments. A valid result replaces the file atomically; new folders are created only when saving. `--dry-run` shows a diff without writing any files or creating folders
 5. Waits 5 seconds between each language request to avoid hitting API rate limits
 **Defaults used when you don't specify anything:**
@@ -60,12 +80,14 @@ When you run `android-localise translate --api-key YOUR_KEY`, here's exactly wha
 | What | Default |
 |---|---|
 | Provider | Gemini |
-| Model | `gemini-3.5-flash` |
+| Model | `gemini-3.8-flash` |
 | Source directory | `app/src/main/res` |
 | Delay between requests | 5 seconds |
 | App context | none (generic prompt) |
-Nothing is modified unless the translation comes back with valid XML. If a request fails, that language is skipped and logged — other languages continue.
+An invalid or incomplete response leaves the existing file unchanged. Other locales continue, and the final summary shows succeeded, failed and skipped counts. Exit code **0** means success; **1** means a setup, validation, API or save failure (including partial failure). Argument syntax errors use argparse's exit code **2**.
+Normal translation still replaces the whole locale file. Use `--missing-only` to retain reviewed translations or combine it with `--dry-run` to preview additions. No cache, database or configuration file is needed.
 ---
@@ -79,7 +101,7 @@ For target languages, you have two options:
 ```bash
 android-localise translate --api-key YOUR_KEY --languages hi,es,fr,de
 ```
-This creates `values-hi/`, `values-es/`, `values-fr/`, `values-de/` folders and their `strings.xml` files automatically, then translates into each one.
+This translates into Hindi, Spanish, French and German, creating each folder and `strings.xml` when its translation passes validation.
 **Option B — pre-create folders yourself:**
 ```
@@ -90,7 +112,7 @@ app/src/main/res/
 ├── values-es/
 └── values-fr/
 ```
-Run `android-localise translate --api-key YOUR_KEY` and it picks up any `values-*` folder it finds, creating `strings.xml` inside each one if it doesn't exist yet.
+Run `android-localise translate --api-key YOUR_KEY` and it picks up locale folders, creating `strings.xml` inside each one after successful translation. Locale examples include `values-hi`, `values-es-rES`, `values-b+zh+Hans`, and `values-en-night`; qualifier-only folders are skipped. `--languages` accepts the same forms without the optional `values-` prefix and rejects path separators or non-locale names.
 **Get a free API key:** [Google Gemini AI Studio](https://aistudio.google.com/) → Get API Key. The free tier handles most apps without hitting limits.
@@ -125,6 +147,19 @@ android-localise translate \
 | `--base-url` | API endpoint for local/custom providers | — |
 | `--sleep` | Seconds to wait between language requests | `5.0` |
 | `--timeout` | Seconds to wait for each API response (up to 3 attempts on timeout) | `180` |
+| `--missing-only` | Translate absent resources; retain existing translations | off (refresh whole file) |
+| `--dry-run` | Generate and validate output, then print a diff without writing files | off |
+**Preserve reviewed translations:**
+```bash
+android-localise translate --languages hi,es --missing-only
+android-localise translate --languages hi --missing-only --dry-run
+```
+`--dry-run` still calls the selected provider and may incur API charges. It is a translation preview, not a no-network estimate. `--missing-only` keeps existing resources, comments and text, but validates them against the current source first. An invalid existing file is reported rather than silently repaired. It does not detect changed English text for an existing key; use the normal translation mode when you deliberately want to refresh those resources. Arrays and plurals count as whole resources: this mode does not fill individual missing items.
+Validation permits positional placeholder reordering such as `%s %d` becoming `%2$d %1$s`, while checking argument identities, conversions, formatting options and occurrence counts. Non-translatable resources may be omitted from locale files to use Android's default fallback, but must remain unchanged if included.
 ---
@@ -135,12 +170,14 @@ android-localise fix
 android-localise fix --res-dir path/to/res
 ```
-LLMs occasionally produce output that looks correct but breaks the Android build — curly apostrophes (`'`) instead of escaped ones (`\'`), unescaped double quotes, or mangled `%` signs. This command scans every translated `strings.xml` and corrects these silently.
+This command scans locale `strings.xml` files, converts curly apostrophes, escapes raw apostrophes, and doubles bare percent signs while retaining recognized format patterns. It checks XML before and after changes and saves atomically. Inline markup attributes and non-translatable values are left alone. It handles single- and double-quoted resource names.
 Strings marked `formatted="false"` are skipped — their `%` signs are literal, not format specifiers.
 Always run this before `verify` and before building.
+`fix` repairs `<string>` text only. It does not repair arbitrary malformed XML, double-quote handling, or array/plural items, and it does not prove a format pattern is valid. Review its changes and use `verify` and your Android build afterward.
 ---
 ### `verify`
@@ -150,10 +187,12 @@ android-localise verify
 android-localise verify --res-dir path/to/res
 ```
-Takes every translated string that contains a format specifier (`%1$s`, `%d`, `%1$f`, etc.) and calls `String.format()` on it using Java's actual runtime. If a translated string would throw `UnknownFormatConversionException` or `MissingFormatArgumentException` in your app, this catches it before your users do.
+First parses XML and compares localized resources with `values/strings.xml`, checking coverage, duplicates, protected content, attributes, inline markup and format-argument preservation. Then checks formatted strings and array/plural items with Java's actual `String.format()` runtime, including date/time and relative argument indexing. Both checks return nonzero on failure. Empty locale folders without a `strings.xml` are skipped.
 Strings marked `formatted="false"` are skipped. Requires `javac` in your PATH. If you don't have it system-wide, run this from the Terminal tab inside Android Studio — it ships with a JDK.
+`formatted="false"` skips formatting checks only; XML, resource coverage and attribute checks still apply. Java compilation uses a temporary directory, so installed package files are not modified. Verification is deliberately stricter than Android's missing-string fallback: missing translatable resources are reported. Passing these checks does not replace an Android build, native-speaker review or device layout checks.
 ---
 ### `models`
@@ -163,27 +202,33 @@ android-localise models                  # all providers
 android-localise models --provider openai  # one provider
 ```
-Lists every available model and fallback for each provider.
+Lists this CLI's configured defaults and automatic fallbacks, not the provider's entire model catalog. Any supported model can still be selected with `--model`.
 ---
 ## Providers
-By default the tool uses Gemini with `gemini-3.5-flash`. You can switch providers with `--provider` and optionally pin a specific model with `--model`.
+By default the tool uses Gemini with `gemini-3.8-flash`. You can switch providers with `--provider` and optionally pin a specific model with `--model`. Configured defaults and fallbacks use only the latest general-purpose text-model lineup, with defaults favoring speed and cost within that lineup.
 | Provider | Default model | Fallbacks | API key env var |
 |---|---|---|---|
-| `gemini` _(default)_ | `gemini-3.5-flash` | `gemini-3.1-flash-lite` → `gemini-2.5-flash` → `gemini-2.5-flash-lite` | `GEMINI_API_KEY` |
-| `openai` | `gpt-5.4-mini` | `gpt-5-mini` → `gpt-4o-mini` | `OPENAI_API_KEY` |
-| `anthropic` | `claude-haiku-4-5` | `claude-sonnet-4-6` → `claude-opus-4-8` | `ANTHROPIC_API_KEY` |
+| `gemini` _(default)_ | `gemini-3.8-flash` | none | `GEMINI_API_KEY` |
+| `openai` | `gpt-6-luna` | `gpt-6.1-sol` → `gpt-6-astra` | `OPENAI_API_KEY` |
+| `anthropic` | `claude-sonnet-5-5` | `claude-opus-5-5` | `ANTHROPIC_API_KEY` |
 | `custom` | set with `--model` | none | `OPENAI_API_KEY` (optional) |
 If the default model returns a "model not found" error (e.g. it was deprecated), the tool automatically retries with the next fallback. If you pin a model with `--model`, no fallback is used.
+Model IDs and compatibility checked against [Google's model catalog](https://ai.google.dev/gemini-api/docs/models), [OpenAI's model catalog](https://developers.openai.com/api/docs/models) and [Anthropic's model catalog](https://platform.claude.com/docs/en/models/overview) on **2026-10-02**. Older Gemini, GPT-5 and Haiku 4.5 models are excluded from automatic selection. Gemini has no fallback in its latest stable text generation. OpenAI and Anthropic fallbacks are higher-cost models; pin `--model` to avoid automatic tier changes. Explicit model selection and custom/local endpoints remain available. The catalog is bundled with each CLI release, rather than automatically discovering models at runtime.
+OpenAI and local providers retain the Chat Completions request format. Provider replies indicating truncation or blocked/incomplete output are rejected. Anthropic allows up to 16,384 output tokens per request and text blocks are collected separately from thinking blocks. Large files can still exceed a model's limits; automatic batching is future work.
 **Using OpenAI:**
 ```bash
 android-localise translate --provider openai --api-key YOUR_KEY
-android-localise translate --provider openai --model gpt-5.4-mini --api-key YOUR_KEY
+android-localise translate --provider openai --model gpt-6-luna --api-key YOUR_KEY
+# Optional stronger tier; different cost/latency
+android-localise translate --provider openai --model gpt-6.1-sol --api-key YOUR_KEY
 ```
 **Using Anthropic:**
@@ -234,6 +279,8 @@ android-localise translate
 | `OPENAI_API_KEY` | `--provider openai` and `--provider custom` |
 | `ANTHROPIC_API_KEY` | `--provider anthropic` |
 | `API_KEY` | fallback for any provider if the provider-specific var is not set |
+| `ANDROID_LOCALISE_NO_UPDATE_CHECK` | Set to `1` to disable update checks/notices |
+| `CI` | When nonempty, skips update checks/notices |
 ---
@@ -262,15 +309,15 @@ android-localise verify
 ./gradlew assembleDebug
 ```
-After this, whenever you add or change strings in your English `strings.xml`, run the same three commands again. Existing translated strings will be overwritten with fresh translations.
+After this, whenever you add or change strings in your English `strings.xml`, run the same three commands again. Existing translated strings are refreshed by default. For additions that should retain existing translations, run `translate --missing-only` instead; it does not detect changed source text for existing keys.
 ---
 ## Platform support
-This project is developed and **manually tested on Windows only** at the moment. It is written in pure Python (stdlib only) and should run on macOS and Linux, but those platforms have **not been verified** by the maintainer yet.
+I develop and **manually test this project on Windows only** at the moment. It is written in pure Python (stdlib only) and should run on macOS and Linux, but I have **not verified** those platforms yet.
-We especially need help testing on:
+I especially need help testing on:
 - **macOS** — `translate`, `fix`, `verify` (including `javac` / Android Studio terminal)
 - **Linux** — same workflow, plus common CI environments
@@ -281,7 +328,7 @@ If you use another OS, please try the [quick start](#quick-start) workflow and r
 - **Broken?** — open a [bug report](https://github.com/BharathKmalviya/android-llm-localization/issues/new?template=bug_report.md) with the full error output
 - **Want to help more?** — see [Contributing](#contributing) and [CONTRIBUTING.md](CONTRIBUTING.md)
-Cross-platform fixes and test notes in pull requests are very welcome.
+PRs with cross-platform fixes and test notes are especially appreciated.
 ---
@@ -289,10 +336,13 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 | Topic | Detail |
 |---|---|
-| **Platform testing** | Maintainer-tested on **Windows only** — macOS and Linux need community verification (see [Platform support](#platform-support)) |
-| **Scope** | Translates `values/strings.xml` only — not `plurals.xml`, `arrays.xml`, or other resource files |
-| **Overwrite** | Each run replaces the entire `strings.xml` in each locale folder with a fresh LLM translation |
-| **Folder scan** | Without `--languages`, every `values-*` folder is treated as a locale. Qualifier-only folders like `values-night` or `values-sw600dp` may be picked up incorrectly — prefer `--languages` or keep only locale folders in `res/` |
+| **Platform testing** | I test on **Windows only** — macOS and Linux need community verification (see [Platform support](#platform-support)) |
+| **Scope** | Reads `values/strings.xml` only. Strings, arrays and plurals within that file are checked; separate XML files are not scanned |
+| **Plurals** | Preserves source quantities and item structure; does not generate target-language plural categories. Review plural completeness for each language |
+| **Overwrite** | Normal runs refresh whole files. `--missing-only` retains existing resources but does not detect source changes |
+| **Folder scan** | Recognizes language-first and Android `b+` locale forms, with optional trailing qualifiers. MCC/MNC-prefixed resource folders are not scanned |
+| **Validation** | Requires source attributes, inline element order and formatting options to match. DTD/entity declarations are unsupported; checks do not replace Android compilation or language review |
+| **Large files** | One request per locale; no automatic batching or resume cache. Incomplete output is rejected |
 | **Network** | `translate` requires internet access to reach the LLM API (except local `custom` providers) |
 | **JDK** | `verify` requires `javac` on your PATH |
@@ -305,6 +355,7 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 | `Could not find English strings.xml` | Check `--res-dir` points to your `res/` folder and `values/strings.xml` exists |
 | `No locale directories found` | Add `--languages hi,es,fr` or create `values-<lang>/` folders manually |
 | API auth errors | Confirm your key env var or `--api-key` matches the `--provider` |
+| Resource validation fails | Read the named resource error; check source/target keys, attributes, placeholders and markup. Existing files are retained |
 | `javac` not found | Install a JDK or run `verify` from Android Studio's terminal |
 | Build fails on apostrophes | Run `android-localise fix` before building |
 | `%` crashes at runtime | Run `android-localise verify` — it catches bad format specifiers before release |
@@ -317,17 +368,17 @@ Cross-platform fixes and test notes in pull requests are very welcome.
 - [ ] **iOS support** — translate `Localizable.strings` and `Localizable.xcstrings` for iOS/macOS apps. The LLM prompt and provider logic is already in place — it mainly needs a parser for Apple's strings format and the right folder structure (`<lang>.lproj/`). Good first contribution if you're familiar with iOS projects.
 - [ ] **Smarter locale folder detection** — skip non-locale `values-*` qualifiers (`night`, `sw600dp`, `v21`, etc.) when scanning without `--languages`
 - [ ] **Automated test suite** — unit tests for `fix`, XML parsing, and format-specifier edge cases
-- [ ] **Cross-platform verification** — confirm `translate`, `fix`, and `verify` on macOS and Linux (Windows is maintainer-tested today)
+- [ ] **Cross-platform verification** — confirm `translate`, `fix`, and `verify` on macOS and Linux (I currently test on Windows only)
 ---
 ## Contributing
-Bug reports, pull requests, and **cross-platform testing** are all welcome. For larger changes, open an issue first.
+I welcome bug reports, pull requests, and **cross-platform testing**. For larger changes, please open an issue first.
 **No code required** — if you are on macOS or Linux, running the tool and filing an issue (pass or fail) is a real contribution. See [Platform support](#platform-support).
-See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, branch strategy, and release process.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the development workflow, branch strategy, and release process.
 ```bash
 git clone https://github.com/BharathKmalviya/android-llm-localization

{android_localisation-1.0.7 → android_localisation-1.1.2}/android_localisation/__init__.py RENAMED Viewed

@@ -2,4 +2,4 @@
 android-localisation: Zero-dependency Android strings.xml translation using LLMs.
 """
-__version__ = "1.0.7"
+__version__ = "1.1.2"

{android_localisation-1.0.7 → android_localisation-1.1.2}/android_localisation/cli.py RENAMED Viewed

@@ -9,10 +9,14 @@ Usage:
 """
 import argparse
+import sys
 from android_localisation import __version__
-def main():
+def main(args=None):
+    for stream in (sys.stdout, sys.stderr):
+        if hasattr(stream, "reconfigure"):
+            stream.reconfigure(encoding="utf-8", errors="replace")
     parser = argparse.ArgumentParser(
         prog="android-localise",
         description="Zero-dependency Android strings.xml localization using LLMs.",
@@ -37,6 +41,8 @@ def main():
         help=f"Seconds to wait for each API response, up to {MAX_TIMEOUT_RETRIES + 1} attempts on timeout (default: {DEFAULT_API_TIMEOUT})",
     )
     translate_parser.add_argument("--languages", help="Comma-separated language codes, e.g. hi,es,fr,de — creates folders and strings.xml automatically")
+    translate_parser.add_argument("--missing-only", action="store_true", help="Translate missing resources while retaining existing translations")
+    translate_parser.add_argument("--dry-run", action="store_true", help="Generate and validate translations, then show a diff without writing files (API usage applies)")
     # --- fix ---
     fix_parser = subparsers.add_parser("fix", help="Fix XML escaping issues in translated strings.xml files")
@@ -47,23 +53,33 @@ def main():
     verify_parser.add_argument("--res-dir", default="app/src/main/res", help="Path to the Android res/ directory (default: app/src/main/res)")
     # --- models ---
-    models_parser = subparsers.add_parser("models", help="List all available models per provider")
+    models_parser = subparsers.add_parser("models", help="List configured model defaults and fallbacks")
     models_parser.add_argument("--provider", choices=["gemini", "openai", "anthropic"], default=None,
                                help="Filter by provider (shows all if not set)")
-    args = parser.parse_args()
+    if args is None or isinstance(args, list):
+        args = parser.parse_args(args)
+    from android_localisation.updates import start_update_check, show_update_notice
+    update_state = start_update_check()
+    try:
+        return _run_command(args)
+    finally:
+        show_update_notice(update_state)
+def _run_command(args):
     if args.command == "translate":
         from android_localisation.translate import main as run
-        run(args)
+        return run(args)
     elif args.command == "fix":
         from android_localisation.fix import main as run
-        run(args)
+        return run(args)
     elif args.command == "verify":
         from android_localisation.verify import main as run
-        run(args)
+        return run(args)
     elif args.command == "models":
         from android_localisation.translate import PROVIDER_MODELS
@@ -80,9 +96,9 @@ def main():
         print("    → Any model name your local server supports (must use --model)")
         print()
         print("  Tip: use --model to pick any model, e.g:")
-        print("    android-localise translate --provider openai --model gpt-5.4-mini --api-key KEY")
+        print("    android-localise translate --provider openai --model gpt-6-luna --api-key KEY")
         print()
 if __name__ == "__main__":
-    main()
+    raise SystemExit(main())

android-localisation 1.0.7__tar.gz → 1.1.2__tar.gz

android-localisation 1.0.7tar.gz → 1.1.2tar.gz