crm114 1.0.2 → 1.0.3

data/VERSION

@@ -1 +1 @@
-1.0.2
+1.0.3

data/lib/crm114.rb

@@ -1,33 +1,40 @@
-# Author::    Arto Bendiken (mailto:arto.bendiken@gmail.com)
-# License::   Public domain
+require 'crm114/version'
 
 module Classifier
-
   class CRM114
-
-    VERSION = '1.0.2'
-
     CLASSIFICATION_TYPE = '<osb unique microgroom>'
     FILE_EXTENSION = '.css'
     CMD_CRM = '/usr/bin/env crm'
     OPT_LEARN = '-{ learn %s ( %s ) }'
     OPT_CLASSIFY = '-{ isolate (:stats:); classify %s ( %s ) (:stats:); match [:stats:] (:: :best: :prob:) /Best match to file .. \\(%s\\/([[:graph:]]+)\\%s\\) prob: ([0-9.]+)/; output /:*:best:\\t:*:prob:/ }'
 
+    ##
     # Returns a string containg the installed CRM114 engine version in a
     # format such as "20060118-BlameTheReavers".
+    #
+    # @return [String, nil]
     def self.version
       $1 if IO.popen(CMD_CRM + ' -v', 'r') { |pipe| pipe.readline } =~ /CRM114, version ([\d\w\-\.]+)/
     end
 
+    ##
     # Returns a new CRM114 classifier defined by the given _categories_.
+    #
+    # @param  [Array<#to_s>] categories
+    # @option options [String] :path ('.')
     def initialize(categories, options = {})
       @categories = categories.to_a.collect { |category| category.to_s.to_sym }
       @path = File.expand_path(options[:path] || '.')
       @debug = options[:debug] || false
     end
 
+    ##
     # Trains the classifier to consider the given _text_ to be a sample from
     # the set named by _category_.
+    #
+    # @param  [#to_s]  category
+    # @param  [String] text
+    # @return [void]
     def learn!(category, text, &block)
       cmd = CMD_CRM + " '" + (OPT_LEARN % [CLASSIFICATION_TYPE, css_file_path(category)]) + "'"
       puts cmd if @debug
@@ -36,15 +43,22 @@ module Classifier
 
     alias_method :train!, :learn!
 
+    ##
+    # @raise  NotImplementedError
+    # @return [void]
     def unlearn!(category, text, &block) # :nodoc:
-      raise 'unlearning not supported at present'
+      raise NotImplementedError.new('unlearning not supported at present')
     end
 
     alias_method :untrain!, :unlearn! #:nodoc:
 
+    ##
     # Returns the classification of the provided _text_ as a tuple
     # containing the highest-probability category and a confidence indicator
     # in the range of 0.5..1.0.
+    #
+    # @param  [String] text
+    # @return [Array(Symbol, Float)]
     def classify(text = nil, &block)
       files = @categories.collect { |category| css_file_path(category) }
       cmd = CMD_CRM + " '" + (OPT_CLASSIFY % [CLASSIFICATION_TYPE, files.join(' '), @path.gsub(/\//, '\/'), FILE_EXTENSION]) + "'"
@@ -73,15 +87,20 @@ module Classifier
 
     protected
 
+      ##
+      # @param  [String] file
+      # @return [void]
       def self.create_css_file(file)
         cmd = CMD_CRM + " '" + (OPT_LEARN % [CLASSIFICATION_TYPE, file]) + "'"
         IO.popen(cmd, 'w') { |pipe| pipe.close }
       end
 
+      ##
+      # @param  [#to_s] category
+      # @return [String]
       def css_file_path(category)
         File.join(@path, category.to_s + FILE_EXTENSION)
       end
 
   end
-
 end

data/lib/crm114/version.rb

@@ -0,0 +1,19 @@
+module Classifier class CRM114
+  module VERSION
+    MAJOR = 1
+    MINOR = 0
+    TINY  = 3
+    EXTRA = nil
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+    STRING << "-#{EXTRA}" if EXTRA
+
+    ##
+    # @return [String]
+    def self.to_s()   STRING end
+
+    ##
+    # @return [String]
+    def self.to_str() STRING end
+  end
+end end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: crm114
 version: !ruby/object:Gem::Version 
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors: 
 - Arto Bendiken
@@ -9,19 +9,10 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-20 00:00:00 +01:00
+date: 2009-12-26 00:00:00 +01:00
 default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: bendiken-rakefile
-  type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
+dependencies: []
+
 description: "    CRM114.rb is a Ruby interface to the CRM114 Controllable Regex\n    Mutilator, an advanced and fast text classifier that uses sparse binary\n    polynomial matching with a Bayesian Chain Rule evaluator and a hidden\n    Markov model to categorize data with up to a 99.87% accuracy.\n"
 email: arto.bendiken@gmail.com
 executables: []
@@ -31,12 +22,12 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- UNLICENSE
 - AUTHORS
 - README
-- Rakefile
+- UNLICENSE
 - VERSION
 - lib/crm114.rb
+- lib/crm114/version.rb
 - test/test_code_or_text.rb
 - test/test_crm114.rb
 has_rdoc: false

data/Rakefile

@@ -1,5 +0,0 @@
-#!/usr/bin/env ruby
-$:.unshift(File.expand_path(File.join(File.dirname(__FILE__), 'lib')))
-require 'rubygems'
-require 'rakefile' # http://github.com/bendiken/rakefile
-require 'crm114'