wlt 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8049e360e977622ad37d565010206d18bcc57131
+  data.tar.gz: c6d95f8a82c7cf6ad4c06a6071cb48610b8f6999
+SHA512:
+  metadata.gz: 261e17e4a4214747a293b1b2714a2bae4e680ecdc56f33976115f767dc1e89ca43a87e0332f202b456384b734ff43c61c962e30c809242a4cf4999f530e61656
+  data.tar.gz: '06683dfad19e529147a70e3a79ee8c6e21ab4e89ecaaf52c45c4c056d43c25829b1f63c6695a319c7c5574b44f8c11aafc05e40c4ef224831301dc13dbeb3db4'

data/.gitignore

@@ -0,0 +1,11 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.4.2
+before_install: gem install bundler -v 1.16.0

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Mauro Morales
+
+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,67 @@
+# Watson Language Translator gem
+
+Wlt is a command line application and API to translate text using the Watson
+Language Translator service.
+
+Before you can use Wlt you need to create a set of credentials see:
+https://console.bluemix.net/docs/services/watson/getting-started-credentials.html#getting-credentials-manually
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'wlt'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install wlt
+
+## Usage
+
+You can do translations via the CLI or using the Wlt API
+
+### CLI
+
+Translate a file:
+
+    $ wlt --username=<your-watson-username> --password=<your-watson-password> --file=path/to/file
+
+Save your credentials locally in order not to pass them every time you want to do a translation:
+
+    $ wlt --username=<your-watson-username> --password=<your-watson-password> --save-credentials
+
+Choose different source and target languages:
+
+    $ wlt --source=es --target=en --file=path/to/file
+
+Use process substitution to pass your text directly in the command line:
+
+    $ wlt --file=<(echo "Hello world!")
+
+Print out the help message
+
+    $ wlt --help
+
+### API
+
+```ruby
+require 'wlt'
+
+creds_manager = Wlt::CredsManager.new('<your-watson-username>', '<your-watson-password>')
+translate_args = { text: 'Hello world!', source: 'en', target: 'es' }
+result = Wlt::Translator.new(creds_manager).translate(translate_args)
+```
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/mauromorales/wlt.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/wlt

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+
+require 'optparse'
+require 'wlt'
+
+
+options = {}
+translate_args = {}
+
+parser = OptionParser.new do |parser|
+  parser.on("-u", "--username USERNAME", "The Watson username") do |v|
+    options[:username] = v
+  end
+
+  parser.on("-p", "--password PASSWORD", "The Watson password") do |v|
+    options[:password] = v
+  end
+
+  parser.on("--save-credentials", "Saves the given credentials in $HOME/.wlt/credentials") do
+    options[:save_credentials] = true
+  end
+
+  parser.on("-s", "--source LANG", "Source language (default: en)") do |v|
+    translate_args[:source] = v
+  end
+
+  parser.on("-t", "--target LANG", "Target language (default: es)") do |v|
+    translate_args[:target] = v
+  end
+
+  parser.on("-f", "--file PATH", "File containing text to be translated") do |v|
+    options[:file_path] = v
+  end
+
+  parser.on("-h", "--help", "Prints this message") do |v|
+    puts parser
+    exit
+  end
+end
+
+parser.parse!
+
+creds_manager = Wlt::CredsManager.new
+
+if options[:username] && options[:password]
+  creds_manager.username = options[:username]
+  creds_manager.password = options[:password]
+else
+  begin
+    creds_manager.load
+  rescue Errno::ENOENT
+    puts "Error: Missing credentials"
+    puts parser
+    exit 1
+  end
+end
+
+if options[:save_credentials]
+  creds_manager.save
+  puts "Saved credentials into $HOME/.wlt/credentials"
+  exit
+end
+
+if options[:file_path]
+  begin
+    translate_args[:text] = File.read(options[:file_path])
+  rescue Errno::ENOENT
+    puts "Cannot open file #{options[:file_path]}"
+    exit 1
+  end
+
+  result = Wlt::Translator.new(creds_manager).translate(translate_args)
+  puts result
+else
+  puts "Error: Missing file"
+  puts parser
+  exit 1
+end

data/lib/wlt.rb

@@ -0,0 +1,8 @@
+require 'wlt/version'
+require 'wlt/creds_manager'
+require 'wlt/translator'
+
+module Wlt; end
+
+class Error < RuntimeError; end
+class CredsManagerError < Error; end

data/lib/wlt/creds_manager.rb

@@ -0,0 +1,46 @@
+require 'fileutils'
+
+module Wlt
+
+  class CredsManager
+    attr_accessor :username, :password
+
+    def initialize(username=nil, password=nil)
+      @username = username
+      @password = password
+    end
+
+    def save
+      validate
+
+      wlt_dir = File.join(Dir.home, '.wlt')
+      FileUtils.mkdir_p(wlt_dir)
+      File.open(File.join(wlt_dir, 'credentials'), 'w+') do |file|
+        file.write("WATSON_USERNAME=#{@username}\n")
+        file.write("WATSON_PASSWORD=#{@password}\n")
+      end
+    end
+
+    def load
+      File.open(File.join(Dir.home, '.wlt', 'credentials')) do |file|
+        file.each_line do |line|
+          username = line.match(/WATSON_USERNAME=(.*)/)
+          @username = username[1] if username
+          password = line.match(/WATSON_PASSWORD=(.*)/)
+          @password = password[1] if password
+        end
+      end
+    end
+
+    private
+
+    def invalid_argument(name)
+      "'#{name}' cannot be empty. See: https://console.bluemix.net/docs/services/watson/getting-started-credentials.html#getting-credentials-manually"
+    end
+
+    def validate
+      raise CredsManagerError, 'Missing username' if @username.nil? || @username.empty?
+      raise CredsManagerError, 'Missing password' if @password.nil? || @password.empty?
+    end
+  end
+end

data/lib/wlt/translator.rb

@@ -0,0 +1,26 @@
+require 'net/http'
+
+module Wlt
+  class Translator
+
+    def initialize(authenticator)
+      @authenticator = authenticator
+    end
+
+    def translate(text:, source: 'en', target: 'es')
+      uri = URI('https://gateway.watsonplatform.net/language-translator/api/v2/translate')
+      params = { source: source, target: target, text: text }
+      uri.query = URI.encode_www_form(params)
+
+      req = Net::HTTP::Get.new(uri)
+      req.basic_auth @authenticator.username, @authenticator.password
+
+      http = Net::HTTP.new(uri.hostname, uri.port)
+      http.use_ssl = true
+
+      res = http.request(req)
+
+      res.body
+    end
+  end
+end

data/lib/wlt/version.rb

@@ -0,0 +1,3 @@
+module Wlt
+  VERSION = "0.1.0"
+end

data/wlt.gemspec

@@ -0,0 +1,27 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "wlt/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "wlt"
+  spec.version       = Wlt::VERSION
+  spec.authors       = ["Mauro Morales"]
+  spec.email         = ["contact@mauromorales.com"]
+
+  spec.summary       = %q{Watson Language Translator}
+  spec.description   = %q{Wlt is a command line application and API to translate text using the Watson Language Translator service.}
+  spec.homepage      = "https://github.com/mauromorales/wlt"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.16"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: wlt
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mauro Morales
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-12-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.16'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Wlt is a command line application and API to translate text using the
+  Watson Language Translator service.
+email:
+- contact@mauromorales.com
+executables:
+- wlt
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/wlt
+- lib/wlt.rb
+- lib/wlt/creds_manager.rb
+- lib/wlt/translator.rb
+- lib/wlt/version.rb
+- wlt.gemspec
+homepage: https://github.com/mauromorales/wlt
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: Watson Language Translator
+test_files: []