opencc-rb 1.0.5

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 36111587c88ebb5bad5627397aec98d5a5100863ba55c6da2decf5c6740e0008
+  data.tar.gz: 58d1302032b5612973a48d13df89ca86bdfefb619e6b70261fa587ac137c5680
+SHA512:
+  metadata.gz: a589ef598d17e5506844398be9c91e0b67053cbcfa5bad8731a926a0c016f849ca5ebac405921c98ed08b76d29704b4033f37394e477e3c3f79104d8c429826e
+  data.tar.gz: 89dc71b414e3515009836a0ee5f3940289cb794a610a6ecca0ed3a5b4580a94e122d0db71c63d2f60f83e46d69b22520cc203eb54370ba05479792b3a958a89a

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.DS_Store
+.keep

data/.travis/install.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+if [ $TRAVIS_OS_NAME = 'osx' ]; then
+	brew install opencc
+else
+  git clone https://github.com/BYVoid/OpenCC
+  cd OpenCC
+  git checkout ver.1.1.2
+  make PREFIX=/usr/local
+  sudo make install
+fi

data/.travis.yml

@@ -0,0 +1,26 @@
+---
+language: ruby
+os:
+  - linux
+  - osx
+dist: focal
+compiler:
+  - clang
+  - gcc
+cache: bundler
+rvm:
+  - 2.7.0
+  - 2.6.5
+  - 2.5.5
+addons:
+  apt:
+    update: true
+    packages:
+      - cmake
+      - doxygen
+before_install:
+  - gem install bundler -v 2.1.4
+install:
+    - ./.travis/install.sh 
+    - bundle install
+script: bundle exec rake

data/Gemfile

@@ -0,0 +1,8 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in opencc.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rake-compiler"
+gem "minitest", "~> 5.14", ">= 5.14.3"

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    opencc-rb (1.0.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.14.4)
+    rake (13.0.3)
+    rake-compiler (1.1.1)
+      rake
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  minitest (~> 5.14, >= 5.14.3)
+  opencc-rb!
+  rake (~> 13.0)
+  rake-compiler
+
+BUNDLED WITH
+   2.2.16

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 zsj
+
+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,118 @@
+# OpenCC [![Build Status](https://travis-ci.org/songjiz/opencc-rb.svg?branch=master)](https://travis-ci.org/songjiz/opencc-rb)
+
+## Description
+
+This gem is for conversions between Traditional Chinese, Simplified Chinese and Japanese Kanji (Shinjitai). It's builded on [OpenCC](https://github.com/BYVoid/OpenCC).
+
+## Installation
+
+You have to install OpenCC firstly.
+
+MacOS:
+
+```shell
+brew install opencc
+```
+
+Debian/Ubuntu:
+
+```shell
+sudo apt install libopencc-dev
+```
+Archlinux:
+
+```shell
+sudo pacman -Sy opencc
+```
+
+Fedora:
+
+```shell
+sudo yum install opencc-devel
+```
+
+Or install from source code:
+
+```shell
+cd /usr/src
+git clone https://github.com/BYVoid/OpenCC
+cd OpenCC
+git checkout ver.1.1.1
+make PREFIX=/usr/local
+sudo make install
+```
+
+Then add this line to your application's Gemfile:
+
+```ruby
+gem 'opencc-rb'
+```
+
+And then execute:
+
+```shell
+bundle install
+```
+
+Or install it yourself as:
+
+```shell
+gem install opencc-rb
+```
+
+## Usage
+
+```ruby
+require "opencc"
+
+# The converter will automatically be closed when the block terminates.
+OpenCC.with(:s2t) do |ct|
+  ct.convert("汉字") # => "漢字"
+  ct.convert("曾经有一份真诚的爱情放在我面前，我没有珍惜，等我失去的时候我才后悔莫及。人事间最痛苦的事莫过于此。如果上天能够给我一个再来一次得机会，我会对那个女孩子说三个字，我爱你。如果非要在这份爱上加个期限，我希望是，一万年。") # => "曾經有一份真誠的愛情放在我面前，我沒有珍惜，等我失去的時候我才後悔莫及。人事間最痛苦的事莫過於此。如果上天能夠給我一個再來一次得機會，我會對那個女孩子說三個字，我愛你。如果非要在這份愛上加個期限，我希望是，一萬年。"
+end
+
+OpenCC.with(:s2t) do
+  convert("汉字") # => "漢字"
+  convert("曾经有一份真诚的爱情放在我面前，我没有珍惜，等我失去的时候我才后悔莫及。人事间最痛苦的事莫过于此。如果上天能够给我一个再来一次得机会，我会对那个女孩子说三个字，我爱你。如果非要在这份爱上加个期限，我希望是，一万年。") # => "曾經有一份真誠的愛情放在我面前，我沒有珍惜，等我失去的時候我才後悔莫及。人事間最痛苦的事莫過於此。如果上天能夠給我一個再來一次得機會，我會對那個女孩子說三個字，我愛你。如果非要在這份愛上加個期限，我希望是，一萬年。"
+end
+
+# Or
+OpenCC.s2t("汉字") # => "漢字"
+OpenCC.t2s("漢字") # => "汉字"
+OpenCC.s2tw('着装污染虚伪发泄棱柱群众里面') # => "著裝汙染虛偽發洩稜柱群眾裡面"
+OpenCC.tw2s("著裝汙染虛偽發洩稜柱群眾裡面") # => "着装污染虚伪发泄棱柱群众里面"
+OpenCC.s2hk("虚伪叹息") # => "虛偽嘆息"
+OpenCC.hk2s("虛偽嘆息") # => "虚伪叹息"
+OpenCC.s2twp("海内存知己") # => "海內存知己"
+OpenCC.tw2sp("海內存知己") # => "海内存知己"
+OpenCC.hk2t("想到自己一緊張就口吃，我就沒胃口吃飯") # => "想到自己一緊張就口吃，我就沒胃口喫飯"
+OpenCC.t2hk("想到自己一緊張就口吃，我就沒胃口喫飯") # => "想到自己一緊張就口吃，我就沒胃口吃飯"
+OpenCC.t2jp("藝術 缺航 飲料罐") # => "芸術 欠航 飲料缶"
+OpenCC.jp2t("芸術 欠航 飲料缶") # => "藝術 缺航 飲料罐"
+OpenCC.tw2t("想到自己一緊張就口吃，我就沒胃口吃飯") # => "想到自己一緊張就口吃，我就沒胃口喫飯"
+
+# Or
+converter = OpenCC[:s2t]
+converter = OpenCC.new(:s2t)
+converter = OpenCC::Converter.new(:s2t)
+converter.convert("汉字") # => '漢字'
+converter.close # => true
+converter.closed? # => true
+converter.close # => false
+converter.convert("汉字") # => nil
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/songjiz/opencc-rb.
+
+
+## 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,18 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "rake/extensiontask"
+
+task :build => :compile
+
+Rake::ExtensionTask.new("opencc") do |ext|
+  ext.lib_dir = "lib/opencc"
+end
+
+task :default => [:clobber, :compile, :test]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "opencc"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ext/opencc/extconf.rb

@@ -0,0 +1,21 @@
+require "mkmf"
+
+def missing!(lib)
+  if RUBY_PLATFORM =~ /mingw|mswin/
+    abort "-----\n#{lib} is missing. Check your installation of OpenCC, and try again.\n-----"
+  elsif RUBY_PLATFORM =~ /darwin/
+    abort "-----\n#{lib} is missing. You may need to 'brew install opencc', and try again.\n-----"
+  else
+    abort "-----\n#{lib} is missing. You may need to 'sudo apt-get install libopencc-dev', 'sudo pacman -Sy opencc' or 'sudo yum install opencc-devel' and try again.\n-----"
+  end
+end
+
+missing!('opencc')   if !have_library('opencc')
+missing!('opencc.h') if !have_header('opencc.h')
+
+have_func 'opencc_open'
+have_func 'opencc_convert_utf8'
+have_func 'opencc_convert_utf8_free'
+have_func 'opencc_close'
+
+create_makefile 'opencc/opencc'

data/ext/opencc/opencc.c

@@ -0,0 +1,49 @@
+#include "opencc.h"
+
+VALUE rb_mOpenCC;
+VALUE rb_mOpenCC_Mixin;
+
+static VALUE rb_opencc_open(VALUE self, VALUE rb_cfg) {
+  const char *cfg = OPENCC_DEFAULT_CONFIG_SIMP_TO_TRAD;
+  opencc_t ptr;
+
+  if (TYPE(rb_cfg) == T_STRING && RSTRING_LEN(rb_cfg) > 0) {
+    cfg = RSTRING_PTR(rb_cfg);
+  }
+
+  ptr = opencc_open(cfg);
+
+  // On error the return value will be (opencc_t) -1.
+  if (ptr == (opencc_t) - 1) {
+    return Qnil;
+  } else {
+    return LONG2FIX((long)ptr);
+  }
+}
+
+static VALUE rb_opencc_convert(VALUE self, VALUE rb_opencc, VALUE rb_str) {
+  opencc_t ptr = (opencc_t) FIX2LONG(rb_opencc);
+  char * buff = opencc_convert_utf8(ptr, RSTRING_PTR(rb_str), RSTRING_LEN(rb_str));
+  VALUE converted = rb_utf8_str_new_cstr(buff);
+  opencc_convert_utf8_free(buff);
+  return converted;
+}
+
+static VALUE rb_opencc_close(VALUE self, VALUE rb_opencc) {
+  opencc_t ptr = (opencc_t) FIX2LONG(rb_opencc);
+
+  if (opencc_close(ptr) == 0) {
+    return Qtrue;
+  } else {
+    return Qfalse;
+  }
+}
+
+void Init_opencc(void) {
+  rb_mOpenCC = rb_define_module("OpenCC");
+  rb_mOpenCC_Mixin = rb_define_module_under(rb_mOpenCC, "Mixin");
+
+  rb_define_private_method(rb_mOpenCC_Mixin, "opencc_open", rb_opencc_open, 1);
+  rb_define_private_method(rb_mOpenCC_Mixin, "opencc_close", rb_opencc_close, 1);
+  rb_define_private_method(rb_mOpenCC_Mixin, "opencc_convert", rb_opencc_convert, 2);
+}

data/ext/opencc/opencc.h

@@ -0,0 +1,11 @@
+#ifndef RUBY_OPENCC_H
+#define RUBY_OPENCC_H 1
+
+#include <ruby.h>
+#include <opencc/opencc.h>
+
+static VALUE rb_opencc_open(VALUE self, VALUE rb_cfg);
+static VALUE rb_opencc_convert(VALUE self, VALUE rb_occid, VALUE rb_str);
+static VALUE rb_opencc_close(VALUE self, VALUE rb_occid);
+
+#endif /* RUBY_OPENCC_H */

data/lib/opencc/converter.rb

@@ -0,0 +1,70 @@
+module OpenCC
+  class Converter
+    include OpenCC::Mixin
+
+    class << self
+      def with(config, &block)
+        converter = new(config)
+        if block.arity == 0
+          converter.instance_eval(&block)
+        else
+          yield converter
+        end
+      ensure
+        converter.close
+      end
+    end
+    
+    attr_reader :config
+
+    # *<tt>:config</tt> - The config file name without .json suffix, default "s2t"
+    def initialize(config = nil)
+      @config = (config || OpenCC::DEFAULT_CONFIG).to_s
+
+      if !OpenCC::CONFIGS.include?(@config)
+        raise ArgumentError, "Unsupported configuration name #{@config.inspect}, expected one of #{OpenCC::CONFIGS.join(', ')}"
+      end
+
+      @mutex  = Mutex.new
+      @closed = false
+    end
+
+    def convert(input)
+      synchronize do
+        return if closed?
+        
+        @__opencc__ ||= opencc_open(config_file_name)
+        
+        if @__opencc__.nil?
+          raise RuntimeError, "OpenCC failed to load (#{config_file_name})"
+        end
+        
+        opencc_convert(@__opencc__, input.force_encoding(Encoding::UTF_8))
+      end
+    end
+
+    def close
+      synchronize do
+        return false if closed?
+        return false if @__opencc__.nil?
+        return false if !opencc_close(@__opencc__)
+
+        @__opencc__ = nil
+        @closed = true
+      end
+    end
+
+    def closed?
+      @closed
+    end
+
+    private
+      def synchronize(&block)
+        @mutex.synchronize(&block)
+      end
+
+      def config_file_name
+        "#{@config}.json"
+      end
+  end
+end

data/lib/opencc/version.rb

@@ -0,0 +1,3 @@
+module OpenCC
+  VERSION = "1.0.5"
+end

data/lib/opencc.rb

@@ -0,0 +1,30 @@
+require "opencc/version"
+require "opencc/opencc"
+require "opencc/converter"
+
+module OpenCC
+  CONFIGS = %w[ s2t t2s s2tw tw2s s2hk hk2s s2twp tw2sp hk2t t2hk t2jp jp2t tw2t ]
+  DEFAULT_CONFIG = "s2t"
+
+  class << self
+    def with(config, &block)
+      Converter.with(config, &block)
+    end
+
+    def [](config)
+      config && new(config)
+    end
+
+    def new(config = nil)
+      Converter.new(config)
+    end
+
+    CONFIGS.each do |config|
+      define_method :"#{config}" do |input|
+        with(config) do |converter|
+          converter.convert(input)
+        end
+      end
+    end
+  end
+end

data/opencc.gemspec

@@ -0,0 +1,25 @@
+require_relative "lib/opencc/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "opencc-rb"
+  spec.version       = OpenCC::VERSION
+  spec.authors       = ["zsj"]
+  spec.email         = ["lekyzsj@gmail.com"]
+
+  spec.summary       = %q{This gem is for conversions between Traditional Chinese, Simplified Chinese and Japanese Kanji (Shinjitai).}
+  spec.description   = %q{This gem is for conversions between Traditional Chinese, Simplified Chinese and Japanese Kanji (Shinjitai). It supports character-level and phrase-level conversion, character variant conversion and regional idioms among Mainland China, Taiwan and Hong Kong.}
+  spec.homepage      = "https://github.com/songjiz/opencc-rb"
+  spec.license       = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  spec.extensions    = ["ext/opencc/extconf.rb"]
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: opencc-rb
+version: !ruby/object:Gem::Version
+  version: 1.0.5
+platform: ruby
+authors:
+- zsj
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-06-04 00:00:00.000000000 Z
+dependencies: []
+description: This gem is for conversions between Traditional Chinese, Simplified Chinese
+  and Japanese Kanji (Shinjitai). It supports character-level and phrase-level conversion,
+  character variant conversion and regional idioms among Mainland China, Taiwan and
+  Hong Kong.
+email:
+- lekyzsj@gmail.com
+executables: []
+extensions:
+- ext/opencc/extconf.rb
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- ".travis/install.sh"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- ext/opencc/extconf.rb
+- ext/opencc/opencc.c
+- ext/opencc/opencc.h
+- lib/opencc.rb
+- lib/opencc/converter.rb
+- lib/opencc/version.rb
+- opencc.gemspec
+homepage: https://github.com/songjiz/opencc-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/songjiz/opencc-rb
+  source_code_uri: https://github.com/songjiz/opencc-rb
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.15
+signing_key:
+specification_version: 4
+summary: This gem is for conversions between Traditional Chinese, Simplified Chinese
+  and Japanese Kanji (Shinjitai).
+test_files: []