localio 0.1.7 → 0.2.1

data/spec/localio/string_helper_spec.rb

@@ -0,0 +1,49 @@
+require 'localio/string_helper'
+
+RSpec.describe String do
+  describe '#space_to_underscore' do
+    it { expect('hello world'.space_to_underscore).to eq('hello_world') }
+    it { expect('hello'.space_to_underscore).to eq('hello') }
+  end
+
+  describe '#strip_tag' do
+    it 'strips single-letter bracket tags from the start' do
+      expect('[a]hello'.strip_tag).to eq('hello')
+    end
+    it 'does not strip multi-letter bracket tags' do
+      expect('[comment]hello'.strip_tag).to eq('[comment]hello')
+    end
+    it 'does not strip tags not at the start' do
+      expect('hello[a]'.strip_tag).to eq('hello[a]')
+    end
+  end
+
+  describe '#camel_case' do
+    it { expect('hello_world'.camel_case).to eq('HelloWorld') }
+    it { expect('HelloWorld'.camel_case).to eq('HelloWorld') }
+  end
+
+  describe '#replace_escaped' do
+    it { expect('a`+b'.replace_escaped).to eq('a+b') }
+    it { expect('a`=b'.replace_escaped).to eq('a=b') }
+    it { expect("a\\+b".replace_escaped).to eq('a+b') }
+  end
+
+  describe '#underscore' do
+    it { expect('HelloWorld'.underscore).to eq('hello_world') }
+  end
+
+  describe '#uncapitalize' do
+    it { expect('Hello'.uncapitalize).to eq('hello') }
+  end
+
+  describe '#blank?' do
+    it { expect(''.blank?).to be true }
+    it { expect('hello'.blank?).to be false }
+  end
+
+  describe '#green / #yellow / #red / #cyan' do
+    it { expect('ok'.green).to include("\e[32m") }
+    it { expect('ok'.yellow).to include("\e[33m") }
+  end
+end

data/spec/localio/template_handler_spec.rb

@@ -0,0 +1,67 @@
+require 'localio/string_helper'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/template_handler'
+
+RSpec.describe TemplateHandler do
+  let(:holder) do
+    h = SegmentsListHolder.new('en')
+    h.segments << Segment.new('app_name', 'My App', 'en')
+    h.segments << Segment.new('greeting', 'Hello world', 'en')
+    h
+  end
+
+  describe '.process_template' do
+    it 'creates the output file in the target directory' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        target  = File.join(tmpdir, 'out')
+        Dir.chdir(workdir) do
+          TemplateHandler.process_template('rails_localizable.erb', target, 'en.yml', holder)
+          expect(File).to exist(File.join(target, 'en.yml'))
+        end
+      end
+    end
+
+    it 'renders ERB template content correctly' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        target  = File.join(tmpdir, 'out')
+        Dir.chdir(workdir) do
+          TemplateHandler.process_template('rails_localizable.erb', target, 'en.yml', holder)
+          content = File.read(File.join(target, 'en.yml'))
+          expect(content).to include('en:')
+          expect(content).to include('app_name: "My App"')
+          expect(content).to include('greeting: "Hello world"')
+        end
+      end
+    end
+
+    it 'does not leave a stray temp file in the working directory' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        target  = File.join(tmpdir, 'out')
+        Dir.chdir(workdir) do
+          TemplateHandler.process_template('rails_localizable.erb', target, 'en.yml', holder)
+          files = Dir.entries(workdir).reject { |f| f.start_with?('.') }
+          expect(files).to be_empty
+        end
+      end
+    end
+
+    it 'creates subdirectories as needed' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) do
+          subdir = File.join(tmpdir, 'out', 'values')
+          TemplateHandler.process_template('rails_localizable.erb', subdir, 'en.yml', holder)
+          expect(File).to exist(File.join(subdir, 'en.yml'))
+        end
+      end
+    end
+  end
+end

data/spec/localio/term_spec.rb

@@ -0,0 +1,24 @@
+require 'localio/term'
+
+RSpec.describe Term do
+  subject(:term) { Term.new('app_name') }
+
+  it 'stores the keyword' do
+    expect(term.keyword).to eq('app_name')
+  end
+
+  it 'initializes with empty values hash' do
+    expect(term.values).to be_empty
+  end
+
+  it 'stores values by language' do
+    term.values['en'] = 'My App'
+    expect(term.values['en']).to eq('My App')
+  end
+
+  describe '#is_comment?' do
+    it { expect(Term.new('[comment]').is_comment?).to be true }
+    it { expect(Term.new('[COMMENT]').is_comment?).to be true }
+    it { expect(term.is_comment?).to be false }
+  end
+end

data/spec/localio/writers/android_writer_spec.rb

@@ -0,0 +1,71 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/android_writer'
+
+RSpec.describe AndroidWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates values/strings.xml for the default language' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'values', 'strings.xml'))
+      end
+    end
+
+    it 'creates values-{lang}/strings.xml for non-default languages' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'values-es', 'strings.xml'))
+        expect(File).to exist(File.join(tmpdir, 'values-fr', 'strings.xml'))
+      end
+    end
+
+    it 'converts & to & in translations' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('& Jerry')
+        expect(content).not_to include('"Tom & Jerry"')
+      end
+    end
+
+    it 'converts ... to … in translations' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('Wait…')
+      end
+    end
+
+    it 'converts %@ to %s in translations' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('%s world')
+      end
+    end
+
+    it 'renders comment rows as XML comments' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('<!-- Section General -->')
+      end
+    end
+
+    it 'includes app_name string resource' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { AndroidWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('<string name="app_name">My App</string>')
+      end
+    end
+  end
+end

data/spec/localio/writers/ios_writer_spec.rb

@@ -0,0 +1,63 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/ios_writer'
+
+RSpec.describe IosWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates Localizable.strings in {lang}.lproj/ for each language' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { IosWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'en.lproj', 'Localizable.strings'))
+        expect(File).to exist(File.join(tmpdir, 'es.lproj', 'Localizable.strings'))
+      end
+    end
+
+    it 'creates LocalizableConstants.h by default' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { IosWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'LocalizableConstants.h'))
+      end
+    end
+
+    it 'skips LocalizableConstants.h when create_constants is false' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { IosWriter.write(languages, terms, tmpdir, :smart, options.merge(create_constants: false)) }
+        expect(File).not_to exist(File.join(tmpdir, 'LocalizableConstants.h'))
+      end
+    end
+
+    it 'renders comment rows as line comments' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { IosWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'en.lproj', 'Localizable.strings'))
+        expect(content).to include('// Section General')
+      end
+    end
+
+    it 'includes translation values' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { IosWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'en.lproj', 'Localizable.strings'))
+        expect(content).to include('My App')
+      end
+    end
+  end
+end

data/spec/localio/writers/java_properties_writer_spec.rb

@@ -0,0 +1,35 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/java_properties_writer'
+
+RSpec.describe JavaPropertiesWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates language_{lang}.properties for each language' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JavaPropertiesWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'language_en.properties'))
+        expect(File).to exist(File.join(tmpdir, 'language_es.properties'))
+      end
+    end
+
+    it 'includes translation values' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JavaPropertiesWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'language_en.properties'))
+        expect(content).to include('My App')
+      end
+    end
+  end
+end

data/spec/localio/writers/json_writer_spec.rb

@@ -0,0 +1,57 @@
+require 'json'
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/json_writer'
+
+RSpec.describe JsonWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates strings-{lang}.json for each language' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JsonWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'strings-en.json'))
+        expect(File).to exist(File.join(tmpdir, 'strings-es.json'))
+        expect(File).to exist(File.join(tmpdir, 'strings-fr.json'))
+      end
+    end
+
+    it 'produces valid JSON' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JsonWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'strings-en.json'))
+        expect { JSON.parse(content) }.not_to raise_error
+      end
+    end
+
+    it 'includes translation values' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JsonWriter.write(languages, terms, tmpdir, :smart, options) }
+        data = JSON.parse(File.read(File.join(tmpdir, 'strings-en.json')))
+        expect(data['translations']['app_name']).to eq('My App')
+      end
+    end
+
+    it 'sets correct language in meta' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { JsonWriter.write(languages, terms, tmpdir, :smart, options) }
+        data = JSON.parse(File.read(File.join(tmpdir, 'strings-es.json')))
+        expect(data['meta']['language']).to eq('es')
+      end
+    end
+  end
+end

data/spec/localio/writers/rails_writer_spec.rb

@@ -0,0 +1,47 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/rails_writer'
+
+RSpec.describe RailsWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates {lang}.yml for each language' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { RailsWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'en.yml'))
+        expect(File).to exist(File.join(tmpdir, 'es.yml'))
+        expect(File).to exist(File.join(tmpdir, 'fr.yml'))
+      end
+    end
+
+    it 'starts YAML with the language key' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { RailsWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'en.yml'))
+        expect(content).to include('en:')
+        expect(content).to include('app_name: "My App"')
+      end
+    end
+
+    it 'renders comment rows as YAML comments' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { RailsWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'en.yml'))
+        expect(content).to include('# Section General')
+      end
+    end
+  end
+end

data/spec/localio/writers/resx_writer_spec.rb

@@ -0,0 +1,44 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/resx_writer'
+
+RSpec.describe ResXWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates Resources.resx for the default language' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { ResXWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'Resources.resx'))
+      end
+    end
+
+    it 'creates Resources.{lang}.resx for non-default languages' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { ResXWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'Resources.es.resx'))
+        expect(File).to exist(File.join(tmpdir, 'Resources.fr.resx'))
+      end
+    end
+
+    it 'uses custom resource_file name when specified' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { ResXWriter.write(languages, terms, tmpdir, :smart, options.merge(resource_file: 'Strings')) }
+        expect(File).to exist(File.join(tmpdir, 'Strings.resx'))
+        expect(File).to exist(File.join(tmpdir, 'Strings.es.resx'))
+      end
+    end
+  end
+end

data/spec/localio/writers/swift_writer_spec.rb

@@ -0,0 +1,42 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/writers/swift_writer'
+
+RSpec.describe SwiftWriter do
+  include_context 'standard terms'
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates Localizable.strings in {lang}.lproj/' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { SwiftWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'en.lproj', 'Localizable.strings'))
+      end
+    end
+
+    it 'creates LocalizableConstants.swift by default' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { SwiftWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'LocalizableConstants.swift'))
+      end
+    end
+
+    it 'skips LocalizableConstants.swift when create_constants is false' do
+      Dir.mktmpdir do |tmpdir|
+        workdir = File.join(tmpdir, 'work')
+        FileUtils.mkdir_p(workdir)
+        Dir.chdir(workdir) { SwiftWriter.write(languages, terms, tmpdir, :smart, options.merge(create_constants: false)) }
+        expect(File).not_to exist(File.join(tmpdir, 'LocalizableConstants.swift'))
+      end
+    end
+  end
+end

data/spec/localio/writers/twine_writer_spec.rb

@@ -0,0 +1,68 @@
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/formatter'
+require 'localio/writers/twine_writer'
+
+RSpec.describe TwineWriter do
+  include_context 'standard terms'
+  # standard terms provides: languages {'en'=>1,'es'=>2,'fr'=>3},
+  # default_language 'en', and terms:
+  #   [comment] "Section General", app_name, greeting, dots_test, ampersand_test
+
+  let(:options) { { default_language: 'en' } }
+
+  describe '.write' do
+    it 'creates strings.txt in the output path' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { TwineWriter.write(languages, terms, tmpdir, :smart, options) }
+        expect(File).to exist(File.join(tmpdir, 'strings.txt'))
+      end
+    end
+
+    it 'uses a custom filename when :output_file is specified' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) do
+          TwineWriter.write(languages, terms, tmpdir, :smart, options.merge(output_file: 'translations.txt'))
+        end
+        expect(File).to exist(File.join(tmpdir, 'translations.txt'))
+        expect(File).not_to exist(File.join(tmpdir, 'strings.txt'))
+      end
+    end
+
+    it 'includes all languages for each key' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { TwineWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'strings.txt'))
+        expect(content).to include('en = My App')
+        expect(content).to include('es = Mi Aplicación')
+        expect(content).to include('fr = Mon Application')
+      end
+    end
+
+    it 'writes [init-node] terms as [[section]] headers' do
+      section_terms = [
+        Term.new('[init-node]').tap { |t| t.values['en'] = 'General'; t.values['es'] = 'General'; t.values['fr'] = 'General' },
+        Term.new('app_name').tap   { |t| t.values['en'] = 'My App';   t.values['es'] = 'Mi App';  t.values['fr'] = 'Mon App' },
+        Term.new('[end-node]').tap { |t| t.values['en'] = 'end';      t.values['es'] = 'end';     t.values['fr'] = 'end' },
+      ]
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { TwineWriter.write(languages, section_terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'strings.txt'))
+        expect(content).to include('[[General]]')
+      end
+    end
+
+    it 'attaches [comment] value as comment = on the following key' do
+      Dir.mktmpdir do |tmpdir|
+        Dir.chdir(tmpdir) { TwineWriter.write(languages, terms, tmpdir, :smart, options) }
+        content = File.read(File.join(tmpdir, 'strings.txt'))
+        # [comment] "Section General" appears before app_name and attaches to it
+        expect(content).to include("\t\tcomment = Section General")
+        # The comment block appears before the greeting key block
+        comment_pos  = content.index('comment = Section General')
+        greeting_pos = content.index('[greeting]')
+        expect(comment_pos).to be < greeting_pos
+      end
+    end
+  end
+end

data/spec/localio_spec.rb

@@ -0,0 +1,62 @@
+require 'json'
+require 'localio/string_helper'
+require 'localio/term'
+require 'localio/segment'
+require 'localio/segments_list_holder'
+require 'localio/filter'
+require 'localio/formatter'
+require 'localio/template_handler'
+require 'localio/processors/csv_processor'
+require 'localio/writers/android_writer'
+require 'localio/writers/json_writer'
+
+RSpec.describe 'Localio pipeline' do
+  let(:fixture_path) { File.expand_path('fixtures/sample.csv', __dir__) }
+
+  it 'processes CSV and writes Android strings.xml with correct transformations' do
+    Dir.mktmpdir do |tmpdir|
+      workdir = File.join(tmpdir, 'work')
+      FileUtils.mkdir_p(workdir)
+      Dir.chdir(workdir) do
+        result = CsvProcessor.load_localizables({}, { path: fixture_path })
+        AndroidWriter.write(result[:languages], result[:segments], tmpdir, :smart,
+                            { default_language: result[:default_language] })
+
+        content = File.read(File.join(tmpdir, 'values', 'strings.xml'))
+        expect(content).to include('<string name="app_name">My App</string>')
+        expect(content).to include('&amp; Jerry')
+        expect(content).to include('Wait…')
+        expect(content).to include('%s world')
+        expect(content).to include('<!-- Section General -->')
+      end
+    end
+  end
+
+  it 'processes CSV and writes valid JSON with correct content' do
+    Dir.mktmpdir do |tmpdir|
+      workdir = File.join(tmpdir, 'work')
+      FileUtils.mkdir_p(workdir)
+      Dir.chdir(workdir) do
+        result = CsvProcessor.load_localizables({}, { path: fixture_path })
+        JsonWriter.write(result[:languages], result[:segments], tmpdir, :smart,
+                         { default_language: result[:default_language] })
+
+        data = JSON.parse(File.read(File.join(tmpdir, 'strings-en.json')))
+        expect(data['translations']['app_name']).to eq('My App')
+        expect(data['meta']['language']).to eq('en')
+      end
+    end
+  end
+
+  it 'applies only filter before writing' do
+    result = CsvProcessor.load_localizables({}, { path: fixture_path })
+    filtered = Filter.apply_filter(result[:segments], { keys: 'app_' }, nil)
+    expect(filtered.map(&:keyword)).to eq(['app_name'])
+  end
+
+  it 'applies except filter before writing' do
+    result = CsvProcessor.load_localizables({}, { path: fixture_path })
+    filtered = Filter.apply_filter(result[:segments], nil, { keys: 'dots_|ampersand_' })
+    expect(filtered.map(&:keyword)).not_to include('dots_test', 'ampersand_test')
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require 'tmpdir'
+require 'fileutils'
+# Load nokogiri eagerly so it is available before any spec file runs.
+# Some specs stub $LOADED_FEATURES for google_drive (which also requires
+# nokogiri internally); loading nokogiri here first ensures SimpleXlsxReader
+# and android_writer can always find the Nokogiri constant.
+require 'nokogiri'
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+Dir[File.expand_path('support/**/*.rb', __dir__)].each { |f| require f }
+
+RSpec.configure do |config|
+  config.expect_with :rspec do |c|
+    c.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.filter_run_when_matching :focus
+  config.disable_monkey_patching!
+  config.order = :random
+end