translate_api 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 90a416412321a8c1a2ae79639bfa9b08fe4136a95382de000e2d85e86dd0f3e2
+  data.tar.gz: 3d7fe373bd31d366b7612e90ad5be874559c756ec96b24aa0d57d684424c05bf
+SHA512:
+  metadata.gz: 52f6a2ebaa3956c30e8bf3ab74756dad624a68b723a0ef229dfd1222a413a1e64c8761828a0dc3298a0f301cdfda410e9447e6755cb123b9ad38b0f2311196d5
+  data.tar.gz: 408ee26e7f326d0376d050cf6a436ef0b5e5cb10d61d02443eeae5e69aa71e7d4167c07e0ca1e3d27172d785e60720cc42505593bcc2227341c09fcbac824f36

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Translate API
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,61 @@
+# Translate API - Ruby SDK
+
+Official Ruby SDK for [Translate API](https://translate-api.com).
+
+## 🚀 Quick Start (For Beginners)
+
+### Step 1: Get Your API Key
+1. Go to [https://translate-api.com](https://translate-api.com)
+2. Click "Login" or "Get Started"
+3. Create an account (it's free to start!)
+4. Go to your Dashboard
+5. Click "Create API Key"
+6. Copy your API key - you'll need it!
+
+### Step 2: Install the SDK
+Open your terminal and run:
+
+```bash
+gem install translate_api
+```
+
+### Step 3: Use It!
+
+```ruby
+require 'translate_api'
+
+# Replace 'your-api-key' with your actual API key from translate-api.com
+client = TranslateAPI::Client.new('your-api-key')
+
+# Translate to one language
+result = client.translate('Hello world', 'es')
+puts result['translations']['es']  # Output: "Hola mundo"
+
+# Translate to multiple languages at once
+result = client.translate('Hello world', ['es', 'fr', 'de'])
+puts result['translations']
+# Output: {"es"=>"Hola mundo", "fr"=>"Bonjour le monde", "de"=>"Hallo Welt"}
+```
+
+## 📖 Full API Reference
+
+### Constructor
+```ruby
+client = TranslateAPI::Client.new(api_key, base_url: 'https://translate-api.com/v1')
+```
+
+### translate(text, target_language)
+Translate text to one or more languages.
+
+### translate_batch(items)
+Translate multiple texts at once.
+
+## 🌍 Supported Languages
+Visit [translate-api.com/documentation](https://translate-api.com/documentation) for a full list.
+
+## ❓ Need Help?
+- Documentation: [translate-api.com/documentation](https://translate-api.com/documentation)
+- Support: support@translate-api.com
+
+## 📝 License
+MIT License

data/lib/translate_api.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+#
+# Translate API - Official Ruby SDK
+#
+# Get your API key at: https://translate-api.com
+# Documentation: https://translate-api.com/documentation
+#
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module TranslateAPI
+  VERSION = "1.0.0"
+
+  class Client
+    attr_reader :api_key, :base_url
+
+    # Create a new Translate API client
+    #
+    # @param api_key [String] Your API key from translate-api.com
+    # @param base_url [String] Optional custom API URL
+    #
+    # @example
+    #   client = TranslateAPI::Client.new('your-api-key')
+    #
+    def initialize(api_key, base_url: 'https://translate-api.com/v1')
+      raise ArgumentError, 'API key is required. Get one at https://translate-api.com' if api_key.nil? || api_key.empty?
+
+      @api_key = api_key
+      @base_url = base_url
+    end
+
+    # Translate text to one or more target languages
+    #
+    # @param text [String] The text to translate
+    # @param target_language [String, Array<String>] Target language code(s)
+    # @return [Hash] Translation response with 'translations', 'success', 'characters_used'
+    #
+    # @example Single language
+    #   result = client.translate('Hello', 'es')
+    #   puts result['translations']['es']  # => "Hola"
+    #
+    # @example Multiple languages
+    #   result = client.translate('Hello', ['es', 'fr'])
+    #   puts result['translations']  # => {"es"=>"Hola", "fr"=>"Bonjour"}
+    #
+    def translate(text, target_language)
+      uri = URI.parse("#{@base_url}/translate")
+
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == 'https'
+
+      request = Net::HTTP::Post.new(uri.path)
+      request['Authorization'] = "Bearer #{@api_key}"
+      request['Content-Type'] = 'application/json'
+      request.body = {
+        text: text,
+        target_language: target_language
+      }.to_json
+
+      response = http.request(request)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        error = JSON.parse(response.body) rescue {}
+        raise StandardError, error['error'] || "Translation failed (HTTP #{response.code})"
+      end
+
+      JSON.parse(response.body)
+    end
+
+    # Translate multiple texts in batch
+    #
+    # @param items [Array<Hash>] Array of {text:, target_language:}
+    # @return [Array<Hash>] Array of translation responses
+    #
+    # @example
+    #   results = client.translate_batch([
+    #     { text: 'Hello', target_language: 'es' },
+    #     { text: 'Goodbye', target_language: 'fr' }
+    #   ])
+    #
+    def translate_batch(items)
+      items.map { |item| translate(item[:text], item[:target_language]) }
+    end
+  end
+end

metadata

@@ -0,0 +1,51 @@
+--- !ruby/object:Gem::Specification
+name: translate_api
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Translate API
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-11-30 00:00:00.000000000 Z
+dependencies: []
+description: Simple and powerful translation API client for Ruby. Translate text to
+  100+ languages with ease.
+email:
+- support@translate-api.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/translate_api.rb
+homepage: https://translate-api.com
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://translate-api.com
+  source_code_uri: https://github.com/Translate-api/translate-api-ruby-sdk
+  changelog_uri: https://github.com/Translate-api/translate-api-ruby-sdk/blob/main/CHANGELOG.md
+  documentation_uri: https://translate-api.com/documentation
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Official Ruby SDK for Translate API
+test_files: []