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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3293e6f4fb7b779387b27788b54885f8b8ccc1d9ffb9187f1b5ce228fbbb4547
-  data.tar.gz: ebddce8416986e40fdfcabba3d54c30dcd31df48731d70aa65fe93f84a4d44a5
+  metadata.gz: 5095227e690cb06e604d1d4639f4608a4e16122f2b57504d6c6040d0ac6a793e
+  data.tar.gz: 7a7d2f7b9dc467ae6a8c87824ac52274de722e6af7854ed1c5b44e326df0985c
 SHA512:
-  metadata.gz: 5695b5aecf448c5177c0a53433766d769c7703accd32ef80465caa6e7a3ce975808f4cda05532df4311b5f92d46dd57c562d0fb72778cc5abbbd071894734b02
-  data.tar.gz: 73e49cafc4ebcfeecc19259d66f192d4a720d5a2e2bb286214e5e82522a9ff0557a84b9159853b36477a8bc97fa514bcc4b046c241d262dbbc675f9c07f67acb
+  metadata.gz: f49fc1dcd0f5a426deda268a1b011a962c2dd81f240334441eb9b781a647325cc82c1b1c2e5d375801eb6cef7973441efcb22f14fef474a9017d25b7f35432c8
+  data.tar.gz: cccd40db4939a0d7fc4282b62254a273946b63431117c72e44e8f845d88904d761685dbfe2f174a0181fad38ccbe98f65406c663e2af7b3ce9ef87b13a36dce9

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: aarch64-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:
   - - ">="