maxmind-db-rust 0.2.1-x86_64-linux → 0.3.0-x86_64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bba7032cef7dcc7be611ddb568bc80e10cbf315ead68b24eee35ae8d1606a2f1
-  data.tar.gz: 6b5afef8c42e9970c61060abcade6eb13cf817646487c3b534427ab39aad14aa
+  metadata.gz: 44b50a29eb78c0c9608b6564b399f7a51ea2d29d9add9459777a97d751c743c3
+  data.tar.gz: 45073904effcde088115cb014f0657e4180029ad0fa5a36b68456339859087f1
 SHA512:
-  metadata.gz: 15deeb44597808553e4ac54c14ed37f4158d6e280798e6285eca7d186d10a7db08fcddb8d5b4cc43db71bcff70c3f00310b5a935cbef218c4db4ede7bcd74edc
-  data.tar.gz: 5799fc30f859c87cd3602eb61bed78c21fd97fe801533846e3ef6a2d9f8c4230eba1d047243a49dd46ab1cb76db8bf55ddf0a32d6699bb29e856428c41f0113e
+  metadata.gz: 3a9ae58533538efb220195f02f032fcfe2d7bec6268a2b42cac27f4f9bb123842cf7b97efde6b215689da146ef5187e342904f77d90cdf68530e1e570b1d1473
+  data.tar.gz: afab743a497847dfbd794d78366cbb89385bd221e30322471be67b981af4f0d051869933d7259241ef58d0038068fbdd13d7375a362d7d8ca7fe27a0577751c5

data/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-02-22
+
+### Changed
+
+- Improved lookup performance by using a generic bounded key cache for decoded map keys.
+- Improved `IPAddr` lookup performance by decoding packed bytes from `IPAddr#hton` directly.
+- Switched map-key cache hashing to `FxHashMap` for faster key-cache access.
+- Switched map-key cache roots to a Ruby-owned cache array with Rust key-to-index lookups.
+- Refactored duplicated prefix and `within` decode paths in the Rust reader for simpler maintenance.
+- Refactored duplicate database file-open error handling shared by MMAP and MEMORY modes.
+- Updated Rust and Ruby dependencies.
+- Added Ruby 4.0 coverage to CI workflows.
+
+### Fixed
+
+- Made extension initialization idempotent across `MaxMind::DB` class/module loading modes to avoid typed-data incompatibility when the extension is loaded more than once.
+- When loaded with the official `MaxMind::DB` class, `MaxMind::DB::Rust` now uses anonymous module creation to preserve canonical module naming.
+- Scoped Rust dependency cache per Ruby version in CI tests and stopped caching `target/` in the test workflow to avoid cross-version artifact contamination.
+
 ## [0.2.1] - 2025-12-18
 
 ### Changed

data/README.md

@@ -3,18 +3,19 @@
 [![Test](https://github.com/oschwald/maxmind-db-rust-ruby/actions/workflows/test.yml/badge.svg)](https://github.com/oschwald/maxmind-db-rust-ruby/actions/workflows/test.yml)
 [![Lint](https://github.com/oschwald/maxmind-db-rust-ruby/actions/workflows/lint.yml/badge.svg)](https://github.com/oschwald/maxmind-db-rust-ruby/actions/workflows/lint.yml)
 
-A high-performance Rust-based Ruby gem for reading MaxMind DB files. Provides API compatibility with the official `maxmind-db` gem while leveraging Rust for superior performance.
+A Ruby gem for reading MaxMind DB files, implemented in Rust.
+It keeps the API close to the official `maxmind-db` gem while adding Rust-backed performance.
 
 > **Note:** This is an unofficial library and is not endorsed by MaxMind. For the official Ruby library, see [maxmind-db](https://github.com/maxmind/MaxMind-DB-Reader-ruby).
 
 ## Features
 
-- **High Performance**: Rust-based implementation provides significantly faster lookups than pure Ruby
-- **API Compatible**: Familiar API similar to the official MaxMind::DB gem
-- **Thread-Safe**: Safe to use from multiple threads
-- **Memory Modes**: Support for both memory-mapped (MMAP) and in-memory modes
-- **Iterator Support**: Iterate over all networks in the database (extension feature)
-- **Type Support**: Works with both String and IPAddr objects
+- Rust implementation focused on fast lookups
+- API modeled after the official `maxmind-db` gem
+- Thread-safe lookups
+- Supports MMAP and in-memory modes
+- Includes network iteration support
+- Accepts both `String` and `IPAddr` inputs
 
 ## Installation
 
@@ -277,30 +278,31 @@ Metadata attributes:
 
 ## Comparison with Official Gem
 
-| Feature          | maxmind-db (official) | maxmind-db-rust (this gem) |
-| ---------------- | --------------------- | -------------------------- |
-| Implementation   | Pure Ruby             | Rust with Ruby bindings    |
-| Performance      | Baseline              | 10-50x faster              |
-| API              | MaxMind::DB           | MaxMind::DB::Rust          |
-| MODE_FILE        | ✓                     | ✗                          |
-| MODE_MEMORY      | ✓                     | ✓                          |
-| MODE_AUTO        | ✓                     | ✓                          |
-| MODE_MMAP        | ✗                     | ✓                          |
-| Iterator support | ✗                     | ✓                          |
-| Thread-safe      | ✓                     | ✓                          |
+| Feature          | maxmind-db (official) | maxmind-db-rust (this gem)                 |
+| ---------------- | --------------------- | ------------------------------------------ |
+| Implementation   | Pure Ruby             | Rust with Ruby bindings                    |
+| Performance      | Baseline              | Faster lookup throughput in our benchmarks |
+| API              | MaxMind::DB           | MaxMind::DB::Rust                          |
+| MODE_FILE        | ✓                     | ✗                                          |
+| MODE_MEMORY      | ✓                     | ✓                                          |
+| MODE_AUTO        | ✓                     | ✓                                          |
+| MODE_MMAP        | ✗                     | ✓                                          |
+| Iterator support | ✗                     | ✓                                          |
+| Thread-safe      | ✓                     | ✓                                          |
 
 ## Performance
 
-Expected performance characteristics (will vary based on hardware):
+Lookup performance depends on hardware, Ruby version, database, and workload.
 
-- Single-threaded lookups: 300,000 - 500,000 lookups/second
-- Significantly faster than pure Ruby implementations
-- Memory-mapped mode (MMAP) provides best performance
-- Fully thread-safe for concurrent lookups
+- In this project’s random-lookup benchmarks, this gem is consistently faster than the official Ruby implementation.
+- On `/var/lib/GeoIP/GeoIP2-City.mmdb` in this environment, random lookup throughput was about `47x` higher than the official gem.
+- `MODE_MMAP` and `MODE_MEMORY` both perform well; which is faster can vary by environment.
+- For reproducible numbers on your own data, run `benchmark/compare_lookups.rb` against your database.
+- Safe for concurrent lookups across threads.
 
 ## Development
 
-Interested in contributing? See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed developer documentation, including:
+See [CONTRIBUTING.md](CONTRIBUTING.md) for developer documentation, including:
 
 - Development setup and prerequisites
 - Building and testing the extension
@@ -321,11 +323,11 @@ bundle exec rake test
 
 ## Contributing
 
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
+1. Fork the repository
+2. Create a feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Describe your change'`)
 4. Push to the branch (`git push origin my-new-feature`)
-5. Create a new Pull Request
+5. Open a Pull Request
 
 ## License
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: maxmind-db-rust
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: x86_64-linux
 authors:
 - Gregory Oschwald
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-12-18 00:00:00.000000000 Z
+date: 2026-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -152,6 +152,7 @@ files:
 - lib/maxmind/db/3.2/maxmind_db_rust.so
 - lib/maxmind/db/3.3/maxmind_db_rust.so
 - lib/maxmind/db/3.4/maxmind_db_rust.so
+- lib/maxmind/db/4.0/maxmind_db_rust.so
 - lib/maxmind/db/rust.rb
 homepage: https://github.com/oschwald/maxmind-db-rust-ruby
 licenses:
@@ -174,7 +175,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '3.2'
   - - "<"
     - !ruby/object:Gem::Version
-      version: 3.5.dev
+      version: 4.1.dev
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="