localio 0.2.1 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e811c8aa9cf8dabaff74b28dca5476b389c46e27a2dbb5addd87177f28abf566
-  data.tar.gz: 6536d23be9e050ec9d579e6fd0bd35af573eba46536f2d711acaf5d8ee086dc3
+  metadata.gz: 5eb5417063807fd19963f7ae28327a1c323357430d3f2de7b55edd04391f06fa
+  data.tar.gz: b41c293c7ab8c37d640b3f33293d84da1c7f6795b2f46e82bc576cadee918aec
 SHA512:
-  metadata.gz: 2217300fc3ff1610320e23053d97969c93983caf57ecbbc064c5e4018ba4d599b90c71a70ee27bfa5e38ffc3f52bf8c539110c9c55eefdcec4fe8c0960a4d5bd
-  data.tar.gz: 40b1707ad311b028a76a4a0b5f26485153642fc48a89b2e488b7c7b3c13e146f82b55f72bf6a18481082a76b486719c33f1936c83a706d94b14afd7a28b3e230
+  metadata.gz: 826799ef9f0a850dfd85c1e21dced3b9130c299081053693a78d2c70e95119cda368c019822360880359f1b9a7e9e1313214a739289a14f930b6ba984a08c15a
+  data.tar.gz: 6f1e9c5137de4906e174d5ae410990db0afa0b333f5a62dd8decdb0a15091c4f6ee1c0c3c5f91ef87c5679d11876978bfdf0c0c6032e4910bf3c8afbbcc7307a

data/.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Publish to RubyGems
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+      - name: Verify version matches tag
+        run: |
+          GEM_VERSION=$(ruby -r ./lib/localio/version -e 'puts Localio::VERSION')
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          if [ "$GEM_VERSION" != "$TAG_VERSION" ]; then
+            echo "::error::Version mismatch: gem=$GEM_VERSION tag=$TAG_VERSION"
+            exit 1
+          fi
+          echo "Publishing localio v$GEM_VERSION"
+
+      - name: Build gem
+        run: gem build localio.gemspec
+
+      - name: Publish to RubyGems
+        run: gem push localio-*.gem
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}

data/.ruby-version

@@ -1 +1 @@
-3.3.10
+3.2.9

data/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

data/CLAUDE.md

@@ -0,0 +1,79 @@
+# AGENTS.md
+
+This file provides guidance to Claude Code (claude.ai/code) and other AI assistants working on this repository.
+
+## Commands
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run a single spec file
+bundle exec rspec spec/localio_spec.rb
+
+# Run a single example by line number
+bundle exec rspec spec/localio_spec.rb:42
+
+# Standard gem tasks (build, install, release)
+bundle exec rake
+```
+
+## What This Gem Does
+
+Localio reads translation data from spreadsheets (Google Drive, XLS, XLSX, CSV) and generates platform-specific localization files. Supported output platforms: Android (`strings.xml`), iOS/Swift (`.strings` + header/constants), JSON, Rails YAML, Java `.properties`, `.resx`, and Twine format.
+
+The entry point is `bin/localize`, which reads a `Locfile` (Ruby DSL) from the current directory.
+
+## Architecture
+
+### Data Flow
+
+```
+Locfile (DSL config)
+  → Processor (reads spreadsheet source)
+  → Filter (regex-based key filtering)
+  → LocalizableWriter (dispatches to platform writer)
+  → ERB templates → output files
+```
+
+### Key Abstractions
+
+**`Locfile`** (`lib/localio/locfile.rb`) — DSL parser using `instance_eval`. Stores platform, source credentials, output path, formatter, and filters.
+
+**`Processor`** (`lib/localio/processor.rb`) — Routes to the correct reader based on `:platform` config. Returns a hash of `language => [Segment]` pairs.
+
+**`LocalizableWriter`** (`lib/localio/localizable_writer.rb`) — Routes to the correct writer class. Writers live in `lib/localio/writers/` and use ERB templates from `lib/localio/templates/`.
+
+**`Segment`** — A single translation unit: `{key, value, language}`. **`Term`** — A key with a hash of all language values.
+
+**`Filter`** (`lib/localio/filter.rb`) — Applied after loading; supports `:only` (allowlist) and `:except` (denylist) regex patterns.
+
+**`Formatter`** (`lib/localio/formatter.rb`) — Transforms key names: `:smart`, `:snake_case`, `:camel_case`, `:none`.
+
+### Spreadsheet Format Convention
+
+Spreadsheets must follow a specific structure:
+- A `[key]` marker row with language codes as column headers (default language marked with `*`)
+- Data rows with key in column A, translations in subsequent columns
+- An `[end]` marker row to stop parsing
+- Optional `[comment]` rows for documentation (skipped during parsing)
+
+### Adding a New Platform
+
+1. Create `lib/localio/writers/<platform>_writer.rb` with a `write_localizables(holder, path)` class method
+2. Create corresponding ERB template(s) in `lib/localio/templates/`
+3. Add a case branch in `LocalizableWriter`
+4. Add a case branch in the `platform` DSL accessor in `Locfile`
+5. Add specs in `spec/localio/writers/`
+
+### Adding a New Source Format
+
+1. Create `lib/localio/processors/<format>_processor.rb` with a `load_localizables(config)` class method returning `{language => [Segment]}`
+2. Add a case branch in `Processor`
+3. Add specs in `spec/localio/processors/`
+
+## Notes
+
+- `String` is monkey-patched in `lib/localio/string_helper.rb` with color helpers and case-conversion methods used throughout
+- The `ConfigStore` (`lib/localio/config_store.rb`) persists OAuth tokens/config to a local YAML file (`.localio.yml`)
+- Tests use fixture spreadsheet files in `spec/` directories alongside spec files

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    localio (0.2.0)
+    localio (0.2.4)
       csv (~> 3.2)
       google_drive (~> 3.0)
       nokogiri (~> 1.16)
@@ -11,32 +11,36 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.8)
+    addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
     base64 (0.3.0)
     bigdecimal (4.0.1)
     csv (3.3.5)
     declarative (0.0.20)
     diff-lcs (1.6.2)
-    faraday (1.8.0)
+    faraday (1.10.6)
       faraday-em_http (~> 1.0)
       faraday-em_synchrony (~> 1.0)
       faraday-excon (~> 1.1)
-      faraday-httpclient (~> 1.0.1)
+      faraday-httpclient (~> 1.0)
+      faraday-multipart (~> 1.0)
       faraday-net_http (~> 1.0)
-      faraday-net_http_persistent (~> 1.1)
+      faraday-net_http_persistent (~> 1.0)
       faraday-patron (~> 1.0)
       faraday-rack (~> 1.0)
-      multipart-post (>= 1.2, < 3)
+      faraday-retry (~> 1.0)
       ruby2_keywords (>= 0.0.4)
     faraday-em_http (1.0.0)
     faraday-em_synchrony (1.0.1)
     faraday-excon (1.1.0)
     faraday-httpclient (1.0.1)
+    faraday-multipart (1.2.0)
+      multipart-post (~> 2.0)
     faraday-net_http (1.0.2)
     faraday-net_http_persistent (1.2.0)
     faraday-patron (1.0.0)
     faraday-rack (1.0.0)
+    faraday-retry (1.0.4)
     google-apis-core (0.11.3)
       addressable (~> 2.5, >= 2.5.1)
       googleauth (>= 0.16.2, < 2.a)
@@ -63,7 +67,7 @@ GEM
       signet (~> 0.15)
     httpclient (2.9.0)
       mutex_m
-    jwt (2.10.2)
+    jwt (2.10.3)
       base64
     logger (1.7.0)
     memoist (0.16.2)
@@ -72,15 +76,15 @@ GEM
     multi_json (1.19.1)
     multipart-post (2.4.1)
     mutex_m (0.3.0)
-    nokogiri (1.19.1)
+    nokogiri (1.19.4)
       mini_portile2 (~> 2.8.2)
       racc (~> 1.4)
-    nokogiri (1.19.1-arm64-darwin)
+    nokogiri (1.19.4-arm64-darwin)
       racc (~> 1.4)
-    nokogiri (1.19.1-x86_64-linux-gnu)
+    nokogiri (1.19.4-x86_64-linux-gnu)
       racc (~> 1.4)
     os (1.1.4)
-    public_suffix (7.0.2)
+    public_suffix (7.0.5)
     racc (1.8.1)
     rake (13.3.1)
     representable (3.2.0)
@@ -104,7 +108,7 @@ GEM
     rspec-support (3.13.7)
     ruby-ole (1.2.13.1)
     ruby2_keywords (0.0.5)
-    rubyzip (3.2.2)
+    rubyzip (3.6.0)
     signet (0.21.0)
       addressable (~> 2.8)
       faraday (>= 0.17.5, < 3.a)

data/README.md

@@ -271,6 +271,43 @@ For example, if we wanted to override the default (english) and use spanish inst
 platform :android, :override_default => 'es'
 ```
 
+## Fastlane Integration
+
+Use the [fastlane-plugin-localio](https://github.com/mrmans0n/fastlane-plugin-localio) plugin to run localio as part of your Fastlane workflow.
+
+### Installation
+
+```bash
+fastlane add_plugin localio
+```
+
+### Usage
+
+You can use an existing Locfile:
+
+```ruby
+lane :localize do
+  localio(locfile: "Locfile")
+end
+```
+
+Or configure everything inline:
+
+```ruby
+lane :localize do
+  localio(
+    platform: "android",
+    source: "xlsx",
+    source_path: "translations.xlsx",
+    source_sheet: "Sheet1",
+    output_path: "app/src/main/res",
+    formatting: "smart"
+  )
+end
+```
+
+See the [plugin README](https://github.com/mrmans0n/fastlane-plugin-localio) for the full list of parameters and examples.
+
 ## Contributing
 
 Please read the [contributing guide](https://github.com/mrmans0n/localio/blob/master/CONTRIBUTING.md).

data/lib/localio/version.rb

@@ -1,3 +1,3 @@
 module Localio
-  VERSION = "0.2.1"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: localio
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.4
 platform: ruby
 authors:
 - Nacho Lopez
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-24 00:00:00.000000000 Z
+date: 2026-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -117,9 +117,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".github/workflows/ci.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
 - ".rspec"
 - ".ruby-version"
+- AGENTS.md
+- CLAUDE.md
 - CONTRIBUTING.md
 - Gemfile
 - Gemfile.lock
@@ -127,10 +130,6 @@ files:
 - README.md
 - Rakefile
 - bin/localize
-- docs/plans/2026-02-23-modernization-design.md
-- docs/plans/2026-02-23-modernization.md
-- docs/plans/2026-02-23-twine-writer-design.md
-- docs/plans/2026-02-23-twine-writer.md
 - lib/localio.rb
 - lib/localio/config_store.rb
 - lib/localio/filter.rb
@@ -193,7 +192,7 @@ homepage: https://github.com/mrmans0n/localio
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -208,8 +207,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Generates Android, iOS, Rails, JSON, Java Properties, and .NET ResX localization
   files from spreadsheet sources.

data/docs/plans/2026-02-23-modernization-design.md

@@ -1,91 +0,0 @@
-# Localio Modernization Design
-
-**Date:** 2026-02-23
-**Approach:** Option A — tests first, then dependency updates
-
-## Overview
-
-Modernize the Localio gem in two phases:
-
-1. Write a comprehensive RSpec test suite with fixtures and mocks
-2. Update all dependencies to current versions and target Ruby 3.x, using the test suite as a safety net
-
-## Phase 1: Test Suite
-
-### Structure
-
-```
-spec/
-  spec_helper.rb
-  fixtures/
-    sample.csv          # canonical test data: keys in 3 languages, special chars, comments, multi-level keys
-    sample.xlsx         # small binary fixture
-    sample.xls          # small binary fixture
-  localio/
-    term_spec.rb
-    segment_spec.rb
-    filter_spec.rb
-    formatter_spec.rb
-    template_handler_spec.rb
-    processors/
-      csv_processor_spec.rb
-      xlsx_processor_spec.rb
-      xls_processor_spec.rb
-      google_drive_processor_spec.rb   # mocked worksheet interface
-    writers/
-      android_writer_spec.rb
-      ios_writer_spec.rb
-      swift_writer_spec.rb
-      json_writer_spec.rb
-      rails_writer_spec.rb
-      java_properties_writer_spec.rb
-      resx_writer_spec.rb
-  localio_spec.rb       # end-to-end: CSV fixture → writer → verify output files
-```
-
-### Fixture Data
-
-A single canonical `sample.csv` covers all test scenarios:
-- Normal keys with translations in 3 languages
-- Special characters: ampersands, ellipsis, printf format strings
-- Comment rows
-- Multi-level/nested keys (dot-separated) for JSON nesting tests
-
-The same fixture data drives all processor and writer tests for consistency.
-
-### Testing Strategy Per Layer
-
-**Models (Term, Segment):** Construction, attribute access, `is_comment?` detection.
-
-**Filter:** `only` and `except` with regex patterns against a fixed segment list.
-
-**Formatter:** All 4 modes (`:smart`, `:none`, `:camel_case`, `:snake_case`) against varied key strings.
-
-**Processors:**
-- CSV/XLSX/XLS: Parse real fixture files, assert correct Term extraction, language detection, comment handling
-- Google Drive: Mock the gem's worksheet interface, test the same parsing logic in isolation
-
-**TemplateHandler:** Render ERB templates, write to `Dir.mktmpdir`, assert output matches expected content.
-
-**Writers (all 7):** Feed a fixed Terms array → call writer → assert output files in a temp dir contain expected strings (spot-check key lines, not byte-perfect comparison).
-
-**Pipeline (`localio_spec.rb`):** CSV fixture → Android + JSON writers → verify files exist with correct content.
-
-### Key Test Helpers
-- Shared `let(:terms)` factory via RSpec shared contexts
-- `Dir.mktmpdir` for output isolation in all writer and template tests
-- No network calls; Google Drive mocked at the worksheet interface level
-
-## Phase 2: Dependency Updates
-
-| Gem | Current | Target | Notes |
-|-----|---------|--------|-------|
-| `google_drive` | `~> 1.0` | `~> 3.0` | API changed; processor needs update |
-| `spreadsheet` | `~> 1.0` | `~> 1.3` | Minor updates only |
-| `simple_xlsx_reader` | `~> 1.0` | `~> 2.0` | Breaking changes in v2 |
-| `nokogiri` | `~> 1.6` | `~> 1.16` | Mostly drop-in |
-| `micro-optparse` | `~> 1.2` | remove → stdlib `optparse` | Unmaintained |
-| `bundler` | `~> 1.3` | `~> 2.0` | Dev dep |
-| Ruby | `>= 1.9.2` | `>= 3.0` | Gemspec update |
-
-The green test suite from Phase 1 is the safety net — failures after dep updates pinpoint exactly what broke.