You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@arrow.apache.org by ko...@apache.org on 2018/11/09 02:09:05 UTC
[arrow] branch master updated: ARROW-3723: [Plasma][Ruby] Add Ruby
bindings of Plasma
This is an automated email from the ASF dual-hosted git repository.
kou pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/arrow.git
The following commit(s) were added to refs/heads/master by this push:
new a7df9c6 ARROW-3723: [Plasma][Ruby] Add Ruby bindings of Plasma
a7df9c6 is described below
commit a7df9c6c1e5f96d4dec71e3598028f7126032771
Author: Yosuke Shiro <ys...@gmail.com>
AuthorDate: Fri Nov 9 11:08:40 2018 +0900
ARROW-3723: [Plasma][Ruby] Add Ruby bindings of Plasma
It's Ruby bindings of Plasma.
Author: Yosuke Shiro <ys...@gmail.com>
Author: Kouhei Sutou <ko...@clear-code.com>
Closes #2921 from shiro615/ruby-support-plasma and squashes the following commits:
0315d9a6 <Kouhei Sutou> Add missing license header
92d18df4 <Yosuke Shiro> Remove pathname
501c7e18 <Yosuke Shiro> Change permissions
f3f06f61 <Yosuke Shiro> Add .gitignore
62729549 <Yosuke Shiro> Add Pathname support
5f876d4d <Yosuke Shiro> Add red-plasma in Travis CI
b71e6552 <Yosuke Shiro> Build Plasma in Travis CI
d11bbd75 <Yosuke Shiro> Support plasma
---
.travis.yml | 1 +
ci/travis_script_ruby.sh | 9 ++
ruby/red-plasma/.gitignore | 20 +++
ruby/red-plasma/Gemfile | 22 +++
ruby/red-plasma/LICENSE.txt | 202 ++++++++++++++++++++++++++++
ruby/red-plasma/NOTICE.txt | 2 +
ruby/red-plasma/README.md | 60 +++++++++
ruby/red-plasma/Rakefile | 39 ++++++
ruby/red-plasma/dependency-check/Rakefile | 43 ++++++
ruby/red-plasma/lib/plasma.rb | 29 ++++
ruby/red-plasma/lib/plasma/client.rb | 26 ++++
ruby/red-plasma/lib/plasma/loader.rb | 35 +++++
ruby/red-plasma/red-plasma.gemspec | 49 +++++++
ruby/red-plasma/test/helper.rb | 27 ++++
ruby/red-plasma/test/helper/plasma-store.rb | 50 +++++++
ruby/red-plasma/test/run-test.rb | 37 +++++
ruby/red-plasma/test/test-plasma-client.rb | 34 +++++
ruby/red-plasma/version.rb | 71 ++++++++++
18 files changed, 756 insertions(+)
diff --git a/.travis.yml b/.travis.yml
index 20bf4ae..457e656 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -252,6 +252,7 @@ matrix:
- ARROW_TRAVIS_ORC=1
- ARROW_TRAVIS_GANDIVA=1
- ARROW_TRAVIS_PARQUET=1
+ - ARROW_TRAVIS_PLASMA=1
cache:
addons:
rvm: 2.2
diff --git a/ci/travis_script_ruby.sh b/ci/travis_script_ruby.sh
index b01cf3a..7d69bee 100755
--- a/ci/travis_script_ruby.sh
+++ b/ci/travis_script_ruby.sh
@@ -69,3 +69,12 @@ if [ -d $ARROW_C_GLIB_INSTALL_MESON/lib/$(arch)-linux-gnu ]; then
# (arrow_ruby_run_test $ARROW_C_GLIB_INSTALL_MESON/lib)
fi
popd
+
+pushd $ARROW_RUBY_DIR/red-plasma
+(arrow_ruby_run_test $ARROW_C_GLIB_INSTALL_AUTOTOOLS/lib)
+if [ -d $ARROW_C_GLIB_INSTALL_MESON/lib/$(arch)-linux-gnu ]; then
+ (arrow_ruby_run_test $ARROW_C_GLIB_INSTALL_MESON/lib/$(arch)-linux-gnu)
+# else # TODO: Enable this
+# (arrow_ruby_run_test $ARROW_C_GLIB_INSTALL_MESON/lib)
+fi
+popd
diff --git a/ruby/red-plasma/.gitignore b/ruby/red-plasma/.gitignore
new file mode 100644
index 0000000..bd50ff8
--- /dev/null
+++ b/ruby/red-plasma/.gitignore
@@ -0,0 +1,20 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+/lib/plasma/version.rb
+
+/pkg/
diff --git a/ruby/red-plasma/Gemfile b/ruby/red-plasma/Gemfile
new file mode 100644
index 0000000..3907918
--- /dev/null
+++ b/ruby/red-plasma/Gemfile
@@ -0,0 +1,22 @@
+# -*- ruby -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+source "https://rubygems.org/"
+
+gemspec
diff --git a/ruby/red-plasma/LICENSE.txt b/ruby/red-plasma/LICENSE.txt
new file mode 100644
index 0000000..d645695
--- /dev/null
+++ b/ruby/red-plasma/LICENSE.txt
@@ -0,0 +1,202 @@
+
+ Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "[]"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright [yyyy] [name of copyright owner]
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
diff --git a/ruby/red-plasma/NOTICE.txt b/ruby/red-plasma/NOTICE.txt
new file mode 100644
index 0000000..e08aeda
--- /dev/null
+++ b/ruby/red-plasma/NOTICE.txt
@@ -0,0 +1,2 @@
+Apache Arrow
+Copyright 2016 The Apache Software Foundation
diff --git a/ruby/red-plasma/README.md b/ruby/red-plasma/README.md
new file mode 100644
index 0000000..19038af
--- /dev/null
+++ b/ruby/red-plasma/README.md
@@ -0,0 +1,60 @@
+<!---
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+# Red Plasma - Plasma Ruby
+
+Red Plasma is the Ruby bindings of Plasma. Red Plasma is based on GObject Introspection.
+
+Plasma is an in-memory object store and cache for big data.
+
+[GObject Introspection](https://wiki.gnome.org/action/show/Projects/GObjectIntrospection) is a middleware for language bindings of C library. GObject Introspection can generate language bindings automatically at runtime.
+
+Red Plasma uses [Plasma GLib](https://github.com/apache/arrow/tree/master/c_glib/plasma-glib) and [gobject-introspection gem](https://rubygems.org/gems/gobject-introspection) to generate Ruby bindings of Plasma.
+
+Plasma GLib is a C wrapper for [Plasma C++](https://github.com/apache/arrow/tree/master/cpp/plasma). GObject Introspection can't use Plasma C++ directly. Plasma GLib is a bridge between Plasma C++ and GObject Introspection.
+
+gobject-introspection gem is a Ruby bindings of GObject Introspection. Red Plasma uses GObject Introspection via gobject-introspection gem.
+
+## Install
+
+Install Plasma GLib before install Red Plasma. Use [packages.red-data-tools.org](https://github.com/red-data-tools/packages.red-data-tools.org) for installing Plasma GLib.
+
+Note that the Plasma GLib packages are "unofficial". "Official" packages will be released in the future.
+
+Install Red Plasma after you install Plasma GLib:
+
+```text
+% gem install red-plasma
+```
+
+## Usage
+
+Starting the Plasma store
+
+```console
+plasma_store_server -m 1000000000 -s /tmp/plasma
+```
+
+Creating a Plasma client
+
+```ruby
+require "plasma"
+
+client = Plasma::Client.new("/tmp/plasma")
+```
diff --git a/ruby/red-plasma/Rakefile b/ruby/red-plasma/Rakefile
new file mode 100644
index 0000000..96851af
--- /dev/null
+++ b/ruby/red-plasma/Rakefile
@@ -0,0 +1,39 @@
+# -*- ruby -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require "rubygems"
+require "bundler/gem_helper"
+
+base_dir = File.join(__dir__)
+
+helper = Bundler::GemHelper.new(base_dir)
+helper.install
+
+release_task = Rake::Task["release"]
+release_task.prerequisites.replace(["build", "release:rubygem_push"])
+
+desc "Run tests"
+task :test do
+ cd("dependency-check") do
+ ruby("-S", "rake")
+ end
+ ruby("test/run-test.rb")
+end
+
+task default: :test
diff --git a/ruby/red-plasma/dependency-check/Rakefile b/ruby/red-plasma/dependency-check/Rakefile
new file mode 100644
index 0000000..d5c728e
--- /dev/null
+++ b/ruby/red-plasma/dependency-check/Rakefile
@@ -0,0 +1,43 @@
+# -*- ruby -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require "pkg-config"
+require "native-package-installer"
+
+case RUBY_PLATFORM
+when /mingw|mswin/
+ task :default => "nothing"
+else
+ task :default => "dependency:check"
+end
+
+task :nothing do
+end
+
+namespace :dependency do
+ desc "Check dependency"
+ task :check do
+ unless PKGConfig.check_version?("plasma-glib")
+ unless NativePackageInstaller.install(:debian => "libplasma-glib-dev",
+ :redhat => "plasma-glib-devel")
+ exit(false)
+ end
+ end
+ end
+end
diff --git a/ruby/red-plasma/lib/plasma.rb b/ruby/red-plasma/lib/plasma.rb
new file mode 100644
index 0000000..c8b4aa8
--- /dev/null
+++ b/ruby/red-plasma/lib/plasma.rb
@@ -0,0 +1,29 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require "arrow"
+
+require "plasma/version"
+
+require "plasma/loader"
+
+module Plasma
+ class Error < StandardError
+ end
+
+ Loader.load
+end
diff --git a/ruby/red-plasma/lib/plasma/client.rb b/ruby/red-plasma/lib/plasma/client.rb
new file mode 100644
index 0000000..464ef8c
--- /dev/null
+++ b/ruby/red-plasma/lib/plasma/client.rb
@@ -0,0 +1,26 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Plasma
+ class Client
+ alias_method :initialize_raw, :initialize
+ def initialize(socket_path)
+ socket_path = socket_path.to_path if socket_path.respond_to?(:to_path)
+ initialize_raw(socket_path)
+ end
+ end
+end
diff --git a/ruby/red-plasma/lib/plasma/loader.rb b/ruby/red-plasma/lib/plasma/loader.rb
new file mode 100644
index 0000000..f9125a6
--- /dev/null
+++ b/ruby/red-plasma/lib/plasma/loader.rb
@@ -0,0 +1,35 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Plasma
+ class Loader < GObjectIntrospection::Loader
+ class << self
+ def load
+ super("Plasma", Plasma)
+ end
+ end
+
+ private
+ def post_load(repository, namespace)
+ require_libraries
+ end
+
+ def require_libraries
+ require "plasma/client"
+ end
+ end
+end
diff --git a/ruby/red-plasma/red-plasma.gemspec b/ruby/red-plasma/red-plasma.gemspec
new file mode 100644
index 0000000..53b4d1e
--- /dev/null
+++ b/ruby/red-plasma/red-plasma.gemspec
@@ -0,0 +1,49 @@
+# -*- ruby -*-
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative "version"
+
+Gem::Specification.new do |spec|
+ spec.name = "red-plasma"
+ version_components = [
+ Plasma::Version::MAJOR.to_s,
+ Plasma::Version::MINOR.to_s,
+ Plasma::Version::MICRO.to_s,
+ # "beta1",
+ ]
+ spec.version = version_components.join(".")
+ spec.homepage = "https://arrow.apache.org/"
+ spec.authors = ["Apache Arrow Developers"]
+ spec.email = ["dev@arrow.apache.org"]
+
+ spec.summary = "Red Plasma is the Ruby bindings of Plasma"
+ spec.description = "Plasma is an in-memory object store and cache for big data."
+ spec.license = "Apache-2.0"
+ spec.files = ["README.md", "Rakefile", "Gemfile", "#{spec.name}.gemspec"]
+ spec.files += ["LICENSE.txt", "NOTICE.txt"]
+ spec.files += Dir.glob("lib/**/*.rb")
+ spec.test_files += Dir.glob("test/**/*")
+ spec.extensions = ["dependency-check/Rakefile"]
+
+ spec.add_runtime_dependency("red-arrow")
+
+ spec.add_development_dependency("bundler")
+ spec.add_development_dependency("rake")
+ spec.add_development_dependency("test-unit")
+end
diff --git a/ruby/red-plasma/test/helper.rb b/ruby/red-plasma/test/helper.rb
new file mode 100644
index 0000000..d66d43e
--- /dev/null
+++ b/ruby/red-plasma/test/helper.rb
@@ -0,0 +1,27 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require_relative "../../red-arrow/version"
+require_relative "../version"
+
+require "plasma"
+
+require "tempfile"
+
+require "test-unit"
+
+require_relative "helper/plasma-store"
diff --git a/ruby/red-plasma/test/helper/plasma-store.rb b/ruby/red-plasma/test/helper/plasma-store.rb
new file mode 100644
index 0000000..30504fb
--- /dev/null
+++ b/ruby/red-plasma/test/helper/plasma-store.rb
@@ -0,0 +1,50 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Helper
+ class PlasmaStore
+ def initialize(options={})
+ @path = `pkg-config --variable=executable plasma`.chomp
+ @memory_size = options[:memory_size] || 1024 * 1024
+ @socket_file = Tempfile.new(["plasma-store", ".sock"])
+ @socket_file.close
+ @pid = nil
+ FileUtils.rm_f(socket_path)
+ end
+
+ def socket_path
+ @socket_file.path
+ end
+
+ def start
+ @pid = spawn(@path,
+ "-m", @memory_size.to_s,
+ "-s", socket_path)
+ until File.exist?(socket_path)
+ if Process.waitpid(@pid, Process::WNOHANG)
+ raise "Failed to run plasma_store_server: #{@path}"
+ end
+ end
+ end
+
+ def stop
+ return if @pid.nil?
+ Process.kill(:TERM, @pid)
+ Process.waitpid(@pid)
+ end
+ end
+end
diff --git a/ruby/red-plasma/test/run-test.rb b/ruby/red-plasma/test/run-test.rb
new file mode 100755
index 0000000..b826f3e
--- /dev/null
+++ b/ruby/red-plasma/test/run-test.rb
@@ -0,0 +1,37 @@
+#!/usr/bin/env ruby
+#
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+$VERBOSE = true
+
+require "pathname"
+
+base_dir = Pathname.new(__dir__).parent.expand_path
+arrow_base_dir = base_dir.parent + "red-arrow"
+
+lib_dir = base_dir + "lib"
+test_dir = base_dir + "test"
+
+arrow_lib_dir = arrow_base_dir + "lib"
+
+$LOAD_PATH.unshift(arrow_lib_dir.to_s)
+$LOAD_PATH.unshift(lib_dir.to_s)
+
+require_relative "helper"
+
+exit(Test::Unit::AutoRunner.run(true, test_dir.to_s))
diff --git a/ruby/red-plasma/test/test-plasma-client.rb b/ruby/red-plasma/test/test-plasma-client.rb
new file mode 100644
index 0000000..e7f8dbd
--- /dev/null
+++ b/ruby/red-plasma/test/test-plasma-client.rb
@@ -0,0 +1,34 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+class TestPlasmaClient < Test::Unit::TestCase
+ def setup
+ @store = nil
+ @store = Helper::PlasmaStore.new
+ @store.start
+ end
+
+ def teardown
+ @store.stop if @store
+ end
+
+ def test_new
+ assert_nothing_raised do
+ Plasma::Client.new(Pathname(@store.socket_path))
+ end
+ end
+end
diff --git a/ruby/red-plasma/version.rb b/ruby/red-plasma/version.rb
new file mode 100644
index 0000000..015aac9
--- /dev/null
+++ b/ruby/red-plasma/version.rb
@@ -0,0 +1,71 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require "pathname"
+
+version_rb_path = Pathname.new(__FILE__)
+base_dir = version_rb_path.dirname
+pom_xml_path = base_dir.join("..", "..", "java", "pom.xml")
+lib_version_rb_path = base_dir.join("lib", "plasma", "version.rb")
+
+need_update = false
+if not lib_version_rb_path.exist?
+ need_update = true
+elsif version_rb_path.mtime > lib_version_rb_path.mtime
+ need_update = true
+elsif pom_xml_path.exist? and pom_xml_path.mtime > lib_version_rb_path.mtime
+ need_update = true
+end
+
+if need_update
+ version = pom_xml_path.read.scan(/^ <version>(.+?)<\/version>/)[0][0]
+ major, minor, micro, tag = version.split(/[.-]/)
+ lib_version_rb_path.open("w") do |lib_version_rb|
+ lib_version_rb.puts(<<-RUBY)
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Plasma
+ module Version
+ MAJOR = #{major}
+ MINOR = #{minor}
+ MICRO = #{micro}
+ TAG = #{tag ? tag.dump : nil}
+ STRING = #{version.dump}
+ end
+
+ VERSION = Version::STRING
+end
+ RUBY
+ end
+end
+
+require_relative "lib/plasma/version"