julius 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8fae0d4d7635d1a147f0e69aebb0f0c8f9b4e9ef
+  data.tar.gz: 6a005282f6f17ee41813f4c230fffd8f627462b2
+SHA512:
+  metadata.gz: 56230ef389f291e92898c7358c29ba69acd6c6392312876eeb69ba4847f7d7892d56ae7173f2cba2062fa727ce9c85abeef44492dd2a66e2bc7e1a428982b0f6
+  data.tar.gz: 8097961a9c2c4beb45290aecbac0e58bb20f9e63c863925f13891e61169cab3b21ed3bdd1aa4a761285af42ab8fcb14efd75a3e47300eca3cb64f85da5fa2e3d

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in julius.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Hajime WAKAHARA
+
+MIT License
+
+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,41 @@
+# Julius [![Build Status](https://travis-ci.org/hadzimme/julius.png)](https://travis-ci.org/hadzimme/julius)
+
+Get results from module mode Julius.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'julius'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install julius
+
+## Usage
+
+```ruby
+require 'julius'
+
+julius = Julius.new
+julius.each_message do |message, prompt|
+  prompt.terminate
+  case message.name
+  when :RECOGOUT
+    puts message.sentence
+  end
+  prompt.resume
+end
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,11 @@
+require "bundler/gem_tasks"
+
+Bundler.setup
+require 'rspec/core/rake_task'
+
+desc 'run spec'
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = ["-c", "-fs"]
+end
+
+task :default => :spec

data/julius.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'julius/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "julius"
+  gem.version       = Julius::VERSION
+  gem.authors       = ["Hajime WAKAHARA"]
+  gem.email         = ["hajime.wakahara@gmail.com"]
+  gem.description   = %q{Get results from module mode Julius.}
+  gem.summary       = %q{A wrapper for Julius, the Open-Source Large Vocabulary CSR Engine}
+  gem.homepage      = "https://github.com/hadzimme/julius"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  gem.required_ruby_version = '>= 1.9'
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
+end

data/lib/julius.rb

@@ -0,0 +1,32 @@
+require 'socket'
+require 'rexml/document'
+require 'julius/version'
+require 'julius/message'
+require 'julius/command'
+require 'julius/prompt'
+
+class Julius
+  def initialize(arg = {})
+    @host = arg[:host] || 'localhost'
+    @port = arg[:port] || 10500
+  end
+
+  def each_message
+    return self.to_enum(__method__) unless block_given?
+    socket = TCPSocket.new(@host, @port)
+    prompt = Prompt.new(socket)
+    xml_enum(socket).each do |xml|
+      yield(Message.init(xml), prompt)
+    end
+    self
+  end
+
+  private
+  def xml_enum(socket)
+    Enumerator.new do |yielder|
+      while line = socket.readline(".\n")
+        yielder << line.force_encoding('UTF-8').sub(/\.\n$/, '')
+      end
+    end
+  end
+end

data/lib/julius/command.rb

@@ -0,0 +1,43 @@
+class Julius
+  class Command
+    class Status            < Command; end
+    class Die               < Command; end
+    class Version           < Command; end
+    class Pause             < Command; end
+    class Terminate         < Command; end
+    class Resume            < Command; end
+    class Currentprocess    < Command; end
+    class Shiftprocess      < Command; end
+    class Addprocess        < Command; end
+    class Delprocess        < Command; end
+    class Listprocess       < Command; end
+    class Deactivateprocess < Command; end
+    class Activateprocess   < Command; end
+    class Graminfo          < Command; end
+    class Changegram        < Command; end
+    class Addgram           < Command; end
+    class Delgram           < Command; end
+    class Deactivategram    < Command; end
+    class Activategram      < Command; end
+    class Inputonchange     < Command; end
+    class Syncgram          < Command; end
+    class Addword           < Command; end
+
+    def initialize(*args)
+      @args = args
+    end
+
+    def to_s
+      if @args.size > 0
+        "#{name} #{@args.join(' ')}"
+      else
+        name
+      end
+    end
+
+    private
+    def name
+      self.class.name.upcase[/[A-Z]+$/]
+    end
+  end
+end

data/lib/julius/message.rb

@@ -0,0 +1,116 @@
+class Julius
+  class Message
+    class ElementError < StandardError; end
+
+    class Startproc  < Message; end
+    class Endproc    < Message; end
+    class Startrecog < Message; end
+    class Endrecog   < Message; end
+
+    class Input < Message
+      attr_reader :status, :time
+    end
+
+    class Inputparam < Message
+      attr_reader :frames, :msec
+    end
+
+    class GMM < Message
+      attr_reader :result, :cmscore
+    end
+
+    class Recogout < Message
+      include Enumerable
+      class Shypo < Message
+        include Enumerable
+        class Whypo < Message
+          attr_reader :word, :classid, :phone, :cm
+          def to_s
+            @word
+          end
+        end
+
+        def initialize(element)
+          @whypo_list = element.elements.map do |element|
+            Whypo.new(element)
+          end
+          super(element)
+        end
+        attr_reader :rank, :score
+
+        def each(&block)
+          return self.to_enum unless block_given?
+          @whypo_list.each(&block)
+          self
+        end
+      end
+
+      def initialize(element)
+        @shypo_list = element.elements.map do |element|
+          Shypo.new(element)
+        end
+        super(element)
+      end
+
+      def each(&block)
+        return self.to_enum unless block_given?
+        @shypo_list.each(&block)
+        self
+      end
+
+      def first
+        @shypo_list.first
+      end
+
+      def [] nth
+        @shypo_list[nth]
+      end
+
+      alias at []
+
+      def sentence
+        self.first.map{|whypo| whypo.to_s }.join
+      end
+    end
+
+    class Recogfail < Message; end
+
+    class Rejected < Message
+      attr_reader :reason
+    end
+
+    class Graphout < Message; end
+    class Graminfo < Message; end
+
+    class Sysinfo < Message
+      attr_reader :process
+    end
+
+    class Engineinfo < Message
+      attr_reader :type, :version, :conf
+    end
+
+    class Grammar < Message
+      attr_reader :status, :reason
+    end
+
+    class Recogprocess < Message; end
+
+    def self.init(xml)
+      document = REXML::Document.new(xml.gsub(/<(\/?)s>/){ "&lt;#{$1}s&gt;" })
+      eval(document.root.name.capitalize).new(document.root)
+    rescue NameError
+      raise ElementError, "invalid XML element found: #{document.root.name}"
+    end
+
+    def initialize(element)
+      element.attributes.each do |attribute|
+        self.instance_variable_set("@#{attribute[0].downcase}", attribute[1])
+      end
+    end
+
+    def name
+      self.class.name.upcase[/[A-Z]+$/].intern
+    end
+  end
+end

data/lib/julius/prompt.rb

@@ -0,0 +1,16 @@
+class Julius
+  class Prompt
+    class NoCommandError < StandardError; end
+
+    def initialize(socket)
+      @socket = socket
+    end
+
+    def method_missing(name, *args)
+      command = eval("Command::#{name.capitalize}").new(*args)
+      @socket.puts(command.to_s)
+    rescue NameError
+      raise NoCommandError, "the command '#{name}' is not supported."
+    end
+  end
+end

data/lib/julius/version.rb

@@ -0,0 +1,3 @@
+class Julius
+  VERSION = "0.0.1"
+end

data/spec/julius_spec.rb

@@ -0,0 +1,119 @@
+# coding: utf-8
+
+require 'rspec'
+require 'julius'
+
+describe Julius::Message do
+  context 'when initialized with XML "<STARTPROC/>"' do
+    subject { message = Julius::Message.init('<STARTPROC/>') }
+    it { should be_an_instance_of(Julius::Message::Startproc) }
+    it { should respond_to :name }
+    its(:name){ should eq :STARTPROC }
+  end
+
+  context 'when initialized with unknown XML' do
+    subject { lambda { Julius::Message.init('<FOO/>') } }
+    it { should raise_error Julius::Message::ElementError }
+  end
+end
+
+describe Julius::Message::Recogout do
+  before do
+    @xml = <<EOS # validなXMLでない
+<RECOGOUT>
+  <SHYPO RANK="1" SCORE="-3214.712891">
+    <WHYPO WORD="" CLASSID="<s>" PHONE="silB" CM="0.244"/>
+    <WHYPO WORD="送れ" CLASSID="送れ:オクレ:送れる:239" PHONE="o k u r e" CM="0.198"/>
+    <WHYPO WORD="ます" CLASSID="ます:マス:ます:146" PHONE="m a s u" CM="0.723"/>
+    <WHYPO WORD="か" CLASSID="か:カ:か:72" PHONE="k a" CM="0.411"/>
+    <WHYPO WORD="？" CLASSID="？:？:？:5" PHONE="sp" CM="0.111"/>
+    <WHYPO WORD="" CLASSID="</s>" PHONE="silE" CM="1.000"/>
+  </SHYPO>
+</RECOGOUT>
+EOS
+    @message = Julius::Message.init(@xml)
+  end
+  subject { @message }
+  it { should respond_to :each }
+  it { should respond_to :first }
+  it { should respond_to :sentence }
+  its(:sentence){ should eq '送れますか？' }
+  context 'each' do
+    it do
+      expect {|block| @message.each(&block) }.to yield_control
+    end
+    it do
+      expect {|block| @message.each(&block) }.to yield_with_args(
+        Julius::Message::Recogout::Shypo)
+    end
+  end
+  context 'first' do
+    subject { @message.first }
+    it { should be_an_instance_of Julius::Message::Recogout::Shypo }
+    context 'each' do
+      # it do
+      #   expect {|block| @message.first.each(&block) }.to yield_control
+      # end
+      it do
+        expect {|block| @message.first.each(&block) }.to yield_successive_args(
+          Julius::Message::Recogout::Shypo::Whypo,
+          Julius::Message::Recogout::Shypo::Whypo,
+          Julius::Message::Recogout::Shypo::Whypo,
+          Julius::Message::Recogout::Shypo::Whypo,
+          Julius::Message::Recogout::Shypo::Whypo,
+          Julius::Message::Recogout::Shypo::Whypo)
+      end
+    end
+  end
+end
+
+describe Julius::Command::Status do
+  subject { @status = Julius::Command::Status.new }
+  its(:to_s){ should eq 'STATUS' }
+end
+
+describe Julius::Command::Addprocess do
+  subject { @addprocess = Julius::Command::Addprocess.new('/path/to/jconf') }
+  its(:to_s){ should eq 'ADDPROCESS /path/to/jconf' }
+end
+
+describe Julius::Prompt do
+  before do
+    @server_socket, fake_socket = IO.pipe
+    @prompt = Julius::Prompt.new(fake_socket)
+  end
+
+  context 'status' do
+    it 'server should receive command "STATUS"' do
+      @prompt.status
+      @server_socket.gets.chomp.should eq 'STATUS'
+    end
+  end
+
+  context 'unknown command: foo' do
+    subject { lambda { @prompt.foo } }
+    it { should raise_error Julius::Prompt::NoCommandError }
+  end
+end
+
+describe Julius do
+  before do
+    allow_message_expectations_on_nil
+    @socket = IO.popen('-')
+    @socket.stub!(:readline).and_return('<STARTPROC/>', nil)
+    TCPSocket.should_receive(:new)
+             .with('localhost', 10501)
+             .and_return(@socket)
+    @julius = Julius.new(port: 10501)
+  end
+  context 'each_message' do
+    it do
+      expect {|block| @julius.each_message(&block) }.to yield_control
+    end
+    it do
+      expect {|block| @julius.each_message(&block) }.to yield_with_args(
+        Julius::Message::Startproc,
+        Julius::Prompt)
+    end
+  end
+end

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: julius
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Hajime WAKAHARA
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Get results from module mode Julius.
+email:
+- hajime.wakahara@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- julius.gemspec
+- lib/julius.rb
+- lib/julius/command.rb
+- lib/julius/message.rb
+- lib/julius/prompt.rb
+- lib/julius/version.rb
+- spec/julius_spec.rb
+homepage: https://github.com/hadzimme/julius
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '1.9'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: A wrapper for Julius, the Open-Source Large Vocabulary CSR Engine
+test_files:
+- spec/julius_spec.rb