jruby-mmap 0.2.0-java

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7c7bf167de5d4de80bf87ca85cc506dfeb8ef238
+  data.tar.gz: 0eb9ebd6fdfd47ca7c6cc6fb4e441a3088ddaa20
+SHA512:
+  metadata.gz: 65e536cadfa5713e0e57bbeb2c43a329c53d0845567eee2834020e78a5b6689a334d25629116e5c831e83ea563291e25be7bfff5afa0d3332f06f5416c798111
+  data.tar.gz: 1f72791aba1c476c6f68190430d0e7231e16eaa197e7686f26570ab1dc1d6663db43c0759ead059b27a66b935e06e70e8898b7c4f5f9b7fb37bb34abae7205b7

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2015–2016 Colin Surprenant colin.surprenant@gmail.com
+
+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.

data/README.md

@@ -0,0 +1,67 @@
+# JRuby Mmap
+
+This gem only supports [JRuby](http://jruby.org/).
+
+JRuby Mmap is a Java JRuby extension wrapper over the Java NIO memory mapping. 
+
+See also
+- [JRuby Mmap Queues](https://github.com/colinsurprenant/jruby-mmap-queues)
+- [JRuby Mmap Benchmarks](https://github.com/colinsurprenant/jruby-mmap-benchmark)
+
+## Installation
+
+This gem only supports [JRuby](http://jruby.org/).
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'jruby-mmap'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install jruby-mmap
+
+## Building
+
+Building uses Gradle. The build process compiles the Java classes, produces a jar file and copies the jar file in the project `lib/jruby-mmap` dir.
+
+```sh
+$ ./gradlew build
+```
+
+## Usage
+
+```ruby
+require "jruby-mmap"
+
+BYTE_SIZE = 2048
+FILE_PATH = "mmap-file-path"
+
+mmap = Mmap::ByteBuffer.new(FILE_PATH, BYTE_SIZE)
+mmap.put_bytes("foobar")
+mmap.close
+```
+
+## Tests
+
+```sh
+$ bundle install
+$ bundle exec rspec
+```
+
+## Author
+
+**Colin Surprenant** on [GitHub](https://github.com/colinsurprenant) and [Twitter](https://twitter.com/colinsurprenant).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/colinsurprenant/jruby-mmap.
+
+## License and Copyright
+
+*JRuby Mmap* is released under the Apache License, Version 2.0. See [LICENSE](https://github.com/colinsurprenant/jruby-mmap/blob/master/LICENSE).

data/jruby-mmap.gemspec

@@ -0,0 +1,28 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'jruby-mmap/version'
+
+raise("JRuby required") unless defined?(JRUBY_VERSION)
+
+Gem::Specification.new do |s|
+  s.name = "jruby-mmap"
+  s.version = Mmap::VERSION
+
+  s.authors = ["Colin Surprenant"]
+  s.email = ["colin.surprenant@gmail.com"]
+
+  s.summary = "JRuby extension to Java NIO Mmap"
+  s.description = s.summary
+  s.homepage = "http://github.com/colinsurprenant/jruby-mmap"
+  s.licenses = ["Apache-2.0"]
+
+  s.require_paths = ["lib"]
+  s.files += Dir.glob(["jruby-mmap.gemspec", "lib/**/*.jar", "lib/**/*.rb", "spec/**/*.rb", "README.md", "LICENSE"])
+
+  s.platform = "java"
+
+  s.add_development_dependency "rspec", "~> 3"
+  s.add_development_dependency "rake", "~> 10"
+end

data/lib/jruby-mmap.rb

@@ -0,0 +1,3 @@
+# encoding: utf-8
+
+require "jruby-mmap/jruby-mmap.rb"

data/lib/jruby-mmap/jruby-mmap.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+require "java"
+require "jruby-mmap/version"
+
+# local dev setup
+classes_dir = File.expand_path("../../../build/classes/main", __FILE__)
+
+if File.directory?(classes_dir)
+  # if in local dev setup, add target to classpath
+  $CLASSPATH << classes_dir unless $CLASSPATH.include?(classes_dir)
+else
+  # otherwise use included jar
+  require "jruby-mmap/jruby-mmap-#{Mmap::VERSION}.jar"
+end
+
+require "mmap"

data/lib/jruby-mmap/version.rb

@@ -0,0 +1,4 @@
+module Mmap
+  # sync with build.gradle
+  VERSION = "0.2.0"
+end

data/spec/jruby-mmap/mmap_spec.rb

@@ -0,0 +1,147 @@
+require 'spec_helper'
+# require "tempfile"
+
+describe Mmap do
+  INT_BYTES = 4
+  LONG_BYTES = 8
+
+  before(:all) do
+    @path = "spec_mmap_file.dat"
+    @size = 2048
+    File.delete(@path) if File.exist?(@path)
+  end
+
+  after(:each) do
+    File.delete(@path) if File.exist?(@path)
+  end
+
+  it "should create a file with specified size" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    expect(File.size(@path)).to eq(mmap.size)
+    mmap.close
+  end
+
+  it "should be at position 0 upon initialize" do
+    mmap = Mmap::ByteBuffer.new(@path, @size)
+    expect(mmap.position).to eq(0)
+    mmap.close
+  end
+
+  it "should relative put/get integer" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    mmap.put_int(1967)
+    expect(mmap.position).to eq(INT_BYTES)
+    mmap.position = 0
+    expect(mmap.get_int).to eq(1967)
+    mmap.close
+  end
+
+  it "should absolute put/get integer" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    mmap.put_int(1, 1 * INT_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_int(Java::java.lang.Integer::MAX_VALUE, 3 * INT_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_int(2, 2 * INT_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_int(0, 0 * INT_BYTES)
+    expect(mmap.position).to eq(0)
+
+    expect(mmap.get_int(3 * INT_BYTES)).to eq(Java::java.lang.Integer::MAX_VALUE)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_int(0 * INT_BYTES)).to eq(0)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_int(2 * INT_BYTES)).to eq(2)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_int(1 * INT_BYTES)).to eq(1)
+    expect(mmap.position).to eq(0)
+
+    expect{mmap.put_int(Java::java.lang.Integer::MAX_VALUE + 1, 0)}.to raise_error(RangeError)
+
+    mmap.close
+  end
+
+  it "should relative put/get long" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    mmap.put_long(1967)
+    expect(mmap.position).to eq(LONG_BYTES)
+    mmap.position = 0
+    expect(mmap.get_long).to eq(1967)
+    mmap.close
+  end
+
+  it "should absolute put/get long" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    mmap.put_long(1, 1 * LONG_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_long(Java::java.lang.Long::MAX_VALUE, 3 * LONG_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_long(2, 2 * LONG_BYTES)
+    expect(mmap.position).to eq(0)
+    mmap.put_long(0, 0 * LONG_BYTES)
+    expect(mmap.position).to eq(0)
+
+    expect(mmap.get_long(3 * LONG_BYTES)).to eq(Java::java.lang.Long::MAX_VALUE)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_long(0 * LONG_BYTES)).to eq(0)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_long(2 * LONG_BYTES)).to eq(2)
+    expect(mmap.position).to eq(0)
+    expect(mmap.get_long(1 * LONG_BYTES)).to eq(1)
+    expect(mmap.position).to eq(0)
+
+    expect{mmap.put_long(Java::java.lang.Long::MAX_VALUE + 1, 0)}.to raise_error(RangeError)
+
+    mmap.close
+  end
+
+  it "should relative put/get bytes" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    s = "hello world"
+    expect(s.size).to eq(11)
+    expect(s.bytesize).to eq(11)
+    mmap.put_bytes(s)
+    expect(mmap.position).to eq(11)
+
+    s = "foobar"
+    expect(s.size).to eq(6)
+    expect(s.bytesize).to eq(6)
+    mmap.put_bytes(s)
+    expect(mmap.position).to eq(17)
+
+    mmap.position = 0
+    expect(mmap.get_bytes(11)).to eq("hello world")
+    expect(mmap.get_bytes(6)).to eq("foobar")
+    mmap.close
+  end
+
+  it "should relative put/get bytes copy" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    s = "hello world"
+    expect(s.size).to eq(11)
+    expect(s.bytesize).to eq(11)
+    mmap.put_bytes_copy(s)
+    expect(mmap.position).to eq(11)
+
+    s = "foobar"
+    expect(s.size).to eq(6)
+    expect(s.bytesize).to eq(6)
+    mmap.put_bytes_copy(s)
+    expect(mmap.position).to eq(17)
+
+    mmap.position = 0
+    expect(mmap.get_bytes(11)).to eq("hello world")
+    expect(mmap.get_bytes(6)).to eq("foobar")
+    mmap.close
+  end
+
+  it "should mmap when opening existing file" do
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    mmap.put_bytes("hello foo bar baz")
+    expect(mmap.position).to eq(17)
+    mmap.close
+    mmap = Mmap::ByteBuffer.new(@path, 2048)
+    expect(mmap.get_bytes(17)).to eq("hello foo bar baz")
+    mmap.close
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+$:.unshift File.expand_path("../../lib/", __FILE__)
+$:.unshift File.expand_path("../../spec/", __FILE__)
+
+require "rspec"
+require "jruby-mmap"

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: jruby-mmap
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: java
+authors:
+- Colin Surprenant
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2016-03-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+  name: rspec
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+  name: rake
+  prerelease: false
+  type: :development
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10'
+description: JRuby extension to Java NIO Mmap
+email:
+- colin.surprenant@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- jruby-mmap.gemspec
+- lib/jruby-mmap.rb
+- lib/jruby-mmap/jruby-mmap-0.2.0.jar
+- lib/jruby-mmap/jruby-mmap.rb
+- lib/jruby-mmap/version.rb
+- spec/jruby-mmap/mmap_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/colinsurprenant/jruby-mmap
+licenses:
+- Apache-2.0
+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.4.8
+signing_key:
+specification_version: 4
+summary: JRuby extension to Java NIO Mmap
+test_files: []