tr4n5l4te 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d228d06a6c7ee98997991fdb7324100d55388e31a645732b41a038757507cc1
-  data.tar.gz: 6ef946a28f7a103e94e7a663bdbd930a4d75c5681addbedc73fa4218572a2868
+  metadata.gz: de91f2f7be53edf09dac7ac551203443908e35313912974a829214b9171bf470
+  data.tar.gz: 6406468eb4da61b7fcb1448a24842b0a8125cb461680f673cbf7a82e5c0024d6
 SHA512:
-  metadata.gz: bcc38177c0cbfe45b3c74b5d37537213adf59dff52c75d3b1b8a20cfc82fb69f9a3640ad614e52d38e6f807a427cce12b86b93f3bbed1bd4e5ab4356bc31bd4c
-  data.tar.gz: 2febf98bedb51028dae7512f81fede2c9e816964a86029ba6ea621167ff8f71ba2f9b9157fa815b6efca02cf880ec8bf5533250f1c2f1f252bd217b6111649bd
+  metadata.gz: bd08cbe5857f621d10569ce363e34364c88497b5688025b66790e770602af8e1622cc72b1ee64685544b17b2993cea2643d89e6bb838000611379f971f4d39fc
+  data.tar.gz: '0381e45fd11649394d0002c8e648ff1cb2be416e47dc5fdb84425f6f4a3a6fe69dff574b967e13bbf0101e0470e39d050bf15e5dbd4b26bd7bd4beba0e6f2e1f'

data/CHANGELOG

@@ -1,3 +1,10 @@
+*1.1.0* (February 17, 2026)
+
+* Add proxy support for Net::HTTP requests (host:port or user:pass@host:port)
+* Add -p/--proxy CLI option
+* Add configurable proxy via Tr4n5l4te.configure
+* Update README with proxy documentation
+
 *1.0.0* (February 14, 2026)
 
 * Replace PhantomJS/Poltergeist with direct HTTP translation via Google's undocumented translate endpoint

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    tr4n5l4te (1.0.0)
+    tr4n5l4te (1.1.0)
       colored (~> 1)
       midwire_common (~> 0.1)
       optimist (~> 3.0)

data/README.md

@@ -1,15 +1,13 @@
 # Tr4n5l4te
 
-**Version: 0.1.17**
+**Version: 1.1.0**
 
 Use Google Translate without an API key.
 
-Like me, maybe you've found that Google makes it a pain to work with their API. Tr4n5l4te gets around all that.
+Like me, maybe you've found that Google makes it a pain to work with their API. Tr4n5l4te gets around all that by using Google's free translation endpoint directly via HTTP — no browser, no API key, no headless dependencies.
 
 ## Installation
 
-First, install [PhantomJS](http://phantomjs.org/).
-
 Add this line to your application's Gemfile:
 
 ```ruby
@@ -24,6 +22,8 @@ Or install it yourself as:
 
     $ gem install tr4n5l4te
 
+Requires Ruby >= 3.2.
+
 ## Usage
 
 In your code:
@@ -41,6 +41,8 @@ end
 # => cómo estás
 ```
 
+Ruby string interpolation variables (`%{var}`) are preserved through translation.
+
 ### Command Line
 
     ➤ ./exe/translate -h
@@ -49,7 +51,8 @@ end
       -l, --lang=<s>          Destination language
       -i, --list              List known languages
       -s, --sleep-time=<i>    Sleep time (default: 2)
-      -t, --timeout=<i>       Poltergeist timeout option (default: 30)
+      -t, --timeout=<i>       HTTP request timeout (default: 30)
+      -p, --proxy=<s>         Proxy - host:port or user:pass@host:port
       -v, --verbose           Be verbose with output
       -h, --help              Show this message
 
@@ -63,10 +66,39 @@ The translator will sleep for 2 seconds, by default, between each string transla
 
 Warning: If you pass in '0' and translate a large file, it is very likely that Google will ban your IP address.
 
+### Proxy Support
+
+Route requests through an HTTP proxy to avoid IP bans or to use from behind a firewall:
+
+    $ ./exe/translate -y config/locales/en.yml -l French -p proxy.example.com:8080
+
+With authentication:
+
+    $ ./exe/translate -y config/locales/en.yml -l French -p user:pass@proxy.example.com:8080
+
+You can also configure a proxy programmatically:
+
+```ruby
+Tr4n5l4te.configure do |config|
+  config.proxy = { addr: 'proxy.example.com', port: 8080 }
+  # or with authentication:
+  config.proxy = { addr: 'proxy.example.com', port: 8080, user: 'user', pass: 'pass' }
+end
+```
+
 To list all known languages
 
     $ ./exe/translate --list
 
+## Configuration
+
+```ruby
+Tr4n5l4te.configure do |config|
+  config.timeout = 60 # HTTP request timeout in seconds (default: 30)
+  config.proxy = { addr: 'proxy.example.com', port: 8080 } # optional HTTP proxy
+end
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

data/lib/tr4n5l4te/configuration.rb

@@ -2,10 +2,11 @@
 
 module Tr4n5l4te
   class Configuration
-    attr_accessor :timeout
+    attr_accessor :timeout, :proxy
 
     def initialize
       @timeout = 30
+      @proxy = nil
     end
   end
 end

data/lib/tr4n5l4te/runner.rb

@@ -7,6 +7,7 @@ require 'midwire_common/string'
 require 'pry' unless ENV.fetch('GEM_ENV', nil).nil?
 
 module Tr4n5l4te
+  # rubocop:disable Metrics/ClassLength
   class Runner
     attr_accessor :logger, :options, :count
 
@@ -24,10 +25,7 @@ module Tr4n5l4te
       log_identifier(start_time)
       @count = 0
 
-      # configure
-      Tr4n5l4te.configure do |config|
-        config.timeout = options[:timeout]
-      end
+      apply_configuration
 
       hash = YAML.load_file(options[:yaml_file])
       translated = process(hash)
@@ -109,6 +107,11 @@ module Tr4n5l4te
           'HTTP request timeout - default 30',
           type: :integer, default: 30, short: 't'
         )
+        opt(
+          :proxy,
+          'Proxy - host:port or user:pass@host:port',
+          type: :string, required: false, short: 'p'
+        )
         opt(
           :verbose,
           'Be verbose with output',
@@ -138,9 +141,29 @@ module Tr4n5l4te
     end
     # rubocop:enable Metrics/AbcSize
 
+    def apply_configuration
+      Tr4n5l4te.configure do |config|
+        config.timeout = options[:timeout]
+        config.proxy = parse_proxy(options[:proxy]) if options[:proxy]
+      end
+    end
+
+    def parse_proxy(proxy_string)
+      if proxy_string.include?('@')
+        auth, host_port = proxy_string.split('@', 2)
+        user, pass = auth.split(':', 2)
+        addr, port = host_port.split(':', 2)
+        { addr:, port: port.to_i, user:, pass: }
+      else
+        addr, port = proxy_string.split(':', 2)
+        { addr:, port: port.to_i }
+      end
+    end
+
     def log_identifier(start_time)
       timestr = start_time.strftime('%H:%M:%S.%3N')
       puts("Starting Tr4n5l4te v#{Tr4n5l4te::VERSION} @#{timestr}".green)
     end
   end
+  # rubocop:enable Metrics/ClassLength
 end

data/lib/tr4n5l4te/translator.rb

@@ -44,14 +44,22 @@ module Tr4n5l4te
     end
 
     def build_http(uri)
-      timeout = Tr4n5l4te.configuration.timeout
-      http = Net::HTTP.new(uri.host, uri.port)
+      config = Tr4n5l4te.configuration
+      http = create_http_client(uri, config.proxy)
       http.use_ssl = true
-      http.open_timeout = timeout
-      http.read_timeout = timeout
+      http.open_timeout = config.timeout
+      http.read_timeout = config.timeout
       http
     end
 
+    def create_http_client(uri, proxy)
+      if proxy
+        Net::HTTP.new(uri.host, uri.port, proxy[:addr], proxy[:port], proxy[:user], proxy[:pass])
+      else
+        Net::HTTP.new(uri.host, uri.port)
+      end
+    end
+
     def extract_translation(body)
       parsed = JSON.parse(body)
       parsed[0].map { |segment| segment[0] }.join

data/lib/tr4n5l4te/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tr4n5l4te
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: tr4n5l4te
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Chris Blackburn
 bindir: exe
 cert_chain: []
-date: 2026-02-14 00:00:00.000000000 Z
+date: 2026-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colored