mmap-ruby 0.1.0

data/ext/mmap_ruby/mmap_ruby.h

@@ -0,0 +1,21 @@
+#ifndef MMAP_RUBY_H
+#define MMAP_RUBY_H 1
+
+#include "ruby.h"
+#include "ruby/io.h"
+#include "ruby/re.h"
+#include "ruby/util.h"
+
+#include <ctype.h>
+#include <fcntl.h>
+#include <unistd.h>
+
+#include <sys/mman.h>
+#include <sys/stat.h>
+#include <sys/types.h>
+
+#include <sys/ipc.h>
+#include <sys/sem.h>
+#include <sys/shm.h>
+
+#endif /* MMAP_RUBY_H */

data/lib/mmap-ruby/mmap.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module MmapRuby
+  class Mmap
+    include Comparable
+    include Enumerable
+
+    def clone # :nodoc:
+      raise TypeError, "can't clone instance of #{self.class}"
+    end
+
+    def dup # :nodoc:
+      raise TypeError, "can't dup instance of #{self.class}"
+    end
+
+    # See https://docs.ruby-lang.org/en/master/String.html#method-i-each_byte
+    def each_byte(...)
+      to_str.each_byte(...)
+    end
+    alias :each :each_byte
+
+    # See https://docs.ruby-lang.org/en/master/String.html#method-i-each_line
+    def each_line(...)
+      to_str.each_line(...)
+    end
+
+    # See https://docs.ruby-lang.org/en/master/String.html#method-i-scan
+    def scan(...)
+      to_str.scan(...)
+    end
+
+    private
+
+    def process_options(options)
+      options.each do |key, value|
+        key_str = key.to_s
+        case key_str
+        when "initialize" # skip
+        when "length" then set_length value
+        when "offset" then set_offset value
+        when "advice" then set_advice value
+        when "increment" then set_increment value
+        when "ipc" then set_ipc value
+        else raise TypeError, "unknown option #{key_str}"
+        end
+      end
+    end
+  end
+end

data/lib/mmap-ruby/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MmapRuby
+  VERSION = "0.1.0"
+end

data/lib/mmap-ruby.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "mmap-ruby/mmap_ruby"
+require "mmap-ruby/mmap"
+
+Mmap = MmapRuby::Mmap

data/mmap-ruby.gemspec

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "lib/mmap-ruby/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "mmap-ruby"
+  spec.version = MmapRuby::VERSION
+  spec.authors = ["Guy Decoux", "Aaron Patterson", "Joshua Young"]
+  spec.email = ["ts@moulon.inra.fr", "tenderlove@github.com", "djry1999@gmail.com"]
+
+  spec.summary = "mmap wrapper for Ruby"
+  spec.homepage = "https://github.com/joshuay03/mmap-ruby"
+  spec.license = "https://www.ruby-lang.org/en/about/license.txt"
+  spec.required_ruby_version = ">= 3.3.0"
+
+  spec.metadata["documentation_uri"] = "https://joshuay03.github.io/mmap-ruby/"
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir["lib/**/*", "ext/**/*", "**/*.{gemspec,md,txt}"]
+  spec.require_paths = ["lib"]
+  spec.extensions = ["ext/mmap_ruby/extconf.rb"]
+end

data/tmp/arm64-darwin25/stage/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2025-07-19
+
+- Rewrite tenderlove/mmap with modern Ruby support

data/tmp/arm64-darwin25/stage/README.md

@@ -0,0 +1,92 @@
+# MmapRuby
+
+![Version](https://img.shields.io/gem/v/mmap-ruby)
+![Build](https://img.shields.io/github/actions/workflow/status/joshuay03/mmap-ruby/.github/workflows/main.yml?branch=main)
+
+[`mmap`](https://en.wikipedia.org/wiki/Mmap) wrapper for Ruby.
+
+A modern fork of https://github.com/tenderlove/mmap.
+
+**Docs:** https://joshuay03.github.io/mmap-ruby
+
+**Example:**
+
+```ruby
+# frozen_string_literal: true
+
+require "mmap-ruby"
+
+PAGESIZE = 4096
+
+file = File.open("aa", "w")
+file.write("\0" * PAGESIZE)
+file.write("test")
+file.write("\0" * PAGESIZE)
+file.close
+
+mmap = Mmap.new("aa", "rw", offset: 0)
+p mmap.size == "test".size + (2 * PAGESIZE)
+p mmap.scan(/[a-z.]+/) == ["test"]
+p mmap.index("test") == PAGESIZE
+p mmap.rindex("test") == PAGESIZE
+p mmap.sub!(/[a-z.]+/, "toto") == mmap
+p mmap.scan(/[a-z.]+/) == ["toto"]
+begin
+  mmap.sub!(/[a-z.]+/, "alpha")
+  puts "not OK, must give an error"
+rescue
+  puts "OK: #$!"
+end
+mmap.munmap
+
+mmap = Mmap.new("aa", "rw")
+p mmap.index("toto") == PAGESIZE
+p mmap.sub!(/([a-z.]+)/, "alpha") == mmap
+p $& == "toto"
+p $1 == "toto"
+p mmap.index("toto") == nil
+p mmap.index("alpha") == PAGESIZE
+p mmap.size == 5 + 2 * PAGESIZE
+mmap.gsub!(/\0/, "X")
+p mmap.size == 5 + 2 * PAGESIZE
+
+File.delete("aa")
+```
+
+## Installation
+
+Install the gem and add to the application's Gemfile by executing:
+
+```bash
+bundle add mmap-ruby
+```
+
+If bundler is not being used to manage dependencies, install the gem by executing:
+
+```bash
+gem install mmap-ruby
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `bundle exec rake` 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 the created tag, 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/[joshuay03]/mmap-ruby. This project is
+intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the
+[code of conduct](https://github.com/[joshuay03]/mmap-ruby/blob/main/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [Ruby license](https://www.ruby-lang.org/en/about/license.txt).
+
+## Code of Conduct
+
+Everyone interacting in the MmapRuby project's codebases, issue trackers, chat rooms and mailing lists is expected to
+follow the [code of conduct](https://github.com/[joshuay03]/mmap-ruby/blob/main/CODE_OF_CONDUCT.md).

data/tmp/arm64-darwin25/stage/mmap-ruby.gemspec

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative "lib/mmap-ruby/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "mmap-ruby"
+  spec.version = MmapRuby::VERSION
+  spec.authors = ["Guy Decoux", "Aaron Patterson", "Joshua Young"]
+  spec.email = ["ts@moulon.inra.fr", "tenderlove@github.com", "djry1999@gmail.com"]
+
+  spec.summary = "mmap wrapper for Ruby"
+  spec.homepage = "https://github.com/joshuay03/mmap-ruby"
+  spec.license = "https://www.ruby-lang.org/en/about/license.txt"
+  spec.required_ruby_version = ">= 3.3.0"
+
+  spec.metadata["documentation_uri"] = "https://joshuay03.github.io/mmap-ruby/"
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir["lib/**/*", "ext/**/*", "**/*.{gemspec,md,txt}"]
+  spec.require_paths = ["lib"]
+  spec.extensions = ["ext/mmap_ruby/extconf.rb"]
+end

metadata

@@ -0,0 +1,61 @@
+--- !ruby/object:Gem::Specification
+name: mmap-ruby
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Guy Decoux
+- Aaron Patterson
+- Joshua Young
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+email:
+- ts@moulon.inra.fr
+- tenderlove@github.com
+- djry1999@gmail.com
+executables: []
+extensions:
+- ext/mmap_ruby/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- README.md
+- ext/mmap_ruby/extconf.rb
+- ext/mmap_ruby/mmap
+- ext/mmap_ruby/mmap_ruby.c
+- ext/mmap_ruby/mmap_ruby.h
+- lib/mmap-ruby.rb
+- lib/mmap-ruby/mmap.rb
+- lib/mmap-ruby/mmap_ruby.bundle
+- lib/mmap-ruby/version.rb
+- mmap-ruby.gemspec
+- tmp/arm64-darwin25/stage/CHANGELOG.md
+- tmp/arm64-darwin25/stage/README.md
+- tmp/arm64-darwin25/stage/mmap-ruby.gemspec
+homepage: https://github.com/joshuay03/mmap-ruby
+licenses:
+- https://www.ruby-lang.org/en/about/license.txt
+metadata:
+  documentation_uri: https://joshuay03.github.io/mmap-ruby/
+  source_code_uri: https://github.com/joshuay03/mmap-ruby
+  changelog_uri: https://github.com/joshuay03/mmap-ruby/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: mmap wrapper for Ruby
+test_files: []