localio 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e811c8aa9cf8dabaff74b28dca5476b389c46e27a2dbb5addd87177f28abf566
-  data.tar.gz: 6536d23be9e050ec9d579e6fd0bd35af573eba46536f2d711acaf5d8ee086dc3
+  metadata.gz: f1f31b993473369d48f4c412c59ac04e9614ff3d0d614b68e041fa5856c91657
+  data.tar.gz: 502a7d85bb17426d0985328f89488de086fc08692be41c951dc22bc16a517bad
 SHA512:
-  metadata.gz: 2217300fc3ff1610320e23053d97969c93983caf57ecbbc064c5e4018ba4d599b90c71a70ee27bfa5e38ffc3f52bf8c539110c9c55eefdcec4fe8c0960a4d5bd
-  data.tar.gz: 40b1707ad311b028a76a4a0b5f26485153642fc48a89b2e488b7c7b3c13e146f82b55f72bf6a18481082a76b486719c33f1936c83a706d94b14afd7a28b3e230
+  metadata.gz: 10742946a6d8928b4f636bdec770d31364281a4b5070537342656f376500e4a17322c89d8dc755ec91c48d0d0e8e0fe74535a799ee6d990e099b9ec02f9fda3a
+  data.tar.gz: c2135d3b03e5c82250715d03fc4c6354279bc08ec7394bf31ca4edc9b11535dc53efd1dcdafb5591a9be4c2900ce06da2d1325dd0aae8906c1d2263e618d59d7

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/AGENTS.md

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

data/CLAUDE.md

@@ -0,0 +1,79 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in 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/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/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.2)
       csv (~> 3.2)
       google_drive (~> 3.0)
       nokogiri (~> 1.16)

data/lib/localio/version.rb

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

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: localio
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - Nacho Lopez
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2026-02-24 00:00:00.000000000 Z
@@ -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
@@ -193,7 +196,7 @@ homepage: https://github.com/mrmans0n/localio
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -208,8 +211,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.